BuyRegion (1.13+) - BuyRegion - 领地买卖插件

BuyRegion 是一款允许玩家通过告示牌购买或租赁 WorldGuard/RedProtect 领地的插件。它通过 Vault 支持各类经济系统，为服务器提供了便捷的领地交易功能。

💡要求与依赖

前置插件

• Vault (必需)
• 领地管理插件 (必需，任选其一)
• WorldGuard (版本 > 7.0.0 Beta 3，适用于 MC 1.13+)
• RedProtect (版本 > 7.6.0 b#200)
• 经济插件 (必需)
• 任何 Vault 支持的经济插件，例如 Essentials

从旧版本升级

• 如果从 MC 1.13 之前的版本升级，请务必备份你的 BuyRegion、WorldGuard 和 WorldEdit 配置文件。
• 下载适用于 MC 1.13 的最新版 WorldGuard 和 WorldEdit (开发版)。
• 用本项目的新版 BuyRegion.jar 替换旧的插件文件。

✨功能与更新

新增功能

• 在 config.yml 中增加了更好的国际化 (i18n) 支持，可选择语言。
• 支持 WorldGuard 以外的其他领地管理插件。

问题修复

• 修复了当领地未找到时可能发生的 NullPointerException。
• 为大多数输出到控制台的错误信息添加了上下文，便于用户和管理员排查问题。

性能优化

• 略微提升了配置读取性能，代价是几乎无法察觉的内存占用增加。
• 对象现在仅在加载和卸载时进行类型转换，而非每次使用时。

🔧安装与权限

安装步骤

• 将插件放入服务器的 plugins 目录。
• 重启服务器。
• 根据需要配置权限。
• 完成！

权限节点

• buyregion.create - 允许创建 [BuyRegion] 和 [RentRegion] 告示牌。
• buyregion.admin - 允许使用管理员命令。
• buyregion.exempt - 允许玩家绕过 BuyRegionMax 限制。
• buyregion.buy - 允许玩家购买领地 (如果配置要求)。
• buyregion.rent - 允许玩家租赁领地 (如果配置要求)。

🎮告示牌使用指南

创建购买告示牌

告示牌文本格式如下

[BuyRegion]
<领地名称>
<价格>
<任意文本/留空>

示例：

[BuyRegion]
epic_store
200

此告示牌将以 200 经济货币的价格出售名为 epic_store 的领地。

创建租赁告示牌

告示牌文本格式如下

[RentRegion]
<领地名称>
<价格>
<租赁时长>

示例：

[RentRegion]
epic_store
200
7 days

此告示牌将以 200 经济货币的价格出租名为 epic_store 的领地，租期为 7 天。

购买领地流程

• 玩家输入 /buyregion 命令进入购买模式。
• 玩家右键点击一个 [BuyRegion] 告示牌。
• 如果 RequireBuyMode 配置项设为 false，则玩家无需先进入购买模式即可直接购买。

租赁领地流程

流程与购买领地相同。

⭐命令列表

玩家命令

• /buyregion - 切换购买模式。
• /buyregion renew <region> - 续租指定的领地。
• /buyregion autorenew - 显示当前的自动续租状态。
• /buyregion autorenew <true/false> - 为该玩家设置所有租赁的自动续租状态。
• /buyregion help - 显示帮助界面。

管理员命令

• /buyregion reload - 重载配置和语言文件。
• /buyregion buycheck <player> - 检查玩家已购买的领地总数。
• /buyregion rentcheck <player> - 检查玩家已租赁的领地总数。
• /buyregion buyset <player> <amount> - 设置玩家已购买的领地总数。
• /buyregion rentset <player> <amount> - 设置玩家已租赁的领地总数。
• /buyregion buymax - 显示当前的 BuyRegionMax 值。
• /buyregion buymax <amount> - 设置 BuyRegionMax 值 (设为 0 表示无限制)。
• /buyregion rentmax - 显示当前的 RentRegionMax 值。
• /buyregion rentmax <amount> - 设置 RentRegionMax 值 (设为 0 表示无限制)。
• /buyregion buymode - 显示当前的 RequireBuyMode 设置。
• /buyregion buymode <true/false> - 设置 RequireBuyMode。
• /buyregion buyperms - 显示当前的 RequireBuyPerms 设置。
• /buyregion buyperms <true/false> - 设置 RequireBuyPerms。
• /buyregion rentperms - 显示当前的 RequireRentPerms 设置。
• /buyregion rentperms <true/false> - 设置 RequireRentPerms。
• /buyregion evict <region> - 驱逐指定领地的租户/拥有者。
• /buyregion help - 显示所有命令。

❓配置说明

主要配置选项

• SignHeaderBuy - 购买领地告示牌的首行文本，默认为 [BuyRegion]。
• SignHeaderRent - 租赁领地告示牌的首行文本，默认为 [RentRegion]。
• PayRentOwners - 是否将租金支付给领地的原拥有者。
• BuyRegionMax - 单个玩家最多可购买的领地数量。
• RentRegionMax - 单个玩家最多可租赁的领地数量。
• CheckExpirationsInMins - 检查租赁过期的频率 (单位：分钟)。
• RequireBuyMode - 是否要求玩家必须先进入购买模式才能使用告示牌 (推荐：true)。
• RequireBuyPerms - 是否要求玩家拥有 buyregion.buy 权限才能购买。
• RequireRentPerms - 是否要求玩家拥有 buyregion.rent 权限才能租赁。
• DateFormat - 设置日期格式，可选值：Default (年/月/日), US (月/日/年), EU (日/月/年)。

消息自定义

所有发送给玩家的消息都可以通过编辑 config.yml 文件中的 Messages 部分进行修改。你可以根据字段名和内容来判断每条消息的用途。

💡重要注意事项

关于自动续租

• 所有玩家的自动续租功能默认是关闭的。他们只需要手动开启一次即可。

关于告示牌

• 每个可租赁/购买的领地只使用一个对应的 [RentRegion] 或 [BuyRegion] 告示牌。出于性能考虑，插件并未完全支持同一领地的多个告示牌，这可能导致异常行为。
• 建议尽量避免原有的租赁告示牌被破坏，因为其替换功能在位置确定上可能仍不完善。

关于性能配置

• CheckExpirationsInMins 配置项接受小数，例如 0.05 代表 3 秒。但不建议将其设置为低于 0.5 (30秒)。对于租赁了大量领地的服务器，频繁检查可能消耗较多资源。对于通常按天租赁的普通服务器，建议保持 5 分钟或以上。
• 插件没有将告示牌设置为不可破坏，因为通常可以将其放置在已受保护的领地内（这样它自然就无法被破坏）。同时，为了性能，插件也尽量避免挂钩方块破坏事件。