BigBangRegions

BigBangRegions

一个功能强大的Fabric服务端区域保护模组,支持玩家领地、可配置标志、成员角色、区域优先级、付费扩展、地图集成以及模组方块保护。

BigBang Regions

BigBang Regions 是一个功能强大的服务端领土保护和玩家领地声明系统,适用于运行 Fabric 的 Minecraft 服务器。

创建受保护的管理区域,允许玩家声明自己的土地,配置详细的交互规则,管理成员和角色,扩展区域,并保护原版和模组内容,而无需玩家安装模组。

BigBang Regions 专为多人游戏和模组服务器而构建,为土地所有权、服务器区域、受保护建筑、城镇、商店、出生点区域和其他领土系统提供了可靠的基础。


主要特性

玩家领地声明

玩家可以在其当前位置直接创建自己的受保护区域:

/regiao criar aqui

每个玩家区域可以拥有:

  • 专属所有者
  • 多名成员
  • 组长和普通成员
  • 可配置的保护标志
  • 扩展支持
  • 自动重叠验证
  • 可配置的区域数量限制

服务器管理员可以定义初始区域大小,并控制每位玩家可拥有的区域数量。


管理区域

管理员可以为以下用途创建受保护区域:

  • 服务器出生点
  • 商店
  • 活动区域
  • 竞技场
  • 地牢
  • 公共建筑
  • 道路
  • 重要结构
  • 限制区域

可以通过选择坐标来创建区域:

/regions pos1
/regions pos2
/regions create admin <id> [priority]

也可以直接在管理员周围创建区域,无需手动选择两个坐标点:

/regions admin create <sizeX> <sizeZ> [id] [priority]

详细的保护标志

每个区域都可以控制玩家在其内部可以进行哪些操作。

可用的保护类别包括:

  • 方块破坏和放置
  • 常规方块交互
  • 容器访问
  • 门和栅栏门的使用
  • 红石交互
  • 实体交互
  • PvP
  • 物品拾取
  • 物品丢弃

玩家可以管理自己区域的标志:

/regiao flags listar
/regiao flags ver <flag>
/regiao flags definir <flag> <allow|deny|inherit>

inherit 值允许区域使用从更高级别或默认配置继承的保护行为。


区域优先级

BigBang Regions 支持区域优先级,允许管理和系统区域覆盖较低优先级的玩家领地。

默认的优先级结构区分了:

  • 系统区域
  • 管理区域
  • 玩家区域

这允许服务器所有者在更大的区域内创建受保护区域,而不会失去对领土规则的控制。


成员和角色管理

区域所有者可以邀请其他玩家并分配不同的职责。

支持的角色包括:

  • 所有者 — 对区域拥有完全控制权
  • 组长 — 拥有高级管理权限
  • 成员 — 根据区域规则访问受保护区域

主要的成员命令:

/regiao membros listar
/regiao membros adicionar <player>
/regiao membros remover <player>
/regiao membros promover <player>
/regiao membros rebaixar <player>
/regiao sair

管理员也可以检查和修改区域的所有权和成员资格。


区域扩展

玩家区域在创建后可以进行扩展:

/regiao expandir <size>

扩展系统支持与 BigBangEssentials Gems 的可选集成,允许服务器向玩家收取额外受保护土地的费用。

玩家可以在调整大小完成前查看或取消扩展:

/regiao expandir status
/regiao expandir cancelar

提供管理恢复命令,用于检查、重试和协调中断的扩展事务。

初始区域可以保持免费,只有额外土地需要付费。


模组方块保护

BigBang Regions 保护与原版和模组方块的交互,这些方块实现了标准的 Minecraft 容器或菜单界面。

这包括许多常用的:

  • 箱子
  • 存储方块
  • 机器
  • 容器
  • 可交互的模组方块
  • 门和栅栏门
  • 红石组件

保护直接在服务器端应用,即使在大量模组的环境中也有助于防止未经授权的访问。


VirtualLoot 集成

当安装了 VirtualLoot 时,BigBang Regions 可以限制以下内容的数量:

virtualloot:virtual_pasture

