King of the Ladder - 梯王争霸

梯子之王

梯子之王（King of the Ladder）是一款经典的 Minecraft 大厅游戏，服务器管理员可以轻松地将其添加到服务器大厅中。在这款迷你游戏中，每位玩家都需要将其他玩家踢下梯子，以成为“国王”。国王需要努力站在梯子顶端，同时阻止他人攀爬并将其击落！

---

💡基本信息

• 最低 Java 版本: Java 21
• Discord 社区: https://discord.gg/uXVUjmtpU
• 排行榜占位符: Despicaleaderboards
• 详细文档: 请查阅我们的 Wiki
• Java API 文档: 可在线浏览
• 问题与反馈: 请使用 GitHub 上的 问题追踪器
• 支持我们: 可通过 Buy Me a Coffee 进行捐赠

---

🎮命令与权限

命令格式说明：[可选参数]， <必选参数>。

玩家命令

玩家命令无需权限即可执行。

• /kotl stats [玩家名]

- 显示你自己或指定玩家的游戏统计信息。

• /kotl top <统计类型>

- 显示指定统计类型的 TOP 10 玩家。

- 可用统计类型：`score`（分数）和 `tours_played`（游玩次数）。

管理员命令

部分管理员命令无法通过控制台执行，所有命令都需要相应权限。

• /kotl create <竞技场名称>

- 使用指定名称创建一个新的竞技场。

- 权限：`kotl.admin.create`

- 执行者：仅玩家

• /kotl delete <竞技场名称>

- 删除指定的竞技场及其配置。

- 权限：`kotl.admin.delete`

- 执行者：控制台和玩家

• /kotl edit <竞技场名称>

- 为现有竞技场打开设置编辑器。

- 权限：`kotl.admin.edit`

- 执行者：仅玩家

• /kotl list

- 打印可用竞技场列表。

- 权限：`kotl.admin.list`

- 执行者：控制台和玩家

• /kotl reload

- 重新加载所有游戏实例（游戏将被停止）。

- 权限：`kotl.admin.reload`

- 执行者：控制台和玩家

• /kotl leaderboard

- 立即更新 McRankings 条目并显示排行榜 URL。

- 权限：`kotl.admin.leaderboard`

- 执行者：控制台和玩家

• /kotl help

- 显示所有命令及其用法和描述。

- 权限：`kotl.admin.help`

- 执行者：控制台和玩家

---

✨主要特性

自定义职业

• 现已加入职业系统！
• 你可以添加无限数量的职业，并为每个职业设置权限、物品和盔甲。

无硬性依赖

• 本插件不依赖任何其他插件。
• 仅有一些可选依赖，如 PlaceholderAPI 和 Multiverse-Core（用于多世界支持）。

自定义 PAPI 占位符

• 查看我们的 Wiki 以获取插件用于游戏内消息、自定义记分板和自定义 Boss 栏的占位符列表。

广泛兼容性

• 当前支持的 Minecraft 版本为 1.8 至 1.21.4+。
• 未来发布的版本也将获得支持。

HEX 颜色支持

• 支持在游戏内消息、记分板条目和 Boss 栏消息中使用 HEX 颜色代码（例如 &#FF0000）。
• 此功能仅在 Minecraft 1.16 及更高版本中有效。

传统颜色代码支持

• 插件中的所有消息都支持传统颜色代码（例如 &a、&4）。

支持 1.8 版攻击速度

• 你可以通过修改配置文件中的数值，来调整游戏竞技场内所有玩家的通用攻击冷却速度。
• 此选项允许 1.9+ 版本的玩家像 1.8 版本玩家一样快速攻击，使条件一致。

竞技场编辑器菜单

• 我们的竞技场系统非常易于设置游戏。使用 /kotl edit 命令即可打开竞技场编辑器。

自定义竞技场压力板

• 现在竞技场设置编辑器菜单中包含自定义竞技场压力板编辑器。

多语言支持

• 当前默认支持英语、土耳其语和德语。如果你想帮助我们，可以将我们的消息翻译成你的语言。

自定义记分板与 Boss 栏

• 我们拥有可配置消息的自定义游戏内记分板和 Boss 栏。消息支持 HEX 颜色代码和 Minecraft 颜色代码。
• 在高级版本中，记分板和 Boss 栏有更多消息，并且还有一些很酷的动画效果。

