Skip to content

TopBlock#

为 BentoBox 专门计算 AOneBlock 岛屿等级的插件。排名由挖掘了多少魔法方块决定 - 计数。

由 tastybento 创建和维护。

有用的链接

安装#

  1. 将 top block 插件 jar 文件放入 BentoBox 插件的 addons 文件夹
  2. 重启服务器
  3. 插件将创建一个数据文件夹,里面有一个 config.yml
  4. 根据需要编辑 config.yml。
  5. 如果进行了更改,请重启服务器

配置#

TopBlock 插件有 2 个通用配置项:

  • config.yml 文件包含插件的默认配置。
  • /panels/ 包含管理玩家 GUI 的文件。

config.yml#

配置文件包含插件的主要功能。

最新的 config.yml 可以在这里找到。

本节定义了插件的许多整体设置。

refresh-time

前十名应该以分钟为单位刷新的频率。最小值为 1 分钟,默认值为 5 分钟。 每次刷新都需要从数据库读取每个岛屿,因此不应过于频繁。

默认值: 5

shorthand

允许显示较短的岛屿等级数字。

显示向下取整的大等级值,例如 10,345 -> 10k

默认值: false

可自定义 GUI#

BentoBox 1.17 API 引入了一个允许实现可自定义 GUI 的功能。我们尽量让自定义变得简单,但有些功能需要解释。 你可以在这里找到更多关于 BentoBox 自定义 GUI 如何工作的信息: 自定义 GUI

我如何自定义 GUI?

插件将在 /plugins/bentobox/addons/topblock 下创建一个名为 panels 的新目录

目前你可以自定义 GUI:

  • 排行榜面板: top_panel - 允许查看前 10 名岛屿。
TOP 按钮类型是什么?

此按钮在 top_panel 中可用。它按岛屿排名前 X 显示岛屿。

icon 默认为 PLAYER_HEAD,带有正确的玩家皮肤。启用它将使用指定的材料替换它。

data 字段中的 index 允许指定当前位置应显示前 10 名中的哪个位置。

排行榜面板有 2 个实现的操作,功能需要额外的插件:

  • warp - 需要 Warps 插件。仅当玩家岛屿上存在传送标志时才会显示。
  • visit - 需要 Visit 插件。仅当玩家岛屿上允许访问时才会显示。

Fallback 允许在排行榜位置上没有玩家时更改背景图标。

示例: 

    #icon: PLAYER_HEAD
    title: topblock.gui.buttons.island.name
    description: topblock.gui.buttons.island.description
    data:
      type: TOP
      index: 1
    actions:
      warp:
        click-type: LEFT
        tooltip: topblock.gui.tips.click-to-warp
      visit:
        click-type: RIGHT
        tooltip: topblock.gui.tips.right-click-to-visit
    fallback:
      icon: LIME_STAINED_GLASS_PANE
      title: topblock.gui.buttons.island.empty

VIEW 按钮类型是什么?

此按钮在 top_panel 中可用。它显示查看者的岛屿 topblock 值。

icon 默认为 PLAYER_HEAD,带有正确的玩家皮肤。启用它将使用指定的材料替换它。

view 操作允许查看玩家岛屿的详细菜单。

示例: 

    #icon: PLAYER_HEAD
    title: topblock.gui.buttons.island.name
    description: topblock.gui.buttons.island.description
    data:
      type: VIEW
    actions:
      view:
        click-type: unknown
        tooltip: topblock.gui.tips.click-to-view

命令#

Tip

[player_command] 和 [admin_command] 是根据你运行的游戏模式而不同的命令。 游戏模式的 config.yml 文件包含允许你修改这些值的选项。 例如,在 BSkyBlock 中,默认的 [player_command] 是 island,默认的 [admin_command] 是 bsbadmin。

  • /[player_command] topblock: 访问排行榜面板。需要 aoneblock.island.topblock 权限。

权限#

  • aoneblock.island.topblock - (默认: true) - 允许玩家使用 /[player_command] top 命令。
有缺失的内容吗?

你可以在此插件的 addon.yml 文件中找到完整的权限列表。 如果下面的列表中确实缺少了什么,请告诉我们!

占位符#

提示

[gamemode] 是一个前缀，根据你运行的游戏模式而有所不同。

前缀是游戏模式名称的小写形式，即如果你正在使用 BSkyBlock，前缀则为 bskyblock。

每个游戏模式正确翻译的占位符可以在以下位置找到：

请阅读主要的占位符页面.

Placeholder Description TopBlock version
%aoneblock_island_player_name_top_#rank#% Island owner's name at the #rank# position 1.0.1
%aoneblock_island_member_names_top_#rank#% Name of island team members at the #rank# position 1.0.1
%aoneblock_island_phase_name_top_#rank#% Name of the phase they have reached at the #rank# position 1.0.1
%aoneblock_island_phase_number_top_#rank#% Phase number (e.g. Plains is 1; Underground is 2) at the #rank# position 1.0.1
%aoneblock_island_count_top_#rank#% Block Count of magic blocks mined this round at the #rank# position 1.0.1
%aoneblock_island_lifetime_top_#rank#% Lifetime count of magic blocks mined at the #rank# position 1.0.1

常见问题#

你能添加 X 功能吗?

请将其添加到这里的列表中。

翻译#

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

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

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

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

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

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

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

API#

Maven 依赖#

TopBlock 为其他插件提供了 API。

Note

将 TopBlock 依赖项添加到你的 Maven POM.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>topblock</artifactId>
            <version>1.0.1</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

TopBlock 的 JavaDoc 可以在这里找到。

Last update: April 3, 2024 02:27:47