ModBlocker

插件

· 作者 az_ttv

限制服务器上允许的模组。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

ModBlocker

限制服务器上允许使用的模组。


? 概览

ModBlocker 是一款轻量但功能强大的 Paper 插件,赋予服务器管理员完全控制玩家可使用哪些客户端模组的权限。无论你是运行竞技 PvP 服务器、RPG 体验服,还是追求原版一致性的社区,ModBlocker 都能确保所有玩家在一个公平且统一的环境中游戏。


⚙️ 特性

  • 模组检测 — 通过基于通道的握手检查来检测客户端修改(例如 wurst:init 用于识别 wurst 客户端)
  • 黑名单与白名单模式 — 选择直接屏蔽特定模组,或通过 use-whitelist-mode 仅允许经过批准的列表中的模组
  • 按权限绕过 — 授予受信任的玩家或工作人员使用 modblocker.bypass 权限节点以绕过限制的能力
  • 自定义踢出消息 — 使用带有 {player} 和 {mods} 占位符的 MiniMessage 格式定义完全可定制的踢出消息
  • 可配置的检测延迟 — 在加入时通道检查前可调整的刻数延迟,因为模组通道并非立即注册
  • 调试模式 — 启用调试日志以在控制台中查看所有已注册的玩家通道
  • 重载支持 — 无需重启服务器即可通过 /modblocker reload 运行时重载配置

? 命令

命令 描述 权限
/modblocker list 根据当前活动模式显示所有当前被屏蔽或列入白名单的模组 modblocker.admin
/modblocker check <player> 检查已连接玩家注册了哪些模组 modblocker.admin
/modblocker add <mod> 在运行时将模组添加到当前的黑名单或白名单中 modblocker.admin
/modblocker remove <mod> 在运行时从当前的黑名单或白名单中移除模组 modblocker.admin
/modblocker reload 从磁盘重载插件配置 modblocker.admin

? 权限

权限节点 描述 默认值
modblocker.admin 授予所有 ModBlocker 命令(list, check, add, remove, reload)的访问权限 OP
modblocker.bypass 绕过所有模组限制 — 适用于受信任的玩家或工作人员 false

? 配置

# ============================================================
#  ModBlocker — 配置
#  阻止携带特定客户端模组加入游戏的玩家
# ============================================================
settings:
  # 加入后检查玩家通道的延迟(单位:刻)。
  # 推荐 40 刻(2 秒)—— 通道不会立即注册。
  check-delay-ticks: 40
  # 白名单模式:如果为 true,则只允许 'whitelisted-mods' 中的模组。
  # 如果为 false,则只屏蔽 'blocked-mods' 中的模组(黑名单模式)。
  use-whitelist-mode: false
  # 启用调试日志以在控制台中查看所有已注册的通道
  debug: false

# 黑名单模式 — 常见作弊客户端 ID:
blocked-mods:
  - wurst
  - meteor-client
  - inertia
  - aristois
  - kami
  - lambda
  - xray
  - killaura

# 白名单模式 — 仅允许以下模组(minecraft/paper/bukkit 始终被允许)
whitelisted-mods:
  - fabric
  - optifine
  - sodium
  - lithium
  - iris

# 消息 — MiniMessage 格式 | 占位符:{player}, {mods}
messages:
  kick-message: |
    <red><bold>ModBlocker</bold></red>
    <white>检测到未授权的模组:</white>
    <red>{mods}</red>
    <yellow>请在加入前移除它们。</yellow>
  no-permission: "<red>你没有权限使用此命令。"

?️ 要求

  • 服务端软件: Paper (1.19+)
  • Java: Java 17 或更高版本
  • 依赖项: 无 — 完全独立运行

发现错误或有任何功能请求?请在 Discord 上联系我!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源