What is the Minecraft module?

The Minecraft module is supposed to help you moderate a Minecraft server via discord. In this module you can set up some rules, which is just taking your server rules and giving them IDs like 1 or 1a.

Since Weirdoes Moderator is made to be multi-server compatible, using the Minecraft module is synced to one server so you can have the same bot in multiple servers without worrying about data bleeding into each other!

Getting Started

To use the Minecraft module, you need to install the plugin on your Minecraft server. You can download the plugin from the button below:

Download WMMC v1.0.0

Minecraft Module also will not work if you don't self-host the Discord bot. To set up "Minecraft", go to Discord and first make sure you have enabled the Minecraft module by using !module enable minecraft After that you'll need to link the server and your bot. To do this, first run !minecraft setup in Discord and then go to Minecraft and run /wmmc setup. Your Minecraft server will then be linked to your Discord server and you can start using the module.

WMMC Modes of operation

Standardized punishment

With Standardized punishment you can do /punish <user> <rule> <degree> and the bot will automatically punish the user based on what you set the punishment for let’s say 3rd degree violation of rule 1.

You can have up to 3 degrees of punishment per rule.

Standardized punishment is useful for rules like griefing where the punishment is usually the same. So a 3rd degree violation on griefing might be ban and the bot will ban the user, from the Minecraft server, as soon as the punishment was issued by a moderator.

Manual mode

Manual mode is useful for rules that don’t usually have the same punishment.

Let’s say i have a rule about claims and how far you’re allowed to extend them. Here it could be difficult to just say “You extended too far, now you’re banned” or something.

That’s why with manual mode you can use the command /punish <user> <rule>

The warning will be logged and saved to the users account however no action will be taken automatically.

Rule setup

To setup the rules find your wm-rules.json inside your servers config folder.

wm-config.json

wm-rules.json

The file will look like this before changed

{
  "1": {
    "name": "Griefing",
    "punishments": [
      "warn",
      "temp_ban_7d",
      "perm_ban"
    ]
  },
  "1a": {
    "name": "Hacking/X-Ray",
    "punishments": [
      "perm_ban"
    ]
  },
  "2": {
    "name": "Claim Extension",
    "punishments": []
  },
  "3": {
    "name": "Chat Toxicity",
    "description": "Inappropriate language or slurs",
    "punishments": [
      "warn",
      "temp_ban_1h",
      "perm_ban"
    ]
  }
}

Each rule will have:

Field	Required	Description
`id`	✅	Unique identifier for the rule
`name`	❌	Used for logging only
`description`	❌	Used for logging only
`punishments`	✅	Array of punishments to apply in order

Name and description are used only for logging and have no effect on punishment behaviour.

Value	Description
`warn`	Issues a warning to the player
`perm_ban`	Permanently bans the player
`temp_ban_DURATION`	Temporarily bans, e.g. `temp_ban_7d`, `temp_ban_1h`
`mute_DURATION`	Mutes the player, e.g. `mute_30m`

If the punishments array is left empty, the rule will be treated as a manual rule.

Integration & Syncing

Account Linking

Staff can link Discord accounts to Minecraft accounts through the WMD interface. This creates a bridge between the two platforms to make moderation easier. This is a manual process managed by staff, players are not forced to link their accounts.

Rule Synchronization

The wm-rules.json on the Minecraft server is the source of truth for all rules. Every time the Minecraft server starts, it pushes this file to WMD, keeping the Discord bot always up to date.

Punishment History

The /hwarn command is cross-platform. If a Discord account is linked to a Minecraft account, /hwarn will pull infraction history from both platforms giving staff a full view in one command.

Server Tethering

WMD manages a folder per Discord server to keep data isolated. When WMMC starts it checks wm-config.json for a discord_server_id and pings WMD to identify itself.

If it's a new server, WMD assigns it a unique ID and creates a dedicated folder for it. The rules are then saved inside that folder as mcrules.json.

Because WMMC is bound to a specific Discord server ID, warnings and punishments are fully isolated. A punishment on the TCC Minecraft server only logs to the TCC Discord and never bleeds into another servers data.

Configuration

WMMC may be configured in wm-config.json

discord_server_id:

On a side note for the Minecraft Module, in-game players will also be affected by mutes and we add /mute to Minecraft. If your Discord account has been synced with Minecraft, mutes will also sync cross-platform.

Minecraft

On this page