通过租赁告示牌、邮箱等扩展 GriefPrevention 的功能
GPExpansion 为 GriefPrevention 添加了强大的功能,包括租赁告示牌、领地邮箱、全球领地、租赁快照、领地 GUI、告示牌保护等——同时保持自助服务的理念。
还没听说过 GriefPrevention 3D Subdivisions?请在此处获取 这里 以启用邮箱支持。这是一个替换 GriefPrevention jar 的分支版本。
支持的平台
Spigot, Paper, Purpur 和 Folia
需要 GriefPrevention,并可选安装 Vault 以支持经济功能。
可选地,用 GriefPrevention3D 替换 GriefPrevention 以实现无缝邮箱体验(1x1x1 子分区和公共容器信任)。邮箱也可以与常规 GP 配合使用,并且有一个名为 mailbox-protocol: virtual 的配置项,如果您希望允许邮箱堆叠放置,可以使用此项。
功能特性
租赁告示牌
允许领地所有者使用告示牌将他们的领地出租给其他玩家。
- 设置租赁价格和时长
- 租赁开始/到期时自动添加/移除信任
- 支持 Vault 经济、经验值、领地方块数和基于物品的支付方式
- 提供交互式设置向导,使用
/rentclaim命令 - 租赁快照 – 保存和恢复租客之间的领地状态
手动设置租赁告示牌
出售告示牌
允许领地所有者使用告示牌将他们的领地出售给其他玩家。
- 设置领地价格
- 自动转移领地所有权
- 支持 Vault 经济、经验值、领地方块数和基于物品的支付方式
- 提供交互式设置向导,使用
/sellclaim命令
手动设置出售告示牌
领地邮箱
为每个领地提供一个邮箱,其他玩家可以向其中存入物品。
- 所有者拥有完全访问权限以取出物品
- 非所有者看到虚拟库存(打开时的快照)
- 更改仅在菜单关闭时保存
- 关闭前可以取回物品(可撤销的存入操作)
- 如果查看期间邮箱已满,物品将被退回
- 点击告示牌时发出箱子打开的声音/动画
- 邮箱接近满载时显示存储警告
- 可通过告示牌购买,价格可配置
- 提供交互式设置向导,使用
/mailbox命令
创建自用邮箱
向其他玩家出售邮箱
与其他玩家共享邮箱
自用邮箱(即时创建)
- 所有者和租客可以在他们拥有或租用的领地上的容器旁直接放置
[Mailbox]墙壁告示牌 - 可通过
defaults.max-self-mailboxes-per-claim配置限制数量
| 协议类型 | 创建的子分区 | 非所有者视图 | 实时更新 | 可堆叠 |
|---|---|---|---|---|
| Real Protocol (真实协议) | 1x1x1 (GP3D) 或 1x1 2D (常规 GP) | 带有公共容器信任的真实箱子 | 是 | 否 |
| Virtual Protocol (虚拟协议) | 无 | 虚拟快照库存 | 否(打开时快照) | 是 |
全球领地
允许将领地列在全球领地列表中,供所有人查看。
- 设置全局属性,如图标、描述、名称、出生点等
- 默认情况下允许用户通过 GUI 传送至全球领地
- 允许
[global]领地告示牌即时设置出生点并将其列为全球领地 - 简单的
/claim global <true|false>命令用于管理全球列表状态
告示牌保护
保护您的租赁和邮箱告示牌免受未授权修改。
- 活动租赁期间的告示牌破坏仅限管理员
- 移除告示牌时自动清理
租赁恢复快照
拥有 griefprevention.restoresnapshot 权限的管理员可以保存和恢复租赁的领地方块状态。当租赁或驱逐结束时,领地可以恢复到保存的快照,以便下一位租客看到原始的建造状态。
- 创建 (Create) – 将当前领地方块保存为快照(例如,在挂牌出租前)
- 列表 (List) – 查看特定领地或所有领地的快照
- 恢复 (Restore) – 在驱逐或租赁结束时,最新快照会自动应用
命令
/claim snapshot create [claimId]– 创建快照/claim snapshot list [claimId|all]– 列出快照/claim snapshot remove <snapshotId>– 删除快照
领地管理与图形界面
交互式领地管理,支持完全可配置的 GUI:
/claim name <name>- 设置领地名称(支持通过权限使用颜色代码)/claim desc <description>- 设置领地描述(使用与名称相同的颜色权限)/claim icon <material>- 为 GUI 显示设置领地图标/claim spawn- 设置领地的传送出生点/claim tp [claimId]- 传送到某个领地的出生点/claim flags [claimId]- 打开领地标志 GUI(GPFlags)/claim options [claimId]- 打开领地选项 GUI/claim ban <player>- 禁止玩家进入你的领地/claim unban <player>- 解除对玩家的禁令/claim info [claimId]- 查看详细的领地信息/mailbox- 管理邮箱/gpx reload- 重新加载配置文件和语言文件/gpx max- 管理玩家创建告示牌的数量限制
领地 GUI 功能
- 可视化领地地图编辑器 – 通过交互式 GUI 调整大小、分割和管理领地
- 可自定义布局、图标和权限
- 从一个界面传送到领地、查看领地信息并管理设置
- 集成 GPFlags 以进行领地标志管理
可配置的税收系统
可选的领地维护税收系统:
- 按领地方块配置税率
- 多种支付方式(金钱、领地方块、经验值)
- 领地删除前的宽限期
- 通过权限实现税收豁免
CrowBar 定位栏集成
当安装了 Fabric 客户端模组 CrowBar 并与 GPExpansion 一起使用时,领地所有者和受信任的玩家会在定位栏上看到领地航点的领地名称以及领结标记。CrowBar 读取 GPExpansion 发送的相同定位数据,并在每个航点上方渲染可读的名称标签。

