NexaKits | Next Generation Kit System v1.0.0

---

NexaKits is a premium, all-in-one PvP kit plugin that goes far beyond basic kit claiming. It provides a complete loadout workflow: personal kit layouts, multiple Ender Chest profiles, a built-in item editor, a dynamic Kit Room browser, premade kits, auto-kit triggers, a regear system, and deep integration hooks — all inside one plugin.

Every player gets their own custom arrangement for each kit. No more "one layout fits all." Your players build their PvP style, your staff keep full control.

---

Fast Kit Claims
Claim kits instantly through menus, direct commands, or quick shortcuts like /k and /k1 through /k7. Supports cooldowns, permissions, world allowlists/blocklists, and WorldGuard region checks out of the box.

Personal Kit Layouts
Each player can rearrange any kit into their own preferred PvP layout — inventory, armor, and offhand — without touching the original staff-defined kit. Layouts are saved per-player and persist across restarts. Players can also share their layouts with nearby players via temporary snapshot links, and import shared designs from others.

Multiple Ender Chest Profiles
Players get up to 7 permission-gated Ender Chest profiles (configurable) to store PvP supplies for different kits, modes, or ranks. Ender Chest profiles can optionally be injected automatically when a kit is claimed. Staff can view, edit, and reset any player's EC profile.

Built-In Item Editor
A full GUI-based item editor accessible via /edit-item or directly inside the Kit Editor. Edit item names, stack amounts, enchantment levels, armor trims, item flags, and unbreakable state — all through clean menu screens, no commands needed.

Deep Shulker Editing
The item editor detects Shulker Boxes and transitions into a dedicated Shulker Editor GUI. Players can customize shulker contents directly inside the kit workflow. Nested shulker exploit protection is strictly enforced.

Dynamic Kit Room
A modern, visual browsing interface for all server kits. Features include:

• Premium Category Cycle: A single interactive item cycles through categories — no wasted inventory slots for navigation.
• Deep Search Engine: /kitroom search <query> instantly cross-references kit names, premade descriptions, and materials.
• Favorites & Recents: Players can favorite kits and access their recently used ones.
• Sort Modes: Multiple sort options for personalized browsing.
• Auto-Pagination: Handles unlimited amounts of kits without performance issues.
• Interactive Actions: Left-click to Load, Right-click to Preview, Shift-Right to Favorite, Middle-click to Edit.

Premade Kits
Staff-created loadouts that serve as global defaults or starting points. Premades are stored as human-readable YAML files — easy to share between servers or networks. Players can load premades instantly or clone them directly into their personal kit layout.

Auto Kit System
Automatically apply kits on:

• Server Join
• Player Respawn
• World Change
• Player Kill

Validates combat state (CombatLogX/PvPManager), allowed worlds, and WorldGuard regions before applying. Supports broadcast notifications.

Regear System
/regear gives players an interactive shulker mapped to their last-used kit. It automatically detects missing inventory items and refills them. Combat delay logic prevents mid-battle abuse, and material blacklists (e.g. Totems) protect server economy.

---

NexaKits ships with 12+ fully configurable YAML menu files:

• Main Menu
• Kit Room Browser
• Kit Preview
• Kit Editor (Inventory, Armor, Offhand)
• Ender Chest Editor
• Item Editor
• Item Editor — Enchantments
• Item Editor — Item Flags
• Item Editor — Armor Trims
• Shulker Editor
• Premade Kits Menu
• Shared Kit Import
• Confirmation Menu

Every menu layout, item, title, lore, slot, and action is customizable through YAML. MiniMessage formatting is supported across all player-facing text. Message outputs support chat, actionbar, title, bossbar, and sound types.

---

• SQLite (default, WAL mode) or MySQL via HikariCP connection pooling.
• No flat-file fragmentation — no kits/ or ender-chests/ folders with thousands of player files.
• Player layouts, EC profiles, cooldowns, favorites, and audit logs are all stored in SQL.
• Premade kits stay in human-readable YAML for easy file sharing.
• Built-in backup, restore, and SQLite to MySQL migration commands.
• Storage health check via /nexakits storage.

---

NexaKits hooks into popular plugins automatically when detected:

• PlaceholderAPI — Placeholders for total kits, available kits, selected kit, last kit, cooldowns, and layout status.
• WorldGuard — Region-based kit allowlists and blocklists.
• LuckPerms — Meta hook support for scalable Ender Chest profile limits.
• Vault — Economy integration.
• Skript — Skript event support.
• CombatLogX & PvPManager — Combat state checks for Auto Kit.
• SkinsRestorer — Skin-aware head displays.

All hooks are soft dependencies — missing plugins are silently skipped. Use /nexakits hooks to inspect active integrations.

---

NexaKits exposes a stable public API:


Bukkit Events:

• KitClaimEvent, KitPreviewEvent, KitCooldownCheckEvent
• KitEditorOpenEvent, KitEditorSaveEvent, KitEditorResetEvent
• EnderChestSaveEvent, KitRoomSelectEvent, PremadeKitPublishEvent

---

• Create & manage premade kits from inventory with one command.
• Edit any player's kit layout or Ender Chest remotely.
• Reset player data (layouts, EC profiles) per-kit or globally.
• Give kits to other players with admin overrides.
• Visual category editing for the Kit Room — edit in-game, save with /kitroom save.
• Full reload support — configs, messages, menus, kits, premades, and hooks.
• Backup & restore YAML data with timestamped snapshots.
• Storage diagnostics — database health, kit count, premade count.

---

---

• Complete: Kits, layouts, Ender Chests, premades, item editing, Kit Room, regear — one plugin.
• Personal: Every player gets their own layout for every kit.
• Fast: SQL storage with HikariCP, no flat-file lag, no thousands of YAML files.
• Configurable: 12+ YAML menus, MiniMessage text, per-kit permissions, cooldowns, and world rules.
• Staff-Friendly: In-game premade creation, player data editing, visual Kit Room management, backups.
• Integration-Ready: PlaceholderAPI, WorldGuard, LuckPerms, Vault, Skript, CombatLogX, PvPManager.
• Developer-Friendly: Public API with Bukkit events for full extensibility.

---