XiceTextArranger 文本交互插件

返回插件列表

XiceTextArranger 用于整理玩家在服务器内外看到的文本提示和验证流程，让白名单注册、黑名单拒绝和维护广播的文案集中管理。

功能概述

XiceTextArranger 在服务器上主要影响玩家看到的系统文本。未加入白名单的玩家连接服务器时，插件会把拒绝提示改写为更清楚的说明，并生成一次性临时邀请码；插件本身负责生成、保存和展示邀请码，不负责处理后续登记提交。

插件还会处理正版验证失败提示、黑名单拒绝提示、玩家加入/离开消息，以及维护脚本通过 RCON 触发的系统广播。它不改变白名单、正版验证和封禁判断本身，只负责把玩家最终看到的文字整理成更准确的格式。

当前管理的文本

白名单拒绝提示和临时邀请码。
正版验证失败提示。
黑名单拒绝登录提示。
玩家加入与退出消息，可选择保留、删除、重写或追加。
xicebroadcast 系统广播，用于每日维护前的倒计时提醒。

部署方式

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

运行时配置文件位于 /opt/xicemc/runtime/plugins/XiceTextArranger/config.yml。配置中包含白名单拒绝提示、邀请码生成规则、黑名单提示、正版验证失败匹配文本、进退服消息模式和广播模板。

插件使用两个运行时数据文件：邀请码文件 /opt/xicemc/runtime/plugins/XiceTextArranger/verification-codes.tsv，黑名单文件 /opt/xicemc/runtime/plugins/XiceTextArranger/blacklist.tsv。文件路径由 config.yml 中的 verification-codes.path 和 blacklist.path 配置。

xicebroadcast 命令权限为 xicetextarranger.broadcast，默认仅 OP 或控制台可执行；每日维护脚本通过 RCON 以控制台身份发送维护提醒。