King of the Ladder

King of the Ladder is an old Minecraft lobby game that every server owner can add very their server lobies easly. In this minigame each player have to kick other players out of the ladders to be the king. The king tries to stand on the top of the ladders while not letting others to climb and punching them out of the way!

Documentation

More detailed information can be found on our wiki. The Java documentation can be browsed. For questions or isseus use our issue tracker on GitHub. Also you can join our small Discord community to get support and news early.

Donations

You like the KOTL? Then donate back me to support the development. Donations are more like motivation than money and, they are speeding up the development.

Commands and Permissions

[optional argument] <required argument>

Player Commands

Player commands do not require permission to execute.

/kotl stats [player]
- Shows your stats or specified player's stats

/kotl top <statistic type>
Shows TOP 10 players of specified statistic
Statistics: score and tours_played

Admin Commands

Some of the admin commands can not be executed by console and all of these commands requires some permissions.

/kotl create <arena name>
Creates new arena with specified name.
Permission: kotl.admin.create
Executor: Only players

/kotl delete <arena name>
Deletes specified arena and its configuration.
Permission: kotl.admin.delete
Executor: Console and players

kotl edit <arena name>
Opens setup editor for the existing arena.
Permission: kotl.admin.edit
Executor: Only players

/kotl list
Prints list of available arenas.
Permission: kotl.admin.list
Executor: Console and players

/kotl reload
Reloads all game instances they will be stopped.
Permission: kotl.admin.reload
Executor: Console and players

/kotl help
Shows all of the commands and their usage and descriptions.
Permission: kotl.admin.help
Executor: Console and players

Features

No Dependencies

We are not depending on any other plugins.

There only optional dependenices we use such as PlaceHolderAPI, Multiverse-Core (multi-world support).

Custom PAPI Placeholders

View our wiki for the list of placeholders that our plugin using for in-game messages, custom scoreboard and, custom boss bar.

Wide Compatibility

Supported versions are currently 1.8 - 1.19. Also upcoming versions are supported when they are released. This plugin is compiling with using JDK 8 but future updates won't support this version of Java. To ignore warning message on plugin startup go to config file and set true the Ignore-Warning-Messages option.

HEX Color Support

We are supporting HEX color codes in our in-game messages, scoreboard entries, and boss bar messages. Also this is only effective in Minecraft 1.16 and later versions.

(E.g. &#FF0000)

Legacy Color Code Support

Every message in this plugin supports legacy color codes (E.g &a &4).

1.8 PvP Hits Supported

You can edit the generic attack cooldown speed for everyplayer in the game arena by changing the value in config file. This option allows 1.9+ players to hit as faster 1.8 players and makes conditions the same.

Arena Editor Menu

Our arena system is very easy to setup games. Use /kotl edit command to open arena editor. (Some images will be added)

Multi Language Support

We are currently supporting English by default, Turkish and German. If you want to help us you can translate our messages into your language.

Custom Scoreboard and Boss Bar

We have custom in-game scoreboard and boss bar with configurable messages. The messages supports HEX color codes and the Minecraft color codes. In premium version scoreboard and boss bars have more messages and they have some cool animations too.

MySQL Database Suppport

You can store the player statistics in your database. The database operations won't lock the main thread when connecting to your server to upload information. Also there is no migrator between switching flat file storage and MySQL database storage.

Death Blocks

These blocks are very deadly because when the player interacts with these blocks they will get kicked out of the game. The death blocks can be edited from config file. (Some images will be added)

Reward System

Rewards are executed for the player who becomes king and the players who couldn't become king as well. Rewards can do anything with simple Java codes. We have a rewards.yml file which explains everything related rewards system. Our API is also accessible in reward codes.

Interactable Game Signs

Game sign is a sign that players can interact with right clicking to join arena that sign related. These interactable signs can be created by manually using signs or directly from arena editor.

Configuration Options

# Enable this option if you want a game bar in-game.

Boss-Bar-Enabled: true

# Enable this option if want a editable scorebaord in-game.

Scoreboard-Enabled: true

# Enable this option when you're using MySQL, otherwise it won't work.

# Be careful when changing this because there is no migrator between

# flat file and MySQL for statistics.

Database-Enabled: false

# Enable inventory manager for your games? (Very useful feature for MULTI ARENA)

# This saves inventory of players and restores it after player leaves arena.

# Saved elements: max health, health, food, experience, full inventory, armor contents, and more.

Inventory-Manager-Enabled: true

# Should we clear player's inventory on join and after leaving the game area.

# Also disable inventory manager option above before enabling this option.

Clear-Inventory: true

# Should we clear player's active potion effects when player join the arena.

Clear-Effects: true

# Should in game chat format be enabled?

# You can edit the formatting in messages.yml

Chat-Format-Enabled: true

# Should we disable all chat related stuff?

# It will disable the separated chat.

Disable-Separate-Chat: false

# Should players get fall damage?

Disable-Fall-Damage: true

# Should we spawn some cool fireworks around the game area when someone becomes king?

Fireworks-On-New-King: true

# The delay between hitting players. ONLY EFFECTED in Minecraft 1.9+

Hit-Cooldown-Delay: 16

# Commands which can be used in game, remove all of them to disable

Whitelisted-Commands:

- me

- help

# Enable in game rewards? See rewards.yml for more.

Rewards-Enabled: false

# Should we block every not KOTL Premium associated commands in game?

Block-Commands: true

# When players click these blocks should we remove them from the game?

Death-Blocks-Enabled: true

# Blocks which shouldn't you click in game, remove all of them to disable.

Death-Blocks:

- BEDROCK

- GLASS

# When player enters the game area should we notify players?

Join-Notify: true

# When player leaves the game area should we notify players?

Leave-Notify: true

# Should we send random pro tips when the setup menu opens.

Send-Setup-Tips: false

# Should we check for updates on plugin start/after admin join?

Update-Notifier-Enabled: true

# Should we send warning messages if server is running a old Java version such as JAVA 8?

Ignore-Warning-Messages: true

# This option isn't included in the default config but can be added manually to enable debug mode.

# In debug mode plugin will log almost every operation with timings and parameters to understand errors.

Debug-Enabled: false

PlaceholderAPI & Scoreboard & Game Sign

Placeholders

List of the PlaceholderAPI's placeholders:

%kotl_score% - Shows your total score in-game.

%kotl_tours_played% - Shows your total amount of played tours.

%kotl_{arenaid}:king% - Shows the current king's name.

%kotl_{arenaid}:players% - Shows the amount of players in arena.

List of scoreboard placeholders:

%arena% - Shows arena's id (name).

%players% - Shows the amount of players in arena.

%king% - Shows the current king's name.

%score% - Shows your total score in-game.

%tours_played% - Shows your total amount of played tours.

List of game sign placeholders:

%map_name% - Shows arena's id (name).

%players% - Shows the amount of players in arena.

%king_name% - Shows the current king's name.

bStats

Please do not use review section for your problems instead of doing that, join our Discord server.

If you like the plugin don't forget to review us!