## NDPR Bukkit/Paper 客户端插件 v2.2.0 适配 **Minecraft 26.3**，并按服务端世代提供两个产物（同一份源码双目标构建）。 ### 产物选择 | 文件 | 支持版本 | 运行环境 | |---|---|---| | `ndpr-bukkit-2.2.0.jar` | MC 26.3+ | Java 25 | | `ndpr-bukkit-2.2.0-legacy.jar` | MC 1.20.1 ~ 1.21.x | Java 17 | ### 本次更新 - **适配 MC 26.3**：paper-api `26.3.build.174-beta`、Java 25 字节码、`api-version: 26.3` - **一份源码双目标构建**：26.3 产物（Java 25）与 1.20.1~1.21.x 产物（Java 17）由同一提交构建 - **新增文本兼容层 `ChatBridge`**：Paper/Folia 使用 Adventure（`kick(Component)` / `showTitle(Title)` / `Component` 点击与悬停事件），Spigot/CraftBukkit 自动回退 BungeeCord chat 与旧版方法 - **服务端 API 弃用项全部处理**：双目标编译 0 弃用告警 - **Folia 支持保留**：26.3 中 `io.papermc.paper.threadedregions.scheduler.*` 仍然存在，反射适配继续有效 - 内嵌 sqlite-jdbc，无需额外安装依赖 ### 功能 - 云端封禁数据库：ID / UUID / IPv4 / IPv6 四维封禁，自动定时更新，原子替换 - 玩家加入检测：实时比对封禁库，命中即踢出并上报拦截统计 - HWID 设备验证：网页验证 + freeze 钉人 + 超时请离 - fail_closed / fail_open 双策略 - 命令：`/ndpr help` / `download` / `ban` / `check` / `reload` / `checkupdate` / `auth` - 中英双语，GitHub 更新检查 ### 安装 1. 按服务端版本选择对应 jar，放入 `plugins/` 目录 2. 启动后编辑 `plugins/NDPR-Bukkit/config.yml`，填写 `onlinemode`（true=正版 / false=离线） 3. 封禁功能需在官网 https://ndpreforged.com 绑定邮箱获取 token 后填入

修复已知问题

## NDPReforged 代理端客户端 v2.4.0 Velocity + BungeeCord 双平台单 Jar 插件。**本版本新增 Velocity 4.x 支持，并修复 4.x 下开启 HWID 导致玩家无法进入游戏的问题。** --- ### ⚠️ 兼容性问题公告（Velocity 4.x） - **受影响版本**：≤ 2.3.0 - **修复版本**：2.4.0+ - **现象**：在 **Velocity 4.x** 上运行并**开启 HWID** 时，玩家无法进入游戏 - **原因**：Velocity 4.x 依赖 **Adventure 5.x**，其中 `ClickEvent.Action` 由枚举改为泛型接口，旧版本使用的 `ClickEvent.Action.OPEN_URL` 等常量已被移除。插件构建认证链接（点击打开验证网页）时抛出 `NoSuchFieldError: ClickEvent$Action does not have member field OPEN_URL`，HWID 验证流程中断 - **修复内容**： - 点击事件改用 Adventure 4.x / 5.x **均存在且字节码签名兼容**的静态工厂：`ClickEvent.openUrl / runCommand / suggestCommand / copyToClipboard` - 新增 `AdventureText` 兼容层：颜色 / 点击 / 悬浮构建全程 `Throwable` 兜底，任何版本差异只**降级为纯文本**，绝不阻断玩家进入 - 玩家加入检查与 HWID 验证循环改为捕获 `Throwable`，链接类错误（`LinkageError`）不再中断流程 - 新增兼容性校验任务：`gradlew adventure5Check`（真实 Adventure 5.x 运行时校验）、`gradlew compileJavaV4Check`（Velocity 4.x 编译校验，需 JDK 25） **升级建议**：Velocity 4.x 用户请升级到 **2.4.0+**；Velocity 3.x 用户同样兼容，可直接升级。BungeeCord 用户不受此问题影响。 --- ### 环境支持 | 平台 | 支持版本 | |---|---| | Velocity | 3.x / 4.x（Adventure 4.x / 5.x） | | BungeeCord | 1.20.1+ | | Java | 17+ | ### 本次更新 - 新增：Velocity 4.x（Adventure 5.x）兼容支持 - 修复：Velocity 4.x 下开启 HWID 导致玩家无法进入游戏（`NoSuchFieldError`） - 优化：玩家加入检查与 HWID 流程全链路 `Throwable` 兜底，插件内部错误不再阻断玩家进入 - 延续：验证未完成期间每 5 秒重发认证链接并附剩余秒数红字倒计时（首次发送不带倒计时） ### 命令 | 命令 | 说明 | |---|---| | `/ndpr` / `/ndpr help` | 帮助信息 | | `/ndpr d` / `/ndpr download` | 手动下载封禁数据库 | | `/ndpr ban <玩家> <原因>` | 提交封禁审核 | | `/ndpr check <ID/IP/UUID>` | 检查封禁状态（模糊建议点击直接查询） | | `/ndpr reload` | 重载配置并下载数据库 | | `/ndpr cu` / `/ndpr checkupdate` | 检查插件更新 | | `/ndpr auth <玩家>` | 强制触发设备验证 | ### 安装 - **Velocity**：放入 `plugins/`，编辑 `plugins/ndpr/config.toml` - **BungeeCord**：放入 `plugins/`，编辑 `plugins/NDPReforged-Proxy/config.toml` - 权限节点：`ndpr.admin` - 首次启动自动生成配置文件，填写 `token` 与 `onlinemode` 后 `/ndpr reload` ### 构建 JDK 17 + `gradlew.bat build`，输出 `build/libs/ndpr-proxy.jar` Made with ❤️ by NDPReforged Team

