ServerManagement+
Minecraft 的全能服务器管理解决方案
支持: Minecraft 1.20.1 (Forge 47.4.0+ / Fabric API 0.92.8+) | Minecraft 1.21.1 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric API 0.116.1+)
ServerManagement+ 为您提供一套完整的服务器运行工具——包括带有银行账户的完整经济系统、玩家市场、赌场、日常任务、世界管理以及精致的管理员面板——所有功能集成在一个模组中。
发布状态与路线图
最新版本 — Minecraft 1.20.1 v2.1.2-b1 及 1.21.1 v2.1.2-b3
适用于 Minecraft 1.20.1 和 1.21.1 的最新 beta 更新现已上线!
- 1.20.1 (v2.1.2-b1): 已发布 Forge 和 Fabric 版本。这次大规模移植带来了与现代 1.21.1 分支完全的功能对等性!它包含了第一阶段经济引擎“淘金热”重平衡(动态通胀曲线、140+ 个估值锚点、基于配方的价格周期打破器)、第三阶段 GUI 更新(下拉菜单、浮动徽标、基于节点的编辑器)、第六至八阶段性能引擎及 Zstd 网络协议,以及与 1.21.1 设计相匹配的完整 UI 重构。
- 1.21.1 (v2.1.2-b3): 已发布 Forge、NeoForge 和 Fabric 版本。此更新带来了进一步的稳定性修复、UI 优化以及经济引擎调整,以提供更流畅的跨平台体验。
1.20.1 和 1.21.1 版本现在均具备完全的功能对等性,包括对所有屏幕的完整 GUI 打磨、统一的姿态矩阵缩放、玩家管理器重写,以及对聊天隔离、标签页隔离和 OP-2 控制台的一系列关键修复。
下一步 — 即将到来的移植与更新
Minecraft 1.21.4 和 1.21.11 的专用移植版本正在积极开发中。
功能特性
管理员面板
一个现代化的深色主题指挥中心,通过 /sm 命令即可访问。六个功能卡片让您直接进入世界管理器、玩家管理器、控制台、全局设置、经济管理或模组设置。每个屏幕都拥有包含返回/关闭按钮和精致标题栏的一致性导航。
- 实时服务器控制台 — 直接从 GUI 运行服务器命令。输出按日志级别着色(红色表示错误,黄色表示警告)并可滚动。需要 OP 等级 2。
- 全局设置 — 使用 iOS 风格的切换开关开启或关闭聊天隔离(按维度分离聊天)和标签页隔离(按维度分离标签页列表)。
- 模组设置 — 无需重启服务器即可启用或禁用各个功能(世界管理器、玩家管理器、SlimeHead、经济、服务器性能、MOTD)。每个切换开关都附带简短说明,并采用交替的行背景以提高清晰度。
经济系统
每位玩家首次加入时都会获得一个银行账户,初始余额可配置(默认:$1,000)。
- 余额管理 — 查看您的余额、交易历史并追踪每一笔资金流动
- 玩家间转账 — 直接发送金钱或创建金钱请求,其他玩家可以接受或拒绝
- 交易历史 — 所有购买、销售、转账、任务奖励、赌博和免费领取的完整审计记录,并带有特定类型的图标
- 动作栏通知 — 显示在快捷栏上方的非侵入式成功/错误消息
- 管理员工具 — 通过命令或管理员面板为任何玩家设置、给予或扣除金钱
- 经济统计 — 实时经济概览:总账户数、流通货币量、通胀率、市场活跃度、赌博统计数据以及交易量
- 加密存储 — 所有经济数据均使用 AES-256-GCM 加密保护
MineBay 市场
一个功能齐全的玩家市场,您可以与其他玩家买卖物品。
- 创建商品 — 出售库存中的任何物品或堆叠
- 灵活定价 — 接受金钱、最多 3 种不同类型的物品或两者兼收
- 动态市场价格 — 供需跟踪,支持可配置的通胀机制
- 还价功能 — 买家可以提出替代价格;卖家可审查并接受/拒绝
- 溢出库存 — 如果购买时库存已满,物品将安全存储以供稍后取回(适用于生存模式和创造模式)
- 物品安全 — 服务器权威的物品处理机制,附带托管回滚。物品永远不会丢失或重复生成
- 草稿系统 — 分步骤创建商品,提供物品选择器和数量控制
- 利润率控制 — 卖家可以将价格调整为市场价值的 -50% 到 +200%
MineStacks 赌场
提供四种游戏的完整赌场体验,全部使用 SecureRandom 以确保结果的可验证公平性。
- 抛硬币 — 庄家优势 2%,赔率 2x。简单的正反面
- 掷骰子 — 庄家优势 3%。押注高/低(2x)、七点(5x)或对子(6x)
- 老虎机 — 庄家优势 5%。赔付从樱桃(2x)到大奖(100x),两个相同符号也有半额赔付
- 轮盘赌 — 庄家优势 2.7%。押注红/黑、偶/奇、小/大以获得 2x 回报
支持金钱投注($10–$10,000)和物品投注(自动估值)。包括旋转动画、胜利粒子效果、屏幕震动和音效。您的赌博统计数据会被记录。
日常任务与免费奖励
每天随机分配三个任务,从可配置的模板池中抽取。
任务类型:
| 类型 |
示例 |
| 破坏方块 |
破坏 250 个方块 |
| 击杀生物 |
击杀 50 个生物 |
| 移动距离 |
移动 5,000 格 |
| 合成物品 |
合成 100 个物品 |
| 挖掘矿石 |
挖掘 75 个矿石 |
| 与村民交易 |
交易 25 次 |
- 实时进度跟踪 — GUI 中带有进度条
- 即时通知 — 任务完成时立即通知 — 点击聊天消息即可领取
- 可配置奖励 — 每个任务模板均可配置金钱和/或物品奖励
- 每日免费奖励 — 每 24 小时领取免费金钱和可选物品(冷却时间可配置)
- 管理员模板编辑器 — 从 GUI 创建、编辑、启用/禁用和删除任务模板
世界管理
通过可视化界面管理所有服务器世界。
- 世界列表 — 查看所有维度及玩家数量
- 传送 — 点击在世界间传送(含冷却时间)
- 传送门控制 — 开启或关闭下界与末地传送门
- 大厅出生点 — 设置大厅出生点并将玩家传送至该位置(精确位置+旋转角度,而非仅对齐方块的出生点)
- 聊天隔离 — 按维度隔离聊天消息(在 1.20.1 和 1.21.1 上完全兼容)
- Tab 列表隔离 — 按维度分离 Tab 列表(在 1.20.1 和 1.21.1 上完全兼容)
- 计时器系统 — 按计划自动启用/禁用传送门,并在 GUI 中显示实时倒计时
玩家管理
用于管理在线和离线玩家的后台工具。经过重构,支持标签页、搜索和分页功能。
- 在线标签页 — 查看所有在线玩家的位置、维度和游戏模式
- 封禁标签页 — 封禁/解封玩家(通过配置文件缓存支持对离线玩家操作);可选 IP 封禁
- 白名单标签页 — 添加/移除玩家,并切换白名单强制执行的开关
- 旁观者模式 — 实时观察任意玩家,支持全维度追踪、潜行模式(仅限同维度)以及伪装 Tab 列表名称(避免旁观者的名字以斜体灰色显示给其他人)
- 查看物品栏 — 只读检查玩家的物品栏
- 踢出 — 踢出在线玩家,可附带原因
- 自动同步 — 每次更改后,服务器会将封禁/白名单/状态切换信息推送至客户端
- 在姓名字段中按下 E 键不再关闭屏幕
SlimeHead
一款有趣的装饰性物品——一个具有自定义纹理的不可破坏史莱姆头部方块。
- 可通过
/slimehead 命令获取,或由史莱姆掉落(5% 概率)
- 放置后非 OP 玩家无法破坏
- 可在“创意工具与实用程序”标签页中找到
MOTD 编辑器
通过可视化编辑器自定义服务器的每日消息 (Message of the Day)。
- 富文本格式 — 应用颜色代码和格式(粗体、斜体、下划线、删除线),并支持实时预览
- 多行支持 — 编辑服务器 MOTD 的两行内容
- 仅限管理员 — 从仪表盘访问,需要至少 2 级 OP 权限
- 即时生效 — 更改立即生效,无需重启服务器
- 可切换 — 可通过配置文件启用/禁用自定义 MOTD
服务器性能工具
包含八个运行时切换选项的可滚动统计信息面板的“性能设置”面板——一目了然地显示 TPS、MSPT、内存使用和实体数量。
- 物品合并处理器 — 限制每个维度每秒的物品实体合并上限为 500 个(避免因怪物农场倾倒导致的 O(n²) 卡顿)
- 生物生成限制器 — 限制每tick的生物生成数量,以平滑生成峰值
- 红石节流阀 — 限制每tick的红石快速更新次数
- 所有切换选项均可在运行时调整,无需重启
通知系统
可点击的聊天通知让玩家保持知情,同时避免刷屏。
- 登录通知 — 管理员看到仪表盘链接;玩家看到免费奖励和任务提醒
- 支付警报 — 发送或接收金钱时的通知
- 任务完成 — 任务完成后立即通知,并提供可点击的领取按钮
- 奖励已领取 — 收集奖励后的确认通知
帮助集成
所有 ServerManagement+ 命令均已集成到原版 /help 命令中。
/help — 列出所有可用命令,包括带有描述的 ServerManagement+ 命令
/help <command> — 提供任意模组命令的详细用法(例如 /help bank)
- 管理员过滤 — 标记为 [Admin] 的管理员命令对非 OP 玩家隐藏
- 可与原版及其他模组的命令共存
自动模组更新与智能重启
为连接的客户端提供自动空中下载 (OTA) 模组更新,并简化服务器更新流程。
- 双平台更新 — 自动检查 Modrinth 和 CurseForge 以查找最新更新。
- 优雅服务器关闭 — 更新服务器时,它会在热替换模组 jar 文件之前安全地保存世界并正确关闭。
- 智能重启脚本 — 扫描服务器中的
run.bat / run.sh,并智能地将其挂钩,以便在应用更新后服务器自动重启。管理员可以选择在游戏中自动修补其运行脚本!
- 多版本感知 — OTA 更新会阻止跨不同 Minecraft 版本的传输(例如,1.20.1 客户端不会收到 1.21.1 的更新)
- 多加载器感知 — Forge 客户端不会接收 NeoForge 或 Fabric JAR 文件,反之亦然
- 速率限制 — 每个会话每位玩家仅限一次传输;如果客户端在传输过程中断开连接,则提前中止
更新器的工作原理(供手动审核人员参考)
为确保完全透明地了解模组如何在不触发误报安全标志的情况下处理更新:
- API 获取:模组仅向官方
api.modrinth.com 和 api.curseforge.com 端点发出标准的 GET 请求以检查版本号。
- 独立更新器:为避免 Windows 上的文件锁定问题,模组会将嵌入的
updater.jar 提取到服务器根目录。该 jar 包在一个独立的临时 JVM 进程中运行,其唯一任务是等待主服务器退出,将新下载的模组 jar 覆盖旧的 jar,然后自我删除。
- 服务端脚本修改:如果管理员通过游戏内 GUI 提示选择加入智能重启功能,模组将读取现有的
run.bat 或 run.sh 脚本,将其备份为 run.bat.bak,并注入标准 -Dservermanagement.smartstart=true JVM 参数。它不会执行任意 shell 代码或下载外部脚本。所有脚本生成都是在本地完成的,并且需要明确的游戏内管理员同意。
- 客户端同意:在客户端侧,如果检测到更新,模组会使用专用的 UI 遮罩拦截主菜单。除非用户点击 “立即更新”,否则客户端绝不会自动下载或安装任何内容。此外,还会明确提供 “稍后更新” 和 “跳过此版本” 选项。
- 自行验证:如果您是代码审核员或服务器管理员,并希望安全地测试此系统的实际运行情况,可以克隆我们的开源仓库并将版本降级以模拟过时的模组。由于模组的当前版本是静态验证的,您需要降低
gradle.properties 中的版本,并将 ForgeUpdateHooks.java 和 FabricUpdateHooks.java 中硬编码的版本字符串更改为旧版本。编译模组(gradlew build),启动本地测试服务器,并通过游戏内管理员菜单明确选择加入智能重启功能。您将观察到模组安全地下载更新、提取 updater.jar、将您的运行脚本备份为 .bak 文件,并干净地注入 -Dservermanagement.smartstart=true 标志,而不会执行任意 shell 代码。没有任何隐藏内容。
安全性
所有敏感数据在静态存储时均经过加密,在传输过程中均经过身份验证。
- AES-256-GCM 加密用于经济数据、每日任务、金钱请求和成就追踪
- 唯一服务器密钥首次运行时自动生成,并以受限权限存储
- HMAC-SHA256 数据包身份验证可防止重放和篡改
- 会话管理采用每个玩家令牌和 30 分钟超时机制
- 原子事务配合自动托管回滚——无部分操作,无数据丢失
- 物品复制防止——市场列表和报价中的服务器权威物品验证;竞态条件安全的槽位清除;同步余额操作
- 网络缓冲区加固——所有数据包字符串和整数字段在解码层强制执行严格的长度/值限制,以防止因过大负载导致的内存耗尽
- NBT 大小限制——所有 NBT 数据加载使用 10MB NbtAccounter 限制,以防止因损坏文件导致的内存耗尽
- 每个管理员数据包上的权限强制执行——包括维度传送和控制台命令执行
- 输入验证——玩家名称在网络层面对
[a-zA-Z0-9_]{1,16} 正则表达式进行验证,然后再进行任何服务端处理
- 日志注入防止——用户控制的字符串在记录之前经过清理,以防止日志伪造
- 线程安全的经济系统——同步余额操作、带 try-catch 回滚的原子托管、基于快照的集合迭代、虚拟线程/守护线程保存调度器以及共享管理器中的并发集合
命令
玩家命令
| 命令 |
描述 |
/bank |
打开银行 GUI |
/bank balance |
查看您的余额 |
/bank pay <player> <amount> |
向玩家发送金钱 |
/bank request <player> <amount> |
向玩家请求金钱 |
/bank requests |
查看待处理的金钱请求 |
/bank accept <id> |
接受金钱请求 |
/bank deny <id> |
拒绝金钱请求 |
/bank stats |
查看您的银行统计数据 |
/bank dailies |
打开每日任务 GUI |
/bank dailies claim <1-3> |
领取已完成的每日任务 |
/bank dailies free |
领取免费每日奖励 |
/minebay |
打开 MineBay 市场 |
/minestacks 或 /casino |
打开 MineStacks 赌场 |
/teleportlobby |
传送至大厅 |
管理员命令
| 命令 |
权限 |
描述 |
/sm 或 /servermanagement |
OP 2 |
打开管理员仪表盘 |
/smconfig |
OP 2 |
打开模组设置 GUI |
/smconfig toggle <feature> |
OP 2 |
开启/关闭某项功能 |
/smconfig info |
OP 4 |
显示配置版本信息 |
/smconfig validate |
OP 4 |
验证配置完整性 |
/smconfig reset confirm |
OP 4 |
将配置重置为默认值 |
/worldmanager 或 /wm |
OP 2 |
打开世界管理器 |
/playermanager 或 /pm |
OP 2 |
打开玩家管理器 |
/spectate <player> |
OP 2 |
旁观一名玩家 |
/stopspectate |
OP 2 |
停止旁观 |
/viewinv <player> |
OP 2 |
查看玩家的物品栏 |
/netherportals <true|false> |
OP 2 |
切换下界传送门 |
/endportals <true|false> |
OP 2 |
切换末地传送门 |
/setlobby |
OP 2 |
设置大厅出生点 |
/clearlobby |
OP 2 |
移除大厅出生点 |
/slimehead [player] |
OP 2 |
给予史莱姆头颅 |
/bank admin set <player> <amount> |
OP 2 |
设置玩家的余额 |
/bank admin give <player> <amount> |
OP 2 |
给予玩家金钱 |
/bank admin take <player> <amount> |
OP 2 |
从玩家处扣除金钱 |
/servermanagement resetdailies |
OP 2 |
强制重置所有每日任务 |
/smmetrics |
OP 2 |
查看性能指标 |
/smmetrics reset |
OP 2 |
重置性能指标 |
配置
配置文件位于 config/servermanagement-common.toml。主要设置如下:
| 设置项 |
默认值 |
描述 |
| 初始资金 |
$1,000 |
新玩家的起始资金 |
| 加密存储 |
已启用 |
AES-256-GCM 数据加密 |
| 交易历史记录限制 |
100 |
每位玩家存储的交易数量 |
| 每日任务数 |
3 |
分配给每位玩家的每日任务数量 |
| 免费奖励金额 |
$50 |
每日可领取的免费金额 |
| 免费奖励冷却时间 |
24 小时 |
两次免费领取之间的间隔时间 |
| 每位玩家最大挂牌数 |
10 |
MineBay 挂牌上限 |
| 单条挂牌接受物品类型数 |
3 |
每条挂牌允许接受的物品类型数量 |
| 还价功能 |
已启用 |
允许买家提出报价 |
| 传送冷却时间 |
5 秒 |
世界间传送的冷却间隔 |
所有经济数据、任务模板和玩家进度会在服务器重启后保留,并支持自动备份与迁移。
安装
要求
- Minecraft: 1.20.1 或 1.21.1(1.21.4 移植版将于今年夏季推出)
- Forge: 47.4.0+(MC 1.20.1)或 52.1.0+(MC 1.21.1),
- NeoForge: 21.1.80+(MC 1.21.1),
- Fabric API: 0.92.8+(MC 1.20.1)或 0.116.1+(MC 1.21.1),需搭配 Fabric Loader 0.19.2+(MC 1.20.1)或 0.18.1+(MC 1.21.1)
- Java: 17+(MC 1.20.1)或 21+(MC 1.21.1)
设置
- 下载对应 Minecraft 版本和加载器的 JAR 文件:
- MC 1.20.1 Forge:
ServerManagement-forge-1.20.1-2.1.2-b01-mc1.20.1.jar
- MC 1.20.1 Fabric:
ServerManagement+-fabric-1.20.1-2.1.2-b01-mc1.20.1.jar
- MC 1.21.1 Forge:
ServerManagement-forge-1.21.1-2.1.2-b03-mc1.21.1.jar
- MC 1.21.1 NeoForge:
ServerManagement-neoforge-1.21.1-2.1.2-b03-mc1.21.1.jar
- MC 1.21.1 Fabric:
ServerManagement+-fabric-1.21.1-2.1.2-b03-mc1.21.1.jar
- 将其放入服务器的
mods/ 文件夹中
- 启动服务器——配置和数据文件夹将自动生成
- (可选)在客户端也安装该模组以获得完整的 GUI 支持(仅服务端安装也可正常工作)
- 调整
config/servermanagement-common.toml 中的设置并重启服务器
首次设置(服务器所有者)
- 检查配置值(初始资金、奖励、冷却时间等)
- 使用
/sm 打开管理面板以探索各项功能
- 进入 Economy Management 创建每日任务模板
- 设置免费奖励的金额和物品
- 通过
/bank、/minebay 和 /minestacks 测试经济流程
数据存储
所有模组数据存储在 world/data/servermanagement/ 目录下:
| 文件 |
内容 |
格式 |
economy.json |
银行账户与余额 |
加密 JSON |
daily_tasks.json |
玩家任务进度 |
加密 JSON |
daily_task_templates.json |
管理员任务模板 |
加密 JSON |
money_requests.json |
待处理转账 |
加密 JSON |
achievement_rewards.json |
成就领取记录 |
加密 JSON |
world_manager.json |
世界设置 |
纯文本 JSON |
minebay_listings.dat |
市场挂牌信息 |
压缩 NBT |
playerdata/[UUID]/bank_inventory.dat |
银行物品栏 |
压缩 NBT |
playerdata/[UUID]/transactions.dat |
交易历史记录 |
压缩 NBT |
请在更新前备份 world/data/servermanagement/ 和 config/servermanagement/。
故障排除
| 问题 |
解决方案 |
"Could not load economy data" |
从备份恢复 economy.json,或删除它进行重置 |
MineBay listings not loading |
检查 minebay_listings.dat——若损坏则从备份恢复 |
Daily tasks not resetting |
验证服务器系统时钟;或在配置文件中调整 resetHour |
GUI not opening |
确保客户端和服务端均安装了该模组;重新连接 |
Transaction failed |
查看聊天中的错误消息——交易会自动回滚,不会丢失任何数据 |
许可
MIT 许可证 —— 可免费使用、修改和分发。
ServerManagement+ — Minecraft 1.20.1 v2.1.2-b1 (Forge 47.4.0+ / Fabric API 0.92.8+) — Minecraft 1.21.1 v2.1.2-b3 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric 0.116.1+) — Minecraft 1.21.4 移植版将于今年夏季推出
ServerManagement+ 团队
ServerManagement+
The all-in-one server management solution for Minecraft
Supported: Minecraft 1.20.1 (Forge 47.4.0+ / Fabric API 0.92.8+) | 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.20.1 v2.1.2-b1 & 1.21.1 v2.1.2-b3
The latest beta updates are now live for both Minecraft 1.20.1 and 1.21.1!
- 1.20.1 (v2.1.2-b1): Shipped for Forge and Fabric. This massive backport brings complete feature parity with the modern 1.21.1 branch! It includes the Phase 1 Economy Engine Goldrush Rebalancing (dynamic inflation curves, 140+ valuation anchors, RecipeBasedPricing cycle breaker), Phase 3 GUI updates (Dropdowns, Floating Logos, Node-Based Editors), Phase 6-8 Performance Engine & Zstd Networking, and a complete UI overhaul matching the 1.21.1 design.
- 1.21.1 (v2.1.2-b3): Shipped for Forge, NeoForge, and Fabric. This update brings further stability fixes, UI refinements, and economy engine tuning for a smoother cross-platform experience.
Both 1.20.1 and 1.21.1 versions now feature complete feature parity including a full GUI polish pass across every screen, uniform pose-matrix scaling, Player Manager rework, and a long list of critical fixes for Chat Isolation, Tab Isolation, and the OP-2 console.
Next — Upcoming Ports & Updates
Dedicated ports for Minecraft 1.21.4 and 1.21.11 are in active development.
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 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)
- Chat isolation — Keep chat messages per-dimension (fully working on both 1.20.1 & 1.21.1)
- Tab isolation — Separate the tab list by dimension (fully working on both 1.20.1 & 1.21.1)
- 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 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
- 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
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
Automatic Mod Updates & Smart Restart
Automatic over-the-air mod updates for connected clients and easy server updates.
- Dual-Platform Updates — Automatically checks both Modrinth and CurseForge to find the latest updates.
- Graceful Server Shutdown — When updating the server, it safely saves your world and shuts down properly before hot-swapping the mod jar.
- Smart Restart Script — Scans your server for
run.bat / run.sh and intelligently hooks into them so your server automatically reboots itself after applying an update. Admins can choose to automatically patch their run scripts from in-game!
- 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
How the Updater Works (For Manual Reviewers)
To ensure full transparency on how the mod handles updates without triggering false positive security flags:
- API Fetching: The mod only makes standard GET requests to the official
api.modrinth.com and api.curseforge.com endpoints to check for version numbers.
- Standalone Updater: To avoid file-lock issues on Windows, the mod extracts an embedded
updater.jar into the server root. This jar runs in a separate, temporary JVM process whose only job is to wait for the main server to exit, copy the newly downloaded mod jar over the old one, and then delete itself.
- Server-Side Script Modification: If an admin opts into the Smart Restart feature via the in-game GUI prompt, the mod will read their existing
run.bat or run.sh script, back it up to run.bat.bak, and inject a standard -Dservermanagement.smartstart=true JVM argument. It does not execute arbitrary shell code or download external scripts. All script generation is done locally and requires explicit in-game admin consent.
- Client-Side Consent: On the client side, if an update is detected, the mod intercepts the Main Menu with a dedicated UI overlay. The client will never automatically download or install anything without the user clicking "Update Now". Users are also explicitly provided with "Update Later" and "Skip This Version" options.
- Verify it Yourself: If you are a code reviewer or server admin and want to safely test this system in action, clone our open-source repository and down-bump the version to simulate an outdated mod. Because the mod's current version is statically validated, you will need to lower the version in
gradle.properties, as well as change the hardcoded version strings located in ForgeUpdateHooks.java and FabricUpdateHooks.java to an older version. Compile the mod (gradlew build), launch a local test server, and explicitly opt-in to the Smart Restart feature via the in-game admin menu. You will observe that the mod securely downloads the update, extracts updater.jar, backs up your run scripts to .bak files, and cleanly injects the -Dservermanagement.smartstart=true flag without executing arbitrary shell code. Nothing is hidden.
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
- 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
- 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 / daemon-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 <player> <amount> |
Send money to a player |
/bank request <player> <amount> |
Request money from a player |
/bank requests |
View pending money requests |
/bank accept <id> |
Accept a money request |
/bank deny <id> |
Deny a money request |
/bank stats |
View your bank statistics |
/bank dailies |
Open Daily Tasks GUI |
/bank dailies claim <1-3> |
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 <feature> |
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 <player> |
OP 2 |
Spectate a player |
/stopspectate |
OP 2 |
Stop spectating |
/viewinv <player> |
OP 2 |
View a player's inventory |
/netherportals <true|false> |
OP 2 |
Toggle Nether portals |
/endportals <true|false> |
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 <player> <amount> |
OP 2 |
Set a player's balance |
/bank admin give <player> <amount> |
OP 2 |
Give money to a player |
/bank admin take <player> <amount> |
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 this summer)
- Forge: 47.4.0+ (MC 1.20.1) or 52.1.0+ (MC 1.21.1),
- NeoForge: 21.1.80+ (MC 1.21.1),
- Fabric API: 0.92.8+ (MC 1.20.1) or 0.116.1+ (MC 1.21.1) with Fabric Loader 0.19.2+ (MC 1.20.1) or 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:
ServerManagement-forge-1.20.1-2.1.2-b01-mc1.20.1.jar
- MC 1.20.1 Fabric:
ServerManagement+-fabric-1.20.1-2.1.2-b01-mc1.20.1.jar
- MC 1.21.1 Forge:
ServerManagement-forge-1.21.1-2.1.2-b03-mc1.21.1.jar
- MC 1.21.1 NeoForge:
ServerManagement-neoforge-1.21.1-2.1.2-b03-mc1.21.1.jar
- MC 1.21.1 Fabric:
ServerManagement+-fabric-1.21.1-2.1.2-b03-mc1.21.1.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 |
License
MIT License — free to use, modify, and distribute.
ServerManagement+ — Minecraft 1.20.1 v2.1.2-b1 (Forge 47.4.0+ / Fabric API 0.92.8+) — Minecraft 1.21.1 v2.1.2-b3 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric 0.116.1+) — Minecraft 1.21.4 port to follow this summer
The ServerManagement+ Team
评论 0
登录后参与评分
还没有评论,来抢沙发吧