
区域保护
一个旨在为服务器提供保护和警报的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 月
- 状态:初始版本
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。