Simple Hytale Kits Plugin (v1.3)

Lightweight kits plugin for Hytale: create kits from your inventory/armor, manage per‑kit access, share via UI menu with search and random selection, and serve custom icons/backgrounds.

Features

Create kits from your current hotbar/inventory and armor slots.
Persistent storage; auto load/save on start/stop.
Per‑kit permissions (grant one kit or all kits).
One‑time kits: per‑kit flag to allow only a single claim (hidden from menu after claim).
UI menu with search + random pick, respects cooldowns, permissions, one‑time rules.
Custom assets: icons/backgrounds per kit.
Cooldowns per kit; menu cooldown.

Commands

/kits — open kit selection UI.
/kit get <name> — receive a kit (checks per‑kit permission).
/kit list — list kits by name.
/kit create <name> — create kit from your inventory + armor.
/kit delete <name> — delete kit.
/kit reload — reload kits/settings from disk.
/kit help — show command help.

Permissions (simplified)

simplekits.player — base: /kit (+ get/list/help) and /kits.
simplekits.admin — admin actions: create/delete/reload (and base access).
simplekits.kit or simplekits.kit.* — access all kits for /kit get.
simplekits.kit.<name> — access a specific kit.

Per‑kit Settings (settings.json)

cooldownSeconds: number.
allowKitStacking: bool.
overlapOtherKits: bool.
invDeletion: bool.
oneTimeKit: bool.
allowedWorlds: list (use "all" for any).

Data Layout

<plugin-data>/data/ — runtime data:
- cooldowns.json
- menu_command_cooldowns.json
- one_time_kits.json
<plugin-data>/data/kits/ — assets (PNG only):
- {kit}.png — icon (recommended 128×128 or 256×256)
- {kit}_bg.png — background (recommended 512×512 or 1024×1024; square for best fit)

Assets are auto-packed into the JAR under Common/UI/Custom/kits/ on server start.