yRodrigus: SMP Utilities

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.