SMP-Utils

SMP-Utils is a comprehensive utility plugin designed to give server administrators powerful tools for managing, customizing, and controlling an SMP experience.

The plugin combines team management, randomized nicknames and kits, randomized item durability, death-kick mechanics, player immortality, admin visibility controls, chat management, distance restrictions, anti-mod visual protection, broadcasting, and more into one easy-to-use system.

Whether you're running a competitive SMP, team-based event, challenge server, or custom survival experience, SMP-Utils provides the tools needed to quickly configure and manage your server.

Disclaimer

• Random Kit requires PlayerKits 2.
• Some features are specifically designed for non-OP players.

Features

• 🛠️ Enable or disable SMP-Utils functionality
• ⚙️ Player settings GUI
• 🎲 Randomized player nicknames
• 🎒 Randomized kits with optional percentage-based weighting
• 🔧 Randomized durability for tools, weapons, shields, and armor
• ☠️ Death-kick system
• 🛡️ Death-kick bypass management
• ♾️ Player immortality system
• 👁️ Admin visibility controls
• 💬 Toggle chat for non-OP players
• 📢 Custom server-wide broadcasts
• 📏 5-chunk render and simulation distance limit for non-OP players
• 🪨 Stone visual mode for non-OP players as an anti-mod protection feature
• 👥 Full team management system
• 🤝 Team alliances
• ❄️ Freeze and unfreeze entire teams
• ✨ Team glow colors
• 📍 Team teleportation
• 🎁 Give items to entire teams
• 🎲 Randomly assign players to teams
• 📋 Team information and management tools

Commands

Main Command

/utilities <subcommand>

Available subcommands:

• on — Enable SMP-Utils.
• off — Disable SMP-Utils.
• settings — Open the SMP-Utils settings GUI. (Player only)
• help — Display all available SMP-Utils commands.
• randomnickall — Give every non-OP player a random nickname.
• randomkitall <kit|percentage%kit,...> [teamname] — Give randomized kits to players.
• deathkick <on|off> — Enable or disable the death-kick system.
• deathkickjoin <clear> — Manage death-kick join restrictions.
• immortality <add|remove> <player> — Add or remove immortality from a player.
• markadmin <player> — Mark a player as an administrator.
• adminvisible <player> — Make a player visible to admin-only systems.
• chattoggle — Toggle chat for non-OP players.
• broadcast <message> — Broadcast a message to players who are not admin-visible.
• team <subcommand> — Manage teams.
• deathkickbypass <add|remove|list> [player] — Manage the death-kick bypass list.
• randomdurability — Randomize durability for non-OP players.
• distancelimit — Toggle the 5-chunk render/simulation distance limit for non-OP players.
• stonevisual — Toggle the stone visual system for non-OP players.

Weighted Random Kits

randomkitall supports percentage-based kit selection, allowing you to control how frequently each kit is given.

Example:

/utilities randomkitall 50%iron,50%diamond

Players will receive a randomized kit based on the specified probabilities.

You can also target a specific team:

/utilities randomkitall 50%iron,50%diamond Red

This allows you to give randomized kits only to members of the specified team.

Random Durability

The randomdurability feature randomizes the durability of tools, shields, and armor for non-OP players.

This can be used to make equipment less predictable and add additional difficulty or randomness to an SMP.

/utilities randomdurability

Distance Limit

The distancelimit feature applies a 5-chunk render and simulation distance to non-OP players.

This can be used to limit how far non-OP players can see and simulate the world.

/utilities distancelimit

Stone Visual

The stonevisual feature provides a stone visual mode for non-OP players, designed as an anti-mod protection feature.

/utilities stonevisual

Team Management

/utilities team <subcommand>

SMP-Utils includes a complete team management system for creating, organizing, and controlling teams.

Team subcommands:

• create <teamname> — Create a new team.
• addrandom <percentage> <teamname> — Add a random percentage of players to a team.
• list — Display all existing teams.
• info <teamname> — Display information about a team.
• teleport <teamname> — Teleport to a team's location/members.
• freeze <teamname> — Freeze all members of a team.
• unfreeze <teamname> — Unfreeze all members of a team.
• delete <teamname> — Delete a team.
• remove <player> — Remove a player from their current team.
• give <teamname> — Give items to all members of a team.
• alliance <add|remove> <teamname> — Add or remove team alliances.
• glow <teamname> <color> — Set the glow color for a team.

Team Glow Colors

Supported colors include:

red, green, blue, yellow, aqua, fuchsia, gray, lime, maroon, navy, olive, orange, purple, silver, teal, white, black

Example:

/utilities team glow Red red

Permissions

Permission	Description	Default
utilities.command	Allows access to the /utilities command.	OP
smputils.deathkick	Allows the player to toggle the death-kick system.	—
smputils.deathkickjoin	Allows management of death-kick join restrictions.	—
smputils.immortality	Allows management of player immortality.	—

Installation Guide

Requirements

• A Minecraft server running Paper or a compatible server implementation.
• A Minecraft version supported by the SMP-Utils build you are using.
• The appropriate Java version for your Minecraft version.
• PlayerKits 2 if using the random kit functionality.

Installation

1. Download the SMP-Utils .jar file.
2. Stop your Minecraft server.
3. Open your server's main directory.
4. Open the plugins folder.
5. Place SMP-Utils.jar inside the plugins folder.
6. Start or restart your server.
7. Check the server console to make sure SMP-Utils loaded successfully.
8. Join the server and run:

/utilities help

If the command works, SMP-Utils has been installed successfully.