区域保护

区域保护

一个旨在为服务器提供保护和警报的Fabric模组!

游戏机制

区域保护 v1.0.0 - 初始版本

概述

一个适用于 Minecraft 1.21.11 的全面服务端区域保护与警报系统,集成 LuckPerms。创建保护区域、管理权限、接收实时警报,并控制谁可以访问你的区域。

核心功能

区域管理

  • 创建保护区域:使用 /area pos1、/area pos2 和 /area create <name> 定义矩形区域
  • 删除区域:使用 /area delete <name> 移除区域
  • 查看区域信息:使用 /area info <name> 或 /area list 显示区域详情、保护状态和列表
  • 区域扩展:使用 /area expand <region> <direction> <amount> 向任意方向(上、下、北、南、东、西)扩展现有区域
  • 优先级系统:为区域分配优先级以处理重叠情况
  • 体积限制:可配置每个玩家的最大区域体积(默认:1,000,000 方块)
  • 每玩家限制:限制玩家可创建的区域数量(默认:每玩家 10 个区域)
  • 重叠防护:防止创建与现有区域重叠的区域

保护标志

使用 /area protection <region> <type> <true/false> 按区域开启/关闭保护:

保护类型 描述
block_break 防止未经授权的方块破坏
block_place 防止未经授权的方块放置
block_interact 防止与方块交互(按钮、拉杆等)
container_open 防止访问容器(箱子、木桶、漏斗等)
entity_damage 防止对非玩家实体(动物、宠物等)造成伤害
pvp 防止玩家对战

新区域默认启用所有保护标志。

访问控制

白名单系统

  • 将玩家加入白名单:/area whitelist add <region> <player>
  • 从白名单移除:/area whitelist remove <region> <player>
  • 白名单中的玩家可以执行受保护的操作

黑名单系统

  • 将玩家加入黑名单:/area blacklist add <region> <player>
  • 从黑名单移除:/area blacklist remove <region> <player>
  • 黑名单中的玩家无权执行受保护的操作
  • 将黑名单玩家加入白名单(或反之)会将其从相反的列表中移除

所有者控制

  • 仅区域所有者或管理员可以修改区域设置
  • 区域所有者是创建该区域的玩家
  • 管理员权限:areaprotection.admin

警报系统

实时警报

  • 当有人违反保护规则时立即收到警报
  • 若区域所有者在线,警报发送给所有者
  • 使用 /alert inbox [page] 查看待处理警报
  • 使用 /alert clear 清除警报
  • 使用 /alert history <region> [page] 查看警报历史

警报类型

使用 /alert settings <region> <type> 切换特定警报类型:

警报类型 触发时机
enter 任何玩家进入区域时
leave 任何玩家离开区域时
block_break 有人尝试破坏受保护的方块时
block_place 有人尝试放置受保护的方块时
block_interact 有人尝试与方块交互时
container_open 有人尝试打开容器时
entity_damage 有人尝试对实体造成伤害时
pvp 有人尝试玩家对战时

离线警报存储

  • 当区域所有者离线时,警报会被存储
  • 玩家登录时自动发送
  • 在聊天中显示前 5 条警报,可使用 /alert inbox 查看全部

警报冷却

  • 可按警报类型配置以防止刷屏(默认:30-60 秒)
  • 防止同一操作在短时间内产生重复警报

切换警报

  • 禁用区域的所有警报:/alert toggle <region>
  • 使用相同命令重新启用

自定义消息

  • 设置进入消息:/area message <region> enter <message>
  • 设置离开消息:/area message <region> leave <message>
  • 消息以彩色显示给所有进入/离开该区域的玩家

权限集成

LuckPerms 支持

  • 自动检测并集成 LuckPerms
  • 通过 LuckPerms 网页编辑器或游戏内分配权限
  • 服务器启动时自动向 LuckPerms 注册权限

权限节点

权限 用途
areaprotection.pos 使用 /area pos1 和 /area pos2 命令
areaprotection.create 使用 /area create 创建新区域
areaprotection.delete 使用 /area delete 删除区域
areaprotection.whitelist 管理白名单
areaprotection.blacklist 管理黑名单
areaprotection.protection 修改保护设置
areaprotection.alerts.receive 接收警报通知
areaprotection.bypass 绕过所有保护(仅限管理员)
areaprotection.admin 对所有区域拥有完整管理员访问权限
areaprotection.reload 重载配置

后备权限

  • 如果未安装 LuckPerms,默认向所有玩家授予基础权限
  • 管理员权限需要服务器 OP 状态(等级 4)或 LuckPerms 权限

配置

  • config/areaprotection.json - 可自定义设置:
    • limits.maxRegionVolume - 每个区域的最大方块数(默认:1,000,000)
    • limits.maxRegionsPerPlayer - 每玩家最大区域数(默认:10)
    • alertCooldowns - 警报冷却时间(秒)
    • defaultProtectionFlags - 新区域的默认保护设置
    • blacklistHardBlock - 是否阻止在区域内破坏特定方块

数据存储

  • 区域和警报数据自动持久化到 config/areaprotection/
  • 基于 JSON 的存储,便于备份和编辑
  • 离线警报在服务器重启后保留

事件处理

  • 方块破坏:监控并防止未经授权的方块破坏
  • 方块交互:防止按钮、拉杆及其他方块交互
  • 实体伤害:防止对动物和实体造成伤害
  • 玩家移动:追踪区域进入/离开,显示消息,触发警报
  • 容器访问:防止未经授权的容器打开
  • 玩家连接:登录时发送离线警报

技术细节

要求

  • Minecraft 版本:1.21.11
  • Fabric Loader:0.17.3+
  • Fabric API:0.141.1+1.21.11
  • Java:21+

可选依赖

  • LuckPerms:用于高级权限管理(自动检测)

映射

  • 使用 Mojang 官方映射以实现 100% 兼容性

命令参考

/area pos1                              - 在当前地点设置位置 1
/area pos2                              - 在当前地点设置位置 2
/area create <name> [priority]          - 从选区创建区域
/area delete <name>                     - 删除区域
/area info <name>                       - 显示区域详情
/area list                              - 列出所有区域
/area protection <region> <type> <true/false> - 切换保护
/area whitelist add <region> <player>   - 加入白名单
/area whitelist remove <region> <player> - 从白名单移除
/area blacklist add <region> <player>   - 加入黑名单
/area blacklist remove <region> <player> - 从黑名单移除
/area message <region> enter <message>  - 设置进入消息
/area message <region> leave <message>  - 设置离开消息
/area expand <region> <direction> <amount> - 扩展区域

/alert toggle <region>                  - 切换所有警报的开启/关闭
/alert inbox [page]                     - 查看离线警报
/alert clear                            - 清除所有离线警报
/alert history <region> [page]          - 查看区域警报历史
/alert settings <region> <type>         - 切换特定警报类型

文件结构

config/
├── areaprotection.json           - 主配置
└── areaprotection/
    ├── regions.json              - 已保存的区域
    └── offline_alerts.json       - 存储的离线警报

注意事项

  • 区域保护仅为服务端功能(适用于原版和模组客户端)
  • 所有时间戳以 UTC 存储,并按玩家时区格式化
  • 警报冷却可防止刷屏,但不会阻止违规行为
  • 同一玩家同时处于黑名单和白名单:玩家会被移至相反的列表(从之前的列表移除)

版本信息

  • 版本:1.0.0
  • 发布日期:2026 年 1 月
  • 状态:初始版本