EasyCommandBlocker - 简易指令屏蔽器

EasyCommandBlocker 是一款轻量高效的指令管理插件，它允许你完全阻止特定指令的执行，并可从聊天栏的 Tab 补全中隐藏这些指令。你也可以定义仅允许显示的指令列表，实现精细化的指令控制。

💡核心特性

• 指令管理：支持通过列表完全阻止指令，或将其设为仅允许的指令白名单。
• Tab 补全控制：可隐藏被阻止指令的 Tab 补全提示，或仅为玩家显示其有权限使用的特定指令。
• 跨版本兼容：专为支持多版本服务器设计，经过 ViaVersion、ViaBackwards、ViaRewind 测试，可在 1.8 至 1.21 版本中稳定隐藏 Tab 补全。
• 多平台支持：完美运行于 Spigot、Paper、Purpur、Waterfall 及 Velocity 服务器。
• 自定义动作：当玩家使用被阻止的指令时，可触发多种惩罚或提醒动作。
• 分组配置：可为不同权限组的玩家配置不同的 Tab 补全指令列表。

动作类型

当指令被阻止时，可以执行以下一种或多种动作

• 发送消息 (message)
• 发送标题消息 (title)
• 播放音效 (playsound)
• 给予药水效果 (give_potion_effect)
• 执行控制台指令 (console_command)

🎮安装与使用

Spigot/Paper 服务器

• 下载插件，将其放入服务器的 plugins 文件夹。
• 重启服务器。插件将管理游戏服务器内的指令。

Waterfall 和 Velocity 服务器

• 下载插件，将其放入代理服务器的 plugins 文件夹。
• 重启代理。插件将管理代理层面的指令（如 BungeeCord 指令）。
• 你可以同时在游戏服务器和代理服务器上安装此插件以实现全面控制。

🔧配置文件详解 (`config.yml`)

主要配置选项如下

# 是否将 commands 列表作为白名单（仅允许列表内的指令）
use_commands_as_whitelist: false

# 要阻止的指令列表
commands:
  - "/?"
  - "/ver"
  - "/version"
  - "/plugins"
  - "/pl"
  - "/me"
  - "/about"

# 是否阻止所有包含冒号“:”的指令（如 /minecraft:me）
block_colon_commands: false

# 是否在 OP 玩家加入时通知插件更新
update_notify: true

# 是否为网络模式（在后端服务器设置，当代理和游戏服务器均安装 ECB 时启用）
is_network: false

# 是否启用旧版本（1.12-）兼容模式（需要 ProtocolLib）
legacy_support: false

Tab 补全分组配置

在 tab 部分，你可以为不同权限的玩家定义不同的 Tab 补全指令列表。

tab:
  default:
    priority: 0
    commands: [] # 默认组不显示任何指令
  vip:
    priority: 1
    extends: default # 继承 default 组的设置
    commands:
      - "/home" # VIP 组玩家在 Tab 补全中可以看到 /home

• 玩家需要拥有 easycommandblocker.tab.<组名> 权限才能使用对应分组的 Tab 补全。
• priority 决定当玩家拥有多个组权限时的优先级，数字越高越优先。
• extends 允许一个分组继承另一个分组的指令列表。

自定义指令动作

你可以在 custom_commands_actions 部分，为特定的被阻止指令设置独特的惩罚动作，而非使用默认动作。

custom_commands_actions:
  example1:
    commands:
      - "/ver"
      - "/version"
    actions:
      - "console_command: kick %player% You can't see the version of the server!"

✨动作格式参考

• 发送消息：

message: &8[&b&lECB&8] &c你不能使用这个指令。

• 执行控制台指令：

console_command: say %player% 试图使用违规指令。

• 播放音效：

playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1

格式：音效;音量;音高

• 发送标题：

title: 20;40;20;&c警告;&7请勿使用此指令！

格式：淡入(刻);停留(刻);淡出(刻);标题;副标题

• 给予药水效果：

give_potion_effect: BLINDNESS;180;1

格式：效果类型;持续时间(刻);效果等级

❓重要提示与常见问题

• 测试前请取消 OP：OP 玩家会绕过所有限制。测试时请先使用 /deop 取消自己的 OP 权限。
• Tab 补全限制：Tab 补全列表中只能显示已在服务器注册且玩家拥有使用权限的指令。这是 Minecraft 本身的限制，插件无法添加自定义指令到此列表。
• BungeeCord 不支持：本插件无法在原生 BungeeCord 上运行，仅支持 Waterfall 或 Velocity。
• 旧版本兼容：如需在 1.12 或更低版本服务器上使用完整功能，需设置 legacy_support: true 并安装 ProtocolLib。

⭐指令与权限

指令

• /easycommandblocker reload 或 /ecb reload - 重载插件配置。

权限

• easycommandblocker.admin - 允许使用 /ecb reload 指令。
• easycommandblocker.tab.<group> - 允许玩家使用指定分组的 Tab 补全列表。
• easycommandblocker.bypass.tab - 完全绕过 Tab 补全过滤。
• easycommandblocker.bypass.commands - 完全绕过被阻止的指令。

🔧开发者 API

插件提供了一个简单的事件 API：CommandBlockedEvent

示例代码

@EventHandler
public void onBlockedCommand(CommandBlockedEvent event) {
    Player player = event.getPlayer();
    String command = event.getCommand(); // 配置中检测到的指令
    String fullCommand = event.getFullCommand(); // 玩家使用的完整指令
}

***

请注意：如果在使用中遇到问题或发现漏洞，请通过私信或插件讨论帖联系开发者，我们会尽快处理。请勿在未寻求帮助前直接给予差评。