Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for firesmasher

A PaperMC plugin that watches chat, batches messages, and asks an AI model to flag toxicity, spam, etc.

Report AiModeration?

R

1.0.0

AiModeration 1.0.0

Initial release.

Highlights

  • AI-powered chat moderation using OpenRouter or Groq
  • Configurable model intelligence tiers (LIGHTWEIGHT, SMART, INTELLIGENT)
  • Automatic batching: chat is analyzed every 20 messages
  • Console-dispatched warn / kick / ban actions based on AI output
  • Permanent action audit log (chat-action.log)
  • Optional Discord webhook embeds for every AI action
  • /aimoderation command with reload, status, and forcesend
  • Gson resolved dynamically via PaperMC's libraries loader — no shading
  • Uses Java's built-in HttpClient, no bundled HTTP dependencies

Requirements

  • Java 21
  • PaperMC 1.21.1 (API version 1.21)

Configuration

See GUIDE.md for full setup instructions.

Known Limitations

  • Only OpenRouter and Groq are supported as providers.
  • Punishment commands assume standard kick/ban console commands are available; custom punishment plugins are not yet supported.
  • No built-in rate limiting on API calls beyond the 20-line batching threshold.

Checksums

Generate your own checksum after building:

sha256sum target/AiModeration-1.0.0.jar

Information

Published
August 20, 2026
0Downloads

Platforms

Paper
Paper
1.21–26.2