AreaProtection

模组

· 作者 msg4edy

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

0 本站下载 0 关注 更新于 1 个月前

最新 1.1.0 · 26.2 · Fabric

一键开服(送7天)

Area Protection 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 防止访问容器(箱子、 barrels、漏斗等)
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 Web 编辑器或在游戏内分配权限
  • 服务器启动时权限会自动注册到 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 加载器: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 月
  • 状态:初始发布

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源