Nascraft 市场的汉化改造版（Paper 服务器插件）。这是一个由玩家交易驱动的动态物品市场：价格随买卖量实时波动，支持税制、噪音、限价单、资产组合、借贷，以及 SQLite/MySQL/Redis 跨服、Discord 机器人、自托管网页。
原版说明见：https://www.spigotmc.org/resources/108216/
| 目标 | 适用版本 | Java | 界面库 |
|---|---|---|---|
| 1.21.11 | Paper / Purpur 1.21.11 | JDK 21 | invui 1.x |
| 26.2 | Paper / Purpur 26.2 | JDK 25 | invui 2.x |
| 26.3 | Paper / Purpur 26.3 | JDK 25 | invui 2.x |
三个目标共享同一套源码；26.2 / 26.3 会额外把 src/invui2/java 下的 6 个界面文件和 AnvilPrompt（invui 2.x 版）覆盖进构建。
当前版本号只写在 gradle.properties 的 version 里，产物文件名和 plugin.yml 的版本都取自它，改版本只需要改这一行。
- 玩家驱动的动态价格，买卖税、噪声波动、支撑位/压力位、弹性
- 主菜单、分类页、热门趋势、涨跌幅榜单
- 限价单（限时）、超卖/超买限制
- 资产组合（portfolio）与借贷、利息、清算
- 子物品（child）价格按比例联动
- SQLite（单服）/ MySQL（多服共享）+ Redis 实时同步
- Discord 桥接：交易日志、链接账号、警报
- 自托管网页：行情、图表、会话登录
- 内置中文语言包（zh_CN），
/nascraft edit管理员编辑器已汉化
- Paper / Purpur 1.21.11 / 26.2 / 26.3
- Vault（必装，作为默认货币）
- 可选：PlaceholderAPI（多货币）、AdvancedGUI（游戏内图表）
- 依赖：redis.clients:jedis（跨服用）、JDA（Discord 用）
前置：
- JDK 21 和 JDK 25（工具链路径在
gradle.properties的org.gradle.java.installations.paths中配置） - Gradle 8.14.3
- 依赖下载需要代理（
gradle.properties已配置 127.0.0.1:7897）
命令：
gradlew shadowJar "-PmcTarget=1.21.11" # 1.21.11（默认）
gradlew shadowJar "-PmcTarget=26.2" # 26.2
gradlew shadowJar "-PmcTarget=26.3" # 26.3
PowerShell 用户注意：
-PmcTarget=1.21.11必须整体加引号。 不加引号时 PowerShell 会把参数拆坏，Gradle 只收到.21.11，直接报Task '.21.11' not found并构建失败；这时build/libs里留着的是上一次构建的旧 jar， 如果把它发出去，就会得到「没打依赖、启动报NoClassDefFoundError」的坏包。 用 CMD 或 Linux / macOS 的 shell 不需要加引号。
注意：Gradle daemon 必须运行在 JDK 21 上（即使构建 26.2 / 26.3 目标），因为 Gradle 8.14.3 内嵌的 Kotlin DSL 编译器无法解析 Java 25 的版本号 25.0.3。javac 会自动通过 Java 工具链切换到对应 JDK。
产物（版本号取自 gradle.properties）：
build/libs/Nascraft-26.3-1.21.11.jarbuild/libs/Nascraft-26.3-26.2.jarbuild/libs/Nascraft-26.3-26.3.jar
shadowJar 跑完会自动做一次打包自检：确认 bStats、invui、item-nbt-api 这些随包依赖确实被 shade 进 jar 了，缺任何一个都让构建失败，防止再把没打依赖的 jar 发布出去。
跑测试：
gradlew test "-PmcTarget=1.21.11"
src/test 下有连接复用的回归测试（ConnectionReuseTest）。SQLite 的池只有 1 条连接，历史上「在查库的过程中又去查一次库」会把自己锁死、连带卡住服务器主线程 30 秒（打开资产榜单时的 SQLTransientConnectionException），这些测试就是为了拦住它再出现。
仓库自带两个 GitHub Actions 工作流：
| 工作流 | 触发方式 | 作用 |
|---|---|---|
.github/workflows/build.yml |
push、Pull Request、手动 | 跑测试 + 构建三个目标并上传产物（Actions 页面的 Artifacts 可下载） |
.github/workflows/release.yml |
推 v* tag，或手动触发 |
递增/指定版本号 → 提交 → 打 tag → 跑测试 → 构建 → 发布 Release |
手动发布：Actions → 发布 Release → Run workflow，填版本号（例如 26.3）或选递增方式即可。
gradle.properties 里的本地 Clash 代理和 D:/Zulu 工具链路径只对作者本机有效，两个工作流都会在构建前把这几行删掉，再写入 runner 上真实的 JDK 路径。
- 用对应版本的 jar 替换服务器
plugins/里的旧 jar。 - 不要删除
plugins/Nascraft数据文件夹，里面是数据库（sqlite.db）和你的配置。 - 删除一次
plugins/Nascraft/langs/下的旧语言文件，让插件重新生成（新增的键才能生效）。 - 在
plugins/Nascraft/config.yml中设置language: 'zh_CN'。 - 重启服务器。
- 适配 1.21.11、26.2 与 26.3（invui 1.x / 2.x）。
- 版本号从 26.3 起与 MC 版本对齐，统一由
gradle.properties的version控制。 - 修复随包依赖没有被打进 jar 的问题（bStats / invui / item-nbt-api 缺失时，服务器加载会报
NoClassDefFoundError: org/bstats/charts/CustomChart）；shadowJar现在带打包自检，不会再发出缺依赖的包。 - anvil 输入弹窗不再依赖 anvilgui（其 NMS 包装只支持到 1.21.10，在 1.21.11 上会报
NoClassDefFoundError），改用 invui AnvilWindow。 - 物品贴图未就绪时使用占位图标，物品始终可以加载；客户端 JAR 下载完成后重载即可显示真实贴图。
- 修复
/market在市场无物品时的空列表崩溃。 - 完整中文（zh_CN）语言包，配置注释与默认显示名称均已汉化。