Minecraft Plugin · Ironing out kinks

BotchedKits

Kits with cooldowns, five ranks players earn with money, XP and playtime, and custom rank gear with armor trims, bonus stats and gentle particles.

Discuss on the forum
Website downloads
0
BotchedKits artwork
Platform
Paper 1.21.8 – 26.3
Ranks
5 · Wanderer to Legend
Version
1.1.0
Requires
Nothing else
Overview

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.

Highlights

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.

Everything included

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 /ranks trail
  • Staff can set ranks silently, hand out kits or gear and reset cooldowns
  • Pays with BotchedEconomy when it’s installed
Progression

Ranks

RankCostXP levelsPlaytimeGear set
WandererStart–––
Settler$5,000–30 minutesTrimmed leather
Knight$25,000103 hoursIron
Champion$100,0002010 hoursDiamond
Legend$500,000301 dayNetherite

These are the defaults. Change costs, requirements, prefixes and gear in ranks.yml and gear.yml.

Kits

Default kits

KitWho can use itCooldown
StarterEveryone6 hours
Daily FoodEveryone1 day
WandererWanderer and up1 day
SettlerSettler and up1 day
KnightKnight and up2 days
ChampionChampion and up4 days
LegendLegend7 days
Reference

Commands

Player commands
CommandWhat it does
/kit [kit] [preview]Open the kits menu, claim a kit or preview it (also /kits, /bkit)
/ranksOpen the ranks menu (also /branks)
/ranks trailTurn your rank trail on or off
/rankupRank up to the next rank (also /ranks up)
Admin commands
CommandWhat 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 checkCheck the config for mistakes
/bkadmin reloadReload the config
Setup

Get started

  1. Place BotchedKits-1.1.0.jar in your server’s plugins folder and restart.
  2. Players can open /kit and /ranks right away.
  3. Edit kits in kits.yml, ranks in ranks.yml and rank gear in gear.yml.
  4. Run /bkadmin check to catch mistakes, then /bkadmin reload.
Compatibility

Requirements

AreaSupport
Server softwarePaper 1.21.8 through 26.3, one jar
Java21 or newer
OptionalBotchedEconomy (needed for rank costs in money)
Updates

Latest version

Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.

v1.1.0Latest

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
  • BotchedKits-1.1.0.jarUniversal build · Java 21 · 89.9 KBIncluded with purchase
Earlier versions (1)
v1.0.2

First release

Works with Paper 1.21.8 – 26.3

  • /kit menu 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, info and check
  • BotchedKits-1.0.2.jarUniversal build · Java 21 · 84.1 KBIncluded with purchase