NeaCommand

插件

· 作者 NeaCol

基于 LuckPerms 的现代命令白名单和整洁的 Tab 补全系统。

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

最新 1.1.0 · 26.3 · Folia / Paper

一键开服(送7天)

⚡ NeaCommand

由 LuckPerms 驱动的现代、超高速命令白名单与整洁的 Tab 补全系统。


? 概述

NeaCommand 是一款先进的、高性能的命令保护与 Tab 补全清理插件,专为现代 Minecraft 服务器设计。它从底层构建以无缝集成 LuckPerms,消除了维护冗余权限和庞大命令列表的烦恼。

传统的命令拦截器要么无法在 Tab 补全中隐藏敏感命令,要么会破坏插件子命令,或者拖慢主服务器线程。NeaCommand 在数据包层面拦截命令,动态解析 LuckPerms 继承关系,同时保持自动补全的整洁。


✨ 主要功能

  • ?️ 全面命令保护:限制所有玩家等级的未授权命令,零绕过漏洞。
  • ? 原生 LuckPerms 继承:按 LuckPerms 组定义允许的命令。如果一个等级继承了另一个等级,它将自动继承所有允许的命令——无需重复列表!
  • ? 整洁的 Tab 补全过滤:完全消除烦人的自动补全,例如 minecraft:、插件命名空间前缀(essentials:、worldguard:)以及语法窥探(/version、/plugins、/about)。
  • ? 交互式员工警报:当玩家尝试执行未授权的命令时,工作人员会收到实时的 MiniMessage 通知,并带有可点击的 [ALLOW] 按钮,可立即将该命令添加到玩家的组中。
  • ? 智能权限解析:NeaCommand 识别任何命令所需的底层插件权限,并提供直接指向 LuckPerms 的可点击建议([ADD PERMISSION])!
  • ? 完整的 Folia & Paper 优化:采用线程安全调度(SchedulerUtils)构建,与 Paper、Purpur 和 Folia 多线程 tick 区域实现 100% 原生兼容。
  • ? 多语言支持:开箱即用的完整国际化,包含英语 (en) 和西班牙语 (es)。支持通过 MiniMessage 格式化和渐变进行完全自定义。
  • ? bStats 遥测:匿名使用指标(插件 ID: 34681)。

? 命令

命令 权限 描述
/nc add <group> <command> [hidden] neacommand.admin 将允许的命令添加到某个组。将 hidden 设置为 true 以允许使用但在 Tab 补全中隐藏它。
/nc remove <group> <command> neacommand.admin 从组中移除允许的命令。
/nc list <group> neacommand.admin 显示指定组当前白名单中的所有命令。
/nc check <player> neacommand.admin 检查玩家的主要组、继承组、允许的命令数量及绕过状态。
/nc sync neacommand.admin 将配置的组与活动的 LuckPerms 组同步。
/nc reload neacommand.admin 在不重启的情况下重新加载 config.yml、groups.yml 和语言文件。
/nc help neacommand.admin 显示命令指南和子命令列表。

别名: /neacommand, /nc, /nea


? 权限

权限 默认值 描述
neacommand.admin op 授予管理命令(/nc reload、/nc add、/nc check 等)的访问权限。
neacommand.admin.notify op 当玩家尝试执行被阻止的命令时,接收可点击的警报。
neacommand.bypass op 完全绕过命令白名单和 Tab 补全过滤。

⚙️ 配置文件

config.yml

# ----------------------------------------------------------------------
# NeaCommand - 主配置文件
# 由 LuckPerms 驱动的高级命令白名单 & Tab 补全拦截器
# ----------------------------------------------------------------------

# 位于 'lang/' 目录内选定的语言文件。
# 开箱即用:'en' (英语), 'es' (西班牙语)。
language: "en"

# 启用调试模式以在控制台中记录命令验证和组查找。
debug-mode: false

# 如果为 true,服务器操作员 (OP) 将自动绕过所有白名单规则。
bypass-op: true

# 通过 bStats 启用匿名指标收集。
metrics: true

# 始终对所有玩家可用的命令,无论其组别如何。
# 对于身份验证插件、基本大厅命令或别名至关重要。
# 不要包含前导 '/' 字符。
global-whitelist:
  - "login"
  - "register"
  - "l"
  - "reg"
  - "neacommand"
  - "nc"
  - "nea"

groups.yml

# ----------------------------------------------------------------------
# NeaCommand - 组配置文件
# 命令白名单直接映射到 LuckPerms 组名。
#
# 语法指南:
#   - "/command"         : 玩家可以运行此命令,且它会出现在 Tab 补全中。
#   - "/command:hidden"  : 玩家可以运行此命令,但它在 Tab 补全中保持 HIDDEN(隐藏)。
#   - "/warp spawn"      : 允许执行该特定子命令。
#   - "*"                : 授予所有命令的访问权限(绕过)。
#
# 注意:LuckPerms 继承会自动应用!
# 例如,如果 'vip' 在 LuckPerms 中继承自 'default',
# VIP 玩家将自动获得 'default' 中所有命令的访问权限。
# ----------------------------------------------------------------------

groups:
  default:
    commands:
      - "/help"
      - "/rules"
      - "/spawn"
      - "/msg"
      - "/r"
      - "/tpa"
      - "/tpaccept"
      - "/tpdeny"
      - "/pay"
      - "/balance"
      - "/baltop"
  vip:
    commands:
      - "/fly"
      - "/feed"
      - "/hat"
      - "/workbench"
  staff:
    commands:
      - "/kick"
      - "/mute"
      - "/ban"
      - "/warn"
      - "/vanish:hidden"

? 依赖要求

  • 平台: Paper、Purpur 或 Folia(1.20 - 1.21.4+)
  • Java: Java 21 或更高版本
  • 依赖项: LuckPerms (v5.4+)

?‍? 贡献与作者

由 NeaCol 用 ❤️ 开发。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源