ServerManagement+

The all-in-one server management solution for Minecraft

Supported: Minecraft 1.20.1 (Forge 47.4.0+) | Minecraft 1.21.1 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric API 0.116.1+)

ServerManagement+ gives you a complete suite of tools to run your server — a full economy with bank accounts, a player marketplace, a casino, daily tasks, world management, and a sleek admin dashboard — all in one mod.

Release Status & Roadmap

Latest Release — Minecraft 1.21.1 v2.1.0

The 1.21.1 build has just received a major update: MultiLoader migration (Forge + NeoForge + Fabric), a full GUI polish pass across every screen, uniform pose-matrix scaling that fixes layout breakage at GUI Scales 2–4 / Auto, a complete Player Manager rework, and a long list of critical fixes for Chat Isolation, Tab Isolation, /spectate, /teleportlobby, and the OP-2 console. See the v2.1.0 changelog for the full list.

Coming Soon — Minecraft 1.20.1 v2.1.0

A v2.1.0 update for Minecraft 1.20.1 is in active development and will follow shortly. It will bring the 1.20.1 branch back in line with the 1.21.1 baseline (security audit fixes, thread-safety fixes, performance fixes, and console polish).

Next — Minecraft 1.21.4 Port

A dedicated port for Minecraft 1.21.4 will follow once the 1.20.1 v2.1.0 update has been released. It will ship for NeoForge, and Fabric on day one alongside the 1.21.1 line.

⚠ Known Issues on Minecraft 1.20.1 (v2.0.0-b01)

The following bugs are fixed in the 1.21.1 v2.1.0 release but are not yet patched in the current 1.20.1 build. They are essential fixes and will be backported as part of the upcoming 1.20.1 v2.1.0 update:

Chat Isolation toggle is non-functional — chat is always global regardless of the GUI setting
Tab Isolation toggle is non-functional — visible-player computation runs but no packets are ever sent
/teleportlobby teleports to the wrong location — sends the player to the dimension's world spawn instead of the lobby coordinates set with /setlobby
/smconfig opens the outdated screen — shows the legacy 3-toggle config screen instead of the full 6-toggle screen with descriptions
/spectate collides with vanilla — vanilla's /spectate requires the executor to already be in spectator mode; the mod's version is shadowed
Spectate mode reveals the spectator — player model stays visible to others, hands/HUD remain rendered, body collides with the target, and the tab list shows the spectator in italic gray
Spectate camera breaks on cross-dimension travel — camera detaches and gets stuck at spawn after the target portals
Spectate fire/damage invincibility can persist after server restart — if the server crashes mid-spectate, the player loads back invulnerable
Tab list ghost entries after dimension travel — returning players are invisible in others' tab lists / player models fail to render until reconnect
Privilege escalation in OP-2 console command execution — commands run with permission level 4 (console) instead of the player's actual level
Missing permission check on dimension teleport packet — any connected client can teleport to any dimension by sending the packet directly
No rate limiting on OTA file transfer — a malicious client can repeatedly request the full mod JAR
Several network packets accept oversized payloads — MOTD, daily-task templates, free-reward settings, MineBay listings, and OTA chunks decode without strict caps
Thread-safety issues — DailyTasksManager uses a non-concurrent HashMap shared across tick + network threads; GamblingManager/PlayerManagerSingleton getInstance() is unsynchronized; TransactionManager grows unbounded in memory
Performance — ItemMergeHandler runs an uncapped O(n²) loop over every dropped item in the world

If any of these affect your 1.20.1 server in the meantime, the recommended workaround is to disable the affected feature via /smconfig until v2.1.0 ships.

Features

Admin Dashboard

A modern dark-themed command center accessible with /sm. Six feature cards let you jump straight into World Manager, Player Manager, Console, Global Settings, Economy Management, or Mod Settings. Every screen has consistent navigation with back/close buttons and a polished header bar.

Live Server Console — Run server commands directly from the GUI. Output is color-coded by log level (red for errors, yellow for warnings) and scrollable. Requires OP level 2.

Global Settings — Toggle Chat Isolation (separate chat per dimension) and Tab Isolation (separate tab list per dimension) with iOS-style toggle switches.

Mod Settings — Enable or disable individual features (World Manager, Player Manager, SlimeHead, Economy, Server Performance, MOTD) without restarting the server. Each toggle now ships with a short description and alternating row backgrounds for clarity.

Economy System

Every player gets a bank account on first join with a configurable starting balance (default: $1,000).

Balance management — Check your balance, view transaction history, and track every dollar
Player-to-player transfers — Send money directly or create money requests that the other player can accept or deny
Transaction history — Full audit trail of all purchases, sales, transfers, task rewards, gambling, and free claims with type-specific icons
Action bar notifications — Non-intrusive success/error messages displayed above the hotbar
Admin tools — Set, give, or take money from any player via commands or the admin dashboard
Economy Statistics — Real-time economy overview: total accounts, money in circulation, inflation rate, marketplace activity, gambling stats, and transaction volumes
Encrypted storage — All economy data secured with AES-256-GCM encryption

