生态区#

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

由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[potion_contents={custom_color: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

  data:
    type: BIOME
    id: example_biome

  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

命令#

权限#

更新日志#

翻译#

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/bentoboxworld/</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();
}