MySQL 数据库支持

• 你可以将玩家统计数据存储在你的数据库中。数据库操作在连接到你的服务器上传信息时不会锁定主线程。
• 注意：在切换平面文件存储和 MySQL 数据库存储之间没有迁移工具。

死亡方块

• 这些方块非常致命，因为当玩家与之交互时，他们将被踢出游戏。死亡方块可以在配置文件中进行编辑。

奖励系统

• 奖励会发放给成为国王的玩家，以及未能成为国王的玩家。
• 奖励可以通过简单的 Java 代码执行任何操作。我们有一个 rewards.yml 文件，解释了与奖励系统相关的所有内容。我们的 API 也可以在奖励代码中访问。

---

🔧配置选项概览

以下是一些关键的配置选项，你可以在 config.yml 中找到它们及其详细描述。

• locale: 设置语言（如 default（英语）、de（德语）、tr（土耳其语））。
• Arena-Schedulers: 设置竞技场玩家检测机制（类型 1、2、3）和检测间隔。
• King-Settings: 配置与国王相关的设置，如连任、冷却时间、冷却时间覆盖权限、Boss 栏和记分板开关等。
• Database-Enabled: 启用或禁用 MySQL 数据库支持（注意：切换时没有数据迁移工具）。
• Inventory-Manager: 启用库存管理（对多竞技场非常有用），并可设置不恢复的属性。
• Clear-Inventory: 玩家加入/离开游戏区域时是否清空背包。
• Game-Mode: 设置玩家进入竞技场时的游戏模式（如 SURVIVAL）。
• Arena-Outlines: 在竞技场角落显示立方体粒子效果（如火焰）。
• Hit-Cooldown-Delay: 设置玩家攻击冷却延迟（仅影响 1.9+ 版本）。
• Death-Blocks-Enabled 与 Death-Blocks: 启用死亡方块并定义哪些方块是死亡方块（如 BEDROCK、GLASS）。
• PlaceholderAPI: 启用 PlaceholderAPI 支持。

---

⭐占位符列表

PlaceholderAPI 占位符

• %kotl_arena% - 显示玩家当前所在的竞技场（如果在游戏中），或显示消息文件中的信息。
• %kotl_score% - 显示你在游戏中的总分数。
• %kotl_tours_played% - 显示你的总游玩次数。
• %kotl_{竞技场ID}:king% - 显示指定竞技场的当前国王名称。
• %kotl_{竞技场ID}:players% - 显示指定竞技场中的玩家数量。

记分板占位符

• %arena% - 显示竞技场 ID（名称）。
• %players% - 显示竞技场中的玩家数量。
• %king% - 显示当前国王名称。
• %score% - 显示你的游戏总分数。
• %tours_played% - 显示你的总游玩次数。

游戏告示牌占位符

• %map_name% - 显示竞技场 ID（名称）。
• %players% - 显示竞技场中的玩家数量。
• %king_name% - 显示当前国王名称。

---

❓开发者 API

我们提供了公共 API。如果你不想使用公共 API，我们的 Wiki 上也有关于如何将此插件作为库使用的详细教程。首先，在你的项目目录中创建一个名为 lib 的文件夹，并将插件放入该文件夹，然后按照以下说明操作。

Maven 依赖

<dependency>
    <groupId>me.despical</groupId>
    <artifactId>kotl</artifactId>
    <version>${在此填写版本号}</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/libs/king-of-the-ladder-3.1.3.jar</systemPath>
</dependency>

Gradle 依赖

dependencies {
    compile files('libs/king-of-the-ladder-3.1.3.jar')
    // 或者包含文件夹中的所有 jar 文件
    compile fileTree(dir: 'libs', include: '*.jar')
}

PlayerStatisticChangeEvent 示例

当玩家的任何统计数据发生变化时（例如完成一轮游戏、成为国王等），将调用此事件。

@EventHandler
public void onStatisticChange(KOTLPlayerStatisticChangeEvent event) {
    StatsStorage.StatisticType stat = event.getStatisticType();
    int value = event.getNumber();
    event.getPlayer().sendMessage("Updated statistic name: " + stat.name() + ", Updated value: " + value);
}

---

如果你喜欢这个插件，别忘了给我们留下评价！

版权所有 © 2025 Berke Akçen