MineBay Marketplace

A fully-featured player marketplace where you can buy and sell items with other players.

Create listings — Sell any item or stack from your inventory
Flexible pricing — Accept money, up to 3 different item types, or both
Dynamic market pricing — Supply/demand tracking with configurable inflation
Counteroffers — Buyers can propose alternative prices; sellers review and accept/deny
Overflow inventory — If your inventory is full when buying, items are safely stored for later pickup (works in both survival and creative mode)
Item safety — Server-authoritative item handling with escrow rollback. Items are never lost or duplicated
Draft system — Step-by-step listing creation with item picker and quantity controls
Margin controls — Sellers can adjust prices from -50% to +200% of market value

MineStacks Casino

A full casino experience with four games, all using SecureRandom for provably fair results.

Coin Flip — 2% house edge, 2x payout. Simple heads or tails
Dice Roll — 3% house edge. Bet on High/Low (2x), Seven (5x), or Doubles (6x)
Slot Machine — 5% house edge. Payouts from Cherry (2x) up to Jackpot (100x), with half payouts for two-of-a-kind
Roulette — 2.7% house edge. Bet on Red/Black, Even/Odd, Low/High for 2x returns

Supports both money bets ($10–$10,000) and item bets (auto-valued). Includes spinning animations, particle effects on wins, screen shake, and sound effects. Your gambling stats are tracked.

Daily Tasks & Free Rewards

Three randomly assigned tasks per day, drawn from a configurable template pool.

Task Types:

Type	Example
Break Blocks	Break 250 blocks
Kill Mobs	Kill 50 mobs
Travel Distance	Travel 5,000 blocks
Craft Items	Craft 100 items
Mine Ores	Mine 75 ores
Trade Villagers	Trade 25 times

Real-time progress tracking with progress bars in the GUI
Instant notifications when a task is completed — click the chat message to claim
Configurable rewards — money and/or item rewards per task template
Free daily reward — Claim free money and an optional item every 24 hours (cooldown configurable)
Admin template editor — Create, edit, enable/disable, and delete task templates from the GUI

World Management

Manage all server worlds from a visual interface.

World list — See all dimensions with player counts
Teleportation — Click to teleport between worlds (with cooldown)
Portal control — Toggle Nether and End portals on or off
Lobby spawn — Set a lobby spawn point and teleport players to it (precise position + rotation, not just block-aligned spawn — 1.21.1 only until 1.20.1 v2.1.0 update release)
Chat isolation — Keep chat messages per-dimension (fully working on 1.21.1 v2.1.0; coming to 1.20.1 in v2.1.0)
Tab isolation — Separate the tab list by dimension (fully working on 1.21.1 v2.1.0; coming to 1.20.1 in v2.1.0)
Timer system — Auto-enable/disable portals on a schedule with live countdown in the GUI

Player Manager

Admin tools for managing online and offline players. Reworked in 1.21.1 v2.1.0 with tabs, search, and pagination.

Online tab — View all online players with location, dimension, and gamemode
Banned tab — Ban / unban players (works for offline players via profile cache); optional IP ban
Whitelist tab — Add / remove players and toggle whitelist enforcement on/off
Spectate — Watch any player in real-time with full cross-dimension tracking, stealth mode (same dimension), and tab-list disguise so the spectator's name doesn't show as italic gray to others (1.21.1 v2.1.0; coming to 1.20.1 in v2.1.0)
View inventory — Inspect a player's inventory read-only
Kick — Kick online players with an optional reason
Auto-sync — The server pushes ban/whitelist/toggle state to the client after every change
Pressing E in a name field no longer closes the screen

SlimeHead

A fun cosmetic item — an unbreakable slime head block with a custom texture.

Obtained via /slimehead command or a 5% drop chance from slimes
Protected from breaking by non-ops when placed
Available in the Creative Tools & Utilities tab

MOTD Editor

Customize your server's Message of the Day with a visual editor.

Rich text formatting — Apply color codes and formatting (bold, italic, underline, strikethrough) with a live preview
Multi-line support — Edit both lines of the server MOTD
Admin-only — Accessible from the Dashboard, requires OP level 2
Instant apply — Changes take effect immediately without server restart
Toggleable — Enable/disable the custom MOTD via config

Server Performance Tools (1.21.1 v2.1.0)

A new Performance Settings panel with eight runtime toggles and a scrollable Stats tab — TPS, MSPT, memory usage, and entity counts at a glance.

