ServerSystem - 服务器基础插件

ServerSystem 是一款适用于 Paper 服务器的综合性 Minecraft 服务器管理插件，提供必要的管理、监管和实用命令。简而言之，它是 Essentials 等插件的替代品。该插件旨在提供更多自定义选项，并（在大多数情况下）实现开箱即用。

💡为什么选择 ServerSystem？

虽然 Essentials 是一款优秀的插件，但更多的选择和竞争总是好事。此插件还致力于提供更高的可定制性，并力求成为一个近乎即插即用的解决方案。

✨功能特性

核心模块

• 管理工具：游戏模式管理、传送、时间/天气控制
• 经济系统：余额管理、支付、经济管理（需要 Vault）
• 监管工具：封禁/禁言系统、命令间谍、隐身、清空聊天
• 实用工具：修复工具、垃圾桶、治疗、喂食
• 玩家功能：家、传送点、礼包、移动工作台访问
• 传送系统：TPA 请求、返回命令、出生点管理
• 通信系统：私信、团队聊天、广播系统
• 可点击告示牌：支持多种功能的交互式告示牌
• 多语言支持：支持按用户设置语言，默认使用玩家区域设置（目前仅限英语、德语和斯洛文尼亚语）

❓要求与依赖

必需条件

• Minecraft 版本：1.21+
• 服务器核心：Paper（或基于 Paper 的分支）
• Java 版本：21+

可选依赖

• Vault：为其他插件提供统一的经济 API
• NBTAPI：用于加载/保存离线玩家数据

🔧安装指南

• 下载最新的 ServerSystem JAR 文件。
• 将其放入服务器的 plugins 文件夹。
• 重启服务器。
• 使用生成的配置文件进行配置。
• 重新加载或重启服务器以应用更改。

⭐配置说明

插件会生成多个配置文件

• config.yml - 包含配置，适用于较小或通用的部分
• commands.yml - 命令设置和别名
• permissions.yml - 权限定义
• economy.yml - 经济相关设置
• moderation.yml - 监管（封禁/禁言）相关设置
• messages/ - 不同区域的语言文件

🎮命令列表

(参数) = 可选参数

[参数] = 必需参数

管理命令

• /gamemode [模式] (玩家) (/gm) - 更改游戏模式
• /gms (玩家) - 设置为生存模式
• /gmc (玩家) - 设置为创造模式
• /gma (玩家) - 设置为冒险模式
• /gmsp (玩家) - 设置为旁观者模式
• /time [时间] (世界) - 设置世界时间
• /day (世界), /night (世界), /noon (世界), /midnight (世界) - 设置特定时间
• /weather [类型] (世界) - 更改天气
• /sun (世界), /rain (世界), /storm (世界) - 设置特定天气
• /sudo [玩家] [命令] - 以另一玩家身份执行命令
• /unlimited (玩家) - 切换物品无限
• /speed [1-10] (玩家) - 设置玩家速度
• /flyspeed [1-10] (玩家) (/speedfly) - 设置飞行速度
• /walkspeed [1-10] (玩家) (/speedwalk) - 设置行走速度
• /lightning (玩家) (视觉) (/thor, /smite) - 在目标处召唤闪电

传送命令

• /teleport [玩家] (目标) (/tp) - 传送到玩家或位置
• /tppos [x] [y] [z] (世界) (玩家) - 传送到坐标
• /tphere [玩家] - 将玩家传送到你身边
• /tpall (世界) - 将所有玩家传送到你身边
• /tpa [玩家] - 请求传送到玩家
• /tpahere [玩家] - 请求玩家传送到你身边
• /tpaccept - 接受传送请求
• /tpdeny - 拒绝传送请求
• /tptoggle (玩家) - 切换传送请求
• /back - 返回上一个位置
• /offlinetp [玩家] (/otp) - 传送到离线玩家的位置
• /offlinetphere [玩家] (/otphere) - 将离线玩家传送到你身边

经济命令

• /balance (玩家) (/money) - 查询余额
• /balancetop (/baltop) - 查看余额排行榜
• /pay [玩家] [金额] - 向玩家发送金钱
• /economy [set/give/take] [玩家] [金额] (/eco) - 管理玩家经济

监管命令

• /ban [玩家] (理由) - 封禁玩家
• /unban [玩家] (/pardon) - 解封玩家
• /mute [玩家] (时间) (理由) - 禁言玩家
• /unmute [玩家] - 解除禁言
• /shadowmute [玩家] - 影子禁言玩家
• /vanish (玩家) (/v) - 切换隐身模式
• /commandspy (玩家) - 切换命令间谍
• /clearchat (/cc) - 为所有玩家清空聊天
• /broadcast [消息] (/bc) - 向服务器广播消息
• /clearinventory (玩家) (/clear, /ci) - 清空玩家背包
• /ip [玩家] - 查看玩家的 IP 地址
• /socialspy (玩家) - 切换社交间谍模式

实用命令

