命令与占位符

Regions 模块通过 /axs regions 和 /rg（别名 /axsrg）两个命令入口提供全部区域管理功能。/rg 为独立注册的缩写命令，自动转发到 regions 子命令处理。

玩家命令

玩家命令通过 /axs regions 或 /rg 执行，部分命令需要选区工具或区域权限。

命令	说明	权限
`/rg help`	显示帮助信息	无
`/rg status`	查看模块状态（已加载区域数、标志类型数）	无
`/rg menu`	打开玩家区域查看菜单（ArcartX UI）	无
`/rg wand`	获取选区工具	`axs.regions.select`
`/rg pos1`	设置选区点 1（当前站位）	`axs.regions.select`
`/rg pos2`	设置选区点 2（当前站位）	`axs.regions.select`
`/rg define <名称>`	用当前选区创建区域	`axs.regions.select`
`/rg redefine <名称>`	用当前选区重定义区域范围	区域所有者或 `axs.regions.admin`
`/rg remove <名称>`	删除区域	区域所有者或 `axs.regions.admin`
`/rg list [世界]`	列出区域（默认当前世界）	无
`/rg info <名称>`	查看区域详细信息	无
`/rg show`	切换区域边框常驻粒子可视化	无
`/rg flag <区域> <标志> <allow\|deny> [数据]`	设置区域标志	区域所有者或 `axs.regions.admin`
`/rg removeflag <区域> <标志>`	移除区域标志	区域所有者或 `axs.regions.admin`
`/rg flags <区域>`	查看区域所有标志	无
`/rg addowner <区域> <玩家\|g:组>`	添加所有者	区域所有者或 `axs.regions.admin`
`/rg removeowner <区域> <玩家\|g:组>`	移除所有者	区域所有者或 `axs.regions.admin`
`/rg addmember <区域> <玩家\|g:组>`	添加成员	区域所有者或 `axs.regions.admin`
`/rg removemember <区域> <玩家\|g:组>`	移除成员	区域所有者或 `axs.regions.admin`
`/rg priority <区域> <数字>`	设置区域优先级	区域所有者或 `axs.regions.admin`
`/rg parent <区域> <父区域\|none>`	设置父区域	区域所有者或 `axs.regions.admin`
`/rg tp <区域>`	传送到区域中心	无

命令详解

`/rg define`

用当前选区创建区域。创建者自动成为区域所有者。

/rg define <名称>

参数	必填	说明
名称	是	区域 ID（不区分大小写），同世界内不可重复

校验流程：选区完成 → 体积不超限 → 名称不重复 → 数量不超限（axs.regions.bypass.limit 绕过）→ 创建并清除选区。

`/rg flag`

设置区域标志，支持附加数据（如 greeting/farewell 自定义文本）。

/rg flag <区域> <标志> <allow|deny> [数据...]

参数	必填	说明
区域	是	区域 ID
标志	是	标志 Key（如 `pvp`、`block-break`、`greeting`）
allow\|deny	是	标志状态（也接受 `true`/`false`/`yes`/`no`）
数据	否	附加文本数据（greeting/farewell 的自定义消息）

示例：

/rg flag spawn pvp deny
/rg flag spawn greeting allow &6欢迎来到出生点！
/rg flag spawn block-break deny

`/rg addowner` / `/rg addmember`

添加区域所有者或成员，支持玩家名和权限组（g: 前缀）。

/rg addowner <区域> <玩家|g:组名>
/rg addmember <区域> <玩家|g:组名>

示例：

/rg addowner spawn Steve
/rg addmember spawn g:vip

权限组通过 axs.regions.group.<name> 权限节点识别。玩家拥有该权限节点时被视为属于对应组，享受成员豁免。

`/rg parent`

设置区域父区域，父区域必须与当前区域同世界，模块自动检测继承环。

/rg parent <区域> <父区域|none>

参数	必填	说明
父区域	是	父区域 ID，设为 `none` 移除父区域

`/rg show`

切换区域边框常驻粒子可视化。普通玩家仅看到自己拥有/参与的区域（黄色粒子），管理员（axs.regions.admin）可看到所有区域（紫色粒子）。按视距 48 方块半径裁剪，每 16 tick 刷新。

管理员命令

命令	说明	权限
`/rg admin`	打开管理员区域管理面板（ArcartX UI）	`axs.regions.admin`
`/axs reload regions`	重载模块配置	`arcartxsuite.admin`

管理员面板支持区域列表浏览、区域编辑（标志/成员/优先级/父区域）、区域创建/重定义/重命名/删除，以及世界规则管理（禁飞/禁活塞/禁交互的运行时切换）。

权限

权限节点	默认	说明
`axs.regions.select`	op	使用选区工具（左/右键选区、`/rg wand`）
`axs.regions.admin`	op	管理员权限，可管理任意区域、打开管理员面板
`axs.regions.bypass`	op	绕过所有区域保护（标志查询直接返回 ALLOW）
`axs.regions.bypass.limit`	op	绕过每玩家最大区域数量限制
`axs.regions.group.<name>`	-	区域权限组，玩家拥有此节点时属于对应组，享受成员豁免
`axs.essentials.fly.bypass`	op	绕过世界规则禁飞限制
`axs.essentials.interact.bypass`	op	绕过世界规则禁交互限制

axs.regions.bypass 是全局保护绕过——拥有此权限的玩家在任何区域都不受标志限制。axs.regions.bypass.limit 仅绕过区域数量限制，不影响保护逻辑。

PlaceholderAPI 占位符

Regions 模块当前 未注册 PlaceholderAPI 占位符。区域数据通过 ArcartX UI 面板和命令交互获取。

如需在其他插件中获取区域信息，可通过以下方式：

方式	说明
EventBus 事件	监听 `axs.regions.region_change` 事件获取玩家进出区域信息
命令输出	`/rg info <区域>` 获取区域详情
UI 面板	`/rg menu` 查看当前区域与个人区域列表

图形界面

Regions 模块提供两个 ArcartX UI 界面：

界面	打开方式	权限	功能
玩家菜单	`/rg menu`	-	查看当前区域、个人区域列表与选区状态
管理员面板	`/rg admin`	`axs.regions.admin`	区域创建/编辑/删除、标志与成员管理、世界规则管理

命令与占位符

本页目录