On this page
What it does #
Manuka Moderation reads your server's chat and flags misconduct with a rules engine built for English and Spanish chat. No AI is needed to detect anything. Detections become cases that your staff review in a web panel served by the plugin itself: no external database, no web hosting and no cloud service to set up.
Twelve violation types
Advertising, insults, harassment, discrimination, sexual content, threats, spam, caps, personal data, filter evasion, rank abuse and your own rules, with English and Spanish rule packs.
Hard to dodge
Accents, leetspeak, spaced or dotted letters, repeated letters and look-alike characters are undone before matching, and an address typed over several lines (
mc./myserver/.net) is put back together.Reads the context
A targeted insult weighs more than cursing at the air, banter between friends is not escalated, and the website and Discord invite you list as your own are never flagged.
Cases, not noise
Detections are grouped into cases with evidence, the conversation around them, notes, an assignee and a status. Nothing is punished automatically unless you set it up (Pro).
A private web panel
Dashboard, cases, players, punishments, chat logs, analytics and settings, served by the plugin itself and updated in real time. Works on phones.
Punishment tracking
Bans, temporary and IP bans, mutes, kicks and warnings from LiteBans, AdvancedBan, Essentials, the vanilla ban list and your own punishment commands.
Alerts and e-mail
In-game alerts with a clickable panel link for your staff, and e-mails through any SMTP server: one per case, or digests on a schedule.
Analytics and insights
Messages, active players, cases, punishments, evasion attempts and review times, with plain-language insights on the dashboard.
Optional AI
Off by default. With your own Anthropic or OpenAI-compatible key, staff can ask for a short explanation of a case. E-mail addresses and phone numbers are masked first.
Who it is for #
Owners and staff teams of Paper and Spigot servers who want to:
- catch players advertising other servers, including the tricks they use to get past chat filters;
- spot insults, harassment, threats and shared personal data early, with the conversation around them;
- keep every case, and the bans, mutes and kicks their staff hand out, in one place;
- keep their chat data on their own server.
The bundled rule packs cover English and Spanish. For other languages, add your own words and patterns in rules/custom.yml.
What it detects #
| Type | What it looks for |
|---|---|
| Advertising | IP addresses, domains, mc. and play. hosts, Discord invites, known hosting sites and invitation phrases ("join my server", "entren a mi server"). The website and Discord invite you list in advertising.allowed are never flagged. |
| Insult, discrimination, sexual content, threat | Word lists per language, matched after normalization. A targeted message weighs more than cursing at the air. |
| Harassment | One player going after the same victim again and again, or a victim's distress ("leave me alone") right after an insult. It is charged to the harasser. |
| Spam | Repeated or near-identical messages in a short window. |
| Caps | Lines written mostly in capital letters. |
| Personal data | E-mail addresses, phone numbers and street addresses. |
| Filter evasion | A rule that only matched after spaced letters, symbols, leetspeak or look-alike characters were undone. Reported as its own type, on top of the underlying one. |
| Rank abuse | A staff member threatening sanctions outside a punishment, or insulting players. |
| Custom | Your own named rules (words or regular expressions) in rules/custom.yml. |
What happens next is up to you, per type and severity: log (store only), notify (panel, e-mail and in-game alert) or command (Pro: run console commands when a case reaches a threshold). Out of the box, advertising and personal data notify staff at every severity, spam notifies only at high severity, caps is only logged, and every other type is logged at low severity and notifies at medium and high. Nothing is punished automatically by default.
Free and Pro #
Every detector, the web panel and all moderation data are the same in both tiers. Pro lifts the limits and adds features; the panel shows Pro features with a tag instead of hiding them.
| Feature | Free | Pro and Pro Lifetime |
|---|---|---|
| Chat capture, rules engine and every violation type | Included | Included |
| Split-message reassembly and filter-evasion detection | Included | Included |
| Tracking of bans, unbans, mutes and kicks | Included | Included |
| Web panel with real-time updates, light and dark themes, 3 languages | Included | Included |
| Panel accounts | Up to 3 | Unlimited |
| Access groups (which ranks see which violation types) | 2 groups | Unlimited, plus permission overrides |
| Chat log retention | 30 days | Unlimited |
| Analytics ranges | 24 h, 7 d, 30 d | Adds 90 d |
| Analytics: staff activity and repeat offenders | Not included | Included |
CSV export (/mm export and the panel) | Not included | Included |
| E-mail recipients | 1 | Unlimited |
| E-mail schedule | Real-time or a daily digest | Any schedule, both modes, AI paragraph in digests |
| AI case explanations (your own provider key) | 10 per day | Unlimited, plus an automatic second opinion |
| Automatic actions (console commands at a threshold) | Not included | Included |
| Editing settings and users from the panel | Language, theme and accent colour | Everything |
| External website mode (host the panel on your own site) | Not included | Included |
| Updates | Notice and manual download | Automatic download, applied on restart |
| Priority support and future Pro features | Not included | Included |
On Free, every setting can still be changed in config.yml (then run /mm reload). If Pro ends, nothing is deleted except chat log older than 30 days, and only under the conditions described in Licensing.
Pricing #
Free
$0 no key needed
Every detector, the web panel and punishment tracking.
- Up to 3 panel accounts and 2 access groups
- 30 days of chat log
- Analytics for 24 hours, 7 days and 30 days
- 1 e-mail recipient
- 10 AI explanations a day (your own key)
Pro monthly
$20 USD per month
Pro while the subscription is active. Cancel any time.
- Unlimited panel accounts and access groups
- Unlimited chat log retention
- 90-day analytics, staff activity, repeat offenders, CSV export
- Automatic actions at a threshold
- Priority support
Pro Lifetime
$250 USD, paid once
Pro forever on one server, with every future update we publish. The key never expires.
- Everything in Pro
- No renewals
- One server at a time; move it whenever you need
Prices are in US dollars. Polar, our merchant of record, adds sales tax or VAT for your country at checkout. Each key works on one server at a time. Details in Licensing and payment.
Requirements #
- Server software
- Paper or Spigot. Folia is not supported (the plugin refuses to enable).
- Minecraft
- 1.21 – 1.21.x and the year-based 26.1 – 26.3
- Java
- 21 or newer
- Storage
- A local SQLite file (
plugins/ManukaModeration/data.db). Nothing else to install. - Web panel
- Served by the plugin on a TCP port of your choice (8765 by default).
- Optional
- LuckPerms, Vault, LiteBans, AdvancedBan, EssentialsX, PlaceholderAPI; LoginSecurity or AuthMe for signing in to the panel with the in-game password.
- Network
- Pro checks its license key with Polar over HTTPS (
api.polar.sh). Update checks contact Modrinth or GitHub, and player skins are downloaded from Mojang (textures.minecraft.net); both can be turned off.
Get started #
- Download
ManukaModeration-1.0.0.jar(see Install), put it in your server'splugins/folder and restart the server. - In game, set your panel password with
/mm password <password>, or get a one-time login link with/mm panel. - Open the panel at
http://127.0.0.1:8765on the server machine and log in with your Minecraft name.
The install guide covers the details: allowing your own links, giving your staff access and reaching the panel from another computer.
Support #
Write to [email protected]; the support page lists what to include. Pro and Pro Lifetime include priority support. Answers to common questions are in the FAQ.