What is BotchedKits?
BotchedKits gives players a /kit menu with seven kits out of the box: a Starter kit every 6 hours, a Daily Food kit, and one kit for each rank, from a daily Wanderer kit up to a weekly Legend kit. Players can preview any kit before claiming it, and the menu shows which ones are ready and how long the rest have left.
Ranks go Wanderer, Settler, Knight, Champion and Legend. Each rank costs money (with BotchedEconomy), XP levels and playtime, and /rankup checks all three before charging anything. Every rank has its own chat and tab prefix, a soft particle trail and a gear set: trimmed leather for Settler, iron for Knight, diamond for Champion and netherite for Legend, with small bonus stats and auras when you hold the weapon or wear the full set.
What you can do
Kits menu
/kit opens every kit with a preview, a ready-or-cooldown status and one-click claiming.
Five ranks
Wanderer to Legend, paid with money, XP levels and playtime through /rankup.
Custom rank gear
Named armor and tools with armor trims, enchants, bonus stats and particle auras.
Prefixes and trails
Chat and tab prefixes for every rank, plus a gentle rank trail players can turn off.
Features
- Seven ready-made kits in kits.yml, each with its own cooldown, lowest rank and optional permission
- Preview any kit before claiming it with
/kit<kit> preview - Cooldowns survive restarts, and a full inventory drops the rest at your feet instead of losing it
- Five ranks with money, XP level and playtime requirements in ranks.yml
- Chat and tab prefixes for each rank, with gradients and colors
- Rank gear sets in gear.yml: trims, enchants, bonus stats, held auras and full-set auras
- One soft particle trail per rank that slowly circles the player, toggled with
/rankstrail - Staff can set ranks silently, hand out kits or gear and reset cooldowns
- Pays with BotchedEconomy when it’s installed
Ranks
| Rank | Cost | XP levels | Playtime | Gear set |
|---|---|---|---|---|
| Wanderer | Start | – | – | – |
| Settler | $5,000 | – | 30 minutes | Trimmed leather |
| Knight | $25,000 | 10 | 3 hours | Iron |
| Champion | $100,000 | 20 | 10 hours | Diamond |
| Legend | $500,000 | 30 | 1 day | Netherite |
These are the defaults. Change costs, requirements, prefixes and gear in ranks.yml and gear.yml.
Default kits
| Kit | Who can use it | Cooldown |
|---|---|---|
| Starter | Everyone | 6 hours |
| Daily Food | Everyone | 1 day |
| Wanderer | Wanderer and up | 1 day |
| Settler | Settler and up | 1 day |
| Knight | Knight and up | 2 days |
| Champion | Champion and up | 4 days |
| Legend | Legend | 7 days |
Commands
| Command | What it does |
|---|---|
/kit [kit] [preview] | Open the kits menu, claim a kit or preview it (also /kits, /bkit) |
/ranks | Open the ranks menu (also /branks) |
/ranks trail | Turn your rank trail on or off |
/rankup | Rank up to the next rank (also /ranks up) |
| Command | What it does |
|---|---|
/bkadmin setrank <player> <rank> [-silent] | Set someone’s rank |
/bkadmin givekit <player> <kit> | Give a kit without a cooldown |
/bkadmin gear <player> <id> [amount] | Give a piece of rank gear |
/bkadmin resetcooldown <player> [kit] | Reset kit cooldowns |
/bkadmin info <player> | See someone’s rank and cooldowns |
/bkadmin check | Check the config for mistakes |
/bkadmin reload | Reload the config |
Get started
- Place BotchedKits-1.1.0.jar in your server’s plugins folder and restart.
- Players can open
/kitand/ranksright away. - Edit kits in kits.yml, ranks in ranks.yml and rank gear in gear.yml.
- Run
/bkadmincheck to catch mistakes, then/bkadminreload.
Requirements
| Area | Support |
|---|---|
| Server software | Paper 1.21.8 through 26.3, one jar |
| Java | 21 or newer |
| Optional | BotchedEconomy (needed for rank costs in money) |
Latest version
Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.
Shared menu style
Works with Paper 1.21.8 – 26.3
- The Kits, Ranks and Preview menus use the shared Botched panel style. The right side shows your rank or the item count
- Included with purchase
Earlier versions (1)
First release
Works with Paper 1.21.8 – 26.3
/kitmenu with seven kits, previews and cooldowns: Starter, Daily Food, and a kit for each rank- Five ranks from Wanderer to Legend, paid with money, XP levels and playtime through
/rankup - Rank gear sets with armor trims, enchants, bonus stats, held auras and full-set auras
- Chat and tab prefixes for every rank, and a gentle rank trail you can turn off with
/ranks trail - Staff tools:
/bkadmin setrank,givekit,gear,resetcooldown,infoandcheck
- Included with purchase
Screens





Kits menu




