Описание
# **ShadowKits**
**ShadowKits is a fully customizable kit system designed for Minecraft Fabric servers. It allows server administrators to create, manage, and configure kits that players can claim based on cooldowns, permissions, and other settings.**
### 📜 Features:
- ✅ Fully Configurable Kits - Define kits in JSON format, including items, enchantments, names, lore, commands, cooldowns, and more.
- ✅ Custom GUI Menus - Beautifully designed and configurable inventory GUIs for kit selection and previews.
- ✅ Custom Enchantment & NBT Support - Kits retain all item properties, including enchantments, custom model data, and NBT tags.
- ✅ Cooldown & Claim Limits - Set cooldowns and maximum claims per kit.
- ✅ Permission-Based Access - Restrict specific kits using LuckPerms or any permission plugin.
- ✅ Command Execution - Run custom commands when a player claims a kit.
- ✅ Custom Sounds - Play unique sounds when a kit is claimed or when it's on cooldown.
- ✅ Language & Message Customization - Edit all messages, GUI titles, and lore with full RGB color support.
- ✅ Player Data Storage - Track kit usage, cooldowns, and claims in individual player JSON files.
- ✅ Kits Privew on Blocks - Allow admins to set custom privew kits menu on custom blocks.
### ⚙️ Commands:
Spoiler
- `/kits` - Opens the main kits GUI where players can browse and claim kits.
- `/kit claim ` - Claim a specific kit if available.
- `/kit give ` - Admin command to give a kit to another player.
- `/kit remove ` - Deletes a kit from the configuration.
- `/kit create ` - Creates a new kit in kits folder.
- `/kit preview ` - Opens a GUI preview of a specific kit.
- `/kit reload` - Reloads the kit configuration without restarting the server.
- `/kit block set ` - This command will transform the block you are looking at into a kit preview block, which you can interact with to preview the kit or claim it.
- `/kit block unset` - With this command you will be able to transform the preview kit block back into a normal block.
### 🔒 Permissions:
Spoiler
- `kit.claim` - Allows players to claim kits using **/kit claim **
- `kits.view` - Allows players to open the kits menu with **/kits**
- `kit.preview` - Allows players to preview a kit with **/kit preview **
- `kit.create` - Allows admins to create new kits using **/kit create **
- `kit.give` - Allows admins to give kits to players using **/kit give **
- `kit.remove` - Allows admins to remove kits using **/kit remove **
- `kit.reload` - Allows admins to reload the kits configuration with **/kit reload**
- `kit.` - Grants access to a specific kit by name
- `kit.block.set` - Allow admins to set the privew blocks
- `kit.block.unset` - Allow admins to remove the privew blocks
### 📝 Configurable Menus:
- Kit Selection Menu - A GUI for browsing kits, with customizable slots, fill items, and pagination.
- Kit Preview Menu - A GUI that previews kit contents before claiming.
- Fully Customizable - All GUI elements (buttons, titles, filler blocks, navigation buttons) are fully configurable via menu.json and menu_preview.json.
### 📂 Configuration Files:
- 📁 `/config/shadowkits/config.json` - Stores general settings, cooldowns, and messages.
- 📁 `/config/shadowkits/kits/` - Stores individual kit configurations in JSON format.
- 📁 `/config/shadowkits/menu.json` - Configures the kit selection GUI.
- 📁 `/config/shadowkits/menu_preview.json` - Configures the kit preview GUI.
### 📃 Config Ex:
Spoiler
```json
{
"name": "Starter",
"onJoin": false,
"firstTimeJoin": false,
"cooldown": "1h",
"claims": true,
"maxClaims": 5,
"permission": "kit.starter",
"economyProvider": "auto",
"currency": "money",
"costMoney": false,
"cost": 100,
"claimSound": "minecraft:entity.player.levelup",
"cooldownSound": "minecraft:entity.villager.no",
"page": 1,
"slotOnPage": 10,
"displayItem": {
"material": "minecraft:diamond_sword",
"amount": 1,
"displayname": "&bKit Starter",
"lore": [
"&7A powerful kit to begin your journey!",
"&aIncludes enchanted tools and a food!"
],
"cooldownLore": true,
"enchantEffect": true,
"unbreakable": false
},
"rewards": [
{
"type": "item",
"material": "minecraft:iron_pickaxe",
"amount": 1,
"displayname": "&bIron Pickaxe",
"lore": [
"&7Handy starter tool"
],
"enchants": [
{
"name": "minecraft:unbreaking",
"level": 2
}
],
"enchantEffect": true
},
{
"type": "command",
"command": "give %player% minecraft:cooked_beef 16",
"displayItem": {
"material": "minecraft:cooked_beef",
"amount": 16,
"displayname": "&6Food Voucher",
"lore": [
"&7Runs a give-food command"
],
"enchantEffect": false
}
},
{
"type": "item_pack",
"displayname": "&aStarter Supplies",
"lore": [
"&7A small pack of basics"
],
"pack": [
{
"material": "minecraft:oak_log",
"amount": 32,
"displayname": "&eOak Logs"
},
{
"material": "minecraft:torch",
"amount": 16,
"displayname": "&eTorches"
}
]
},
{
"type": "command_pack",
"displayItem": {
"material": "minecraft:paper",
"amount": 1,
"displayname": "&dCommand Pack",
"lore": [
"&7Executes multiple commands"
],
"enchantEffect": false
},
"pack": [
{
"amount": 1,
"command": "effect give %player% minecraft:regeneration 5 1 true"
},
{
"amount": 1,
"command": "say ShadowKits: Command pack reward for %player%"
}
]
},
{
"type": "item_random",
"displayname": "&eRandom Item",
"lore": [
"&7One random item from the list"
],
"randomList": [
{
"weight": 1.0,
"material": "minecraft:diamond",
"amount": 1,
"displayname": "&bDiamond"
},
{
"weight": 3.0,
"material": "minecraft:gold_ingot",
"amount": 3,
"displayname": "&6Gold Ingots"
},
{
"weight": 6.0,
"material": "minecraft:iron_ingot",
"amount": 5,
"displayname": "&fIron Ingots"
}
]
},
{
"type": "command_random",
"displayItem": {
"material": "minecraft:tripwire_hook",
"amount": 1,
"displayname": "&eRandom Command",
"lore": [
"&7Executes one random command"
],
"enchantEffect": false
},
"randomList": [
{
"weight": 1.0,
"amount": 1,
"command": "effect give %player% minecraft:strength 60 1 true"
},
{
"weight": 2.0,
"amount": 1,
"command": "effect give %player% minecraft:speed 60 1 true"
},
{
"weight": 3.0,
"amount": 1,
"command": "say ShadowKits: Good luck, %player%!"
}
]
}
]
}
```