stopcheat

A lightweight mod designed to help server owners easily manage player command permissions in Minecraft multiplayer. Intuitively disable specific commands, while allowing designated whitelisted players to bypass command restrictions.

AI Translation Notice: This documentation was translated with the assistance of AI. The original author is a non-native English speaker, so please feel free to report any inaccuracies.

Configuration Guide

This mod can be configured either through the in-game GUI (Mod Menu / Config screen) or by manually editing the configuration file:

File location: config/stopcheat-common.toml

Config Fields

blacked_commands

• Type: List of strings
• Purpose: Defines which commands (and their specific arguments) should be blocked from execution.
• Format: {command}:{checkIndex}:{disabled_args}

How It Works

Example 1 — Block an entire command:

blacked_commands = ["give:0:"]

• give is the command name.
• 0 means "do not check any arguments; block the entire command unconditionally."
• disabled_args is ignored because the entire command is banned.
• Result: /give cannot be used in any form.

Example 2 — Block specific arguments:

blacked_commands = ["gamemode:1:creative,spectator"]

• gamemode is the command name.
• 1 means "check the 1st argument after /gamemode."
• creative,spectator are the banned values.
• Result: /gamemode creative and /gamemode spectator are blocked, but /gamemode survival and /gamemode adventure still work normally.

Example 3 — Block multiple commands:

blacked_commands = [
    "give:0:",                # Block /give entirely
    "fill:0:",                # Block /fill entirely
    "gamemode:1:creative,spectator"   # Block only creative and spectator
]

pass_users

• Type: List of UUID strings
• Purpose: Players in this list bypass all command restrictions.
• Format: Standard UUID string with hyphens, e.g. "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"

pass_users = [
    "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",  # Admin Alice
    "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"   # Admin Bob
]

Tips

• Always use full UUIDs with hyphens in pass_users; player names are not accepted. Use a UUID lookup tool if you don't know a player's UUID.