Skip to content
EncinetPublic

About

MikCasual主控插件

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MIK

Paper 服务器插件,提供玩家工具、地段保护、载具、音乐与音游、社交互通和社区治理。

运行与安装

当前构建目标为 Java 25、Paper 26.3,必需插件为 PacketEvents 2.14.0 或更高版本、LuckPerms、Plasmo Voice。其他集成按功能选装,依赖声明见 paper-plugin.yml。

  1. 按下方构建命令生成插件,将 build/libs/mik-1.0.jar 与必需插件放入服务器的 plugins/ 目录。
  2. 启动服务器,检查 MIK 是否正常启用。配置与存档位于 plugins/mik/。
  3. 游戏内执行 /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。

About

MikCasual主控插件

Resources

Stars

0 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages