ArcartXSuite

主题

Regions 区域保护 ​

功能定位 ​

Regions 模块提供类 WorldGuard 的完整区域保护方案，支持 40+ 保护标志、按世界规则限制、成员权限管理和子区域继承。

核心特效 ​

分类功能
区域管理创建/删除/重定义/传送/列表/信息查看
选区工具木斧左/右键设置两点选区
标志系统40+ 区域保护标志，三态（allow/deny/none）
成员管理所有者/成员/权限组，按优先级和继承生效
子区域父区域继承，支持多层嵌套
世界规则按世界级别的禁飞/禁活塞/禁交互

UI 面板 ​

Regions 模块提供两个 ArcartX UI 面板，需要玩家安装 ArcartX 客户端 mod。

玩家区域菜单 ​

命令：/rg menu

页面功能
当前区域显示玩家所在区域的名称/世界/优先级/成员数/标志列表
我的区域玩家拥有或参与的区域列表，点击查看详情
区域详情范围坐标/体积/父区域/所有者/成员/标志详情

管理员面板 ​

命令：/rg admin
权限：axs.regions.admin

页面功能
区域列表所有区域（ID/世界/优先级/体积）+ 编辑/删除按钮
区域编辑成员管理（移除）+ 40+ 标志快速切换（允许/拒绝/清除三态）

前置要求

UI 面板需要玩家安装 ArcartX 客户端 mod。未安装时命令会提示"UI 功能不可用"。

命令 ​

主入口：/axs regions <子命令>，或使用缩写 /rg <子命令>

两种写法完全等价，例如 /rg define myregion = /axs regions define myregion

UI ​

命令说明权限
/rg menu打开区域查看菜单无
/rg admin打开区域管理面板axs.regions.admin

区域 CRUD ​

命令说明权限
/rg define <名称>用当前选区创建区域axs.regions.select
/rg remove <名称>删除区域所有者或 axs.regions.admin
/rg redefine <名称>用新选区重定义区域范围所有者或 admin
/rg list [世界]列出区域axs.regions.admin
/rg info <名称>查看区域详细信息所有人
/rg tp <名称>传送到区域中心axs.regions.admin

选区 ​

命令说明权限
/rg pos1将当前位置设为点1axs.regions.select
/rg pos2将当前位置设为点2axs.regions.select
木斧左键设置点1（自动识别选区工具）axs.regions.select
木斧右键设置点2axs.regions.select

标志管理 ​

命令说明权限
/rg flag <区域> <标志> <allow|deny> [数据]设置区域标志所有者或 admin
/rg removeflag <区域> <标志>移除区域标志所有者或 admin
/rg flags <区域>查看区域所有标志所有人

成员管理 ​

命令说明权限
/rg addowner <区域> <玩家|g:组名>添加所有者所有者或 admin
/rg removeowner <区域> <玩家|g:组名>移除所有者admin
/rg addmember <区域> <玩家|g:组名>添加成员所有者或 admin
/rg removemember <区域> <玩家|g:组名>移除成员所有者或 admin

其他 ​

命令说明权限
/rg priority <区域> <数字>设置区域优先级所有者或 admin
/rg parent <区域> <父区域|none>设置/清除父区域admin

标志系统 ​

共 40+ 个保护标志，按分类如下：

方块类 ​

标志说明默认
block-break方块破坏DENY
block-place方块放置DENY
use交互使用（门/按钮/拉杆）ALLOW
chest-access容器访问DENY
trample踩踏耕地DENY

实体类 ​

标志说明默认
pvp玩家间 PVPDENY
mob-damage怪物对玩家的伤害ALLOW
mob-spawning怪物自然生成ALLOW
animal-damage对动物的伤害DENY
entity-interact实体交互ALLOW

环境类 ​

