SMP Utilities – Command Wiki

Overview

SMP Utilities is a mod designed to enhance the experience of creating and managing SMP (Survival Multiplayer) servers in Minecraft.

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.

Admin Items

Absurd Damage Sword

A sword with extremely high damage. It essentially executes /kill on any mob it hits.

Ban Sword

A sword that bans players when used against them.

Table of Contents

1. Introduction
2. Main Commands
3. Permission System
4. Restriction Types
5. Detailed Commands (idrestrict, idcontrol, idlock)
6. Whitelist Management
7. Practical Examples
8. Configuration Files
9. Frequently Asked Questions
10. Item Customization (/lore and /rename)

Introduction

SMP Utilities provides three main control systems for administrators:

/idrestrict

Blocks the use of items, blocks, or mods.

Players can still keep the item in their inventory, but cannot use it.

/idcontrol

Blocks the possession of items or mods.

If a player has the item in their inventory, it will be automatically removed.

/idlock

Combines both systems.

Players cannot possess or use the item.

All commands require operator (OP) permission or permission level 2.

Main Commands

Basic Structure

/command <action> <type> <id>

Available Actions

• disable Disables or blocks an item, block, or mod.

• enable Re-enables or unblocks an item, block, or mod.

• status Checks the status of an item, block, mod, or player.

• list Shows all restricted items, blocks, or mods.

• allow Adds a player to the whitelist for an item or mod.

• deny Removes a player from the whitelist.

• allowlist check Checks a player's permissions.

• allowlist clear Removes all permissions from a player.

Target Types

Commands can target four different types:

• item Any item in the game Example: minecraft:diamond

• block Blocks in the game Example: minecraft:stone

• mod An entire mod Example: thermal

• item-block Something that is both an item and a block Example: minecraft:dirt

Permission System

Restriction Levels

idrestrict

The player can possess the item, but cannot use it.

idcontrol

The player cannot possess the item. It will be automatically removed from the inventory.

idlock

The player cannot possess nor use the item.

Player Whitelist

You can allow specific players to bypass restrictions.

Examples:

/idrestrict allow player item minecraft:diamond
/idcontrol allow player mod thermal
/idlock allow player all

Whitelist Types

There are four types of permissions:

• item Allows a specific item.

• block Allows a specific block.

• mod Allows all items from a mod.

• all Allows all mods (available only in idcontrol and idlock).

Restriction Types

Item Restriction

Restricts a specific item.

Example:

/idrestrict disable item minecraft:diamond_sword

Players can still possess the sword but cannot use it.

Block Restriction

Restricts a specific block.

Example:

/idcontrol disable block minecraft:tnt

Players cannot keep TNT in their inventory.

Mod Restriction

Restricts all items from a mod.

Example:

/idlock disable mod thermal

Nobody can use or possess items from that mod.

Item-Block Restriction

Used for things that are both items and blocks.

Example:

/idlock disable item-block minecraft:dirt

Dirt will be restricted as both an item and a world block.

Allowing ALL Mods

Allows a player to ignore all mod restrictions.

/idcontrol allow player all
/idlock allow player all

/idrestrict

Blocks the use of items, blocks, and mods.

Players can still keep the item, but cannot interact with it.

Usage Examples

Restrict item:

/idrestrict disable item minecraft:elytra

Restrict block:

/idrestrict disable block minecraft:enchanting_table

Restrict mod:

/idrestrict disable mod twilightforest

Restrict item-block:

/idrestrict disable item-block minecraft:dirt

Check status:

/idrestrict status item minecraft:diamond
/idrestrict status player PlayerName
/idrestrict list

What idrestrict blocks

Blocked actions:

• Using items
• Eating or drinking
• Placing blocks
• Breaking blocks
• Interacting with blocks
• Attacking entities with the item
• Equipping armor
• Equipping Curios accessories

Actions that are NOT blocked:

• Having the item in inventory
• Picking the item up from the ground
• Crafting with the item
• Trading the item in interfaces

/idcontrol

Blocks the possession of items or mods.

Restricted items are automatically removed from the inventory.

Examples

/idcontrol disable item minecraft:diamond
/idcontrol disable mod create