## v2.1.1 ### 适配 MC 26.3 - 新增 dpr-26.3-2.1.1-universal.jar（Fabric / Forge 66.0.10 / NeoForge 26.3.0.70-beta，Java 25） ### 修复服务端 API 鉴权兼容问题（重要） NDPR 服务端 API 的 **POST 端点只从 JSON 请求体读取 token**（仅携带 `Authorization` 头会返回 `Missing token` / 401）。 v2.1.0 及更早版本因此受影响的功能： - HWID 设备验证（`/hwid/upd`、`/hwid/upd/check`、`/hwid/upd/cancel`、`/hwid/has`） - 封禁审核提交（`/check/uploader`） - 拦截统计上报（`/stats/a`） - 封禁库下载完成清理（`/bans/download/done`） v2.1.1 中所有 POST 请求均在 **请求体** 携带 `token`，同时保留 `Authorization` 头以兼容旧服务端； `GET /bans/download` 同时携带查询参数与请求头。另外加固了封禁审核响应解析（API 返回 HTML 错误页时不再抛异常）。 ### 版本矩阵（同一版本全部服务端在同一 release） | MC | 覆盖 | Jar | |----|------|-----| | 1.20.4 | 1.20.4 | ndpr-1.20.4-2.1.1-universal.jar | | 1.20.6 | 1.20.5-1.20.6 | ndpr-1.20.6-2.1.1-universal.jar | | 1.21.1 | 1.21-1.21.1 | ndpr-1.21.1-2.1.1-universal.jar | | 1.21.4 | 1.21.2-1.21.4 | ndpr-1.21.4-2.1.1-universal.jar | | 1.21.6 | 1.21.5-1.21.6 | ndpr-1.21.6-2.1.1-universal.jar | | 1.21.9 | 1.21.7-1.21.9 | ndpr-1.21.9-2.1.1-universal.jar | | 1.21.11 | 1.21.10-1.21.11 | ndpr-1.21.11-2.1.1-universal.jar | | 26.2 | 26.1-26.2 | ndpr-26.2-2.1.1-universal.jar | | 26.3 | 26.3+ | ndpr-26.3-2.1.1-universal.jar | 每个 jar 同时支持 Fabric / Forge / NeoForge 三种服务端，放入 `mods/` 即可（无需区分加载器）。

## NDPR-BE v2.1.0 - 基岩版全平台客户端 同一版本的所有服务端客户端打包在同一个 Release 中： | 平台 | 文件 | 说明 | |------|------|------| | Nukkit / PowerNukkitX | `ndpr-nukkit-2.1.0.jar` | Java 8+，放入 plugins/ | | Allay | `ndpr-allay-2.1.0.jar` | JDK 21，放入 plugins/ | | gomint | `ndpr-gomint-2.1.0.jar` | Java 11+，放入 plugins/ | | BDSpyrunner / BDSpyrunnerW | `ndpr-bdspyrunner-2.1.0.py` | 放入 plugins/ | | BDSX | `ndpr-bdsx-2.1.0.zip` | npm 插件源码包，npm install 后构建 | | LeviLamina | `ndpr-levilamina-2.1.0.zip` | C++ 插件源码包，xmake 构建 | ### 功能 - 多维封禁（ID / UUID/XUID / IPv4 / IPv6）+ 云端跨服联防 - 玩家进服自动检测与踢出 + 拦截统计上报 - 游戏内封禁审核提交、封禁查询（含模糊建议） - HWID 网页设备验证（冻结防逃逸 + 超时踢出 + 免验缓存） - 封禁库定时自动更新、插件更新检查、中英双语 ### 使用 1. 下载对应平台文件，按各目录 README 安装 2. 启动后控制台获取服务器 UUID → https://ndpreforged.com 绑定邮箱获取 Token 3. 填入 config.json 后游戏内执行 `/ndpr reload` ### 构建 Java 三平台（Nukkit/Allay/gomint）共享 `java-core` 业务核心，源码见仓库各目录。