Item Sanitizer

Item Sanitizer allows server administrators to define a list of blacklisted items in a configuration file

Features:

• Blacklist Enforcement: Automatically removes blacklisted items from players' inventories.
• Player Notifications: Displays a message to players when a blacklisted item is removed.
• Player Whitelist: Allows specific players to use specific blacklisted items via playersWhitelist.
• Configurable: Easily define blacklisted items in the configuration file.
• OP Bypass: Optionally allow server operators to use blacklisted items.
• Dual-Side Sync: Configuration is synced from server to clients, ensuring consistent enforcement.

Use Cases:

• Prevent the use of overpowered or disruptive items in survival or competitive servers.
• Enforce server rules and maintain a balanced gameplay environment.
• Grant specific players access to certain items (e.g., staff members, builders).

Compatibility:

• Compatible with Minecraft 1.20.1 and Forge.
• Requires installation on both server and client for full functionality (blacklist sync and tooltip blocking).

Installation:

1. Place the mod's JAR file in the mods folder of both your server and clients.
2. Start the server to generate the configuration file.
3. Edit the configuration file to define your blacklist and player whitelists.
4. Restart the server to apply changes.

Commands:

• /itemsanitizer reload: Reloads the configuration file without restarting the server.

Permissions:

• Server operators (OPs) can bypass item restrictions if enabled in the configuration file.
• Players listed in playersWhitelist can use their whitelisted items regardless of the blacklist.

Configuration:

The configuration file is located at config/itemsanitizer.json. You can define blacklisted items using the blacklistedItems list. Each entry in the list can be either a specific item ID or a pattern using regular expressions.

Example Configuration:

{
  "blacklistedItems": [
    "minecraft:tnt",
    "minecraft:tnt_minecart",
    "!minecraft:.*_spawn_egg",
    "tfmg:advanced_potato_cannon",
    "tfmg:segmented_display"
  ],
  "allowOpsUseBlacklistedItems": true,
  "playersWhitelist": {
    "BuilderSteve": ["minecraft:bedrock", "minecraft:command_block"],
    "AdminAlex": ["*"]
  }
}

• Specific Item: Add the exact item ID (e.g., minecraft:tnt).
• Pattern: Use ! followed by a regular expression to match multiple items (e.g., !minecraft:.*_spawn_egg matches all spawn eggs).
• Player Whitelist: A map of player names to lists of item IDs they are allowed to use despite the blacklist.
  • Use "*" as the only entry to allow all items for a specific player.
  • Players not listed in playersWhitelist are subject to the normal blacklist rules.

Notes:

• Changes to the configuration file require a server restart or the /itemsanitizer reload command to take effect.
• Ensure the item IDs or patterns are valid to avoid errors.
• The mod must be installed on clients to receive synced configuration and prevent blacklisted items from appearing in tooltips.