Modscraper Modscraper Minecraft
Item Sanitizer logo

Item Sanitizer

Mod

Lightweight server side Minecraft mod that removes banned items from player inventories

Type

Mod

Modrinth Downloads

24

Modrinth ID

VYAwjEml

Last Updated

Jun 16, 2026

Description

Item Sanitizer allows server administrators to define a list of blacklisted items in a configuration file. When a player attempts to pick up or equip a blacklisted item, the mod automatically removes the item and notifies the player with a message displayed at the bottom center of their screen. The mod also includes an option to allow server operators (OPs) to bypass these restrictions.

Features:

  • Blacklist Enforcement: Automatically removes blacklisted items from players' inventories.
  • Player Notifications: Displays a message to players when a blacklisted item is removed.
  • Configurable: Easily define blacklisted items in the configuration file.
  • OP Bypass: Optionally allow server operators to use blacklisted items.
  • Server-Side Only: No need for players to install the mod on their clients.

Use Cases:

  • Prevent the use of overpowered or disruptive items in survival or competitive servers.
  • Enforce server rules and maintain a balanced gameplay environment.

Compatibility:

  • Compatible with Minecraft 1.20.1 and Forge.
  • Designed for server-side use only.

Installation:

  1. Place the mod's JAR file in the mods folder of your server.
  2. Start the server to generate the configuration file.
  3. Edit the configuration file to define your blacklist.
  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.

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 }
  • 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).

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.

Compatibility

Mod Loaders

Forge

Game Versions

1.20.1

Similar Mods

External Resources