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:

• 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

Admin Commands

Configuration

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

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

1. 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
2. Place it in your server's mods/ folder
3. Start the server — config and data folders generate automatically
4. Optionally install on clients for full GUI support (server-side only works too)
5. Adjust settings in config/servermanagement-common.toml and restart

First-Time Setup (Server Owners)

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

Data Storage

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

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

Troubleshooting

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