Allow all mods for a player:

/idcontrol allow player all

Remove that permission:

/idcontrol deny player all

What idcontrol blocks

• Having the item in inventory
• Picking the item up from the ground
• Equipping the item
• Holding the item in any slot

Special Behavior

When an item is restricted with idcontrol:

1. The item is removed from the player's inventory
2. It is dropped on the ground with the tag smp_disabled_item
3. Items with this tag cannot be picked up again
4. The check runs every game tick

/idlock

Combines idrestrict + idcontrol.

This is the most restrictive system.

Players cannot use or possess the item.

Examples

/idlock disable item minecraft:diamond_sword
/idlock disable block minecraft:crafting_table
/idlock disable mod mekanism

Whitelist for all mods:

/idlock allow player all

Checks:

/idlock status item minecraft:diamond
/idlock list

What is restricted

Everything:

• Using items
• Possessing items
• Picking items from the ground
• Equipping items
• Placing blocks
• Breaking blocks
• Interacting with related objects

Whitelist Management

Check a player's permissions:

/idrestrict allowlist check PlayerName
/idcontrol allowlist check PlayerName
/idlock allowlist check PlayerName

Check permissions of all online players:

/idrestrict allowlist check
/idcontrol allowlist check
/idlock allowlist check

Remove all permissions:

/idrestrict allowlist clear PlayerName
/idcontrol allowlist clear PlayerName
/idlock allowlist clear PlayerName

Practical Examples

Survival Server with Restrictions

/idrestrict disable item minecraft:elytra
/idrestrict disable item minecraft:totem_of_undying

/idcontrol disable block minecraft:tnt
/idcontrol disable block minecraft:bedrock

Whitelist for VIPs:

/idrestrict allow VIP_Player item minecraft:elytra

Themed Server (No Magic)

/idlock disable mod ars_nouveau
/idlock disable mod mana-and-artifice

Mod Maintenance

Temporarily disable a mod:

/idcontrol disable mod problem_mod

Re-enable later:

/idcontrol enable mod problem_mod

Configuration Files

Data is saved inside the world folder:

SMP Utilities/

Main files:

idrestrict

• id_restrict.dat
• id_restrict_whitelist.dat

idcontrol

• id_control.dat
• id_control_whitelist.dat

idlock

• id_lock.dat
• id_lock_whitelist.dat

Frequently Asked Questions

What is the difference between the commands?

idrestrict The player can possess the item but cannot use it.

idcontrol The player cannot possess the item.

idlock The player cannot possess or use the item.

Can I combine the commands?

Yes.

All systems are independent.

You can use:

• idrestrict for light restrictions
• idcontrol for medium restrictions
• idlock for severe restrictions

How do I make a backup?

Copy the files from:

world/SMP Utilities/

Does it work with Curios?

Yes.

The mod integrates with the Curios API.

Restricted items:

• are detected in Curios slots
• are automatically removed
• cannot be equipped

/rename and /lore

The mod also includes commands to customize items.

/rename

Renames the item the player is holding.

Basic syntax:

/rename <color> normal <name>
/rename <color> <format> <name>
/rename <color> <format1> <format2> <name>
/rename <color> <format1> <format2> <format3> <name>

Examples

/rename red normal Fire Sword
/rename gold bold Royal Shield
/rename blue italic Magic Potion
/rename dark_red strikethrough Cursed Item
/rename green bold italic Lucky Amulet

Using this command consumes a Rename Ticket, which is required to rename an item:

/lore

Adds a description (lore) to the item.

Syntax:

/lore <color> normal <text>
/lore <color> <format> <text>
/lore <color> <format1> <format2> <text>

Examples

/lore dark_gray normal A very rare item.
/lore gold bold Forged by ancient kings.
/lore blue italic Said to bring luck.
/lore dark_red strikethrough Forbidden item.

Using this command consumes a Lore Ticket, which is required to add lore to an item:

Available Colors

The available colors include:

• black
• dark_blue
• dark_green
• dark_aqua
• dark_red
• dark_purple
• gold
• gray
• dark_gray
• blue
• green
• aqua
• red
• light_purple
• yellow
• white

SMP Utilities — Keep your server organized.