Frequently asked questions
The plugin #
Does it punish players automatically? #
No. Out of the box it records cases and notifies your staff. On Pro you can add console commands that run when a case reaches a threshold you choose, for the violation types and severities you choose.
Do I need AI or an API key? #
No. Detection is a rules engine that runs on your server. AI is optional and off by default: with your own Anthropic or OpenAI-compatible key, staff can ask for a short explanation of a case (10 a day on Free, unlimited on Pro).
Which languages does it understand? #
The bundled rule packs cover English and Spanish. For other languages, add your own words, phrases and regular expressions in rules/custom.yml. The panel, the in-game messages and the e-mails are available in English, Spanish and Rioplatense Spanish.
Does it replace my punishment plugin? #
No. Manuka Moderation does not ban or mute anyone itself. It records the bans, mutes, kicks and warnings your staff hand out with LiteBans, AdvancedBan, Essentials, the vanilla ban list or the punishment commands you list, and shows them next to the cases.
Will it slow down my server? #
Detection, database writes, e-mails and AI calls run on the plugin's own threads, never on the server thread. Rule patterns are checked when they load, and one that runs too slowly is disabled and named in the console.
Does it run on Folia? #
No. The plugin refuses to enable on Folia. It runs on Paper and Spigot, Minecraft 1.21 – 1.21.x and 26.1 – 26.3, with Java 21 or newer.
Can I change what it detects? #
Yes. Add words, regular expressions, safe words and your own named rules in rules/custom.yml, list your own website and Discord invite in advertising.allowed, and choose per violation type and severity whether a detection is only logged or notifies your staff. See Configuration.
Can my staff use the panel from their phones? #
Yes. The panel works on small screens, and every open panel updates in real time. Staff need to reach it over the network, ideally through a reverse proxy with HTTPS. See the panel guide.
Where is the data stored? Does it leave my server? #
Everything is stored in plugins/ManukaModeration/data.db on your server. We never receive your chat, players or cases. The plugin only contacts other services for the license check (Pro), update checks, player skin images (from Mojang, unless you turn them off), the e-mail server you configure and, if you turn it on, the AI provider you configure. See the privacy policy.
Buying and licenses #
What do I get with Pro? #
Unlimited panel accounts and access groups, unlimited chat log history, longer analytics, more e-mail options, automatic actions and priority support, among others. The full list is in the Free and Pro table.
How much does it cost? #
Pro monthly is $20 a month, and Pro Lifetime is $250 paid once. Polar adds sales tax or VAT for your country at checkout. See Plans.
Where do I find my license key? #
On Polar's confirmation page right after you pay, and at any time in Polar's customer portal, where you sign in with the e-mail address you used at checkout. It starts with MMPRO-.
Can I use one key on two servers? #
One server at a time. Run mm license deactivate on one server before activating the key on the other, or buy a second key for a test server.
What if my server cannot reach Polar for a while? #
Pro keeps working for up to 7 days after the last successful check, and everything goes back to normal as soon as Polar answers again. The grace never extends a subscription past the end of its paid period.
What happens if I cancel my subscription? #
Pro stays active until the end of the period you already paid for. Then the server goes back to Free; cases, punishments, panel accounts and settings are kept. See When Pro ends for the one exception, old chat log.
Can I get a refund? #
Write to [email protected] with your order number. We review refund requests case by case. See the refund policy.