## BorderPlus 插件描述：
BorderPlus 是一款 Minecraft 插件，它允许您的玩家字面意义上地移动世界边界。 这通过一个用户友好的 GUI 来实现，该 GUI 可完全自定义以满足您的需求。 玩家可以使用物品、方块或货币来支付扩展世界边界的费用。 借助最新更新，我们引入了 **集体捐款系统**， 允许玩家汇集资源并共同扩展边界，从而使体验更加互动和引人入胜。
**集体捐款系统** 为您的服务器带来了以社区为中心的转折，玩家可以贡献物品或货币来达成共同目标，以扩展世界边界。 一旦目标达成，世界边界将自动扩展，并通过自定义通知告知所有在线玩家。 集体系统不仅跟踪贡献，还会在排行榜上显示顶级贡献者，从而鼓励友好的竞争。 要打开捐款 GUI，玩家只需键入 `/borderplus collective `。
每个 **世界边界** 可以配置具有单独的限制，以防止扩展超出指定的最大半径。 这确保了平衡并防止世界变得太大难以管理。 贡献通过 SQLite 数据库跟踪，因此即使在重启后也不会丢失任何玩家的努力。
该插件提供 **广泛的自定义选项**，包括每个世界的 GUI、可配置的权限、对通过 **HeadDatabase** 和 **Base64** 的头部支持，以及与经济插件（如 **Vault** 和 **PlayerPoints**）的集成。 您的玩家将在世界边界扩展时收到自定义消息和声音通知，从而进一步增强沉浸式体验。
### Java **17+** 是必需的。
## BorderPlus 插件的功能：
- 每个消息都可以自定义。
- 为每个世界创建一个单独的 GUI。
- 每个 GUI 都有其自己的用法权限。
- **集体捐款系统：** 现在玩家可以使用 `/borderplus collective ` 命令共同贡献来扩展世界边界。
- 用于保存所有玩家扩展的 SQLite 数据库系统。
- 跟踪玩家获得的总方块数。
- 用于排行榜的灵活占位符系统。
- 与 PlaceholderAPI 兼容。
- 当有人扩展世界边界时通知所有玩家。
- 当有人扩展世界边界时自定义标题。
- 支持经济。
- Vault 与兼容经济，例如 EssentialsX。
- PlayerPoints.
- 在一个世界菜单中，您可以添加货币和物品的付款选项。
- 为每个世界指定最大世界边界值。
- 支持 HeadDatabase 插件。
- 您可以使用 `hdb-` 格式。 例如：`hdb-4188`。
- 支持 Base64 格式的头部。
- 支持十六进制颜色代码。
例如：`ᱹDA &lDiamond Expansion`。
- 每个升级物品的自定义声音设置。 GUI 中的声音参数。
- 支持 Skulls 插件。要指定一个头骨，您必须使用 `skull-` 格式。
## BorderPlus 插件的命令和权限
### **玩家命令：**
- **/borderplus open ** – 打开插件菜单，允许玩家使用各种功能来扩展世界边界。
*示例：* `/borderplus open world`
- **/borderplus collective ** – 打开集体贡献菜单，允许玩家贡献资源或货币来扩展世界边界。
*示例：* `/borderplus collective world`
---
## **BorderPlus 插件的权限**
### **玩家权限：**
- **borderplus.open.** – 授予玩家访问特定世界菜单的权限。
- **borderplus.collective.** – 授予玩家访问该世界的集体贡献菜单的权限。
### **管理员权限：**
- **borderplus.change** – 允许玩家使用 `/borderplus ` 命令修改世界边界。
- **borderplus.reload** – 授予重新加载插件及其配置的权限。
## 配置文件示例：
**config.yml**
```yml
# ===============================
# 插件设置
# ===============================
#
# 您可以为每个世界配置单独的 GUI。 这些 GUI 将在玩家进入各自世界时或使用命令 «/borderplus open world_name» 时自动打开。
#
# 配置示例：
# - 指定世界名称和将为该世界打开的 GUI 文件。
# - 对于未使用的世界，注释掉或删除行。
#
settings:
# 插件消息的语言选择
# 可能的值：
# "en" 用于英语
# "ru" для Русского
# "de" für Deutsch
# "fr" pour le français
# "es" para español
# "it" per l'italiano
# "pt" para português
# "zh" 表示中文
language: "en"
# 当玩家扩展世界边界时是否向所有玩家显示标题？
# true = 显示
# false = 不要显示
show_title: true
# 启用或禁用经济的使用
# true = 启用
# false = 禁用
economy_enabled: true
# 要使用的经济系统
# 可能的值： "playerpoints", "vault", "default"
# "default" 表示如果找到两个插件，将使用 PlayerPoints。
preferred_economy: "default"
# 达成目标所需的资源或货币的总量
# 达到集体目标后，世界边界将扩展。
collective_goal: 1000
# 世界边界扩展后移动的方块数量
# 例如，如果设置为 1000，世界边界将以每个方向 1000 个方块扩展。
collective_expansion_amount: 1000
worlds:
world:
gui: "gui.yml"
max_size: 5000
collective_gui: "collective_gui_world.yml"
name: "生存世界"
#flat_world:
#gui: "gui2.yml"
#collective_gui: "collective_gui_flat_world.yml"
#max_size: 5000
#name: "平坦世界"
#world3:
#gui: "gui3.yml"
#collective_gui: "collective_gui_world3.yml"
#max_size: 5000
#name: "第三世界"
```
### 世界 "world" 的 GUI 看起来：
在材质字段中，您可以使用三种类型的物品：
物品名称。 例如：DIAMOND，将显示钻石。
HeadDatabase 插件中的头部。 例如：hdb-4188，其中 4188 是插件中的头部 ID。
Base64 格式的头部。 例如：
```
material: base64-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjRhMmFmMjYxMDFmNDRmMTE2YWY5MzM3NzRjMDQ3NGI3NjcxODJlNmNhM2Y4ZmRmMTc2NDFlY2YwMmI2YTE4ZCJ9fX0=
```
您可以在网站上找到您需要的头部：https://minecraft-heads.com/
Skulls 插件中的头部。 例如：skull-，其中 是头骨 ID。 确保安装了 Skulls 插件才能使用此功能。
**gui.yml**
```yml
menus:
border_menu:
title: ' b◂ ˑc8a&l边境扩展 b▸'
size: 27
items:
increase_diamond_20:
required_material: DIAMOND
cost: 0.0
material: DIAMOND
lore:
- ''
- ' &7花费 &b&l100颗钻石&7 以'
- ' &7增加世界边界'
- ' &7by &b&l500 个方块'
- ''
- ' 𩁠⋅ a852点击 - 扩展边界'
- ''
required_amount: 100
sound: BLOCK_ANVIL_LAND
weight: 500
economy: false
slot: 10
display_name: 'ᱹDA &l钻石扩展'
increase_gold_50:
required_material: GOLD_INGOT
cost: 0.0
material: GOLD_INGOT
lore:
- ''
- ' &7花费 &6&l50 金锭&7 以'
- ' &7增加世界边界'
- ' &7by &6&l500 个方块'
- ''
- ' 𩁠⋅ a852点击 - 扩展边界'
- ''
required_amount: 50
sound: ENTITY_PLAYER_LEVELUP
weight: 500
economy: false
slot: 13
display_name: 'ᱹDA &l黄金扩展'
increase_iron_100:
required_material: IRON_INGOT
cost: 0.0
material: IRON_INGOT
lore:
- ''
- ' &7花费 &f&l100 铁锭&7 以'
- ' &7增加世界边界'
- ' &7by &f&l100 个方块'
- ''
- ' 𩁠⋅ a852点击 - 扩展边界'
- ''
required_amount: 100
sound: ENTITY_EXPERIENCE_ORB_PICKUP
weight: 500
economy: false
slot: 16
display_name: '&f&l铁扩展'
increase_economy_1000:
required_material: EMERALD
cost: 1000.0
material: EMERALD
lore:
- ''
- ' &7花费 &61000 币&7 以'
- ' &7增加世界边界'
- ' &7by &a&l1000 个方块'
- ''
- ' 𩁠⋅ a852点击 - 扩展边界'
- ''
required_amount: 1000
sound: BLOCK_GRASS_BREAK
weight: 1000
economy: true
slot: 22
display_name: '&a&l翡翠边境扩展'
```
**collective_gui_world.yml**
```yml
menus:
collective_menu:
title: ' b◂ ˑc8a&l储蓄罐 b▸'
size: 27
items:
center_item:
material: GOLD_INGOT
lore:
- ''
- ''
- ' &7已贡献： &a%borderplus_collective_progress_world%&7%'
- ' %progress_bar_world%'
- ''
- ' &9&l领先者'
- ' &e1名： &b%borderplus_collective_top_name_1%'
- ' &e2名： &b%borderplus_collective_top_name_2%'
- ' &e3名： &b%borderplus_collective_top_name_3%'
- ''
- ' &a您的贡献： &7%borderplus_collective_player_contribution%'
- ''
- ' 𩁠⋅ a852点击下面的'
- ' 𩁠 按钮投稿'
- ''
slot: 13
display_name: '&e世界扩展进度'
contribute_1:
material: IRON_INGOT
lore:
- ''
- ' &7点击以贡献'
- ' &a1 &7资源到储蓄罐。'
- ''
slot: 21
economy: false
display_name: '&a贡献 1 资源'
contribution_amount: 1
contribute_100:
cost: 100.0
material: EMERALD
lore:
- ''
- ' &7点击以贡献'
- ' &a100 币 &7到储蓄罐。'
- ''
slot: 23
economy: true
display_name: '&a贡献 100 币'
contribution_amount: 100
```
### 消息文件：
```yml
# ===============================
# 插件消息 #
# ===============================
#
# 您可以自定义它，使其更具信息性和吸引力。
# ===============================
messages:
border_expanded: |
A0DAD&l *✧･ﾟ &#C4B0FB世界边界扩展 A0DAD&lﾟ･✧*
A0DAD &#AB47BC%player% A0DAD扩展了 &#B388EB%borderplus_world_name% by A0DAD&#AB47BC%actual_amount% A0DAD方块!!
A0DAD
&#C4B0FB 新的世界边界：
E57C2 最小坐标： ╧CD[%minX%, %minZ%]
E57C2 最大坐标： ╧CD[%maxX%, %maxZ%]
A0DAD&l ･✧ﾟ======================= ﾟ✧･
insufficient_items: "&c您没有足够的 %material% (%needed% pcs.)!"
insufficient_funds: " &c缺钱，但你还在坚持。 需要： %cost%。"
items_removed: "\nᱹDA 从您的库存中删除了 ᱹDA&l%amount_removed% ᱹDA物品。\n "
money_removed: "\nᱹDA 从您的帐户中删除了 ᱹDA&l%amount_removed% ᱹDA币。\n "
invalid_number: "&c无效数字。"
gui_item_not_found: "&c菜单中未找到该物品。"
reload_complete: "&a配置已重新加载。"
title_message: "&e世界边界扩展"
title_next: "&e%player% 扩展了世界边界 %actual_amount% 个方块"
usage: "&c参数不足"
usage_open: "&c无效命令用法! &7用法： &f/borderplus open &e<世界名称>"
no_permission: " &c没有权限，下次好运。"
loaded_guis: "§a已加载以下世界 GUI："
world_gui_info: "§a世界： §e{world} §a| GUI： §e{gui}"
gui_not_found: "§c未找到此世界的GUI."
gui_title_size: "标题： %title% | 大小： %size%"
max_radius_reached: "§c世界边界已达到其最大尺寸。 进一步扩展是不可能的。"
no_data: "没有数据"
not_in_top: "不在前列"
not_found: "找不到"
world_not_found: "世界未找到"
invalid_position_number: "无效的位置号码"
# ============= 消息设置结束 ================== #
```
## BorderPlus 插件占位符：
*需要 PlaceholderAPI 才能正常运行。*
### 一般占位符：
- **`%borderplus_player_rank%`**
返回排行榜上玩家的当前排名，基于扩展的方块数量。 如果玩家不在前几名，则返回消息“不在前列”。
- **`%borderplus_player_blocks%`**
显示玩家贡献给世界边界扩展的总方块数。 此占位符反映了特定玩家的累积贡献。
- **`%borderplus_top_block_nick_X%`**
返回在排行榜上占据特定位置 (X) 的玩家的姓名（按方块扩展计算）。
- *X* 是排行榜位置（例如，`1` 代表第一名）。
- **`%borderplus_top_block_rank_X%`**
显示在排行榜的特定位置 (X) 中，玩家扩展的方块数量。
- *X* 表示排行榜中的位置。
- **`%borderplus_top_block_position_X%`**
显示排行榜上的数字位置。
- *X* 是所需排行榜位置。
- **`%borderplus_world_display_name_%`**
返回插件设置中配置的世界的显示名称。 如果未找到世界，则返回消息“世界未找到”。
- **`%borderplus_world_current_size_%`**
显示指定世界的当前大小（半径）。
- **`%borderplus_world_max_size_%`**
显示指定世界允许的最大半径。
- **`%borderplus_world_max_diameter_%`**
返回指定世界允许的最大直径。
这些占位符允许灵活地显示与世界边界和排行榜相关的信息，从而轻松地将物理物品和虚拟经济集成到您的服务器中。
### 集体捐款占位符：
- **`%borderplus_collective_progress_world%`**
显示达成集体捐款所需的百分比进度。
- **`%borderplus_collective_top_name_%`**
显示集体捐款排行榜上占据相应位置的玩家的姓名。
- **`%borderplus_collective_player_contribution%`**
显示玩家对捐款池的贡献数量（物品或币）。 此占位符反映了当前正在查看的玩家的贡献。
## 配置 BorderPlus 中的排行榜：
如果您想要显示排行榜，可以使用您选择的插件... 我喜欢使用：DecentHolograms。
```yml
pages:
- lines:
- content: " &6&lTop 1: &b%borderplus_top_block_nick_1% &7- &4⌀ &a%borderplus_top_block_rank_1% &4⟘ &a%borderplus_top_block_radius_1% blocks"
height: 0.3
- content: " &6&lTop 2: &b%borderplus_top_block_nick_2% &7- &4⌀ &a%borderplus_top_block_rank_2% &4⟘ &a%borderplus_top_block_radius_2% blocks"
height: 0.3
- content: " &6&lTop 3: &b%borderplus_top_block_nick_3% &7- &4⌀ &a%borderplus_top_block_rank_3% &4⟘ &a%borderplus_top_block_radius_3% blocks"
height: 0.3
- content: ""
height: 0.3
- content: "&f&l您的统计数据："
height: 0.3
- content: "&8#&b%borderplus_player_rank%&7 &7- &4⌀ &a%borderplus_player_blocks% &4⟘ &a%borderplus_player_radius% blocks"
height: 0.3
actions: {}
```
## BorderPlus 插件安装指南：
### 必需依赖项：
要使用 BorderPlus 插件，需要以下依赖项：
#### **强制插件：**
- **占位符：** [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
- **经济系统：**
- 您必须在服务器上安装至少一个经济插件：
- **Vault** 及其它例如 **EssentialsX** 的经济插件，以获得经济支持。
- **PlayerPoints** （如果您更喜欢基于积分的经济）。
- 如果安装了 **Vault** 和 **PlayerPoints**，插件将自动优先使用 **PlayerPoints**。
#### **可选插件（软依赖）：**
- **DecentHolograms**（或任何其他全息插件）：如果您希望在服务器上显示全息图，则推荐使用。
- **HeadDatabase**: 用于将自定义头部作为 GUI 中的物品替换。
---
### 安装步骤：
1. **确保服务器上安装了所有必需的依赖项**，如上所述。
2. **下载 BorderPlus 插件**，从官方来源下载。
3. **停止您的服务器。**
4. **将 `.jar` 文件移动到服务器目录中的 `/plugins/` 文件夹。**
5. **再次启动您的服务器。**
6. **一切设置好了！** 插件已安装并准备好使用。
通过遵循这些步骤，您将在您的服务器上顺利运行 BorderPlus，并解锁所有功能。 尽情享受！
