常见问题

解答关于 NDPR 的常见问题

基础问题

Q: NDPR 是什么？

NDPR(ndpr)是专业的跨平台Minecraft服务器联合封禁系统，支持Velocity、Spigot、Paper、Bukkit、Fabric、Forge、MCDR等多种服务端。提供玩家封禁、IP封禁、数据同步、Token验证等功能，让服务器管理更简单。

Q: 支持哪些服务端？

服务端支持状态
MCDR 2.8+已支持
Java Spigot / Bukkit / Paper / Folia已支持
Fabric / Forge / NeoForge（Mod）已支持
Velocity / BungeeCord（代理端）已支持
LeviLamina / BDSX / BDSpyrunner / gomint / Allay / Nukkit（基岩版）已支持

Q: 如何获取Token？

  1. 打开浏览器，访问 NDPR官网
  2. 点击上方或左上角的 服主管理
  3. 登录/注册账号(温馨提示:滑块验证拖慢一点)
  4. 点击左侧的 Token管理
  5. 在上方"创建新Token"处填写uuid，然后生成Token

    6. Q: 如何获取UUID？

    所有平台首次启动自动获取 UUID（无需手动填写），可从启动日志或配置文件中查看：

    • MCDR：config/ndpr/config.toml → uuid
      • Bukkit/Paper：plugins/NDPR-Bukkit/config.yml → uuid
        • Mod：.minecraft/config/ndpr.json → uuid
          • 代理端：plugins/ndpr/config.toml → uuid
            • 基岩版：plugins/ndpr/config.json → uuid

              • 技术问题

              Q: API 返回 401 错误？

              可能原因：

              1. Token 不存在或已失效
              2. 缺少必要权限

                3. 解决方法：

                • 重新生成 Token
                  • 申请上传权限

                    • Q: 封禁数据不同步？

                    检查：

                    1. 检查Token是否正确配置
                    2. 同步间隔是否合理
                    3. 网络连接是否正常

                      4. Q: 支持离线服务器吗？

                      支持。设置 onlinemode: false 即可使用离线模式封禁：

                      找到服务器类型配置项,填写服务器类型

                      • 内容示例
                        • toml
                        onlinemode = false # true = 正版服, false = 离线服

                        Q: 如何升级 NDPR？

                        • MCDR端
                          • Bash
                          !!NDPR cu
                          • 插件端(JE) / Mod / 代理端 / 插件端(BE)
                            • Bash
                            /ndpr cu

                            然后根据提示操作

                            Q: HWID 设备验证是什么？

                            HWID（设备指纹）验证用于反作弊机器验证：玩家进服后被冻结，通过浏览器采集设备指纹（Canvas + GPU ID）完成验证后放行，未通过验证或设备被封禁则被踢出。

                            • 配置 check_hwid: true 启用
                              • 验证通过的设备在 check_interval 天内免检
                                • 验证链接可点击直达（MCDR / Bukkit / Mod / 代理端 / 基岩版均支持）

                                  • 计费与支持

                                  Q: NDPR 是免费的吗？

                                  NDPR 可以免费使用。

                                  Q: 如何获取支持？