生态区#

生态区允许您的玩家在他们的岛屿上改变生态区。

由BONNe创建和维护。

安装#

1. 将插件 jar 文件放到 plugins/BentoBox/addons 文件夹中。
2. 启动并停止服务器，让生态区生成其配置文件。
3. 编辑config.yml和biomesTemplate.yml文件（你可以在plugins/BentoBox/addons/Biomes文件夹中找到它们）。
4. 重启服务器。
5. 将生态区导入到游戏模式中。

配置#

config.yml#

插件安装成功后，它将创建config.yml文件。这个文件中的每个选项都附有注释。请查阅文件以获取更多信息。 你可以在这里找到最新的配置文件：config.yml

模板#

此文件包含有关默认生态区的所有必要信息。 如果你在biomes.yml中更改了值，那么要应用它们，你必须运行 /[admin_command] biomes。

默认模板文件可以在这里找到：biomesTemplate.yml

块都应用成本，PER_USAGE - 每次使用后成本增加[increment]。默认为STATIC。 cost: # 更改生态区的成本。需要Vault和经济插件。默认为0。 items: [] # 更改生态区所需的物品集。每个物品的写入格式可以在：https://docs.bentobox.world/en/latest/BentoBox/ItemParser/ 中找到。默认为空。 increment: # 如果使用设置为PER_USAGE，则所有成本（金钱和物品）的增量。默认为0。（作为静态） # 这里开始捆绑包列表 bundles: # 内部数据结构。 : # 捆绑包的唯一名称。必需！ name: # 捆绑包的自定义名称。默认为。 description: # 图标描述中的一些额外描述。默认为空。 icon: # BentoBox ItemParser类型。写入格式可以在：https://docs.bentobox.world/en/latest/BentoBox/ItemParser/ 中找到。默认为纸。 biomes: [] # 在生态区部分中使用的集。默认为空。 ```

可自定义的GUI#

BentoBox 1.17 API引入了一个功能，允许实现可自定义的GUI。这个插件是第一个使用这个功能的插件之一。我们试图尽可能简单地进行自定义，然而，一些功能需要解释。 你可以在这里找到更多关于BentoBox自定义GUI如何工作的信息：自定义GUI

    icon: tipped_arrow{CustomPotionColor:11546150}
    title: biomes.gui.buttons.previous.name
    description: biomes.gui.buttons.previous.description
    data:
      type: PREVIOUS
      indexing: true
    action:
      left:
        tooltip: biomes.gui.tips.click-to-previous

    data:
      type: RETURN

保持空白。

默认情况下，生态区将根据它们的顺序编号进行排序，然而，你可以使用`id`参数在数据下指定特定生态区在特定插槽中。

```yaml
  data:
    type: BIOME
    id: example_biome
```

指定标题、描述和图标将覆盖基于数据库数据的动态生成。默认情况下，这些值将从数据库条目中生成。
这个按钮支持3种不同的操作类型：

- CHANGE - 根据默认更新模式和默认范围值更改生态区。在main_panel中可用。
- ADVANCED_PANEL - 打开允许选择不同生态区更新模式的高级面板。在main_panel中可用。
- BUY - 购买选定的生态区。在buy_panel中可用。

示例： 
```yaml
  data:
    type: BIOME
  actions:
    left:
      type: CHANGE
      # 支持ISLAND | CHUNK:NUMBER | RANGE:NUMBER
      content: ISLAND
      tooltip: biomes.gui.tips.left-click-to-apply
    right: 
      type: ADVANCED_PANEL
      tooltip: biomes.gui.tips.right-click-to-open
```

    data:
      type: PURCHASE
    action:
      left:
        tooltip: biomes.gui.tips.click-to-view

    data:
      type: INCREASE
      value: 5
    actions:
      left:
        tooltip: biomes.gui.tips.click-to-increase

    data:
      type: MODE
      value: CHUNK
    actions:
      left:
        tooltip: biomes.gui.tips.click-to-choose

    data:
      type: ACCEPT
    actions:
      left:
        type: ACCEPT
        tooltip: biomes.gui.tips.left-click-to-accept
      right:
        type: INPUT
        tooltip: biomes.gui.tips.right-click-to-write

命令#

命令的帮助 - /[player_command] biomes set <biome> [<type>] [<size>]: 此命令允许在不打开GUI的情况下更改岛屿上的生态区。如果参数和未提供，命令将使用插件配置中的默认值。 - /[player_command] biomes buy <biome>: 此命令允许在不打开GUI的情况下购买生态区。

!!! 信息
    - `<biome>`可能不是实际Minecraft生态区名称。它是由管理员定义的。
    - `<type>`是三种生态区更改类型之一。它提供在整个岛屿(`ISLAND`)、当前区块(`CHUNK`)或围绕玩家的距离(`RANGE`)上更改生态区。

权限#

翻译#

!!! note "我们需要你的帮助！

