Installation

Requirements

Requirement	Version
Minecraft Server	Paper or Spigot 1.21+
Java	21 or higher
PlaceholderAPI	Optional — for countdown placeholders

Installation Steps

1. Download

Obtain KeyAllPro.jar from the official releases page.

2. Place the JAR

server/
└── plugins/
    └── KeyAllPro.jar   ← place here

3. Start the Server

Start or restart your server. The plugin will generate its configuration folder:

plugins/
└── KeyAllPro/
    ├── config.yml
    └── pending-rewards.yml   ← stores offline player pending keys

4. Verify

Check the console for:

[KeyAllPro] Plugin enabled successfully!

File Layout

File	Purpose
config.yml	All settings — interval, crates, bonuses, messages
pending-rewards.yml	Persistent storage for offline player keys

Updating

1. Stop your server
2. Replace the old JAR with the new one in plugins/
3. Start the server — configuration files are preserved automatically

caution

Always back up pending-rewards.yml before updating to avoid losing offline player key data.

Uninstalling

1. Stop the server
2. Remove KeyAllPro.jar from plugins/
3. Optionally delete plugins/KeyAllPro/ to remove configuration

PlaceholderAPI Setup (Optional)

If PlaceholderAPI is installed, no extra steps are required. The expansion registers automatically. Available placeholders:

Placeholder	Returns
%keyall_time%	Time remaining until next drop (formatted)
%keyall_next_crate%	Name of the next crate to be distributed