BE插件配置
在基岩版服务端配置 NDPR 插件
概述
本页面介绍如何在基岩版 Minecraft 服务端（BDS、BDSX、BDX等）上配置 NDPR 封禁同步插件。
<div class="custom-block warning">
<div class="custom-block-title"><i class="fas fa-exclamation-triangle"></i> 开发中</div>
基岩版插件目前处于开发阶段，部分功能可能不可用。
</div>
支持的服务端
| 服务端 | 状态 | 最低版本 |
|---|---|---|
| BDS (Bedrock Dedicated Server) | 开发中 | 1.19+ |
| BDSX | 开发中 | 1.19+ |
| BDSpyrunner | 计划中 | - |
| LiteLoaderBDS | 计划中 | - |
| Nukkit | 计划中 | - |
| PowerNukkitX | 计划中 | - |
安装
1. 下载插件
<div class="custom-block tip">
<div class="custom-block-title"><i class="fas fa-info-circle"></i> 提示</div>
基岩版插件下载链接将在正式版发布后提供。
</div>
2. 安装插件
Bash
# 解压到 BDS plugins 目录
unzip ndpr_be.zip -d BDS/plugins/
3. 配置
编辑 plugins/ndpr_config.json：
JSON
{
"api_url": "http://your-api-server:5030",
"token": "your_api_token",
"auto_ban": true,
"check_on_join": true,
"log_level": "info"
}
4. 重启服务端
Bash
stop
# 然后重新启动服务端
配置说明
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| api_url | string | - | NDPR API 服务器地址 |
| token | string | - | API 访问令牌 |
| auto_ban | boolean | true | 自动封禁检测到的玩家 |
| checkonjoin | boolean | true | 玩家加入时自动检查 |
| log_level | string | info | 日志级别 (debug/info/warn/error) |
功能特性
自动封禁
当玩家尝试加入服务器时：
手动封禁
在游戏内使用命令：
Text
/ndpr ban <玩家> [原因]
/ndpr unban <玩家>
/ndpr reload
日志记录
所有封禁操作都会记录到日志文件：
logs/ndpr.log - 插件运行日志故障排除
<div class="custom-block warning">
<div class="custom-block-title"><i class="fas fa-wrench"></i> 故障排除</div>
- 无法连接 API：检查 api_url 配置和网络连接<br>
- Token 无效：确保 Token 具有相应权限<br>
- 插件未加载：检查服务端日志是否有错误信息
</div>