BentoBox 及其附加组件中的绝大多数字符串几乎可以翻译成任何语言。

然而，BentoBox 或上述附加组件提供的大部分翻译都是由社区完成的，我们在很大程度上依赖社区。

我们无法审查这些翻译的所有内容，也无法保证其质量，因此我们非常感谢任何贡献。

• 如果这个附加组件没有提供你的语言，或者你想改进现有的翻译，请阅读翻译指南并开始翻译！

• 如果下面没有列出你的语言，请在 Discord 上联系我们，我们会安排一切，以便你可以开始翻译！

Available	Language	Language code	Progress
✅	English (United States)	en-US	100% (Default)
✅	中文（中国）	zh-CN
❌	中文（香港）	zh-HK
❌	中文（台湾）	zh-TW
❌	克罗地亚语	hr
❌	捷克语	cs
✅	法语	fr
❌	德语	de
❌	匈牙利语	hu
❌	印尼语	id
❌	意大利语	it
❌	日语	ja
❌	韩语	ko
✅	拉脱维亚语	lv
✅	波兰语	pl
❌	葡萄牙语	pt
❌	罗马尼亚语	ro
❌	俄语	ru
✅	西班牙语	es
❌	土耳其语	tr
❌	越南语	vi
✅	乌克兰语	uk
❌	荷兰语	nl

API#

自从生态区2.0和BentoBox 1.17以来，其他插件可以直接访问生态区插件数据。然而，插件请求仍然是对于不想使用太多依赖的插件来说是一个好的解决方案。

Maven依赖#

生态区提供了一个用于其他插件的API。这涵盖了2.1.0及之后的版本。

添加生态区依赖到你的Maven POM.xml中：

```xml
    <repositories>
        <repository>
            <id>codemc-repo</id>


            <url>https://repo.codemc.io/repository/maven-public/</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>world.bentobox</groupId>
            <artifactId>biomes</artifactId>
            <version>2.1.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
```

使用最新的生态区版本。

生态区的JavaDocs可以在这里找到。

事件#

@EventHandler(priority = EventPriority.LOW)
public void onBiomesUnlock(BiomeUnlockedEvent event) {
    User user = event.getUser();
    BiomesObject biomesOjbect = event.getBiomesObject();
    Island island = event.getIsland();

    // 还有转换方法，不使用生态区插件对象。
    UUID userUUID = event.getUserUUID();
    String islandUUID = event.getIslandUUID();
    String biomeId = event.getBiomeId();
    Biome biome = event.getBiome();

    event.setCancelled(false);
}

@EventHandler(priority = EventPriority.MONITOR)
public void onBiomesPurchase(BiomePurchasedEvent event) {
    User user = event.getUser();
    BiomesObject biomesOjbect = event.getBiomesObject();
    Island island = event.getIsland();

    // 还有转换方法，不使用生态区插件对象。
    UUID userUUID = event.getUserUUID();
    String islandUUID = event.getIslandUUID();
    String biomeId = event.getBiomeId();
    Biome biome = event.getBiome();
}

Coordinate- 生态区更改的最小坐标。 -@NotNull BlockVector maxCoordinate` - 生态区更改的最大坐标。

!!! 示例 "代码示例"
    ```java
    @EventHandler(priority = EventPriority.MONITOR)
    public void onBiomesPreChange(BiomePreChangeEvent event) {
        User user = event.getUser();
        BiomesObject biomesOjbect = event.getBiomesObject();
        Island island = event.getIsland();

        BlockVector minCoordinate = event.getMinCoordinate();
        BlockVector maxCoordinate = event.getMaxCoordinate();

        // 还有转换方法，不使用生态区插件对象。
        UUID userUUID = event.getUserUUID();
        String islandUUID = event.getIslandUUID();
        String biomeId = event.getBiomeId();
        Biome biome = event.getBiome();

        int minX = event.getMinX();
        int minY = event.getMinY();
        int minZ = event.getMinZ();

        int maxX = event.getMaxX();
        int maxY = event.getMaxY();
        int maxZ = event.getMaxZ();
    }
    ```

@EventHandler(priority = EventPriority.MONITOR)
public void onBiomeChanged(BiomeChangedEvent event) {
    User user = event.getUser();
    BiomesObject biomesOjbect = event.getBiomesObject();
    Island island = event.getIsland();

    BlockVector minCoordinate = event.getMinCoordinate();
    BlockVector maxCoordinate = event.getMaxCoordinate();

    Result result = event.getResult();            

    // 还有转换方法，不使用生态区插件对象。
    UUID userUUID = event.getUserUUID();
    String islandUUID = event.getIslandUUID();
    String biomeId = event.getBiomeId();
    Biome biome = event.getBiome();

    int minX = event.getMinX();
    int minY = event.getMinY();
    int minZ = event.getMinZ();

    int maxX = event.getMaxX();
    int maxY = event.getMaxY();
    int maxZ = event.getMaxZ();

    String resultName = event.getResultName();
}