UltraStarterKits

** 🎮 UltraStarterKits - Complete Plugin Documentation --- 🌟 Overview **UltraStarterKits** is a premium, enterprise-grade kit management plugin designed for Minecraft 1.21.x servers running Paper or Spigot. It provides a complete solution for managing player kits with an intuitive GUI, powerful permission system, and extensive customization options. 🎯 What Makes It Ultimate? - **Production-Ready**: Battle-tested code with error handling and optimization - **Network-Compatible**: Full MySQL support for BungeeCord/Velocity networks - **Highly Customizable**: Every message, GUI, and feature is configurable - **Performance-Optimized**: Async operations, connection pooling, smart caching - **Developer-Friendly**: Clean code architecture and comprehensive API 🏆 Perfect For - **Survival Servers** - Starter kits, daily rewards, rank perks - **Skyblock Networks** - Island starter packs, VIP kits, monthly rewards - **Prison Servers** - Rank-based kits, mine rewards, progression systems - **PvP Servers** - Arena kits, loadouts, quick gear access - **Minigame Networks** - Game-specific kits, team loadouts --- ✨ Key Features 🎁 Kit Management | Feature | Description | |---------|-------------| | **Unlimited Kits** | Create as many custom kits as needed | | **Full NBT Support** | Preserves all item data including custom model data, names, lore, enchantments | | **Item Serialization** | Base64 encoding ensures 100% item data preservation | | **Random Items** | Chance-based loot system (e.g., 50% chance for rare items) | | **Kit Categories** | Organize kits into categories (Basic, Premium, Daily, PvP, etc.) | | **Kit Expiry** | Time-limited kits that expire on specific dates | | **Scheduled Availability** | Weekend-only kits, time-of-day restrictions | 🔐 Permission & Access Control | Feature | Description | |---------|-------------| | **LuckPerms Integration** | Direct API integration (not just Vault) | | **Per-Kit Permissions** | Individual permission nodes per kit | | **Rank-Based Overrides** | Different cooldowns/uses for different ranks | | **Group Detection** | Checks both primary and inherited groups | | **Display Names** | Show "VIP" instead of "kit.use.vip" | | **Bypass Permissions** | Admin permissions to bypass all restrictions | ⏱️ Cooldown System | Feature | Description | |---------|-------------| | **Flexible Time Format** | Support for seconds, minutes, hours, days, weeks | | **Rank Overrides** | VIPs get 12h cooldown, MVPs get 6h, etc. | | **Cooldown Tracking** | Persistent cooldown storage across restarts | | **Expiry Notifications** | Optional notifications when cooldowns expire | | **Display Formats** | Full (1d 2h 30m), Short (1d 2h), Seconds (95400) | | **No Cooldown Option** | Use "never" or -1 for instant re-claim | 🎫 Usage Limits | Feature | Description | |---------|-------------| | **Limited Uses** | 1-time, 5-time, 100-time kits | | **Unlimited Uses** | Infinite re-claims with cooldown | | **Rank-Based Limits** | Different use counts per rank | | **Use Tracking** | Persistent storage of claim counts | | **Use Reset** | Admin command to reset usage data | 🌍 World Management | Feature | Description | |---------|-------------| | **Global Whitelist** | Restrict plugin to specific worlds | | **Per-Kit Worlds** | Kit only works in designated worlds | | **Multi-World Support** | Different kits for different worlds | | **World Change Detection** | Auto-give starter kits on world entry | | **Bypass Permission** | Admins can use kits anywhere | 🎮 GUI System | Feature | Description | |---------|-------------| | **Main Kit Menu** | Beautiful paginated kit selection GUI | | **Preview Mode** | 100% secure view-only kit preview | | **Locked Kit Display** | Shows unavailable kits with requirements | | **Clickable Store Links** | MiniMessage-powered clickable URLs | | **Admin Edit GUI** | Visual drag-and-drop kit editor | | **Confirmation Dialogs** | Deletion confirmations with warnings | | **Pagination** | Auto-pagination for 30+ kits | | **Custom Icons** | Per-kit custom materials and model data | | **Glowing Icons** | Optional enchantment glow effect | | **Dynamic Lore** | Real-time cooldown/uses display | 💾 Storage Options | Type | Use Case | Pros | Cons | |------|----------|------|------| | **YAML** | Single servers | Easy setup, human-readable | Not network-compatible | | **SQLite** | Small-medium servers | No external DB needed, fast | Not network-compatible | | **MySQL** | Networks, large servers | Network sync, scalable | Requires MySQL server | 🔌 Integrations | Plugin | Integration Level | Features | |--------|------------------|----------| | **LuckPerms** | ⭐⭐⭐⭐⭐ Deep | Groups, permissions, prefixes, suffixes, rank detection | | **Vault** | ⭐⭐⭐⭐ Full | Economy costs, permission fallback | | **PlaceholderAPI** | ⭐⭐⭐⭐⭐ Deep | 15+ custom placeholders | | **bStats** | ⭐⭐⭐ Standard | Anonymous usage metrics | 🎨 Effects & Feedback | Effect Type | Customizable | Per-Kit