Item Merge Handler — Caps item-entity merging at 500 items per dimension per tick (no more O(n²) freezes from mob-farm dumps)
Mob Spawn Limiter — Per-tick cap to smooth out spawn spikes
Redstone Throttle — Limits rapid redstone updates per tick
All toggles are runtime-adjustable; no restart required

Notification System

Clickable chat notifications keep players informed without being spammy.

Login notifications — Admins see a dashboard link; players see free reward and task reminders
Payment alerts — Notifications when you send or receive money
Task completion — Instant notification with a clickable claim button when a task is done
Reward claimed — Confirmation when rewards are collected

Help Integration

All ServerManagement+ commands are integrated into the vanilla /help command.

/help — Lists all available commands including ServerManagement+ ones with descriptions
/help <command> — Detailed usage for any mod command (e.g., /help bank)
Admin filtering — Admin commands tagged with [Admin] and hidden from non-ops
Works alongside vanilla and other mods' commands

OTA Update System

Automatic over-the-air mod updates for connected clients.

Detects client/server version mismatch automatically
Downloads the correct JAR, verifies hash integrity, and installs
Shows an update progress screen to the player
Smart version comparison: semantic versioning first, then build number for same-version patches
Multi-version aware — OTA updates are blocked across different Minecraft versions (e.g., a 1.20.1 client won't receive a 1.21.1 update)
Multi-loader aware — Forge clients won't be served NeoForge or Fabric JARs and vice versa
Rate-limited — One transfer per player per session; aborts early if the client disconnects mid-transfer

Security

All sensitive data is encrypted at rest and authenticated in transit.

AES-256-GCM encryption for economy data, daily tasks, money requests, and achievement tracking
Unique server key auto-generated on first run, stored with restricted permissions
HMAC-SHA256 packet authentication prevents replay and tampering
Session management with per-player tokens and 30-minute timeout
Atomic transactions with automatic escrow rollback — no partial operations, no data loss
Item duplication prevention — Server-authoritative item validation in marketplace listings and offers; race-condition-safe slot clearing; synchronized balance operations
Network buffer hardening — All packet string and integer fields enforce strict length / value limits at the decode layer to prevent memory exhaustion from oversized payloads (1.21.1 v2.1.0; coming to 1.20.1 in v2.1.0)
NBT size limits — All NBT data loading uses 10MB NbtAccounter limits to prevent memory exhaustion from corrupted files
Permission enforcement on every admin packet — including dimension teleport and console command execution (1.21.1 v2.1.0; coming to 1.20.1 in v2.1.0)
Input validation — Player names validated against [a-zA-Z0-9_]{1,16} regex at the network layer before any server-side processing
Log injection prevention — User-controlled strings are sanitized before logging to prevent log forging
Thread-safe economy — Synchronized balance operations, atomic escrow with try-catch rollback, snapshot-based collection iteration, virtual-thread save scheduler, and concurrent collections in shared managers

Commands

Player Commands

Command	Description
`/bank`	Open Bank GUI
`/bank balance`	View your balance
`/bank pay &lt;player&gt; &lt;amount&gt;`	Send money to a player
`/bank request &lt;player&gt; &lt;amount&gt;`	Request money from a player
`/bank requests`	View pending money requests
`/bank accept &lt;id&gt;`	Accept a money request
`/bank deny &lt;id&gt;`	Deny a money request
`/bank stats`	View your bank statistics
`/bank dailies`	Open Daily Tasks GUI
`/bank dailies claim &lt;1-3&gt;`	Claim a completed daily task
`/bank dailies free`	Claim free daily reward
`/minebay`	Open MineBay marketplace
`/minestacks` or `/casino`	Open MineStacks Casino
`/teleportlobby`	Teleport to lobby

Admin Commands

Command	Permission	Description
`/sm` or `/servermanagement`	OP 2	Open admin Dashboard
`/smconfig`	OP 2	Open mod settings GUI
`/smconfig toggle &lt;feature&gt;`	OP 2	Toggle a feature on/off
`/smconfig info`	OP 4	Show config version info
`/smconfig validate`	OP 4	Validate config integrity
`/smconfig reset confirm`	OP 4	Reset config to defaults
`/worldmanager` or `/wm`	OP 2	Open World Manager
`/playermanager` or `/pm`	OP 2	Open Player Manager
`/spectate &lt;player&gt;`	OP 2	Spectate a player
`/stopspectate`	OP 2	Stop spectating
`/viewinv &lt;player&gt;`	OP 2	View a player's inventory
`/netherportals &lt;true\|false&gt;`	OP 2	Toggle Nether portals
`/endportals &lt;true\|false&gt;`	OP 2	Toggle End portals
`/setlobby`	OP 2	Set lobby spawn
`/clearlobby`	OP 2	Remove lobby spawn
`/slimehead [player]`	OP 2	Give a Slime Head
`/bank admin set &lt;player&gt; &lt;amount&gt;`	OP 2	Set a player's balance
`/bank admin give &lt;player&gt; &lt;amount&gt;`	OP 2	Give money to a player
`/bank admin take &lt;player&gt; &lt;amount&gt;`	OP 2	Take money from a player
`/servermanagement resetdailies`	OP 2	Force-reset all daily tasks
`/smmetrics`	OP 2	View performance metrics
`/smmetrics reset`	OP 2	Reset performance metrics

Configuration

The config file is located at config/servermanagement-common.toml. Key settings:

Setting	Default	Description
Starting Balance	$1,000	Initial money for new players
Encrypted Storage	Enabled	AES-256-GCM data encryption
Transaction History Limit	100	Transactions stored per player
Tasks Per Day	3	Daily tasks assigned per player
Free Reward Amount	$50	Daily free claim amount
Free Reward Cooldown	24 hours	Time between free claims
Max Listings Per Player	10	MineBay listing cap
Max Price Items	3	Item types accepted per listing
Counteroffers	Enabled	Allow buyers to make offers
Teleport Cooldown	5 seconds	Between world teleports

All economy data, task templates, and player progress persist across server restarts with automatic backup and migration support.

Installation

Requirements

Minecraft 1.20.1 or 1.21.1 (1.21.4 port coming after the 1.20.1 v2.1.0 update release)
Forge 47.4.0+ (MC 1.20.1) or 52.1.0+ (MC 1.21.1), NeoForge 21.1.80+ (MC 1.21.1), or Fabric API 0.116.1+ with Fabric Loader 0.18.1+ (MC 1.21.1)
Java 17+ (MC 1.20.1) or 21+ (MC 1.21.1)

Setup

Download the JAR for your Minecraft version and mod loader:
- MC 1.20.1 Forge: servermanagementplus-v2.0.0-b01-mc1.20.1-forge-release.jar (v2.1.0 update coming soon)
- MC 1.21.1 Forge: servermanagementplus-v2.1.0-mc1.21.1-forge-release.jar
- MC 1.21.1 NeoForge: servermanagementplus-v2.1.0-mc1.21.1-neoforge-release.jar
- MC 1.21.1 Fabric: servermanagementplus-v2.1.0-mc1.21.1-fabric-release.jar
Place it in your server's mods/ folder
Start the server — config and data folders generate automatically
Optionally install on clients for full GUI support (server-side only works too)
Adjust settings in config/servermanagement-common.toml and restart

First-Time Setup (Server Owners)

Review config values (starting balance, rewards, cooldowns)
Open the admin dashboard with /sm to explore features
Go to Economy Management to create daily task templates
Set free reward amounts and items
Test the economy flow with /bank, /minebay, and /minestacks

Data Storage

All mod data is stored in world/data/servermanagement/:

File	Contents	Format
`economy.json`	Bank accounts & balances	Encrypted JSON
`daily_tasks.json`	Player task progress	Encrypted JSON
`daily_task_templates.json`	Admin task templates	Encrypted JSON
`money_requests.json`	Pending transfers	Encrypted JSON
`achievement_rewards.json`	Achievement claims	Encrypted JSON
`world_manager.json`	World settings	Plain JSON
`minebay_listings.dat`	Marketplace listings	Compressed NBT
`playerdata/[UUID]/bank_inventory.dat`	Bank items	Compressed NBT
`playerdata/[UUID]/transactions.dat`	Transaction history	Compressed NBT

Back up world/data/servermanagement/ and config/servermanagement/ before updates.

Troubleshooting

Problem	Solution
"Could not load economy data"	Restore `economy.json` from backup, or delete it to reset
MineBay listings not loading	Check `minebay_listings.dat` — restore from backup if corrupted
Daily tasks not resetting	Verify server system clock; adjust `resetHour` in config
GUI not opening	Ensure the mod is installed on both client and server; reconnect
Transaction failed	Check chat error message — transactions auto-rollback, no data is lost
Chat / Tab Isolation toggle does nothing on 1.20.1	Known issue in v2.0.0-b01 — fix lands in 1.20.1 v2.1.0. Already fixed on 1.21.1 v2.1.0
`/teleportlobby` goes to world spawn on 1.20.1	Known issue in v2.0.0-b01 — fix lands in 1.20.1 v2.1.0. Already fixed on 1.21.1 v2.1.0
`/spectate` says "not in spectator mode" on 1.20.1	Vanilla command collision — fix lands in 1.20.1 v2.1.0. Already fixed on 1.21.1 v2.1.0

License

MIT License — free to use, modify, and distribute.

ServerManagement+ — Minecraft 1.21.1 v2.1.0 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric 0.116.1+) — Minecraft 1.20.1 v2.0.0-b01 (Forge 47.4.0+, v2.1.0 coming soon) — Minecraft 1.21.4 port to follow