King of the Ladder
King of the Ladder 是一款竞技性 Minecraft 爬梯小游戏,玩家竞相攀登梯子塔顶,夺取王冠,并将挑战者击落。
玩家进入围绕梯子建造的竞技场,一路战斗至顶部的王冠板(king plate)。登上该板位的玩家将成为国王并增加得分,但随着其他玩家攀爬上来试图夺走王冠,守住这一位置会变得越来越困难。目标是在尽可能将对手挡在顶部之外的同时,成为国王尽可能多的次数。
✨ 特性 ✨
- 经典 King of the Ladder 玩法: 攀登、战斗并夺取王冠,同时其他玩家会试图将你从顶端击落。
- 自动竞技场检测: 玩家通过走入或走出配置好的游戏区域(Game Area)来自然加入和离开游戏。
- 自定义王冠板: 可将王冠触发器放置在竞技场内的任意位置,并提供多种压力板材质供选择。
- 国王冷却与击退: 通过可配置的冷却时间、动作栏反馈以及板位击退功能,控制重复夺得王冠的行为。
- 交互式 GUI 设置: 通过可视化游戏内菜单创建和管理竞技场,无需手动编辑文件。
- 可视化区域选择: 使用专用工具选择竞技场角落,并通过可配置的粒子轮廓预览完整的游戏区域。
- 玩家准备机制: 保存并恢复玩家的物品栏,同时支持可配置的物品栏清理、药水效果清除以及按竞技场设定的加入游戏模式。
- 竞技场记录与统计: 追踪王冠夺取次数、击杀数、死亡数、游玩局数、个人竞技场分数及顶级国王数据。
- 可配置奖励: 当玩家加入、退出、成为国王、击杀对手或死亡时,可执行控制台或玩家命令,内置玩家、竞技场、国王、目标、分数和统计数据占位符。
- 计分板与 Boss 条: 通过完全可配置的游戏实时显示让玩家了解当前状况。
- 高度可配置: 自定义消息、音效、菜单、物品、聊天、冷却时间、计分板、Boss 条以及游戏玩法行为。
- PlaceholderAPI 与排行榜: 在全息图、计分板或其他插件上显示实时的玩家、竞技场、国王、记录和排行榜数据。
- 扁平文件与 MySQL 存储: 可使用简单的本地存储起步,或通过 MySQL 在网络中扩展玩家数据。
- 开发者 API: 通过公共事件 API 挂钩到游戏关闭、竞技场进出、国王变更以及统计数据更新。
竞技场设置指南
使用游戏内 GUI 编辑器设置 King of the Ladder 竞技场非常直观。请按照以下步骤操作:
? 点击查看分步指南
第 1 步:创建竞技场
使用唯一 ID 初始化一个新竞技场。
/kotl create <arena_id>
第 2 步:打开设置菜单
打开该竞技场的可视化编辑器。
/kotl edit <arena_id>
第 3 步:设置终点位置
设置安全回退位置,用于在玩家被移出竞技场、服务器重载或发生意外错误时使用。
第 4 步:选择游戏区域
使用游戏区域选择器标记整个可玩区域的两个对角角落。
- 左键点击: 设置第一个角落。
- 右键点击: 设置并保存第二个角落。
- 轮廓预览: 切换粒子可视化工具以检查所选区域。
第 5 步:设置王冠板
选择一种压力板材质,获取设置工具,并在选定的游戏区域内放置该板。此板将成为王冠触发器。
第 6 步:配置玩家设置
选择玩家进入竞技场时的准备方式。
- 加入游戏模式: 选择生存、创造、冒险,或保留玩家当前的模式。
- 物品栏与效果: 切换物品栏清理和药水效果移除功能。
- 游戏显示: 启用或禁用竞技场计分板和 Boss 条。
- 竞技场记录: 在需要时查看或重置竞技场的国王记录。
第 7 步:注册并开始游戏
点击烟花物品以验证、保存、注册并启用竞技场。
如何游玩:
- 加入: 走入已启用的游戏区域即可自动加入。
- 离开: 走出游戏区域即可离开,恢复你保存的物品栏,并移除竞技场显示。
游戏流程
- 进入竞技场: 走进已启用的游戏区域,插件会自动为玩家准备比赛状态。
- 攀登高塔: 在攀爬梯子结构的同时,与所有其他挑战者争夺位置。
- 争夺地位: 将对手击退路线之外,阻止他们在你之前到达顶端。
- 登上王座板: 站在配置好的压力板上,夺取皇冠,成为竞技场的现任国王。
- 赚取分数: 每次成功戴上皇冠都会增加你的总分、游玩次数以及该竞技场内的个人得分。
- 打破纪录: 超越当前的记录保持者,成为竞技场的第一名国王。
- 再次挑战: 当可配置的国王冷却时间结束后,重新爬上压力板,争夺另一顶皇冠。
- 安全离开: 完成后走出游戏区域,插件会恢复你保存的物品栏并移除竞技场显示。
玩家命令(所有人)
玩家信息命令
统计查询无需任何权限。默认情况下,所有人均可访问帮助。
/kotl help — kotl.command.help — 显示可用的 King of the Ladder 命令。
/kotl stats [player] — 打开你自己或缓存的在线/离线玩家的游戏中统计菜单。
竞技场管理命令
竞技场设置与管理
需要 kotl.arena.* 权限以获取完整访问权。
/kotl create <arena_id> — kotl.arena.create — 创建具有指定唯一 ID 的新竞技场。
/kotl delete <arena_id> [--confirm] [--cancel] — kotl.arena.delete — 确认后删除竞技场。
/kotl edit <arena_id> — kotl.arena.edit — 打开游戏中用于竞技场设置和管理的 GUI 编辑器。
/kotl list — kotl.arena.list — 显示所有已注册的竞技场及其就绪和可用状态。
管理员命令
主要管理命令
需要 kotl.admin 权限以获取完整访问权。
/kotl reload — kotl.admin.reload — 停止活跃游戏,并重新加载消息、选项、物品、事件、命令设置、游戏显示和竞技场轮廓。
/kotl stop [arena] — kotl.admin.stop — 停止你当前的竞技场游戏或指定的活跃竞技场游戏。
/kotl kick <player> — kotl.admin.kick — 将玩家从活跃竞技场中移除,并将其传送至结束位置。
调试命令(高级用户)
高级故障排除
需要 kotl.debug 权限以获取完整访问权,且必须启用调试模式。
⚠️ 注意: 调试命令旨在用于测试和故障排除。
/kotl debug component <message> — kotl.debug.component — 在游戏中解析并预览 MiniMessage 组件。
/kotl debug dump — kotl.debug.dump — 生成并发送事件计时报告,以排查性能问题。
统计与排行榜
King of the Ladder 奖励每一次成功的攀登。追踪皇冠夺取、击杀、死亡、游玩次数、每个竞技场的个人得分以及每个竞技场的顶级国王,并通过实时排行榜展示最佳玩家。
占位符
要使用这些占位符,您必须在服务器上安装 PlaceholderAPI。
玩家统计占位符
个人玩家统计
这些占位符显示查看者的统计数据。
%kotl_name% - 返回玩家名称
%kotl_uuid% - 返回玩家唯一 ID
%kotl_games_played% - 总游玩次数
%kotl_score% - 皇冠夺取总数
%kotl_kills% - 总击杀数
%kotl_deaths% - 总死亡数
%kotl_stat:arena_score:<arena_id>% - 特定竞技场中的个人得分
当前游戏与全局占位符
实时玩家与服务器数据
显示玩家当前的竞技场信息或服务器上的全局活动。
当前玩家数据
%kotl_is_playing% - 玩家是否在竞技场内
%kotl_current_arena% - 当前竞技场 ID
%kotl_current_arena_players% - 当前竞技场中的玩家数量
%kotl_current_arena_king% - 玩家所在竞技场的现任国王
%kotl_current_arena_last_king% - 玩家所在竞技场的上一任国王
%kotl_current_arena_top_king% - 玩家所在竞技场的记录保持者
%kotl_current_arena_top_king_score% - 玩家所在竞技场的记录分数
%kotl_current_arena_score% - 玩家在当前竞技场中的得分
全局服务器数据
%kotl_arenas_total% - 已注册竞技场总数
%kotl_arenas_ready% - 就绪竞技场总数
%kotl_active_games% - 有活跃玩家的游戏数量
%kotl_active_players% - 所有活跃游戏中的玩家总数
竞技场状态占位符
实时竞技场数据
从指定竞技场获取实时数据。将 <id> 替换为你的竞技场标识符,例如 arena1。
实时游戏数据
%kotl_arena:<id>:players% - 当前玩家数量
%kotl_arena:<id>:king% - 当前国王
%kotl_arena:<id>:last_king% - 上一位获得王冠的玩家
%kotl_arena:<id>:top_king% - 竞技场记录保持者
%kotl_arena:<id>:top_king_score% - 竞技场最高分记录
竞技场设置
%kotl_arena:<id>:ready% - 竞技场配置是否已完成
%kotl_arena:<id>:enabled% - 竞技场是否已启用
%kotl_arena:<id>:gamemode% - 配置的加入游戏模式
%kotl_arena:<id>:scoreboard_enabled% - 各竞技场的记分板设置
%kotl_arena:<id>:bossbar_enabled% - 各竞技场的首领栏设置
排行榜占位符
排行榜系统
在记分板或全息图中显示你服务器中表现最佳的玩家。
语法
%kotl_leaderboard:<statistic>:<position>:<type>%
1. 参数说明
<statistic>: 要排名的统计数据,可从下方列表中选择。
<position>: 排名位置,例如 1、2 或 3。
<type>: name(用户名)、value(分数)、uuid 或 formatted_value(格式化后的分数)。
2. 可用统计数据
你可以使用以下数据进行排名:
score(总夺冠次数)
kill(总击杀数)
death(总死亡数)
tours_played(总游玩轮次)
arena_score_<arena_id>(特定个人竞技场的得分)
3. 使用示例
# 按总夺冠次数排第 1 位的玩家名称
%kotl_leaderboard:score:1:name%
# 按总夺冠次数排第 1 位的玩家的夺冠次数
%kotl_leaderboard:score:1:value%
# 按总击杀数排第 3 位的玩家名称
%kotl_leaderboard:kill:3:name%
# 特定竞技场中排名第一的玩家名称
%kotl_leaderboard:arena_score_arena1:1:name%
bStats 指标统计
该插件通过 bStats 收集匿名使用统计数据。
这些数据(如玩家数量、服务器版本和 Java 版本)有助于我们了解插件的使用情况,从而做出更好的开发决策。不会收集任何私人信息。
喜欢这个插件吗?
为了让 King of the Ladder 成为你服务器上最佳的竞技爬梯体验,我们投入了数百小时的努力。
如果你喜欢这款插件,请考虑留下一个 5 星好评!
衷心感谢到目前为止一直支持本项目的所有人!❤️
Copyright 2026 © Berke Akçen
King of the Ladder
King of the Ladder is a competitive Minecraft climbing minigame where players race to the top of a ladder tower, claim the crown, and knock challengers back down.
Players enter an arena built around a ladder and fight their way toward the king plate at the top. Reaching the plate makes a player the king and adds to their score, but holding the position becomes harder as other players climb up and try to take the crown. The goal is to become king as many times as possible while keeping opponents away from the top.
✨ Features ✨
- Classic King of the Ladder Gameplay: Climb, fight, and claim the crown while other players try to knock you away from the top.
- Automatic Arena Detection: Players enter and leave games naturally by walking into or out of a configured Game Area.
- Custom King Plates: Place the crown trigger anywhere inside the arena and choose from multiple pressure plate materials.
- King Cooldowns & Knockback: Control repeated crown claims with configurable cooldowns, action bar feedback, and plate knockback.
- Interactive GUI Setup: Create and manage arenas through visual in-game menus instead of manually editing files.
- Visual Area Selection: Select arena corners with a dedicated tool and preview the complete Game Area with configurable particle outlines.
- Player Preparation: Save and restore inventories while using configurable inventory clearing, potion effect cleanup, and per-arena join game modes.
- Arena Records & Statistics: Track crown claims, kills, deaths, tours played, personal arena scores, and top kings.
- Configurable Rewards: Run console or player commands when players join, quit, become king, kill an opponent, or die, with built-in player, arena, king, target, score, and statistics placeholders.
- Scoreboards & BossBars: Keep players informed with fully configurable live game displays.
- Highly Configurable: Customize messages, sounds, menus, items, chat, cooldowns, scoreboards, boss bars, and gameplay behavior.
- PlaceholderAPI & Leaderboards: Display live player, arena, king, record, and leaderboard data on holograms, scoreboards, or other plugins.
- Flat File & MySQL Storage: Start with simple local storage or scale player data across your network with MySQL.
- Developer API: Hook into game shutdown, arena entry and exit, king changes, and statistic updates through a public event API.
Arena Setup Guide
Setting up a King of the Ladder arena is intuitive with the in-game GUI editor. Follow these steps:
? Click to view the step-by-step guide
Step 1: Create the Arena
Initialize a new arena with a unique ID.
/kotl create <arena_id>
Step 2: Open Setup Menu
Open the visual editor for the arena.
/kotl edit <arena_id>
Step 3: Set the End Location
Set the safe fallback location used when a player is removed from the arena, the server reloads, or an unexpected error occurs.
Step 4: Select the Game Area
Use the Game Area selector to mark the two opposite corners of the complete playable area.
- Left-click: Set the first corner.
- Right-click: Set and save the second corner.
- Outline Preview: Toggle the particle visualizer to inspect the selected area.
Step 5: Set the King Plate
Choose a pressure plate material, receive the setup tool, and place the plate inside the selected Game Area. This plate becomes the crown trigger.
Step 6: Configure Player Settings
Choose how players are prepared when they enter the arena.
- Join Gamemode: Select Survival, Creative, Adventure, or keep the player's current mode.
- Inventory & Effects: Toggle inventory clearing and potion effect removal.
- Game Displays: Enable or disable the arena scoreboard and boss bar.
- Arena Records: Review or reset the arena's king record when needed.
Step 7: Register & Play
Click the Firework item to validate, save, register, and enable the arena.
How to Play:
- Enter: Walk into the enabled Game Area to join automatically.
- Leave: Walk outside the Game Area to leave, restore your saved inventory, and remove the arena displays.
Gameplay Flow
- Enter the Arena: Walk into an enabled Game Area and the plugin automatically prepares your player state for the competition.
- Climb the Tower: Race up the ladder structure while keeping your position against every other challenger.
- Fight for Position: Knock opponents away from the route and stop them from reaching the top before you.
- Reach the King Plate: Step on the configured pressure plate to claim the crown and become the arena's current king.
- Earn Your Score: Every successful crown claim increases your total score, tours played, and personal score for that arena.
- Break the Record: Outscore the current record holder to become the arena's top king.
- Challenge Again: After the configurable king cooldown expires, climb back to the plate and fight for another crown.
- Leave Safely: Walk outside the Game Area when you are finished and the plugin restores your saved inventory and removes the arena displays.
Commands & Permissions
All commands use the /kotl command.
Player Commands (Everyone)
Player Information Commands
No permissions are required for statistics. Help access is enabled for everyone by default.
/kotl help — kotl.command.help — Display the available King of the Ladder commands.
/kotl stats [player] — Open the in-game statistics menu for yourself or a cached online or offline player.
Arena Management Commands
Arena Setup & Management
Requires kotl.arena.* for full access.
/kotl create <arena_id> — kotl.arena.create — Create a new arena with the specified unique ID.
/kotl delete <arena_id> [--confirm] [--cancel] — kotl.arena.delete — Delete an arena after confirming the action.
/kotl edit <arena_id> — kotl.arena.edit — Open the in-game GUI editor for arena setup and management.
/kotl list — kotl.arena.list — Display all registered arenas together with their readiness and availability state.
Admin Commands
Main Administration Commands
Requires kotl.admin for full access.
/kotl reload — kotl.admin.reload — Stop active games and reload messages, options, items, events, command settings, game displays, and arena outlines.
/kotl stop [arena] — kotl.admin.stop — Stop your current arena game or a specified active arena game.
/kotl kick <player> — kotl.admin.kick — Remove a player from an active arena and send them to its end location.
Debug Commands (Advanced Users)
Advanced Troubleshooting
Requires kotl.debug for full access and debug mode must be enabled.
⚠️ Note: Debug commands are intended for testing and troubleshooting.
/kotl debug component <message> — kotl.debug.component — Parse and preview a MiniMessage component in-game.
/kotl debug dump — kotl.debug.dump — Generate and send an event timing report for troubleshooting performance issues.
Stats & Leaderboards
King of the Ladder rewards every successful climb. Track crown claims, kills, deaths, tours played, personal scores for every arena, and each arena's top king, then put the best players on display with live leaderboards.
Placeholders
To use these placeholders, you must have PlaceholderAPI installed on your server.
Player Statistics Placeholders
Individual Player Stats
These placeholders display statistics for the player viewing them.
%kotl_name% - Returns the player's name
%kotl_uuid% - Returns the player's unique ID
%kotl_games_played% - Total tours played
%kotl_score% - Total number of crown claims
%kotl_kills% - Total number of kills
%kotl_deaths% - Total number of deaths
%kotl_stat:arena_score:<arena_id>% - Personal score in a specific arena
Current Game & Global Placeholders
Live Player and Server Data
Display the player's current arena information or global activity across the server.
Current Player Data
%kotl_is_playing% - Whether the player is inside an arena
%kotl_current_arena% - Current arena ID
%kotl_current_arena_players% - Player count in the current arena
%kotl_current_arena_king% - Current king of the player's arena
%kotl_current_arena_last_king% - Last king of the player's arena
%kotl_current_arena_top_king% - Record holder of the player's arena
%kotl_current_arena_top_king_score% - Record score of the player's arena
%kotl_current_arena_score% - Player's score in the current arena
Global Server Data
%kotl_arenas_total% - Total registered arenas
%kotl_arenas_ready% - Total ready arenas
%kotl_active_games% - Games with active players
%kotl_active_players% - Players across all active games
Arena Status Placeholders
Real-Time Arena Data
Fetch live data from specific arenas. Replace <id> with your arena identifier, for example arena1.
Live Game Data
%kotl_arena:<id>:players% - Current player count
%kotl_arena:<id>:king% - Current king
%kotl_arena:<id>:last_king% - Last player to claim the crown
%kotl_arena:<id>:top_king% - Arena record holder
%kotl_arena:<id>:top_king_score% - Arena record score
Arena Settings
%kotl_arena:<id>:ready% - Whether the arena setup is complete
%kotl_arena:<id>:enabled% - Whether the arena is available
%kotl_arena:<id>:gamemode% - Configured join game mode
%kotl_arena:<id>:scoreboard_enabled% - Per-arena scoreboard setting
%kotl_arena:<id>:bossbar_enabled% - Per-arena boss bar setting
Leaderboard Placeholders
Leaderboard System
Display your server's top-performing players on scoreboards or holograms.
Syntax
%kotl_leaderboard:<statistic>:<position>:<type>%
1. Parameters
<statistic>: The statistic to rank from the list below.
<position>: The rank position, such as 1, 2, or 3.
<type>: name for username, value for score, uuid, or formatted_value.
2. Available Statistics
You can use these statistics for ranking:
score (Total crown claims)
kill (Total kills)
death (Total deaths)
tours_played (Total tours played)
arena_score_<arena_id> (Personal score in a specific arena)
3. Usage Examples
# Name of the 1st place player by total crown claims
%kotl_leaderboard:score:1:name%
# Crown claim count of the 1st place player
%kotl_leaderboard:score:1:value%
# Name of the 3rd place player by total kills
%kotl_leaderboard:kill:3:name%
# Name of the top player in a specific arena
%kotl_leaderboard:arena_score_arena1:1:name%
bStats Metrics
This plugin collects anonymous usage statistics through bStats.
This data, such as player count, server version, and Java version, helps us understand how the plugin is being used and allows us to make better development decisions. No private information is collected.
Enjoying the plugin?
We spend hundreds of hours making King of the Ladder the best competitive climbing experience for your server.
If you like the plugin, please consider leaving a 5-star review!
A huge thank you to everyone who has supported the project so far! ❤️
Copyright 2026 © Berke Akçen
评论 0
登录后参与评分
还没有评论,来抢沙发吧