AiModeration
A plugin/mod that watches chat, batches messages, and asks an AI model to flag toxicity, spam, advertising, and grief threats — then applies the suggested punishment automatically.
Автор: firesmasher07921161обновлён 20 авг. 2026 г.
УправлениеТехнологииУтилиты
Описание
AiModeration
A PaperMC plugin/Fabric Mod that watches chat, batches messages, and asks an AI model to flag toxicity, spam, advertising, and grief threats — then applies the suggested punishment automatically.
Features
- Logs every chat message to
chat-msg.txtin the plugin's data folder - Every 20 lines, the batch is flushed and sent to an AI provider for review
- Supports OpenRouter and Groq as providers, with three model tiers (LIGHTWEIGHT, SMART, INTELLIGENT)
- Applies
warn/kick/banactions straight from the console - Writes a permanent audit trail to
chat-action.log - Optional Discord webhook integration — posts an embed for every action
/aimoderationcommand for reload, status, and manual batch sending
Requirements
- Java 21
- PaperMC 1.21.x
- An API key for OpenRouter or Groq
Building
mvn clean package
The compiled jar will be in target/AiModeration-1.0.0.jar.
Installation
- Drop the jar into your server's
plugins/folder. - Start the server once to generate
config.yml. - Fill in your
apiKey, chooseapiProviderandaiIntelligence. - Optionally enable the
discordwebhook section. - Restart or run
/aimoderation reload.
See GUIDE.md for full configuration and command details.
Documentation
- GUIDE.md — setup and usage guide
- SECURITY.md — reporting vulnerabilities
- CODE_OF_CONDUCT.md — community guidelines
- release-1.0.0.md — release notes
License
Provided as-is by CodeStuff.
Галерея
Последние версии
Все версии →release
AiModeration 1.0.0
1.0.020 авг. 2026 г.59Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur
Что нового
# 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](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
```
release
AiModeration 1.0.0
1.0.020 авг. 2026 г.57Minecraft: 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8fabric
Что нового
# 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](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
```