查看“NullProtect”的源代码

{{Plugin Infobox
|外文名     = NullProtect
|作者       = ArcNode
|插件类型   = Bukkit
|最新版本   = 1.4.0-1.21.4
|兼容服务端 = Paper, Folia
|前置插件   = packetevents（可选）
|源地址     = https://github.com/afn-ArcNode/NullProtect/
}}

== 功能 ==

此插件提供 HWID 黑白名单（需要客户端Mod），用户协议控制，账户激活和游戏内人机验证

== 配置文件 ==
<syntaxhighlight lang="yaml>
database:
  type: SQLite

  # MySQL
  host: "127.0.0.1"
  port: 3306
  username: NullProtect
  password: NullProtect
  database: NullProtect

# 线程池设定（通常不需要更改）
async:
  # fixed or virtual
  mode: fixed

  # Core pool size
  core: 10
  # Max threads
  max: 30

# HWID验证
hwid:
  enabled: false

  # 超时验证检测间隔秒数
  check-interval: 10
  # 最长等待秒数
  timeout: 10

  # 启动HWID绑定（强制玩家使用同台设备登录）
  bind: false
  # whitelist（白名单） 或 blacklist（黑名单） 或 none（无，主要用于只使用绑定时）
  mode: none
  # HWID封禁玩家登录或在线时执行的操作
  on-blacklist:
    - "ban %player% HWID banned from this server"

# 账户级激活
activation:
  enabled: false
  # 激活等待秒数
  timeout: 10

  # 未激活时阻止的操作（聊天，移动，互动）
  blocking:
    chat: true
    move: true
    interact: true

# 仿冒插件命令
fake:
  enabled: true
  # 伪造 /version 命令的补全
  fake-version: true
  # 向 /version 命令添加的假插件
  # 执行命令会生成假的版本信息
  fake-version-plugins:
    NotProtect:
      author: AFterNode
      version: 114.514
  # 隐藏 NullProtect 插件本身
  hide-self: true

# 模组文件检查
mods:
  enabled: false

  # 超时检测间隔秒数
  check-interval: 10
  # 超时秒数
  timeout: 10

# 游戏内人机验证
captcha:
  enabled: false

  chest: true # 简单箱子物品点击检测
  furnace: true # 熔炉槽位点击检测
  book: true # 书本颜色点击检测
  image: false  # (BETA) 启用图片检测，会创建多张地图，仅支持128*128大小

  # 触发自动人机验证的最小间隔秒数
  min-interval: 600
  # 人机验证超时时间
  timeout: 30

  # 自动人机验证触发概率 (1-100)
  auto:
    lumbering: 5
    mining: 5
    mining_deepslate: 5
    fishing: 10

# 用户协议
eula:
  enabled: false

  # text, external or manually
  # 使用 TEXT 模式时, 将会为玩家打开如下书本
  # 使用 EXTERNAL 模式时, 会向玩家发送如下配置的URL
  # 使用 MANUALLY 模式时, 需要手动实现用户协议界面，插件只管理玩家冻结和协议状态
  mode: text
  # TEXT 模式的书本内容
  # MiniMessage 格式
  text:
    - |
      PAGE 1
      LINE 2
    - |
      PAGE 2
      LINE 2
  # EXTERNAL 模式的链接
  link: "https://github.com/"

  # 玩家同意协议时发送的消息 (MiniMessage)
  on-accept:
    - "EULA Accepted"

  # 玩家拒绝协议时的踢出消息 (MiniMessage)
  deny-kick:
    - "EULA Rejected"
</syntaxhighlight>

== Mod ==

使用 HWID 验证和 Mods 文件验证时需要安装客户端 Mod，需要使用这些功能时建议自行对插件的通信进行更改和混淆后再使用（需遵循 Apache-2.0 协议）

Mods 支持 NeoForge 和 Fabric 的 1.21.1，1.21.3，1.21.4 版本

== 命令 ==

=== /nullprotect ===

别名：'''nprot'''

* '''/nprot refreshCaches''' 刷新数据库缓存
* '''/nprot info <player>''' 获取用户信息（HWID，UUID）
* '''/nprot hwid [add|remove] <hwid>''' 添加/删除 HWID 黑白名单
* '''/nprot unbind [player]''' 清除玩家的 HWID 绑定
* '''/nprot activation'''
** '''/nprot activation check <player>''' 检查玩家的激活状态
** '''/nprot activation generate''' 生成激活码
* '''/nprot mods <player>''' 设置使用某个玩家的 Mods 文件特征作为验证标准
* '''/nprot captcha <player>''' 手动对某个玩家触发人机验证

=== /eula ===
* '''/eula accept''' 同意用户协议
其它参数均触发拒绝协议

=== /activate ===
* '''/activate <code>''' 激活当前账户

== 权限 ==

* '''nullprotect'''
** '''nullprotect.bypassMods''' 绕过 Mod 文件检查
** '''nullprotect.bypassCaptcha''' 不自动触发人机验证
** '''nullprotect.commands''' /nprot 命令的使用权限

[[分类:管理]][[分类:安全]]