在私有玩家区域内。

这有助于服务器所有者控制过大的自动化农场,并减少过多虚拟牧场导致的性能问题。

可以根据区域或服务器规则配置限制。


JourneyMap 集成

BigBang Regions 通过 BigMonCraft 地图集成和 JourneyMap 提供可选的地图可视化支持。

当安装了可选的集成时,受保护区域可以显示在世界地图上。

当未安装地图集成时,保护系统仍能正常工作;只是地图上的视觉标记会被禁用。


权限集成

该模组通过 fabric-permissions-api 支持权限检查,使其与 LuckPerms 等权限系统兼容。

管理权限示例:

bigbangregions.admin.create
bigbangregions.admin.player.create
bigbangregions.admin.player.owner
bigbangregions.admin.player.members
bigbangregions.admin.delete
bigbangregions.admin.edit
bigbangregions.admin.flags
bigbangregions.admin.list
bigbangregions.admin.reload
bigbangregions.inspect
bigbangregions.bypass
bigbangregions.bypass.<flag>

当未安装兼容的权限提供者时,BigBang Regions 将回退到 Minecraft 管理员权限级别。


持久化存储

区域存储在本地 SQLite 数据库中:

config/bigbangregions/regions.db

主配置文件生成于:

config/bigbangregions/config.json

配置控制:

  • 默认区域优先级
  • 管理员回退级别
  • 每位所有者的最大区域数量
  • 区域重叠策略
  • 默认保护标志
  • 管理区域行为
  • 玩家区域行为

可以在不重启服务器的情况下重新加载配置和区域缓存:

/regions reload

主要玩家命令

/regiao criar aqui
/regiao info
/regiao expandir <size>
/regiao expandir status
/regiao expandir cancelar
/regiao membros listar
/regiao membros adicionar <player>
/regiao membros remover <player>
/regiao membros promover <player>
/regiao membros rebaixar <player>
/regiao flags listar
/regiao flags ver <flag>
/regiao flags definir <flag> <allow|deny|inherit>
/regiao sair

根据命令上下文,可使用别名 /regions、/regiao 和 /regioes。


主要管理员命令

/regions pos1
/regions pos2
/regions create admin <id> [priority]
/regions admin create <sizeX> <sizeZ> [id] [priority]
/regions create player <id> <owner> [priority]
/regions rename <newName>
/regions delete <id>
/regions list [page]
/regions player owner <id> [newOwner]
/regions player members <id>
/regions player addmember <id> <player>
/regions player removemember <id> <player>
/regions player setrole <id> <player> <leader|member>
/regions admin payment status
/regions expansion list
/regions expansion inspect
/regions expansion retry
/regions expansion reconcile
/regions reload

环境要求

  • Minecraft 1.21.1
  • Fabric Loader
  • Fabric API
  • Java 21

BigBang Regions 是一个服务端模组,玩家无需安装。


可选集成

  • fabric-permissions-api 或 LuckPerms
  • BigBangEssentials Gems
  • BigMonCraft 地图集成
  • JourneyMap
  • VirtualLoot

这些集成是可选的。核心区域保护系统可以在没有它们的情况下正常工作。


安装

  1. 在服务器上安装 Fabric Loader 和 Fabric API。
  2. 将 BigBang Regions 的 .jar 文件放入服务器的 mods 文件夹。
  3. 启动服务器。
  4. 编辑生成的配置文件:
config/bigbangregions/config.json
  1. 使用以下命令重新加载配置:
/regions reload

当前限制

区域目前使用三维长方体形状。

复杂的自动化系统,例如自主机器人、管道、机械装置或未经玩家直接操作而与方块交互的机器,可能需要专门的兼容适配器。


源代码和支持

源代码:

https://github.com/pedro-dalben/BigBangRegions

Bug 报告:

https://github.com/pedro-dalben/BigBangRegions/issues

报告问题时,请包含:

  • BigBang Regions 版本
  • Minecraft 版本
  • Fabric Loader 版本
  • 相关配置
  • 服务器日志
  • 重现问题的步骤

许可证

保留所有权利。