Tisane AutoModeration Plugin for Minecraft

Website

Tisane AutoModeration plugin for Minecraft

The Tisane AutoModeration plugin scans messages for inappropriate content based on your configuration. It can automatically ban, mute, or notify administrators when it detects violations.

Installation Guide

Step 1: Install the plugin

1. Download the JAR file for the Tisane AutoModeration plugin.

2. Copy or move the JAR file into the Spigot plugins folder.

3. (Optional) If you need LiteBans support:

Download the LiteBans JAR file.
Copy or move the LiteBans JAR file into the Spigot plugins folder.

Note: LiteBans extends the standard Minecraft moderation commands, enabling timed bans, mutes, and warnings.

Step 2: Configure the plugin

Locate and open the tisane-plugin-config.yml file in the plugin folder.

Edit the configuration file to set your preferred options.

About 2-Factor moderation

This feature enables context-aware actions, reducing moderator involvement in minor disputes.

When this feature is enabled, the plugin:

Detects instances of targeted harassment or insults aimed at a specific user.
Asks targeted users to confirm whether they were insulted
Temporarily grants the targeted user limited moderator privileges to take action against the offender.

When an insult is detected, the targeted user is prompted with the following message:

“It appears you were insulted. Punish @author_of_attack? Y/N”.

If the user responds with Y, the plugin enforces the punishment specified in the configuration file.
If the user responds with N, no action is taken.

About the abuse type categories

For a list of abuse type categories, see: “Abusive or Problematic Content” in the Tisane API documentation

Limitations

Message rate limits

Notifications will appear if the message limit is reached. For higher message volumes, upgrade your plan or contact us for on-prem installation options.

To estimate your projected message count: Multiply the number of active users in your game by 1,000.

Detection accuracy

Detection might misclassify messages. Some degree of error is expected.

Language identification accuracy

The language is harder to identify in short messages (<20 characters) due to similar or identical words in several languages.

For example: “status” is a word in English, Spanish, and French. To mitigate incorrect language identification, use a minimal number of language codes in chat_language.

Upgrading Your Plan

1. Go to Subscription Plans.

2. Select your preferred plan.

3. Click Activate.

Configuration Details

Essentials

The plugin uses a standard Spigot configuration .yml file format.

chat_language

Define the chat language or languages used in your community. Use * for auto-detection or specify a vertical bar-delimited list of language codes.

Examples:

chat_language: en (single language)
chat_language: en|ru|fr|es|de|nl|zh-CN (multiple languages)

api_key or tisane_host

Provide either the Tisane API key for SaaS or the host URL for on-premises use.

Warning: Ensure only one value is set to avoid errors.

Examples:

api_key: AIza1SyDaGmWKa4JsXZ-HjGaw7I2SLn_3namBGewQe
tisane_host: http://1.1.1.1:7888

Command settings

Configure commands for specific abuse types.

Formed based on the following template:

{Tisane abuse type}_command

In addition to the standard types, there is also a special provoked_personal_attack type, that defines punishment when the personal attack was preceded by an adverse interaction (e.g. griefing). It is a good practice to take the provocation into consideration as a mitigating circumstance.

Use the following operands:

{text} - the text posted
{player} - the alias of the player who posted the text
{tisane_explanation} - the explanation provided by Tisane

Examples:

profanity_command: mute {player} "Profanity detected; {text} ({tisane_explanation}). Watch your language!"

Discord Credentials

discord_server_token

The token of the server to send notifications to.

discord_alert_channel_id

The channel ID of the Discord server to send notifications to.

Additional Settings

enable_2f

Enable two-factor moderation of personal attacks

Example: enable_2f: true

whitelisted_users

Specify users exempt from moderation.

Example: whitelisted_users: admin12345

message_admin

Specify users to receive moderation notifications.

Example: message_admin: admin12345

username_language

Language code value when processing usernames.

Example: username_language: en

include_translation

If true, translate non-English messages into English. The translation is concatenated to the original message as part of the notification.

Example: include_translation: true

include_explanation

If true, include the explanation of the issue that Tisane identified in the notification.

Example: include_explanation: true

message_format

Specify the format of the message sent through Discord to the administrators.

Example: message_format: '{command} {player}, message text = {message}, reason = {tisane_explanation}, in English = {translation}'

DOWNLOAD JAR SPIGOT PLUGIN DIRECTORY LISTING

Troubleshooting

Plugin does not load (it appears in red)

Check your configuration file is valid:

The syntax is correct.
api_key or tisane_host is correctly set.
Your Discord settings are valid, if used.

Missed problematic messages

Check:

Your API key and language codes are correct.
All the commands in the configuration file are valid.
LiteBans is installed if LiteBans commands are used.

If you’re expecting a particular utterance to trigger a reaction and it still doesn't work, try making a POST /parse API call directly. You can use Tisane Labs Developer Portal or any REST test tool.

False positives (messages you don't want to be alerted about)

Exclude abuse types you want to ignore from the configuration file.
Adjust the language codes or turn off auto-detect.

If you’re still experiencing problems

Contact Tisane technical support.