⚡ 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 用 ❤️ 开发。
⚡ NeaCommand
Modern, ultra-fast command whitelist and clean tab-completion system powered by LuckPerms.
? Overview
NeaCommand is an advanced, high-performance command protection and tab-completion sanitization plugin engineered for modern Minecraft servers. Built from the ground up to integrate seamlessly with LuckPerms, it eliminates the headache of maintaining redundant permissions and massive command lists.
Traditional command blockers either fail to hide sensitive commands from tab-completion, break plugin subcommands, or lag your main server thread. NeaCommand intercepts commands at the packet level, dynamically resolving LuckPerms inheritance while keeping autocompletion spotless.
✨ Key Features
- ?️ Total Command Protection: Restrict unauthorized commands across all player ranks with zero bypass loopholes.
- ? Native LuckPerms Inheritance: Define allowed commands per LuckPerms group. If a rank inherits another rank, it automatically inherits all allowed commands—no duplicate lists needed!
- ? Clean Tab-Completion Filtering: Completely eliminates annoying autocompletions such as
minecraft:, plugin namespace prefixes (essentials:, worldguard:), and syntax snooping (/version, /plugins, /about).
- ? Interactive Staff Alerts: When a player attempts an unauthorized command, staff members receive real-time MiniMessage notifications with clickable
[ALLOW] buttons to instantly add the command to the player's group.
- ? Intelligent Permission Resolution: NeaCommand identifies the underlying plugin permission required for any command and provides clickable suggestions (
[ADD PERMISSION]) directly to LuckPerms!
- ? Full Folia & Paper Optimization: Built with thread-safe scheduling (
SchedulerUtils) for 100% native compatibility with Paper, Purpur, and Folia multi-threaded tick regions.
- ? Multi-Language Support: Complete internationalization out of the box with English (
en) and Spanish (es) included. Fully customizable with MiniMessage formatting and gradients.
- ? bStats Telemetry: Anonymous usage metrics (Plugin ID:
34681).
? Commands
| Command |
Permission |
Description |
/nc add <group> <command> [hidden] |
neacommand.admin |
Adds an allowed command to a group. Set hidden to true to allow usage while hiding it from tab-completion. |
/nc remove <group> <command> |
neacommand.admin |
Removes an allowed command from a group. |
/nc list <group> |
neacommand.admin |
Displays all currently whitelisted commands for the specified group. |
/nc check <player> |
neacommand.admin |
Inspects a player's primary group, inherited groups, allowed command count, and bypass state. |
/nc sync |
neacommand.admin |
Synchronizes configured groups with active LuckPerms groups. |
/nc reload |
neacommand.admin |
Reloads config.yml, groups.yml, and language files without restarting. |
/nc help |
neacommand.admin |
Displays the command guide and subcommands list. |
Aliases: /neacommand, /nc, /nea
? Permissions
| Permission |
Default |
Description |
neacommand.admin |
op |
Grants access to administrative commands (/nc reload, /nc add, /nc check, etc.). |
neacommand.admin.notify |
op |
Receives clickable alerts when players try to execute blocked commands. |
neacommand.bypass |
op |
Completely bypasses the command whitelist and tab-completion filtering. |
⚙️ Configuration Files
config.yml
# ----------------------------------------------------------------------
# NeaCommand - Main Configuration
# Advanced Command Whitelist & Tab-Completion Blocker powered by LuckPerms
# ----------------------------------------------------------------------
# Selected language file located inside the 'lang/' directory.
# Available out of the box: 'en' (English), 'es' (Spanish).
language: "en"
# Enable debug mode to log command verification and group lookups in console.
debug-mode: false
# If true, server operators (OP) automatically bypass all whitelist rules.
bypass-op: true
# Enable anonymous metrics collection via bStats.
metrics: true
# Commands that are ALWAYS accessible to all players, regardless of their group.
# Essential for authentication plugins, basic lobby commands, or aliases.
# Do NOT include the leading '/' character.
global-whitelist:
- "login"
- "register"
- "l"
- "reg"
- "neacommand"
- "nc"
- "nea"
groups.yml
# ----------------------------------------------------------------------
# NeaCommand - Groups Configuration
# Command whitelist mapped directly to LuckPerms group names.
#
# Syntax Guide:
# - "/command" : Player can run this command and it appears in Tab-Complete.
# - "/command:hidden" : Player can run this command, but it remains HIDDEN from Tab-Complete.
# - "/warp spawn" : Allows execution of that specific subcommand.
# - "*" : Grants access to all commands (bypass).
#
# Note: LuckPerms inheritance is automatically applied!
# For example, if 'vip' inherits from 'default' in LuckPerms,
# VIP players automatically gain access to all commands in '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"
? Requirements
- Platform: Paper, Purpur, or Folia (
1.20 - 1.21.4+)
- Java:
Java 21 or newer
- Dependencies: LuckPerms (
v5.4+)
?? Credits & Author
Developed with ❤️ by NeaCol.
评论 0
登录后参与评分
还没有评论,来抢沙发吧