配置插件/MOD
1.获取UUID
MCDR端
- 方法一:从启动日志获取
- 内容示例
- 方法二:从配置文件获取(第二次启动后)
- 目录: MCDR根目录\config\ndpr\config.toml
- 找到UUID配置项
- 打开浏览器，访问 NDPR官网
- 点击上方或左上角的 服主管理
- 登录/注册账号(温馨提示:滑块验证拖慢一点)
- 点击左侧的 Token管理
- 在上方"创建新Token"处填写uuid，然后生成Token
- (可选)点击左侧 上传权限,点击你的Token旁的申请上传权限,等待审核
text
[MCDR] [20:21:33] [TaskExecutor/INFO] [ndpr]: 服务器类型: xx
[MCDR] [20:21:33] [TaskExecutor/INFO] [ndpr]: UUID: xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx
[MCDR] [20:21:34] [TaskExecutor/INFO] [ndpr]: NDPR插件已加载
toml
uuid = "xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx"
插件端(JE) / Mod / 代理端 / 插件端(BE)
所有平台首次启动都会自动获取 UUID 并写入配置文件，无需手动填写。如需手动确认：
| 平台 | 配置文件位置 | 字段 |
|---|---|---|
| Bukkit/Paper | plugins/NDPR-Bukkit/config.yml | uuid |
| Mod | .minecraft/config/ndpr.json | uuid |
| Velocity | plugins/ndpr/config.toml | uuid |
| BungeeCord | plugins/NDPReforged-Proxy/config.toml | uuid |
| BE 平台（BDSpyrunner/BDSX/LeviLamina/Nukkit/Allay/gomint） | plugins/ndpr/config.json | uuid |
2.获取Token
3.配置Token
找到配置文件中的 Token 配置项,填写 Token
MCDR端
目录: MCDR根目录\config\ndpr\config.toml
toml
token = "xxxxxxxxxxxxxxxxxxxx"
插件端(JE) / Mod / 代理端 / 插件端(BE)
| 平台 | 配置文件 | 字段 |
|---|---|---|
| Bukkit/Paper | plugins/NDPR-Bukkit/config.yml | token |
| Mod | .minecraft/config/ndpr.json | token |
| Velocity / BungeeCord | plugins/ndpr/config.toml | token |
| BE 平台 | plugins/ndpr/config.json | token |
注意：Token 用于启用封禁功能，如不配置则插件不会执行封禁检查。
4.配置服务器类型
找到服务器类型配置项,填写服务器类型（正版/离线）
MCDR端
目录: MCDR根目录\config\ndpr\config.toml
toml
onlinemode = true # true = 正版服, false = 离线服
插件端(JE) / Mod / 代理端 / 插件端(BE)
| 平台 | 配置文件 | 字段 |
|---|---|---|
| Bukkit/Paper | plugins/NDPR-Bukkit/config.yml | onlinemode（必填） |
| Mod | .minecraft/config/ndpr.json | onlinemode（必填） |
| Velocity / BungeeCord | plugins/ndpr/config.toml | onlinemode（留空使用代理自身模式） |
| BE 平台 | plugins/ndpr/config.json | onlinemode（Bedrock 统一 Xbox 登录，透传） |
注意：Java 版各平台 onlinemode 为必填，否则插件不会正常加载。5.其他配置项
| 配置项 | 说明 | 默认 |
|---|---|---|
api_url | API 地址 | https://api.ndpreforged.com |
language | 语言（zh_CN / en_us） | zh_CN |
download_interval | 封禁库自动更新间隔（秒），0=禁用 | 900 |
check_hwid | 启用 HWID 设备验证 | false |
check_interval | 验证通过后免检天数 | 3 |
fail_closed | 封禁库缺失时拒绝进服（安全优先） | false |
verify_timeout | HWID 验证超时（秒，30~600） | 60 |
freeze_interval | 验证期间钉回坐标间隔（秒，1~60） | 1 |