Getting Started

Overview

XKits is a fully-customizable kits addon for XCore. Every item is configurable to the last detail, kits can be free, permission-gated, paid per claim or unlocked once, and access is controlled with cooldowns, usage limits and conditions — all browsable from a yml-driven GUI with live status.

Custom items — model data, item model, enchants, lore, glow, head textures, leather colour, auto-equip
Paid kits — per-claim price or one-off unlock, via Vault or an XCore currency
Cooldowns & limits — per-kit cooldown, rank reductions, total / per-day caps, cross-server
Conditions — placeholder, world, playtime, required item, availability window
GUI menu — paginated, blinking status, claim / preview
Integrations — PlaceholderAPI, web dashboard, cross-server sync, Folia-ready

Requirements

Paper 1.21.1+ (or Folia)
Java 21+
XCore 1.0.4+ installed as a plugin
Optional: PlaceholderAPI (placeholders & conditions), Vault (paid kits routed to the Vault economy)

Installation

Install XCore in your server's plugins/ folder.
Place XKits.jar in plugins/XCore/addons/.
Start the server. XKits generates its files in plugins/XCore/addons/XKits/.
Define your kits in config.yml (or build them in-game with /kits create).
Run /kits reload to apply changes — or edit and save from the web dashboard.

Three example kits ship by default: starter (first-join, one-time), daily (cooldown + rank reduction), and vip (one-off unlock + condition).