- 同时安装 GPExpansion 和 CrowBar 时自动生效——无需额外配置。
- 领地名称会显示在定位栏上的领结航点标记上方。
- 兼容 Minecraft 1.21.6–1.21.11、26.1.x 和 26.2。
文档
告示牌格式、配置、权限和详细指南 全部在这里
支持
从源代码构建
git clone https://github.com/castledking/GPExpansion.git
cd GPExpansion
mvn clean install
编译后的 jar 文件将位于 target/ 目录中。
Extend GriefPrevention with rental signs, mailboxes, and more
GPExpansion adds powerful features to GriefPrevention including rental signs, claim mailboxes, global claims, rental snapshots, claim GUIs, sign protection, and more — all while maintaining the self-service philosophy.
Haven't heard of GriefPrevention 3D Subdivisions? Get it here to enable mailbox support. This is a fork that replaces the GriefPrevention jar.
Supported Platforms
Spigot, Paper, Purpur, and Folia
Requires GriefPrevention and optionally Vault for economy features.
Optionally, replace GriefPrevention with GriefPrevention3D for seamless mailboxes (1x1x1 subdivisions and public container trust). Mailboxes will work with regular GP and there is a config setting called mailbox-protocol: virtual that helps if you want to be able to stack mailboxes on top of each other.
Features
Rental Signs
Allow claim owners to rent out their claims to other players using signs.
- Set rental prices and durations
- Automatic trust/untrust on rental start/expiry
- Supports Vault economy, experience, claim blocks, and item-based payments
- Interactive setup wizard with
/rentclaimcommand - Rental Snapshots – Save and restore claim state between renters
Setting up a rental sign manually
Sell Signs
Allow claim owners to sell their claims to other players using signs.
- Set claim prices
- Automatic transfer of ownership of claim
- Supports Vault economy, experience, claim blocks, and item-based payments
- Interactive setup wizard with
/sellclaimcommand
Setting up a sell sign manually
Claim Mailboxes
Give each claim a mailbox where other players can deposit items.
- Owners have full access to retrieve items
- Non-owners see a virtual inventory (snapshot at open time)
- Changes save only when the menu closes
- Can take back items before closing (reversible deposits)
- Items returned if mailbox fills up while viewing
- Chest opening sound/animation on sign click
- Storage warnings when mailbox is nearly full
- Purchasable via signs with configurable prices
- Interactive setup wizard with
/mailboxcommand
Creating a self mailbox
Selling a mailbox to other players
Sharing a mailbox with other players
Self Mailboxes (Instant Creation)
- Owners and renters can place
[Mailbox]wall signs directly on containers in claims they own or rent - Configurable limit via
defaults.max-self-mailboxes-per-claim
| Protocol Type | Subdivision Created | Non-Owner View | Live Updates | Stackable |
|---|---|---|---|---|
| Real Protocol | 1x1x1 (GP3D) or 1x1 2D (regular GP) | Real chest with public container trust | Yes | No |
| Virtual Protocol | None | Virtual snapshot inventory | No (snapshot at open time) | Yes |
Global Claims
Allow claims to be listed in a global claim list, viewable to all.
- Set global settings like icon, description, name, spawn point, and more
- Allows users to teleport to global claims via GUI by default
- Allows
[global]claim signs to instantly set spawn and list as global - Simple
/claim global <true|false>command to manage global listing status
Sign Protection
Protect your rental and mailbox signs from unauthorized modification.
- Admin-only sign breaking for active rentals
- Automatic cleanup on sign removal
Rental Restoration Snapshots
Admins with griefprevention.restoresnapshot can save and restore claim block state for rentals. When a rental or eviction ends, the claim can be restored to a saved snapshot so the next renter sees the original build.
- Create – Save the current claim blocks as a snapshot (e.g., before listing for rent)
- List – View snapshots for a claim or for all claims
- Restore – On eviction or rental end, the latest snapshot is applied automatically
Commands
/claim snapshot create [claimId]– Create a snapshot/claim snapshot list [claimId|all]– List snapshots/claim snapshot remove <snapshotId>– Delete a snapshot
Claim Management & GUIs
Interactive claim management with fully configurable GUIs:
/claim name <name>- Set claim name (supports color codes with permissions)/claim desc <description>- Set claim description (uses same color permissions as name)/claim icon <material>- Set claim icon for GUI display/claim spawn- Set the teleport spawn point for your claim/claim tp [claimId]- Teleport to a claim's spawn point/claim flags [claimId]- Open the claim flags GUI (GPFlags)/claim options [claimId]- Open the claim options GUI/claim ban <player>- Ban players from your claims/claim unban <player>- Unban players from your claims/claim info [claimId]- View detailed claim information/mailbox- Manage your mailboxes/gpx reload- Reload configuration and language files/gpx max- Manage player sign creation limits
Claim GUI Features
- Visual claim map editor – Resize, subdivide, and manage claims via interactive GUI
- Customizable layouts, icons, and permissions
- Teleport to claims, view claim info, and manage settings from one interface
- Integration with GPFlags for claim flag management
Configurable Tax System
Optional tax system for claim maintenance:
- Configurable tax rates per claim block
- Multiple payment methods (money, claim blocks, experience)
- Grace periods before claim deletion
- Tax exemptions via permissions
CrowBar Locator Bar Integration
When CrowBar, a Fabric client mod, is installed alongside GPExpansion, claim waypoints display the claim name and a bowtie marker on the locator bar to the claim owner and trusted players. CrowBar reads the same locator data GPExpansion sends and renders readable name tags above each waypoint.

