# SMP Utilities \u2013 Command Wiki<\/p>\n
## Overview<\/p>\n
**SMP Utilities** is a mod designed to enhance the experience of creating and managing **SMP (Survival Multiplayer)** servers in Minecraft.<\/p>\n
The main purpose of the mod is to **restrict and control items, blocks, and even entire mods**, while allowing administrators to create **whitelists for specific players** so they can bypass these restrictions.<\/p>\n
—<\/p>\n
# Admin Items<\/p>\n
**Absurd Damage Sword**<\/p>\n
<\/p>\n
A sword with extremely high damage. It essentially executes `\/kill` on any mob it hits.<\/p>\n
**Ban Sword**<\/p>\n
<\/p>\n
A sword that kicks or bans players when used against them.<\/p>\n
– **Attack without Mending** \u2192 kicks the player
\n– **Attack with Mending enchantment** \u2192 permanently bans the player<\/p>\n
**Chapolin Colorado’s Sledgehammer**<\/p>\n
<\/p>\n
A special weapon with **zero damage** but **extreme knockback**. Hitting any entity launches them far away without killing them. Has infinite durability and is fire resistant.<\/p>\n
**Little Poop**<\/p>\n
<\/p>\n
A throwable item. No further mechanical effect beyond being thrown.<\/p>\n
**Realm Coin**<\/p>\n
<\/p>\n
A collectible\/currency item for server economy or event use.<\/p>\n
**Mind Wrench**<\/p>\n
<\/p>\n
A special weapon with **zero damage** and infinite durability.<\/p>\n
– **Left-click (attack) on a mob** \u2192 applies permanent Slowness 255 (invisibly, no particles\/icon), effectively freezing the mob in place.
\n– **Right-click (interact) on a mob** \u2192 toggles the mob’s AI:
\n – If AI is currently **enabled** \u2192 disables it and marks the mob with the `MindWrenched` tag.
\n – If AI is currently **disabled** (previously wrenched) \u2192 re-enables it and removes the tag.<\/p>\n
Useful for posing or freezing mobs for decoration, events, or screenshots.<\/p>\n
**Security Block**<\/p>\n
<\/p>\n
An unbreakable block intended for admin use.<\/p>\n
—<\/p>\n
# Table of Contents<\/p>\n
1. Introduction
\n2. Main Commands
\n3. Permission System
\n4. Restriction Types
\n5. Detailed Commands (idrestrict, idcontrol, idlock)
\n6. Whitelist Management
\n7. Practical Examples
\n8. Configuration Files
\n9. Frequently Asked Questions
\n10. Item Customization (\/lore and \/rename)
\n11. \/objective
\n12. Potions & Effects
\n13. Waystone Suppression<\/p>\n
—<\/p>\n
# Introduction<\/p>\n
**SMP Utilities** provides three main control systems for administrators:<\/p>\n
### `\/idrestrict`<\/p>\n
Blocks the **use** of items, blocks, or mods.<\/p>\n
Players **can still keep the item in their inventory**, but **cannot use it**.<\/p>\n
—<\/p>\n
### `\/idcontrol`<\/p>\n
Blocks the **possession** of items or mods.<\/p>\n
If a player has the item in their inventory, it **will be automatically removed**.<\/p>\n
—<\/p>\n
### `\/idlock`<\/p>\n
Combines **both systems**.<\/p>\n
Players **cannot possess or use the item**.<\/p>\n
—<\/p>\n
All commands require **operator (OP) permission** or **permission level 2**.<\/p>\n
—<\/p>\n
# Main Commands<\/p>\n
## Basic Structure<\/p>\n
“` —<\/p>\n ## Available Actions<\/p>\n * **disable** * **enable** * **global disable \/ global enable** * **status** * **list** * **allow** * **deny** * **allowlist check** * **allowlist clear** —<\/p>\n ## Target Types<\/p>\n Commands can target four different types:<\/p>\n * **item** \u2014 Any item in the game. Example: `minecraft:diamond` —<\/p>\n # Permission System<\/p>\n ## Restriction Levels<\/p>\n ### idrestrict<\/p>\n The player **can possess the item**, but **cannot use it**.<\/p>\n —<\/p>\n ### idcontrol<\/p>\n The player **cannot possess the item**. It **will be automatically removed from the inventory**.<\/p>\n —<\/p>\n ### idlock<\/p>\n The player **cannot possess nor use the item**.<\/p>\n —<\/p>\n # Player Whitelist<\/p>\n You can allow specific players to **bypass restrictions**.<\/p>\n Examples:<\/p>\n “` —<\/p>\n ## Whitelist Types<\/p>\n There are four types of permissions:<\/p>\n * **item** \u2014 Allows a specific item. —<\/p>\n ## Priority Rule<\/p>\n **Individual bans always override player whitelist permissions.**<\/p>\n If a specific item is banned with `disable item` or `global disable item`, **no player can use or possess it**, even if they have whitelist permission for the entire mod.<\/p>\n Example: —<\/p>\n # Restriction Types<\/p>\n ## Item Restriction<\/p>\n “` Players can still possess the sword but **cannot use it**.<\/p>\n —<\/p>\n ## Block Restriction<\/p>\n “` Players **cannot keep TNT in their inventory**.<\/p>\n —<\/p>\n ## Mod Restriction<\/p>\n “` Nobody can **use or possess items from that mod**.<\/p>\n —<\/p>\n ## Item-Block Restriction<\/p>\n Used for things that are **both items and blocks**.<\/p>\n “` Dirt will be restricted **as both an item and a world block**.<\/p>\n —<\/p>\n ## Allowing ALL Mods<\/p>\n Allows a player to ignore all mod restrictions.<\/p>\n “` —<\/p>\n ## Global Exceptions<\/p>\n When a mod is banned globally, you can **allow specific items\/blocks** even while keeping the mod banned:<\/p>\n “` This adds `aether:golden_amber` as a **global exception** \u2014 everyone can use it despite the mod being banned.<\/p>\n To remove the exception, ban the item directly:<\/p>\n “` —<\/p>\n # \/idrestrict<\/p>\n Blocks the **use** of items, blocks, and mods. Players **can still keep the item**, but **cannot interact with it**.<\/p>\n ## Behavior of disable \/ global disable \/ enable \/ global enable<\/p>\n | Command | Effect | ## Usage Examples<\/p>\n “` —<\/p>\n ## What idrestrict blocks<\/p>\n * Using items —<\/p>\n ## What idrestrict does NOT block<\/p>\n * Having the item in inventory —<\/p>\n # \/idcontrol<\/p>\n Blocks the **possession of items or mods**. Restricted items are **automatically removed from the inventory**.<\/p>\n ## Examples<\/p>\n “` —<\/p>\n ## What idcontrol blocks<\/p>\n * Having the item in inventory —<\/p>\n ## Special Behavior<\/p>\n When an item is restricted with idcontrol:<\/p>\n 1. The item is removed from the player’s inventory —<\/p>\n # \/idlock<\/p>\n Combines **idrestrict + idcontrol**. This is the **most restrictive system**. Players **cannot use or possess the item**.<\/p>\n ## Examples<\/p>\n “` —<\/p>\n ## What is restricted<\/p>\n * Using items —<\/p>\n # Whitelist Management<\/p>\n Check a player’s permissions:<\/p>\n “` Check permissions of all online players:<\/p>\n “` Remove all permissions:<\/p>\n “` —<\/p>\n # Practical Examples<\/p>\n ## Survival Server with Restrictions<\/p>\n “` \/idcontrol disable block minecraft:tnt Whitelist for VIPs:<\/p>\n “` —<\/p>\n ## Themed Server (No Magic)<\/p>\n “` —<\/p>\n ## Mod Maintenance<\/p>\n Temporarily disable a mod:<\/p>\n “` Re-enable later:<\/p>\n “` —<\/p>\n ## Restrict Mod but Allow Specific Items<\/p>\n “` Both items will be usable by everyone even though the rest of the mod is banned.<\/p>\n —<\/p>\n # Configuration Files<\/p>\n Data is saved inside the world folder under `serverconfig\/smp_utilities\/`:<\/p>\n **idrestrict**<\/p>\n * `id_restrict_config.dat` \u2014 banned items, blocks, mods **idcontrol**<\/p>\n * `id_control_config.dat` \u2014 disabled items and mods **idlock**<\/p>\n * `id_lock_config.dat` \u2014 locked items, blocks, mods **Waystone Suppression**<\/p>\n * `waystone_suppression_config.toml` \u2014 suppressed mod patterns, banned items and blocks<\/p>\n —<\/p>\n # Frequently Asked Questions<\/p>\n ## What is the difference between the commands?<\/p>\n **idrestrict** \u2014 The player can possess the item but cannot use it.<\/p>\n **idcontrol** \u2014 The player cannot possess the item.<\/p>\n **idlock** \u2014 The player cannot possess or use the item.<\/p>\n —<\/p>\n ## What is the difference between `disable` and `global disable`?<\/p>\n Both ban the item for all players who lack whitelist permission. The difference is in priority: `global disable` explicitly marks the item as individually banned, ensuring it overrides mod-level whitelist permissions. Use `global disable` when banning a specific item from a mod that is otherwise allowed.<\/p>\n —<\/p>\n ## What is the difference between `enable` and `global enable`?<\/p>\n `enable` removes the item from the ban list. If its mod is still banned, players without individual permission remain restricted.<\/p>\n `global enable` adds the item as a **global exception** \u2014 it becomes usable by *everyone*, regardless of whether the mod is banned.<\/p>\n —<\/p>\n ## Can I combine the commands?<\/p>\n Yes. All systems are independent. You can use idrestrict for light restrictions, idcontrol for medium restrictions, and idlock for severe restrictions.<\/p>\n —<\/p>\n ## Can a player whitelist bypass an individual item ban?<\/p>\n No. **Individual item\/block bans always take priority** over mod whitelist permissions. Even if a player has permission for a mod, a specific item banned with `disable item` cannot be used or held.<\/p>\n —<\/p>\n ## Does it work with Curios?<\/p>\n Yes. The mod integrates with the **Curios API**. Restricted items are detected in Curios slots, are automatically removed, and cannot be equipped.<\/p>\n —<\/p>\n # \/rename and \/lore<\/p>\n The mod includes commands to **customize items** using consumable tickets.<\/p>\n —<\/p>\n # \/rename<\/p>\n Renames the item the player is holding. Requires a **Rename Ticket**.<\/p>\n “` Examples:<\/p>\n “` Using this command consumes a **Rename Ticket**:<\/p>\n <\/p>\n —<\/p>\n # \/lore<\/p>\n Adds a description (lore) to the item the player is holding. Requires a **Lore Ticket**.<\/p>\n “` Examples:<\/p>\n “` Using this command consumes a **Lore Ticket**:<\/p>\n <\/p>\n —<\/p>\n # \/objective<\/p>\n Displays a persistent message on the **action bar** of players. Useful for showing objectives, rules, or events during gameplay.<\/p>\n Requires **permission level 4** (server operator).<\/p>\n —<\/p>\n ## Syntax<\/p>\n “` —<\/p>\n ## Examples<\/p>\n “` \/objective player Steve blue italic Find 5 diamonds. \/objective clear —<\/p>\n ## Behavior<\/p>\n * The objective is shown on the **action bar** (above the hotbar). —<\/p>\n # Available Colors and Formats<\/p>\n The following color and format options are available for `\/rename`, `\/lore`, and `\/objective`:<\/p>\n **Colors:**<\/p>\n `black`, `dark_blue`, `dark_green`, `dark_aqua`, `dark_red`, `dark_purple`, `gold`, `gray`, `dark_gray`, `blue`, `green`, `aqua`, `red`, `light_purple`, `yellow`, `white`<\/p>\n **Formats:**<\/p>\n `normal`, `bold`, `italic`, `underlined`, `strikethrough`<\/p>\n **Combinations:**<\/p>\n `bold italic`, `bold underlined`, `bold strikethrough`, `italic underlined`, `italic strikethrough`, `bold italic underlined`, `bold italic strikethrough`<\/p>\n —<\/p>\n # Potions & Effects<\/p>\n SMP Utilities adds two custom potion effects.<\/p>\n —<\/p>\n ## Waystone Suppression<\/p>\n **Effect color:** Purple (`#ae37d5`) While active, the player **cannot use or interact** with items, blocks, or mods listed in the `waystone_suppression_config.toml`.<\/p>\n Designed to block teleportation mods (such as Waystones) during specific game moments or events.<\/p>\n Potions available:<\/p>\n * Potion of Waystone Suppression —<\/p>\n ## Imbalance<\/p>\n **Effect color:** Dark magenta (`#3b4c5b` inverted) Reduces the player’s **knockback resistance** by `-(amplifier + 1)` per tick. At amplifier 0 (level I), removes 1 point of knockback resistance. At higher levels the reduction scales accordingly.<\/p>\n Designed to make players **much more vulnerable to knockback**, for use with items like the Chapolin Colorado’s Sledgehammer.<\/p>\n Potions available:<\/p>\n * Potion of Imbalance —<\/p>\n # Waystone Suppression<\/p>\n The Waystone Suppression system restricts teleportation and movement items\/blocks for players under the **Waystone Suppression** effect.<\/p>\n —<\/p>\n ## Configuration File<\/p>\n Located at: `serverconfig\/smp_utilities\/waystone_suppression_config.toml`<\/p>\n “`toml [banned_items] [banned_blocks] —<\/p>\n ## Pattern Format<\/p>\n * `modid:*` \u2014 bans **all items and blocks** from that mod —<\/p>\n ## What it blocks (while effect is active)<\/p>\n * Placing or breaking blocks from banned mods —<\/p>\n ## Default Suppressed Content<\/p>\n By default, the following mods are suppressed:<\/p>\n * `waystones:*` \u2014 all Waystones mod content And these individual items are banned:<\/p>\n * `minecraft:ender_pearl` —<\/p>\n **SMP Utilities \u2014 Keep your server organized.**<\/p>\n","protected":false},"excerpt":{"rendered":" This mod was designed and planned to improve the experience of creating SMPs servers in Minecraft. Its main function is to ban and control items, blocks, and mods, with the ability to unban those same items, blocks, or mods for specific players.<\/p>\n","protected":false},"featured_media":144353,"template":"","meta":{"_minecraft_slug":"smp-utilities","_minecraft_project_id":"b7wSFPg8","_minecraft_author":"forgotten.and.stuff","_minecraft_license":"CC0-1.0","_minecraft_downloads":203,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smp-utilities.zip","_minecraft_size_bytes":25257818,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-16T20:00:38.488149Z","_minecraft_date_created":"2026-03-08T04:47:57.265499Z","_minecraft_date_modified":"2026-05-10T05:18:26.002553Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smp-utilities","_minecraft_icon_attachment_id":144353,"_minecraft_imported_at":"2026-06-08T15:00:47+00:00","_minecraft_import_hash":"7fd9c326de9e5372af786916aad27b3d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,89,126,867,92],"mod_loader":[106],"minecraft_version":[36],"class_list":["post-144352","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-social","mod_category-utility","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n
\n\/command
\n“`<\/p>\n
\n Bans an item, block, or mod for all players, except those with a whitelist permission for that item or its mod.<\/p>\n
\n Removes an item, block, or mod from the ban list. If the mod of origin is still banned, players without individual permission remain restricted.<\/p>\n
\n `global disable` explicitly marks an item as individually banned, overriding mod-level whitelist permissions. `global enable` adds the item as a global exception \u2014 usable by *all* players even if its mod is banned.<\/p>\n
\n Checks the status of an item, block, mod, or player.<\/p>\n
\n Shows all restricted items, blocks, or mods.<\/p>\n
\n Adds a player to the whitelist for an item or mod. Whitelisted players can use, hold, equip, and place the item even if it is globally banned or its mod is banned.<\/p>\n
\n Removes a player from the whitelist.<\/p>\n
\n Checks a player’s permissions.<\/p>\n
\n Removes all permissions from a player.<\/p>\n
\n* **block** \u2014 Blocks in the game. Example: `minecraft:stone`
\n* **mod** \u2014 An entire mod. Example: `thermal`
\n* **item-block** \u2014 Something that is **both an item and a block**. Example: `minecraft:dirt`<\/p>\n
\n\/idrestrict allow player item minecraft:diamond
\n\/idcontrol allow player mod thermal
\n\/idlock allow player all
\n“`<\/p>\n
\n* **block** \u2014 Allows a specific block.
\n* **mod** \u2014 Allows all items from a mod.
\n* **all** \u2014 Allows **all mods** (available in all three systems).<\/p>\n
\n– Mod `aether` is banned
\n– Player `ddogo` is whitelisted for mod `aether`
\n– Admin bans `aether:some_item` individually
\n– **Result:** `ddogo` cannot use `aether:some_item` despite the mod whitelist<\/p>\n
\n\/idrestrict disable item minecraft:diamond_sword
\n“`<\/p>\n
\n\/idcontrol disable block minecraft:tnt
\n“`<\/p>\n
\n\/idlock disable mod thermal
\n“`<\/p>\n
\n\/idlock disable item-block minecraft:dirt
\n“`<\/p>\n
\n\/idcontrol allow player all
\n\/idlock allow player all
\n“`<\/p>\n
\n\/idlock global enable item aether:golden_amber
\n“`<\/p>\n
\n\/idlock global disable item aether:golden_amber
\n“`<\/p>\n
\n|—|—|
\n| `\/idrestrict disable item
\n| `\/idrestrict global disable item
\n| `\/idrestrict enable item
\n| `\/idrestrict global enable item
\n\/idrestrict disable item minecraft:elytra
\n\/idrestrict disable block minecraft:enchanting_table
\n\/idrestrict disable mod twilightforest
\n\/idrestrict disable item-block minecraft:dirt
\n\/idrestrict global enable item twilightforest:some_item
\n\/idrestrict status item minecraft:diamond
\n\/idrestrict status player PlayerName
\n\/idrestrict list
\n“`<\/p>\n
\n* Eating or drinking
\n* Placing blocks
\n* Breaking blocks
\n* Interacting with blocks
\n* Attacking entities with the item
\n* Equipping armor
\n* Equipping Curios accessories<\/p>\n
\n* Picking the item up from the ground
\n* Crafting with the item
\n* Trading the item in interfaces<\/p>\n
\n\/idcontrol disable item minecraft:diamond
\n\/idcontrol disable mod create
\n\/idcontrol allow player all
\n\/idcontrol deny player all
\n“`<\/p>\n
\n* Picking the item up from the ground
\n* Equipping the item
\n* Holding the item in any slot<\/p>\n
\n2. It is dropped on the ground with the tag `smp_controlled_item`
\n3. Items with this tag cannot be picked up again
\n4. The check runs **every game tick**<\/p>\n
\n\/idlock disable item minecraft:diamond_sword
\n\/idlock disable block minecraft:crafting_table
\n\/idlock disable mod mekanism
\n\/idlock allow player all
\n\/idlock global enable item mekanism:some_item
\n\/idlock status item minecraft:diamond
\n\/idlock list
\n“`<\/p>\n
\n* Possessing items
\n* Picking items from the ground
\n* Equipping items
\n* Placing blocks
\n* Breaking blocks
\n* Interacting with related objects<\/p>\n
\n\/idrestrict allowlist check PlayerName
\n\/idcontrol allowlist check PlayerName
\n\/idlock allowlist check PlayerName
\n“`<\/p>\n
\n\/idrestrict allowlist check
\n\/idcontrol allowlist check
\n\/idlock allowlist check
\n“`<\/p>\n
\n\/idrestrict allowlist clear PlayerName
\n\/idcontrol allowlist clear PlayerName
\n\/idlock allowlist clear PlayerName
\n“`<\/p>\n
\n\/idrestrict disable item minecraft:elytra
\n\/idrestrict disable item minecraft:totem_of_undying<\/p>\n
\n\/idcontrol disable block minecraft:bedrock
\n“`<\/p>\n
\n\/idrestrict allow VIP_Player item minecraft:elytra
\n“`<\/p>\n
\n\/idlock disable mod ars_nouveau
\n\/idlock disable mod mana-and-artifice
\n“`<\/p>\n
\n\/idcontrol disable mod problem_mod
\n“`<\/p>\n
\n\/idcontrol enable mod problem_mod
\n“`<\/p>\n
\n\/idlock global disable mod aether
\n\/idlock global enable item aether:golden_amber
\n\/idlock global enable item aether:zanite_gemstone
\n“`<\/p>\n
\n* `id_restrict_whitelist.dat` \u2014 per-player whitelists
\n* `id_restrict_exceptions.dat` \u2014 global exceptions<\/p>\n
\n* `id_control_whitelist.dat` \u2014 per-player whitelists
\n* `id_control_exceptions.dat` \u2014 global exceptions<\/p>\n
\n* `id_lock_whitelist.dat` \u2014 per-player whitelists
\n* `id_lock_exceptions.dat` \u2014 global exceptions<\/p>\n
\n\/rename
\n\/rename
\n\/rename
\n\/rename
\n“`<\/p>\n
\n\/rename red normal Fire Sword
\n\/rename gold bold Royal Shield
\n\/rename blue italic Magic Potion
\n\/rename dark_red strikethrough Cursed Item
\n\/rename green bold italic Lucky Amulet
\n“`<\/p>\n
\n\/lore
\n\/lore
\n\/lore
\n“`<\/p>\n
\n\/lore dark_gray normal A very rare item.
\n\/lore gold bold Forged by ancient kings.
\n\/lore blue italic Said to bring luck.
\n\/lore dark_red strikethrough Forbidden item.
\n“`<\/p>\n
\n\/objective global
\n\/objective player
\n\/objective clear
\n\/objective clear
\n\/objective global gold bold Defeat the Ender Dragon!
\n\/objective global red normal Do not use Waystones today.<\/p>\n
\n\/objective player Alex green bold italic Complete your quest!<\/p>\n
\n\/objective clear Steve
\n“`<\/p>\n
\n* It is **sent every tick** to ensure it stays visible and doesn’t fade.
\n* When a player **joins the server**, their stored objective is automatically shown.
\n* Player-specific objectives take **priority** over the global objective.
\n* Clearing the global objective does not remove player-specific objectives.<\/p>\n
\n**Category:** Beneficial<\/p>\n
\n* Splash Potion of Waystone Suppression
\n* Lingering Potion of Waystone Suppression
\n* Arrow of Waystone Suppression<\/p>\n
\n**Category:** Beneficial (but mechanically negative)<\/p>\n
\n* Splash Potion of Imbalance
\n* Lingering Potion of Imbalance
\n* Arrow of Imbalance<\/p>\n
\n[blacklist]
\n# disables teleport mods (blocks breaking, use of blocks and items, and\/or equipping armor)
\nWaystoneSuppression = [“waystones:*”, “balm:*”, “endermanoverhaul:*”]<\/p>\n
\n# individual item IDs to ban (cannot equip in armor or curios slots; drops if equipped)
\nBannedItems = [“minecraft:ender_pearl”, “minecraft:chorus_fruit”, “all_in_one:enchiridion”, “relics:chorus_inhibitor”, “relics:enders_hand”, “relics:spatial_sign”]<\/p>\n
\n# individual block IDs to ban (cannot place, break, or interact with) remove the ‘#’ to enable it; minecraft:tnt is just an example, you can remove it
\n# BannedBlocks = [“minecraft:tnt”]
\n“`<\/p>\n
\n* `modid:item_id` \u2014 bans a **specific item or block**<\/p>\n
\n* Using banned items
\n* Equipping banned items as armor or in Curios slots (items are dropped)
\n* Interacting with banned blocks
\n* Attacking with banned items<\/p>\n
\n* `balm:*` \u2014 all Balm mod content (Waystones dependency)
\n* `endermanoverhaul:*` \u2014 all Enderman Overhaul mod content<\/p>\n
\n* `minecraft:chorus_fruit`
\n* `all_in_one:enchiridion`
\n* `relics:chorus_inhibitor`
\n* `relics:enders_hand`
\n* `relics:spatial_sign`<\/p>\n