EssentialsX Selectors: @a, @p, @r (Addon) - EssentialsX 选择器扩展：@a、@p、@r

💡EssentialsX-Target-Selectors

本插件为 EssentialsX 命令添加了 @a、@p 和 @r 等目标选择器支持！同时适用于命令方块和控制台。

❓它有什么用？

广受欢迎的插件 EssentialsX 从未原生支持像 @a 或 @p 这样的目标选择器。尤其是在使用命令方块时，这些选择器会非常有用。现在，通过本插件，这一切都成为了现实。

支持范围

• 玩家：在游戏内聊天框或命令中使用。
• 控制台：在服务器控制台中使用。
• 命令方块：在命令方块中直接使用。

⭐使用方法

安装极其简单。只需将本插件放入服务器的 plugins 文件夹，然后重启服务器即可。无需任何命令、配置或额外设置。

可用选择器

• @a - 所有在线玩家
• @p - 距离最近的玩家
• @r - 随机玩家
• @s - 你自己（执行者）

**注意**

• @p 和 @s 不能在服务器控制台中执行。
• @s 不能在命令方块中使用。

🎮命令示例

未安装插件时（普通 EssentialsX）

• /egive @a dirt -> 提示：未知玩家 @a
• /essentials:kill @p -> 提示：未知玩家 @p
• /give @r diamond 5 -> 提示：未知玩家 @r

安装本插件后

• /egive @a dirt -> 给予服务器上所有玩家一个泥土
• /essentials:kill @p -> 击杀距离最近的玩家
• /give @r diamond 5 -> 给予一名随机玩家 5 个钻石

高级选择器参数

你还可以为目标选择器添加参数，实现更精确的筛选。

**示例**

• /kill @a[distance=..8,tag=KillMe] - 击杀 8 格范围内所有带有 KillMe 标签的玩家。
• /feed @r[distance=..250] - 喂饱 250 格范围内的一名随机玩家。

如需了解所有可用参数及其用法，请查阅 [Minecraft Wiki](HERE)。

🔧权限节点

所有权限默认授予所有玩家。

• essxselectors.use - 允许使用任何选择器（基础权限）。
• essxselectors.all - 允许使用 @a 选择器。
• essxselectors.self - 允许使用 @s 选择器。
• essxselectors.random - 允许使用 @r 选择器。
• essxselectors.closest - 允许使用 @p 选择器。

✨重要须知与支持

依赖与声明

• 本插件不能替代 EssentialsX！ 你必须先安装原版的 [EssentialsX](EssentialsX) 插件，本插件才能正常工作。
• 本插件是一个非官方的 EssentialsX 扩展，未使用任何 EssentialsX 的源代码。

获取帮助

如果你需要支持、发现了漏洞，或者有功能建议，请在此处创建 Issue：[HERE](HERE)。我们会在 24 小时内尽力回复并提供帮助。

本指南介绍了如何在 Minecraft 命令中使用目标选择器参数（specifications）来精确筛选玩家。这些参数可以单独使用，也可以组合使用，以实现复杂的条件选择。

💡重要须知

• 所有参数均可在玩家、命令方块中使用。
• 控制台无法使用 distance 参数。
• 在方括号 [] 内编写参数时，切勿在参数名、等号或值之间添加空格，否则命令将无法正确解析。
• 错误示例：@a[gamemode = creative, tag= "Rat"]
• 正确示例：@a[gamemode=creative,tag=Rat]
• 如果同一个参数被多次指定，系统将采用最后一个写入的值。

🎮参数详解

gamemode

用于筛选处于特定游戏模式的玩家。

**可用值**

• creative (创造模式)
• survival (生存模式)
• adventure (冒险模式)
• spectator (旁观模式)

**语法**

• gamemode=<值>：选择处于该模式的玩家。
• gamemode=!<值>：选择不处于该模式的玩家。

**示例**

• /kill @a[gamemode=creative]：击杀所有处于创造模式的玩家。
• /feed @r[gamemode=!creative]：随机喂饱一个非创造模式的玩家。
• /tp @r[gamemode=sruvivol]：值无效，命令将报错。

level

用于筛选具有特定经验等级的玩家。

可用值：任意大于或等于 0 的整数。

**语法**

• level=<值>：选择经验等级等于该值的玩家。
• level=!<值>：选择经验等级不等于该值的玩家。

**示例**

• /kill @a[level=5]：击杀所有经验等级为 5 的玩家。
• /feed @r[level=!2]：随机喂饱一个经验等级不是 2 的玩家。
• /kill @a[level=cat]：值无效，命令将报错。

tag

用于筛选拥有特定记分板标签的玩家。

可用值：任意不包含空格的字符串。引号可用可不用。

**语法**

• tag=<值>：选择拥有该标签的玩家。
• tag=!<值>：选择没有该标签的玩家。

**示例**

• /kill @a[tag="KillMe"] 或 /kill @a[tag=KillMe]：击杀所有拥有 KillMe 标签的玩家。
• /feed @r[tag=!DontFeedMe]：随机喂饱一个没有 DontFeedMe 标签的玩家。
• /kill @a[tag=cool tag]：值包含空格，命令将报错。

team

用于筛选加入特定队伍的玩家。

可用值：任意不包含空格的字符串（通常为 Bukkit 队伍名）。

**语法**

• team=<值>：选择在该队伍中的玩家。
• team=!<值>：选择不在该队伍中的玩家。

**示例**

• /kill @a[team=KillMe]：击杀所有在 KillMe 队伍中的玩家。
• /feed @r[team=!IDontDeserveFood]：随机喂饱一个不在 IDontDeserveFood 队伍中的玩家。
• /kill @a[team=team name yes]：值包含空格，命令将报错。

distance

用于筛选与命令执行点处于特定距离内的玩家。

可用值：任意正整数。

**语法**

• distance=<值>：选择距离小于或等于该值的玩家。
• distance=!<值>：选择距离大于该值的玩家。

**示例**

• /kill @a[distance=10]：击杀所有在 10 格半径范围内的玩家（包括执行者自身）。
• /feed @r[distance=!20]：随机喂饱一个在 20 格半径范围之外的玩家。
• /kill @a[distance=dog]：值无效，命令将报错。

limit

用于限制最终被选中的目标数量。

可用值：任意正整数。此参数不支持 ! 取反语法。

**语法**

• limit=<值>：最多选择指定数量的目标。

**示例**

• /kill @a[limit=2]：最多击杀 2 个玩家。
• /kill @a[limit=rat]：值无效，命令将报错。

🔧参数组合使用

多个参数可以组合在一个选择器中使用，以实现更精确的筛选。参数之间用英文逗号 , 分隔。

**示例**

• /kill @a[distance=10,gamemode=creative]

击杀所有同时满足“在10格范围内”且“处于创造模式”的玩家。

• /feed @p[tag=Feedable,distance=!100]

喂饱最近的一个同时满足“拥有 Feedable 标签”且“不在100格范围内”的玩家。

• /kill @a[tag=!safe,level=!100,gamemode=!creative,distance=250,limit=5]

最多击杀 5 个玩家，条件是：没有 safe 标签、经验等级不是 100、不在创造模式、且在 250 格范围内。