- Works automatically when both GPExpansion and CrowBar are installed — no extra configuration needed.
- Claim names appear above the bowtie waypoint marker on the locator bar.
- Compatible with Minecraft 1.21.6–1.21.11, 26.1.x, and 26.2.
Documentation
Sign formats, configuration, permissions, and detailed guides All here
Support
- Issue Tracker - Report bugs or problems
- Discussions - Feature requests and questions
- Wiki - Detailed documentation and guides
- Discord - Join our community
Building from Source
git clone https://github.com/castledking/GPExpansion.git
cd GPExpansion
mvn clean install
The compiled jar will be in target/.
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GPExpansion
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
GPExpansion v1.2.8
本次发布修复了 BlueMap 和 Dynmap 上领地边界在 +X(右侧)和 +Z(底部)边缘少显示一个方块的问题,并添加了为每位玩家的领地生成基于其名称的唯一默认颜色的选项。
Maven 项目版本现已更新为 1.2.8。新的配置键会自动添加到现有的 config.yml 文件中。
地图边界轮廓修复
此前,没有 GriefPrevention3D 多边形的矩形领地在膨胀其较大角落时会增加 +1.0,而多边形领地则返回原始包含式块坐标网格坐标。由于每个 GriefPrevention3D 领地(无论是矩形还是形状不规则的)都暴露出一个边界多边形,导致 BlueMap 和 Dynmap 的多边形在 +X(右侧)和 +Z(底部)侧边少了一个方块。
GPBridge.getClaimOutline现在简化正交多边形上连续的重复点和共线点,根据其符号面积确定多边形方向,并将每个向外的+X和+Z边缘偏移+1.0个方块。- 渲染出的轮廓现在与受保护方块的精确
[x, x + 1] × [z, z + 1]世界足迹匹配,无论多边形环绕方向如何或是否存在凹角,同时保留经典矩形回退领地(包括1×1领地)按原样工作。
每位玩家独立的默认地图颜色
默认情况下,所有未自定义 /claim color 的玩家领地共享单一的黄色 integrations.colors.main-claim (#FFD700) 颜色。现在您可以选择启用每位玩家独立的颜色,以便属于同一拥有者的所有领地在 BlueMap 和 Dynmap 上显示一致的颜色:
integrations:
colors:
per-player: false
main-claim: "#FFD700"
admin-claim: "#FF8C00"
- 设置
integrations.colors.per-player: true(或将integrations.colors.main-claim设置为"player-hash"、"owner-hash"或"per-player"),然后运行/gpx reload。 - 玩家颜色由所有者名称的大小写不敏感哈希值(FNV-1a + SplitMix64)确定性派生,并映射到鲜艳的 HSV 色带(
S ∈ [0.65, 0.90],V ∈ [0.75, 0.95]),因此相似的用户名在色轮上均匀分布,并在地图地形上保持清晰可读。 - 优先级: 明确的单个领地
/claim color覆盖仍然优先(包括black/#000000,现在被视为显式覆盖而非未设置),管理员领地继续使用integrations.colors.admin-claim,拥有未知或空白拥有者的领地回退到integrations.colors.main-claim。
更新与验证
替换 GPExpansion.jar 并重启服务器(如果从 1.2.7 更新,则重新加载)。现有的 config.yml 文件在加载时会自动接收 integrations.colors.per-player: false,而在启用之前不会更改现有标记的外观。
所有 39 项测试 均在 Spigot 和 Paper 上通过,包括针对正交多边形膨胀的新单元测试覆盖率,涵盖矩形、带有冗余节点的凹形 L 形、U 型缺口、两种环绕方向、1×1 回退以及每位玩家颜色哈希(ClaimOutlineTest 和 MapColorsTest)。已在 Java 25 上使用 mvn -o test、mvn -o -Ppaper test 和 mvn -o package -DskipTests 进行验证。
GPExpansion v1.2.7
CrowBar 的领地航点按键现在与玩家的 /claim bar 设置同步。此版本还添加了独立的 放置载具 标志,修复了 My Claims 中的邮箱过滤问题,并在 Spigot、Paper、Purpur 和 Folia 上使用标准的 Bukkit 插件加载器。
CrowBar 领地控制
使用 CrowBar 2.0.2 或更高版本时,领地按键(默认为 Z)与 /claim bar 保持同步:
| 模式 | 显示的领地 |
|---|---|
own |
你自己的领地 |
trusted |
你的领地以及你拥有访问信任权限的领地 |
both |
你的领地、受信任的领地和已发布的领地 |
off |
无领地标记 |
- 按键循环切换 own → trusted → both → off,并将选择保存到
waypoint-modes.yml中,与命令行为一致。命令更改也会更新 CrowBar 的选择。 - 切换是即时生效的。编号的请求和确认机制防止在快速按下按键后,延迟回复恢复旧的选择。
- CrowBar 可以在执行
/claim bar off后重新开启领地显示;它不再将隐藏列表误判为没有领地。空模式与无可用地皮的情况会分别报告。 - 集成需要
griefprevention.claim.bar权限。较旧的 CrowBar 客户端仍会接收命令模式所允许的领地;请升级客户端以实现同步的按键控制。 /claim bar现在同时适用于 CrowBar 的领地载荷以及原版领地数据包。领地标记 UUID 仍然可用于去重。/gpx waypoints会报告玩家的模式、CrowBar 频道支持情况、领地按键是否跟随命令,以及每个地皮的原版数据包状态。
新的 crowbar:claim_mode 频道用于双向传输模式更改。更新的客户端会接收每个地皮的模式资格信息,使按键无需等待另一个领地列表即可切换。玩家圆点仍独立于领地标记进行控制。
放置载具标志
- 在玩家标志选项卡中添加了
place_vehicles(放置载具),涵盖船只、箱子船、筏子以及所有矿车变体。 - 明确的 Allow(允许)或 Deny(禁止)设置会覆盖 放置实体 对载具的影响。当未设置时,载具继续遵循
entity_place,保留现有的领地规则。 - 盔甲架和末影水晶仍使用 放置实体。骑乘载具仍由 使用载具 控制。
- 使用建造信任等级和
griefprevention.claim.flag.place_vehicles权限,与其他玩家标志保持一致。
修复
- My Claims 邮箱过滤器不再从异步加载器或另一个 Folia 区域读取告示牌方块。这些调用者改用同步的市场列表。
- 如果过滤器加载失败,现在会记录问题并重绘所选过滤器,而不是保留上一个视图并导致下一次点击看似跳过了一个过滤器。
/gpx reload现在会在航点投递设置更改时刷新现有的领地标记。禁用领地航点会撤回现有标记并清除 CrowBar 的领地数据。- 领地栏消息现在明确描述领地标记,而不是承诺整个定位栏将为空。匹配旧默认值的现有消息会自动更新;自定义措辞得以保留。
插件加载与构建兼容性
- 移除了
paper-plugin.yml。所有平台都通过plugin.yml加载 GPExpansion,使插件可通过常规 Bukkit 依赖关系被其他插件访问。 - 命令继续在运行时注册;权限声明位于单个描述符中。可选的 Paper 功能通过反射访问。
- 默认的 Maven 构建现在针对 Spigot 编译。使用
-Ppaper来检查与 Paper 的兼容性;它取代了旧的-Pspigot-compat配置文件。 - Jar 包声明了 Mojang 映射,以便 Paper 不对航点数据包桥接进行重映射。
- 更新了
publicApi.txt,包含插件依赖示例和 Java 25 要求。
更新与验证
替换 GPExpansion.jar 并重启服务器。为了实现同步控制,还需在客户端安装 CrowBar 2.0.2,并在重启后重新连接它们以通告新频道。现有的航点模式和领地标志数据将被保留;无需手动迁移数据。
所有 35 项测试 均在 Spigot 和 Paper 上通过,包括领地模式请求与确认、旧客户端过滤、标记撤回、载具标志优先级以及语言默认值迁移。已在 Java 25 环境下通过 mvn clean verify 和 mvn -Ppaper clean verify 验证。
GPExpansion v1.2.6
本次更新内置了无需依赖 GPFlags 的地块标志系统,推出了支持远程邮箱礼物和书信的服务器级“地块市场”,为 GriefPrevention3D 的地块所有权转移提供了图形界面流程,支持完整的项目/NBT 地块图标,/claimlist 命令支持交互式分页(悬停显示与点击传送),并全面支持 Spigot,同时兼容 Paper、Purpur 和 Folia。
Maven 项目版本现已更新为 1.2.6。新的配置部分、GUI 文件、语言键和权限会自动添加到现有安装中,现有的 guis/claim-options.yml 文件会迁移其中间行槽位(19, 21, 23, 25),以确保全局设置和转移所有权不会发生冲突。
内置地块标志
GPExpansion 现在在 /claim flags [claimId](以及地块选项 -> 地块标志)的三个标签页中包含了 98 个内置地块标志,无需外部标志插件:
| 标签页 | 数量 | 涵盖内容 |
|---|---|---|
| 玩家 | 48 | 方块破坏/放置/采集、箱子和容器、门/按钮/压力板/床/铁砧、PvP、村民和动物伤害、末影珍珠、紫颂果、传送门、物品掉落/拾取、车辆/悬挂物放置,以及方块、伤害和命令过滤器 |
| 生物与实体 | 18 | 环境生物、动物、怪物和水生生物的生成、生物生成过滤器、农田/海龟蛋践踏、TNT/苦力怕/凋灵/火球/末影水晶对方块的破坏、动物破坏、村民耕作以及银鱼虫侵扰 |
| 自然 | 32 | 作物、竹子、海带、甘蔗和藤蔓的生长,草/菌丝体/火/紫水晶簇蔓延,冰和雪的生成或融化,树叶腐烂,珊瑚死亡,农田干燥,以及水或岩浆跨越地块边界流动 |
- 信任相关的玩家规则: 每个玩家标志都映射到 GriefPrevention 的信任层级(
access、container或build)。将玩家标志设置为允许将使非受信任者无需信任即可执行该操作;拒绝将在即使 GriefPrevention 通常允许的情况下阻止非受信任者。受信任的玩家和地块所有者不受影响,除了pvp,它适用于地块内的所有人。 - 白名单和黑名单过滤器标志:
block_interact_filter(材质)、player_incoming_damage_filter(伤害原因)、command_usage_filter(命令)和mob_spawn_filter(实体类型)允许所有者在白名单和黑名单模式之间切换,并通过 GUI 添加或删除单个条目。 - 继承和默认值: 子地块会从父地块继承未设置的标志,顶级地块会在保持正常 GriefPrevention/原版规则不变之前回退到可选的服务器级默认值。标志数据存储在
claimflags.yml中,采用无锁读取,对于任何地块都不使用的标志完全跳过地块查找。 - 权限和 GPFlags 共存: 单个标志检查
griefprevention.claim.flag.<id>,而griefprevention.claim.flags.bypass(默认为op)可绕过标志限制,允许工作人员编辑任何标志。当也安装了 GPFlags 时,右上角的按钮会打开 GPFlags 菜单,或者设置claim-flags.enabled: false会将/claim flags直接恢复为 GPFlags。
地块市场和统一我的地块
/claim market [search](独立命令 /claimmarket [search] 或 /claimshop [search],以及主菜单中的地块市场按钮)打开了一个可搜索的活跃 [租赁]、[出售] 和可购买 [邮箱] 列表的目录,覆盖整个服务器。
- 通过 GUI 浏览、过滤和购买: 按全部、出租、出售、可购买邮箱或发送礼物/书信过滤列表,按地块名称、所有者或备注搜索,并按
newest(最新)、price_asc(价格升序)、price_desc(价格降序)或area_desc(面积降序)排序。当market.allow-gui-purchase为true时,玩家可以直接从 GUI 租赁或购买,并在完成后选择直接传送到该地块。 - 管理您的列表 (
/claim listed): 所有者可以打开/claim listed [claimId](或点击他们拥有的列表项)以打开市场列表编辑器,在那里他们可以更改价格、切换市场可见性、切换购物者是否可以传送来检查地块、设置最多market.max-note-length个字符的自定义标语,或移除待售的标志牌(/claim removelisting)。 - 统一我的地块过滤器: 我的地块(
OwnedClaimsGUI)现在在一个菜单中循环浏览六种视图:拥有地块、受信任地块、租赁地块、购买地块、邮箱和已列出的地块。 - 市场列表、购买历史、每个邮箱的投递偏好和未读邮件计数存储在
market.yml中。
远程邮箱礼物和书信
已售出的邮箱和 [自我邮箱] 容器现在可以通过 /claim market 中的发送礼物/书信视图接收远程投递:
- 远程物品礼物: 点击接受邮件的邮箱,玩家可以远程存入物品礼物(
griefprevention.claim.market.mail.deposit,默认为true)。 - 书信: 玩家可以在聊天中撰写消息(
market.mail.max-letter-length,默认为 240 个字符),消息会以带签名和日期的信件物品的形式出现在邮箱中(griefprevention.claim.market.mail.letter,默认为true)。 - 所有者远程访问和通知: 邮箱所有者可以为每个邮箱切换远程邮件接受状态,在加入时收到未读邮件通知,并从我的地块或地块市场远程打开自己的邮箱(
griefprevention.claim.market.mail.open-own,默认为true)。 - 虚拟容器保护:
MailboxContainerListener保护虚拟协议邮箱容器免受爆炸和未经授权破坏的影响,要求在移除活动邮箱容器之前进行所有者破坏确认,并在移除标志牌时自动清理市场条目。
地块所有权转移
Claim Options(领地选项)现在包含一个 Transfer Ownership(转移所有权)按钮(槽位 42,使用 TRIAL_KEY;在 1.20–1.20.4 版本中回退为 TRIPWIRE_HOOK),用于在启用了 Claims.TransferClaim.Enabled: true 的 GriefPrevention3D 服务器上向其他玩家转让顶级领地。
- 点击该按钮会弹出一个输入玩家名称的提示框,随后显示确认菜单,展示目标玩家、领地大小和转移费用(通过 Vault 获取
Claims.TransferClaim.Price,若拥有griefprevention.transferclaim.free或griefprevention.transferclaim.others权限则免收)。 - 在转让前验证接收者的领地块余额及最大领地槽位限制,与 GriefPrevention3D 的
/transferclaim <player> confirm规则保持一致。 - 在上游原版 GriefPrevention 服务器或禁用了玩家间领地转让的服务器上,该按钮仍会显示,并附带解释为何无法进行转让的说明文字。
- 现有的
guis/claim-options.yml文件会自动将 Teleport(传送)、Resize Claim(调整领地大小)和 Manage Trust(管理信任)向左移动一个槽位(分别为19, 21, 23),并将 Global Settings(全局设置,使用ENDER_CHEST)放置在槽位25,使其保持在中间一行,与位于槽位42的 Transfer Ownership 并列。
自定义物品与头颅领地图标
当 claim-customization.icons.allow-custom-items 为 true(默认值)时,/claim icon [claimId] 命令及图标选择 GUI 会将完整的 ItemStack 保存至 claimdata.yml:
- 自定义模型数据、物品名称/组件、Oraxen/ItemsAdder/Nexo 物品以及玩家头颅纹理将在 My Claims(我的领地)、Global Claim List(全球领地列表)、Claim Market(领地市场)和管理员领地菜单中保留。
- 图标选择 GUI 支持将物品拖拽到中心槽位、悬停在物品上按热键选中,或从背包中 Shift+左键点击而不消耗物品;如果已设置图标,则会预览当前图标。
- 公共 API:
ClaimMetadataService#getIconItem(String claimId)返回带有完整物品元数据的Optional<ItemStack>(原有的getIcon方法继续返回Optional<Material>)。
交互式 /claimlist 分页与点击传送
/claimlist、/claimslist 和 /claim list 经过重新设计,具备准确的分页行计算、在 Paper 和 Spigot 上均可用的交互悬停/点击组件,以及可自定义的布局选项:
- 按行准确分页:
claim-list.page-size(默认10)现在统计所有显示的领地条目——包括拥有的父级领地、拥有的子领地、受信任的领地和受信任的子领地——而不是仅对拥有的父级领地分页,随后再打印子领地和受信任领地。 - 悬停提示与点击传送: 领地 ID 和领地名称带有悬停提示,显示领地 ID(
Claim ID: <id>)以及在允许情况下的Click to teleport(点击传送)提示。点击启用的条目会通过标准的/claim tp流程路由,尊重传送延迟、冷却时间、移动取消和安全位置检查。 - 仅悬停显示领地 ID (
claim-list.show-id-on-hover): 将claim-list.show-id-on-hover设置为true会在聊天列表中介入内联的#<id>前缀(以及(Child of #<parent>)后缀),同时保持领地 ID 显示在领地名称的悬停提示中,并允许点击名称进行传送。 - 分隔线、页面导航按钮和
lang.yml模板: 顶部和底部分隔线(claim-list.show-divider)、可点击的« Previous/Next »页面按钮(claim-list.page-buttons),以及所有行的前缀、字段、按钮和悬停行均在lang.yml中的claim.list-*下进行自定义。 - 独立的自身/受信任领地与管理员传送权限: 点击自己或受信任的领地需要
claim-list.click-teleport-permission权限(默认为griefprevention.claimslist.teleport),而在查看其他玩家的/claimlist <player>时点击领地则需要同时拥有griefprevention.claimslistother和griefprevention.claimslistother.teleport权限。 - 动态
gpx.admin列表和/claim bar补全:config.yml中的admin-commands现在在启动时动态填充gpx.admin子权限(与player-commands->gpx.player匹配),并且/claim bar模式参数(own、trusted、both、off)在 GriefPrevention3D 接管/claim命令时支持自动补全。
完整的 Spigot 支持
GPExpansion 现原生支持 Spigot,同时也支持 Paper、Purpur 和 Folia,均使用同一个 JAR 包:
- 双插件描述符: 同时提供
plugin.yml(loadbefore: [GriefPrevention],folia-supported: true,匹配softdepend和 1:1 权限)和paper-plugin.yml,并在两个平台上通过CommandMap动态注册命令。 - 自包含 Adventure 桥接: 将 Adventure
5.2.0阴影化并重定位至codes.castled.gpexpansion.libs.kyori。在 Paper/Purpur/Folia 上,Mini直接将组件桥接到服务器的原生Audience、库存标题和ItemMetaAPI。在 Spigot 上,Mini.toBungee将组件直接转换为 BungeeCordBaseComponent树(保留可点击的[CONFIRM]/[EVICT]聊天按钮、悬停提示和 24 位#RRGGBB十六进制颜色,避免 Gson 架构不匹配问题),并使用 24 位§x十六进制颜色格式化 GUI 标题和说明文字。 - 无硬性 Paper 字节码依赖: Paper 特定事件(
AsyncChatEvent、WorldGameRuleChangeEvent、PlayerOpenSignEvent)和 Spigot 的PlayerSignOpenEvent通过PaperEvents反射挂钩,WaypointPacketBridge在 Spigot 上回退到基于版本的 CraftBukkitCraftPlayer包。
配置与权限
新增 config.yml 条目,自动添加到现有配置中:
claim-list:
show-id: true
show-id-on-hover: false
show-divider: true
click-teleport: true
click-teleport-permission: griefprevention.claimslist.teleport
page-size: 10
page-buttons: true
claim-flags:
enabled: true
deny-message: actionbar
disabled-flags: []
spawn-flags-ignore-reasons:
- CUSTOM
- COMMAND
- SPAWNER_EGG
market: enabled: true auto-list-signs: true allow-gui-purchase: true allow-teleport: true default-allow-teleport: true teleport-after-purchase: true default-sort: newest max-note-length: 120 mail: enabled: true default-accepts-mail: true allow-remote-deposit: true allow-owner-remote-open: true allow-letters: true max-letter-length: 240
新增命令与权限:
| 命令 / 权限 | 默认值 | 用途 |
| --- | --- | --- |
| `/claimmarket [search]` (`/claimshop`) | `griefprevention.claim.market` (`true`) | 打开领地市场 GUI |
| `griefprevention.claim.listed` | `true` | 查看和管理你当前的出售列表(`/claim listed`) |
| `griefprevention.claim.market.buy` | `true` | 从领地市场 GUI 中租赁或购买领地及邮箱 |
| `griefprevention.claim.market.teleport` | `true` | 传送至允许市场访问的出售列表位置 |
| `griefprevention.claim.market.edit` | `true` | 编辑你自己出售列表的价格、可见性、传送设置和备注 |
| `griefprevention.claim.market.mail.deposit` | `true` | 远程向邮箱中存入礼物物品 |
| `griefprevention.claim.market.mail.letter` | `true` | 向邮箱中发送书信 |
| `griefprevention.claim.market.mail.open-own` | `true` | 从 *我的领地* 或 *领地市场* 远程打开你自己的邮箱 |
| `griefprevention.claim.market.admin` | `op` | 编辑或删除任何玩家的市场列表和邮件设置 |
| `griefprevention.claim.flags.bypass` | `op` | 绕过内置的领地标志并编辑任意标志 |
| `griefprevention.claimslist.teleport` | `op` | 在 `/claimlist`(`/claimslist`, `/claim list`)中点击传送至自己或受信任玩家的领地 |
| `griefprevention.claimslistother.teleport` | `op` | 查看其他玩家的 `/claimlist <player>` 时(需具备 `griefprevention.claimslistother` 权限),点击传送 |
| `griefprevention.sign.create.buy.anywhere` | `op` | 在非目标领地外放置 `[Buy]` 标牌 |
| `griefprevention.sign.create.mailbox.anywhere` | `op` | 在被管理的领地外放置 `[Mailbox]` 标牌 |
- 新增 GUI 配置文件:`guis/flags.yml`、`guis/claim-market.yml`、`guis/listed-claims.yml`、
`guis/market-listing-edit.yml` 以及 `guis/claim-transfer.yml`。
- 新增数据文件:`claimflags.yml` 和 `market.yml`。
## 兼容性
基于 GriefPrevention3D `18.2.7`、Paper `26.2` 和 Spigot `1.21.4`(`-Pspigot-compat`)构建,
使用 BlueMap API `2.8.0` 和 Dynmap API `3.8`。兼容 Spigot、Paper、Purpur 和 Folia,适用于
Minecraft `1.20`–`26.3`。无需手动进行存储迁移。
## 验证
- `mvn -Pspigot-compat clean test`(`spigot-api:1.21.4-R0.1-SNAPSHOT`)和 `mvn clean test package`
(`paper-api:26.2.build.40-alpha`)均成功并通过全部 17 项单元测试,包括 `plugin.yml`
与 `paper-plugin.yml` 的一致性、Spigot BungeeCord 点击/十六进制组件转换、跨 Paper 和 Spigot 路径的交互式
`/claimlist` 悬停/点击/分页格式化,以及 `guis/claim-options.yml` 布局迁移。
- 验证 `target/GPExpansion.jar` 不包含任何硬编码的 `io/papermc/paper` 字节码引用,
且未包含任何未重定位的 `net/kyori` 类。
GPExpansion v1.2.5
本次更新会在 Dynmap 和 BlueMap 上绘制所有领地,使 /claim color 支持任意十六进制颜色,并添加了一项权限:在领地内拥有永不耗尽的飞行时间。现在,跨重连时其他插件授予的飞行状态会被保留。
Maven 项目版本已更新至 1.2.5。新的配置项和权限会自动添加到现有安装中。
Dynmap 和 BlueMap 上的领地显示
当安装了 Dynmap 或 BlueMap 时,GPExpansion 会添加一个 GriefPrevention 图层以勾勒每个领地的轮廓。形状化的 GriefPrevention3D 领地将按其真实轮廓绘制。点击领地可查看其所有者,若启用 show-trust-list(显示信任列表),还可查看管理员、建造者、容器访问者和物品存取者。
- 两项集成默认开启,在相应的地图插件存在前不会执行任何操作。可通过
integrations.dynmap.enabled或integrations.bluemap.enabled关闭其中一项。 - 即使地图插件在 GPExpansion 之后启动,GPExpansion 也能挂钩生效,且执行
/gpx reload可立即应用这些设置的更改。 - 标记每
update-interval-seconds秒刷新一次(默认为 300 秒,最低不少于 15 秒)。 - 在 BlueMap 上,当
flat-view-only开启时,2D 领地在render-height(63,略高于海平面)处平铺绘制,使轮廓贴合地面。除非将depth-test设置为true,否则轮廓会穿透地形显示。形状化领地始终保持其真实高度。
颜色
每个领地使用其各自的 /claim color 设置,否则使用 integrations.colors.main-claim(#FFD700)或 integrations.colors.admin-claim(#FF8C00)。当 fill-opacity(填充不透明度)为 0 时,填充色为轮廓颜色的半透明色调。
十六进制领地颜色
/claim color 现接受十六进制值(#RGB、#RRGGBB 或 #RRGGBBAA)以及 16 种命名颜色。你设置的颜色将同时用于定位栏航标和地图标记。claimdata.yml 将其存储为颜色名称或 #rrggbb 格式。
无限领地飞行
griefprevention.claimfly.unlimited(默认权限为 op)允许玩家在没有储存飞行时间的情况下使用领地飞行功能。只要他们在允许飞行的领地内飞行,就不会消耗时间。在领地外飞行时,若 claim-flight.disable-on-leaving-claim 关闭,仍会消耗时间。
/claimfly命令会告知持有者在领地内飞行是无限的,而不是显示余额。/claimfly check <player>对持有者报告unlimited,因此余额为 0 不会被误读为无法飞行。%gpx_claim_flight%对在线持有者报告yes。离线玩家仍根据其储存的时间进行判断。
来自其他插件的飞行
由其他插件授予的飞行状态(例如 Essentials 的 /fly 或游戏模式权限)现在会在重连后被保留。GPExpansion 不再在玩家离开领地时撤销该状态,也不再为此扣除其领地飞行时间。如果玩家在领地内时该飞行状态被移除,GPExpansion 将停止将其视为外部飞行。
配置与语言
新增 config.yml 中的 integrations 部分条目,自动添加到现有配置中:
integrations:
colors:
main-claim: "#FFD700"
admin-claim: "#FF8C00"
dynmap:
enabled: true
layer-name: GriefPrevention
update-interval-seconds: 300
show-trust-list: true
colors:
stroke-weight: 3
stroke-opacity: 1.0
fill-opacity: 0.0
bluemap:
enabled: true
marker-set-id: gpexpansion.claims
layer-name: GriefPrevention
update-interval-seconds: 300
flat-view-only: true
render-height: 63
depth-test: false
show-trust-list: true
colors:
line-width: 2
fill-opacity: 0.0
- 新增权限:
griefprevention.claimfly.unlimited(默认op)。 claim.color-usage和claim.color-invalid提及了十六进制值。已有的lang.yml若包含这些键,则保留其当前文本。- Dynmap 和 BlueMap 在
paper-plugin.yml中为可选依赖项。
兼容性
基于 GriefPrevention3D 18.2.7 和 Paper 26.2 构建,使用 BlueMap API 2.8.0 和 Dynmap API 3.8。无需进行存储迁移。
验证
mvn clean package成功完成,生成了版本为1.2.5的target/GPExpansion.jar。- GriefPrevention3D 的插件兼容性检查针对 GriefPrevention3D
19.0.1编译了本次更新。 - 现有的 10 个单元测试全部通过。本次更新的变更未被这些测试覆盖。
- 仍需在实际服务器中检查的内容:Dynmap 和 BlueMap 上的标记(包括形状化领地和信任列表)、地图和定位栏上的十六进制
/claim color值、在griefprevention.claimfly.unlimited权限下领地内外的飞行功能,以及 Essentials/fly在重连后的表现。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