标志说明默认
creeper-explosion苦力怕爆炸DENY
tntTNT 爆炸DENY
fire-spread火焰蔓延DENY
lava-flow岩浆流动DENY
water-flow水流动ALLOW
ice-melt冰融化DENY
snow-fall雪覆盖ALLOW
leaf-decay树叶衰减ALLOW
lightning闪电DENY

玩家行为类 ​

标志说明默认
entry进入区域ALLOW
exit离开区域ALLOW
fly飞行ALLOW
ender-pearl末影珍珠传送ALLOW
chorus-fruit紫颂果传送ALLOW
item-drop丢弃物品ALLOW
item-pickup拾取物品ALLOW
exp-drop经验球掉落ALLOW
hunger饥饿消耗ALLOW
potion-splash投掷药水ALLOW
vehicle-place放置载具ALLOW
vehicle-destroy破坏载具DENY
sleep睡觉ALLOW

特殊类 ​

标志说明默认
pistons活塞推拉ALLOW
invincible区域内无敌NONE
greeting进入区域提示文字NONE
farewell离开区域提示文字NONE
deny-message自定义拒绝提示NONE
enderman-grief末影人搬方块DENY
ghast-fireball恶魂火球DENY
wither-damage凋灵破坏DENY
painting-destroy破坏画DENY
item-frame-destroy破坏展示框DENY
snow-golem-trail雪傀儡铺雪ALLOW

标志状态 ​

每个标志有三种状态：

  • ALLOW — 允许该行为
  • DENY — 禁止该行为
  • NONE — 不设置（继承父区域或全局默认）

世界规则 ​

不依赖区域选区的全局世界级别限制：

yaml
world-rules:
  # 禁止飞行的世界列表
  no-fly-worlds:
    - "world_pvp"
  no-fly-action: cancel
  no-fly-message: "&c此世界禁止飞行。"
  # 禁止活塞推动的世界列表
  no-piston-worlds: []
  # 禁止交互的物品/方块类型 (按世界配置)
  disabled-interactions:
    world_spawn:
      - ENDER_CHEST
      - ANVIL
功能说明绕过权限
禁飞指定世界禁止飞行，进入时自动取消axs.essentials.fly.bypass
禁活塞指定世界所有活塞推拉无效无
禁交互指定世界中特定方块类型不可交互axs.essentials.interact.bypass

选区工具 ​

默认选区工具为木斧（WOODEN_AXE），可在配置中修改。

  • 左键方块 → 设置点 1
  • 右键方块 → 设置点 2
  • 两点设置完成后自动显示选区体积
yaml
selection:
  wand-item: WOODEN_AXE
  max-volume: 1000000
  max-regions-per-player: 10

存储 ​

支持 SQLite（默认）和 MySQL。

yaml
storage:
  dialect: sqlite
  sqlite-file: "regions.db"
  host: "127.0.0.1"
  port: 3306
  database: "arcartxsuite"
  username: "root"
  password: ""
  table-prefix: "axs_rg_"

数据表：

  • regions — 区域元数据（id/world/bounds/priority/parent）
  • region_flags — 区域标志（region_id/flag/state/data）
  • region_members — 成员关系（region_id/uuid/role）

优先级与继承 ​

  • 优先级：数值越大越优先。玩家处于多个重叠区域时，优先级最高的区域的标志生效。
  • 父区域继承：当某标志状态为 NONE 时，向父区域递归查询直到找到明确设置。
  • 成员豁免：区域所有者和成员默认豁免方块破坏/放置/容器访问等保护标志。
  • 全局区域：__global__ 作为所有世界的保底规则，无任何区域覆盖时生效。

权限汇总 ​

权限说明默认
axs.regions.select使用选区工具false
axs.regions.admin管理所有区域OP
axs.regions.bypass绕过所有区域保护OP
axs.regions.bypass.limit绕过区域数量限制OP
axs.regions.group.<name>区域权限组成员false

基于 GPL-3.0 许可发布

© 2024-2026 墨墨啊