• /workbench (/craft, /wb) - 打开工作台
• /anvil - 打开铁砧界面
• /smithing - 打开锻造台
• /loom - 打开织布机界面
• /grindstone - 打开砂轮界面
• /cartography - 打开制图台
• /stonecutter - 打开切石机界面
• /disposal (/trash, /trashcan) - 打开垃圾桶界面
• /enderchest (玩家) (/ec) - 打开末影箱
• /offlineenderchest [玩家] (/oenderchest, /oec) - 打开离线玩家的末影箱
• /invsee [玩家] - 查看玩家背包
• /offlineinvsee [玩家] (/oinvsee) - 查看离线玩家背包
• /smelt - 熔炼背包中的物品
• /stack - 堆叠背包中的物品
• /repair (all) - 修复手中或所有物品
• /skull (玩家) - 获取玩家头颅
• /ping (玩家) - 检查延迟
• /seen [玩家] - 检查玩家最后在线时间
• /god (玩家) - 切换上帝模式
• /fly (玩家) - 切换飞行
• /heal (玩家) - 治疗玩家
• /feed (玩家) - 喂食玩家
• /hat - 将手中物品戴在头上
• /rename [名称] - 重命名手中物品
• /sign [消息] - 为手中物品签名
• /unsign - 移除物品签名

家与传送点命令

• /spawn (玩家) - 传送到出生点
• /setspawn - 设置服务器出生点
• /home [名称] - 传送到家
• /sethome [名称] - 设置家位置
• /delhome [名称] - 删除家
• /adminhome [玩家] [名称] - 传送到玩家的家
• /adminsethome [玩家] [名称] - 为玩家设置家
• /admindelhome [玩家] [名称] - 删除玩家的家
• /warp [名称] - 传送到传送点
• /setwarp [名称] - 创建传送点
• /delwarp [名称] - 删除传送点

通信命令

• /msg [玩家] [消息] (/tell, /whisper) - 发送私信
• /reply [消息] (/r) - 回复上一条消息
• /msgtoggle (玩家) - 切换私信接收
• /teamchat [消息] (/tc) - 发送团队聊天消息
• /ignore [玩家] - 忽略玩家消息
• /unignore [玩家] - 取消忽略玩家消息

礼包命令

• /kit [名称] (玩家) - 给予玩家礼包
• /createkit [名称] - 从背包创建礼包
• /deletekit [名称] - 删除礼包

杂项命令

• /language [语言] - 更改语言
• /signcost - 管理告示牌成本
• /drop (玩家) - 在隐身时切换物品丢弃
• /pickup (玩家) - 在隐身时切换物品拾取
• /interact (玩家) - 在隐身时切换方块交互
• /message (玩家) - 在隐身时切换消息发送能力

⭐权限系统

ServerSystem 将权限分为以下几个主要类别：

• serversystem.admin.* - 完全的管理员权限
• serversystem.moderation.* - 监管工具权限
• serversystem.support.* - 支持/助手权限
• serversystem.command.* - 基本命令权限

适合日常玩家使用的权限默认已授予。这意味着玩家可以开箱即用这些命令（例如 /home）。您可以在 permissions.yml 文件中设置任何权限是否需要。

权限等级

• 管理员：完全服务器控制（游戏模式、时间、天气、经济等）
• 监管：玩家管理（封禁、禁言、隐身等）
• 支持：助手工具（传送、治疗、上帝模式等）
• 玩家：基本命令（家、传送点、消息等）

特殊权限

• serversystem.homes.unlimited - 无限数量家
• serversystem.homes.<数字> - 特定的家数量限制
• serversystem.chat.colored - 在聊天中使用颜色代码
• serversystem.command.teleportask.instant - 无延迟即时传送

✨可点击告示牌

插件支持用于各种功能的交互式告示牌

• 给予告示牌：向玩家给予物品
• 礼包告示牌：向玩家提供礼包
• 时间告示牌：更改服务器时间
• 天气告示牌：更改服务器天气
• 传送点告示牌：传送到传送点

每种告示牌类型都有供管理员使用的创建/销毁权限。

🔧数据迁移

在重写之前（2.x.x 版本），ServerSystem 支持从 Essentials 迁移或迁移到 Essentials。但截至 2025 年 7 月 18 日，3.x.x 版本不支持此功能。原因很简单：在认为插件已准备好发布之前，我还没有来得及实现它。

✨PlaceholderAPI

此插件支持 PlaceholderAPI。您可以在 ServerSystem 的消息中使用其占位符，或使用 ServerSystem 添加的占位符：

• %serversystem_onlineplayers% -> 显示在线玩家数量（如果目标无法看到隐身玩家，则排除隐身玩家）
• %serversystem_balance% (%serversystem_balance_<玩家名>%) -> 显示玩家的格式化余额
• %serversystem_unformattedbalance% (%serversystem_unformattedbalance_<玩家名>%) -> 显示玩家的未格式化余额
• %serversystem_baltop_name_<数字>% -> 显示余额排行榜中第 <数字> 位的玩家名（仅限 1-10！）
• %serversystem_baltop_balance_<数字>% -> 显示余额排行榜中第 <数字> 位的格式化余额（仅限 1-10！）
• %serversystem_baltop_unformattedsbalance_<数字>% -> 显示余额排行榜中第 <数字> 位的未格式化余额（仅限 1-10！）

🔧自动更新

作为用户，您可以通过 config.yml 禁用自动更新。

如果您是服务器托管商或只想使用 JVM 标志，也可以通过以下方式实现：

java -Dserversystem.disable-auto-download=true -jar server.jar