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

Absurd Damage Sword

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

Ban Sword

Ban Sword

A sword that bans players when used against them.

Introduction
Main Commands
Permission System
Restriction Types
Detailed Commands (idrestrict, idcontrol, idlock)
Whitelist Management
Practical Examples
Configuration Files
Frequently Asked Questions
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:

The item is removed from the player's inventory
It is dropped on the ground with the tag smp_disabled_item
Items with this tag cannot be picked up again
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:

Rename Ticket

/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:

Lore Ticket

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.

SMP Utilities – Command Wiki

Overview

Admin Items

Table of Contents

Introduction

/idrestrict

/idcontrol

/idlock

Main Commands

Basic Structure

Available Actions

Target Types

Permission System

Restriction Levels

idrestrict

idcontrol

idlock

Player Whitelist

Whitelist Types

Restriction Types

Item Restriction

Block Restriction

Mod Restriction

Item-Block Restriction

Allowing ALL Mods

/idrestrict

Usage Examples

What idrestrict blocks

/idcontrol

Examples

What idcontrol blocks

Special Behavior

/idlock

Examples

What is restricted

Whitelist Management

Practical Examples

Survival Server with Restrictions

Themed Server (No Magic)

Mod Maintenance

Configuration Files

Frequently Asked Questions

What is the difference between the commands?

Can I combine the commands?

How do I make a backup?

Does it work with Curios?

/rename and /lore

/rename

Examples

/lore

Examples

Available Colors

`/idrestrict`

`/idcontrol`

`/idlock`

yRodrigus: SMP Utilities