🛠️ Shurui's Utilities 🛠️

The all-in-one server administration suite for 1.20.1

Permissions, land claims, economy, protection, ranks, and a huge pile of utility commands, all managed from in-game menus.
No datapacks. No JSON wrangling. No restarts.

🟢 Official Community & Support Server

This mod's official, endorsed Discord is the best place for support, updates, sneak peeks, and sharing your creations:

👉 discord.gg/HaXBGEPXyE

Come say hi. Bug reports, feature requests, and help are all welcome.

Shurui's Utilities is a complete server management toolkit that gives owners everything they need to run a serious multiplayer server from one mod: a full permissions system with groups and per-command control, land claims and region protection, a working economy, custom ranks with image badges, factions-style guilds, multi-world management, teleports, homes and warps, crates, holograms, and dozens of quality-of-life commands. Almost everything is configured live, in-game through clean editor GUIs and saved straight into your world, no config files to hand-edit, no restarts.

✨ Features

🔐 Full Permissions System

Groups, players, and per-command control, all editable from an in-game permission editor. Grant or deny any node with a click, organise command.* nodes into per-module tabs with hover-tooltip descriptions, and manage groups (create, rename, delete, assign) without touching a file. New players drop into a default player group automatically, and command trees sync the moment they log in. Commands are deny-by-default: operators keep everything, and everyone else only sees what you grant them.

🛡️ Region Protection & Land Claims

Protect your world with WorldGuard-style regions and player land claims. Draw claim areas, guard against griefing, and toggle a rich set of region flags, PvP, block use, pistons, chat, entry/exit and more, right down to blocking DragonMineZ combat inside safe zones. Claims can even be drawn and viewed on Xaero's map with a live coloured overlay.

💰 Zeni Economy & Trading

A built-in economy with the /money and /pay commands, plus safe player-to-player trading. Wire balances into claim limits, rewards, and shops, or gate them behind Shurui's Key for premium servers.

🏅 Image Rank Badges

Give every rank a custom bitmap badge that shows in chat, the tab list, and above players' heads. Ranks ship with both crisp static badges and animated ones that cycle frame-by-frame on nameplates and the tab list, and you can build or tweak the whole set from an in-game rank editor.

⚔️ Guilds

Factions-style guilds: create a guild, invite members, claim territory, and fight over it, with claim limits that can scale to power on DragonMineZ servers. Managed through DMZ-styled menus and shown on Xaero's map.

🌍 Multi-World Management

Create, import, and manage extra dimensions on the fly with /mw. Spin up custom worlds (including void world-gen for skyblock-style maps), name them whatever you like, and warp between them, no datapacks or restarts required.

🧭 Teleports, Homes & Warps

A complete teleport suite: homes, server warps, teleport requests, back, and admin teleports. The /tp command follows Minecraft's own /teleport grammar so it works exactly as your players expect, and admin teleports bypass "not loaded" and "obstructed" errors so you always land where you aim.

⛓️ Jail System

Set a jail zone with /setjail, then jail and unjail players with a timed, containment-enforced sentence. Jailed players are kept inside the zone and released automatically when their time runs out, and jail state survives logouts and restarts.

🎁 Crates & Holograms

Place physical crate blocks with matching keys and a spinning reward GUI, and drop floating holograms (text-display) anywhere in the world for signs, rules, shop labels, or decoration.

🧍 NPC Spawn Regions

Paint spawn zones onto the map (right-drag in Xaero's World Map) and fill them with fully-configured NPCs — custom model, stats, a DMZ fighter moveset + AI tier so they teleport, dodge and block like DMZ saga fighters, and searchable-dropdown item drops — that hand out teleport and balance rewards on kill. A region can span any number of map selections: each new drag can grow an existing region or start a new one, selections are managed (and removed) individually, and the whole shape acts as one zone. Give every region a player-facing title, description and colourable difficulty: entering shows an on-screen title, and a movable, DMZ-styled region HUD shows the details while inside. NPCs spawn around each player out to the server's render distance, so huge regions stay lively with zero tick cost, item drops can be added straight from your hand with full NBT (enchants, names, modded data), kills pay exactly what you configure — TP, balance, drops, and console command rewards (%player% placeholder), with the entity's own loot-table drops suppressed unless you re-enable them — and every region gets its own map overlay colour. A npcregion-spawns protection flag keeps ambient spawns out of any protected area (towns, shops) inside a region. Region creation and management sit behind their own permission nodes, and the map overlay (coloured fills + hover info) is only visible to region managers. Great for grinding areas, event arenas, and custom dungeons.

📦 Randomized Airdrops & Crate Bosses

On a random, configurable timer a loot chest drops onto a random surface spot inside one of your NPC regions — announced to the whole server and marked with a chest icon on everyone's HUD compass (with Shurui's DMZ Utilities installed). Whoever gets there first takes the loot, and the chest despawns once emptied. Get close and the region's crate boss spawns to guard it — the region's apex NPC at double stats by default, fully customizable per region. Loot supports full-NBT items copied straight from your hand, every region can define its own crate loot that overrides the global list, and everything is configured live with /airdrop edit and the region editor's Crates screen. Requires Shurui's Key.

🚫 Ban-Item & Command Gating

Block problem items from being used, held, or crafted, and gate specific commands per group, so your rules are enforced automatically instead of by hand.

🗳️ Server Voting & Tab-List Banner

Reward players for voting with /vote and custom reward commands, and brand your server with a custom tab-list banner and rank logos at the top of the player list.

🧰 Dozens of Utility Commands

On top of the big systems, Shurui's Utilities bundles the everyday admin commands you'd otherwise install five mods for, world border control, chat formatting, ban/unban and pardon, server settings, block updates, and much more, all under one roof.

🛠️ Getting Started

Drop the mod on your server (and give it to clients too, so rank badges, GUIs, and claim overlays display).
Open the edit hub with /suinfo edit to reach the permission, rank, guild, and NPC-region editors.
Set up your groups and permissions in the permission editor, then grant commands to the groups that should have them.
Draw your first land claim or region, and toggle the flags you want enforced.
Add ranks with badges, a tab-list banner, crates, holograms, and jail/NPC zones as you go.

All editing and management is operator-gated and server-validated, so these tools are safe to hand to trusted staff. Players only ever get the commands you grant them.

📦 Requirements

Dependency	Version	Required?
Minecraft	1.20.1 (Forge)	✅ Yes
Xaero's Minimap & World Map	Latest for 1.20.1	⭐ Optional — claim overlay & drawing NPC regions
Shurui's Key	Latest	⭐ Optional — unlocks the key-gated premium features

💬 Join the Community

Support, updates, and everything else happen on the official Discord, the endorsed home for this mod:

🔗 discord.gg/HaXBGEPXyE

☕ Support Solo Development

Shurui's Utilities is built and maintained by one developer. It's completely free and always will be, but these tools take a lot of time and effort to build and keep updated. If you'd like to help fund continued development, you can chip in below, entirely optional and genuinely appreciated.

💛 Patreon · 💙 PayPal

No pressure at all, using and sharing the mod already helps a ton.

Shurui's Server Utilities