Paper 服务器插件,提供玩家工具、地段保护、载具、音乐与音游、社交互通和社区治理。
当前构建目标为 Java 25、Paper 26.3,必需插件为 PacketEvents 2.14.0 或更高版本、LuckPerms、Plasmo Voice。其他集成按功能选装,依赖声明见 paper-plugin.yml。
- 按下方构建命令生成插件,将
build/libs/mik-1.0.jar与必需插件放入服务器的plugins/目录。 - 启动服务器,检查 MIK 是否正常启用。配置与存档位于
plugins/mik/。 - 游戏内执行
/menu,进入功能与个人设置。
地段批量编辑保护与 /regen 选区读取使用可选插件 FastAsyncWorldEdit 2.16.1;安装时用它替换 WorldEdit。
AI、QQ、Matrix 默认关闭,启用前需填写各自配置;操作与重载方式见对应手册。入服由平台绑定与成员资格管理,至少启用一个平台并配置接入社区。首次连接的拒绝界面会提供绑定指令,原版白名单和 OP 不作为绕过入口。
直连正版服务器自动启用认证容灾:官方认证故障时,近期验证成功且 IP 相同的玩家可使用原正版 UUID 重连。
| 功能 | 入口与说明 |
|---|---|
| 菜单与个人设置 | /menu;界面、文字与 FOV |
| 建筑地图 | 安装 Pl3xMap 后自动展示已收录建筑;同步与图层 |
| 地段与建造 | /plot;地段操作、权限、选区与子地段 |
| 音乐与音游 | /music;曲库、唱片机与玩法 |
| 网页聊天 | /chat、游戏 /msg;接入与安全规则 |
| 社交与账号 | /password、/bind <平台>;账号安全、身份绑定、QQ、Matrix |
| AI 与治理 | /ai、/gov;AI 配置、社区治理 |
载具、电梯、空间连接、世界更新及其他功能见完整文档。
在项目根目录执行,构建使用 Gradle Wrapper:
| 命令 | 用途 |
|---|---|
./gradlew build |
编译并运行默认测试,产物位于 build/libs/ |
./gradlew checkJavaWarnings |
单独检查生产与测试源码警告,已包含在默认构建中 |
./gradlew test --tests org.encinet.mik.shared.i18n.FluentGrammarTest |
只运行指定测试类 |
./gradlew benchmark |
单独执行性能测量,不进入默认构建 |
python3 tools/i18n/audit.py |
检查翻译清单、引用、参数与生产调用,无第三方 Python 依赖 |
测试报告位于 build/reports/tests/{test,benchmark}/index.html,临时文件位于 build/test-tmp/。比较性能结果时保持环境和数据规模一致。
生产与测试源码共用警告检查,弃用 API 和未解决的警告会使构建失败。必要的局部豁免在代码旁说明。
通用取舍见设计准则,工程约定见项目架构与翻译维护。构建依赖见 build.gradle,动态加载的运行时库见 MikLoader.java。