ArcadiaGuard

ArcadiaGuard

适用于 NeoForge 1.21.1 的独立领地保护模组 — 通过游戏内 GUI、选区权杖、60 多种可配置标志，以及 3D 领地边界渲染来定义受保护区域。

功能

完整的游戏内 GUI

所有操作都可通过 GUI 管理 — 日常使用无需输入命令：

• 领地列表 — 表格视图，支持维度筛选、搜索、分页和实时预览
• 领地详情 — 配置标志、管理成员、编辑坐标、查看审计日志
• 标志选择器 — 搜索并添加或移除标志，切换布尔值，编辑整数或列表值
• 维度编辑器 — 为每个维度设置默认标志
• 创建领地 — 表单提供实时统计数据（表面积、体积、区块数）

选区权杖

• 编辑模式：左键 = 角点 A，右键 = 角点 B
• 查看模式：以 3D 线框被动渲染领地边界
• 在经验条上方的 HUD 中显示选定位置

60 多种保护标志

可精细控制以下内容：

• 方块交互（破坏、放置、交互、容器）
• PvP、实体伤害、生物生成
• 法术与魔法能力（按模组分别控制）
• 物品使用（拴绳、刷怪蛋、书籍、动态禁用）
• 流体、火焰与爆炸的传播
• 以及更多内容 — 可通过公开 API 扩展

子领地与继承

• 在父领地内创建子领地
• 标志会自动从父领地继承到子领地
• 支持维度级别的默认标志
• 冲突解决规则：优先级 > 体积 > 名称

模组兼容性

每项集成都可独立启用或关闭：

| 模组 |会被阻止的行为 |
| ————————— |—————————————— |
| Iron’s Spells ‘n Spellbooks |施放法术 |
| Ars Nouveau |法术、扭曲卷轴传送、传送门 |
| Simply Swords |特殊武器能力 |
| Occultism |仪式与魔法 |
| Supplementaries |可投掷物品 |
| Apotheosis |隧道挖掘、启蒙词缀 |
| Better Archeology |隧道挖掘附魔 |

所有模组均为可选 — 无论安装了哪些模组，ArcadiaGuard 都能正常运行。

动态禁用物品

通过命令即可在运行时禁用受保护领地中的任意物品 — 无需重启：

/arcadiaguard item block <item>
/arcadiaguard item unblock <item>

审计日志

每次被阻止的操作都会记录玩家名称、操作类型、领地和位置。日志每日轮换，并可配置保留期限。

LuckPerms 集成

可通过 LuckPerms 权限节点分配领地角色（MEMBER、MODERATOR、OWNER）— 无需在游戏内管理白名单。

公开 API

第三方模组可注册自定义标志并查询领地权限：

ArcadiaGuardAPI.get().registerFlag(
    new BooleanFlag("mymod:teleport", true, "Allow teleportation"));

ZoneCheckResult result = ArcadiaGuardAPI.get()
    .checkFlag(player, pos, MY_FLAG);

完整 API 指南：docs/api-guide.md

数据包扩展性

物品列表由可覆盖的标签驱动 — 无需重新编译：

• arcadiaguard:banned_leads
• arcadiaguard:banned_spawn_eggs
• arcadiaguard:spawn_banned_books

安装

1. 从 Files 选项卡下载.jar
2. 将其放入 mods/ 文件夹（服务器和客户端）
3. 启动服务器以生成配置
4. 给自己发放魔杖：/give @s arcadiaguard:zone_editor
5. 选取两个角点，然后打开 GUI 创建你的第一个区域

需要： NeoForge 1.21.1（任意 21.1.x 版本）— Java 21

命令

大多数操作都可以直接通过 GUI 完成。命令仍可用于自动化和控制台操作。

/arcadiaguard gui
/arcadiaguard zone add <name> <x1> <y1> <z1> <x2> <y2> <z2>
/arcadiaguard zone remove <name>
/arcadiaguard flag set <zone> <flag> <value>
/arcadiaguard flag list
/arcadiaguard item block <item>
/arcadiaguard reload
/arcadiaguard debug

链接

• 源代码
• API 指南
• 问题反馈

ArcadiaGuard

适用于 NeoForge 1.21.1 的独立区域保护模组 — 通过游戏内 GUI、选区工具（魔杖）、60 多种可配置标志和区域边界 3D 渲染，创建受保护区域。

功能

完整的 GUI

所有操作都可在 GUI 中完成——日常使用无需命令：

• 区域列表 — 表格视图，支持按维度筛选、搜索、分页和预览
• 区域详情 — 配置标志、管理成员、编辑坐标、查看日志
• 标志选择器 — 搜索并添加/移除标志、切换布尔选项、编辑整数/列表值
• 维度编辑器 — 设置维度默认标志
• 创建区域 — 表单实时显示统计信息（面积、体积、区块数）

选区魔杖

• 编辑模式：左键 = 角点 A，右键 = 角点 B
• 查看模式：被动显示区域边界的线框 3D 渲染
• 在经验条上方通过 HUD 显示坐标位置

60 多种保护标志

精细控制以下内容：

• 方块交互（破坏、放置、交互、容器）
• PvP、实体伤害、生物生成
• 法术与魔法能力（按模组区分）
• 物品使用（拴绳、刷怪蛋、书本、动态阻止）
• 流体蔓延、火焰、爆炸
• 以及更多功能——可通过公开 API 扩展

子区域与继承

• 在父区域内创建子区域
• 自动将父区域的标志继承到子区域
• 设置维度级别的默认标志
• 冲突解决规则：优先级 > 体积 > 名称

模组兼容性

每项集成都彼此独立，且可单独禁用：

| 模组 |阻止的内容 |
| ————————— |—————————————— |
| Iron’s Spells ‘n Spellbooks |施放法术 |
| Ars Nouveau |法术、传送卷轴、传送门 |
| Simply Swords |武器特殊能力 |
| Occultism |仪式与魔法 |
| Supplementaries |投掷物品 |
| Apotheosis |挖掘、Enlightened 词缀 |
| Better Archeology |Tunneling 附魔 |

所有模组都是可选的 — 无论使用什么环境，ArcadiaGuard 都能运行。

动态物品阻止

通过命令实时阻止受保护区域中的任意物品——无需重启：

/arcadiaguard item block <item>
/arcadiaguard item unblock <item>

审计日志

每个被阻止的操作都会记录玩家名称、操作类型、区域和位置。日志每天轮换。

LuckPerms 集成

可通过 LuckPerms 权限节点分配区域角色（MEMBER、MODERATOR、OWNER）。

公开 API

第三方模组可以注册自定义标记并检查区域权限：

ArcadiaGuardAPI.get().registerFlag(
    new BooleanFlag("mymod:teleport", true, "Autorise la teleportation"));

ZoneCheckResult result = ArcadiaGuardAPI.get()
    .checkFlag(player, pos, MY_FLAG);

完整指南：docs/api-guide.md

安装

1. 从 Files 选项卡下载 .jar
2. 将其放入 mods/ 文件夹（服务器和客户端）
3. 启动服务器以生成配置
4. 给自己发放 wand：/give @s arcadiaguard:zone_editor
5. 选择两个角，然后打开 GUI 创建区域

要求：NeoForge 1.21.1（所有 21.1.x 版本）— Java 21

链接

• 源代码
• API 指南
• 报告错误