个人技术开发随记
测试入口

已在白名单的玩家使用自己的邀请码;未加入白名单的玩家使用进服拒绝提示中的临时邀请码。

Command Permission

XiceCommandControl 指令权限插件

XiceCommandControl 用于管理需要额外信任的服务器指令,避免为了少量功能直接给玩家 OP 或开放原版高权限命令。

功能概述

XiceCommandControl 在服务器上表现为一组受控指令。普通玩家可以使用默认开放的指令,例如 /survival;需要额外信任的指令,例如 /creative 或插件维护指令,则必须在配置中为指定玩家 UUID 授权。

插件把“谁能执行什么指令”从代码中抽离出来。玩家执行受控指令时,插件会读取配置并拦截无权限操作;管理员可以在游戏内通过维护命令重新加载配置或查看已配置玩家的指令列表。

当前用途

  • /survival:切换自己为生存模式,默认允许所有玩家使用。
  • /creative:切换自己为创造模式,只允许配置中授权的玩家使用。
  • /xcc reload:重新加载指令权限配置。
  • /xcc list [玩家名或 UUID]:查询当前配置中的玩家指令权限。

权限粒度保持在指令层,不继续细分到每个子动作。这样配置更简单,也符合当前服务器只给少数可信玩家开放特殊能力的实际需求。

部署方式

插件基于 Paper API 运行,当前项目按 Paper 1.21.11 和 Java 21 构建。构建产物安装为 /opt/xicemc/runtime/plugins/XiceCommandControl.jar

运行时配置文件位于 /opt/xicemc/runtime/plugins/XiceCommandControl/config.yml。配置中包含 default-allowed-commandsplayers 两部分:前者声明所有玩家默认可用的受控指令,后者按玩家 UUID 配置专属指令列表,name 字段只用于显示和查询。

修改配置后,插件可通过 /xcc reload 重新加载;/xcc list [玩家名或 UUID] 可用于在游戏内查看配置中的玩家授权。