TESTING

GillKits - Advanced Kit Editor Plugin
Version: 1.0.0
Minecraft Version: 1.21+
Dependencies: None

GillKits is a high-performance Minecraft plugin that provides advanced kit management capabilities. Built with modern Java practices, it offers lightning-fast performance with minimal server impact, easy YAML-based configuration, and advanced features like cooldowns, permissions, and multi-world support.

Features
GUI Kit Editor - Edit kits visually with an inventory-based editor
Per-Player Kits - Players can have their own customized kits
Lightning Fast - Optimized for performance with minimal server impact
Easy Configuration - Simple YAML-based configuration
Multi-World Support - Works across multiple worlds and servers
Permission-based Editing - Control who can edit default kits or just their own
Automatic Saving - Kits are saved to .yml files for persistence
Advanced Cooldowns - Flexible cooldown system
Custom Messages - Fully customizable plugin messages
Reload Support - Reload configs and kits without restarting your server

Installation

1. Download the GillKits.jar file
2. Place it into your server's plugins folder
3. Restart the server
4. The plugin will create its folder and default files automatically

Commands
Command Description Permission
/gkits create <name> Create a new kit with the given name gillkits.edit
/gkits edit <name> Open the GUI editor for an existing kit gillkits.edit
/gkits save Save the kit you're currently editing gillkits.edit
/gkits reset Reset your kit editing session back to the original gillkits.edit
/gkits cancel Cancel editing without saving changes gillkits.edit
/gkits remove <name> Delete a kit gillkits.edit.default
/gkits list Show all available kits gillkits.use
/gkits give <kit> [player] Give a kit to yourself or another player gillkits.give
/gkits reload Reload the plugin's configs and kits gillkits.admin
Permissions
Permission Description
gillkits.use Basic permission to use /gkits commands
gillkits.edit Allows a player to edit their own kits
gillkits.edit.default Allows editing of default kits
gillkits.give Allows giving kits to other players
gillkits.admin Full access to all commands
Configuration
config.yml
GillKits Configuration
plugin:
version: "1.0.0"
debug: false

General Settings
settings:
auto-save: true
backup-kits: true
max-kits-per-player: 10

GUI Settings
gui:
editor-title: "Kit Editor"
selector-title: "Select Kit"
confirm-deletions: true

Performance
performance:
async-save: true
cache-kits: true

messages.yml
Message Configuration
messages:
prefix: "&7[&6GillKits&7] "
kit-created: "&aKit '&e{kit}&a' created successfully!"
kit-saved: "&aKit '&e{kit}&a' saved!"
kit-deleted: "&cKit '&e{kit}&c' deleted."
kit-given: "&aGave kit '&e{kit}&a' to &e{player}&a."
kit-received: "&aYou received the '&e{kit}&a' kit!"
kit-not-found: "&cKit '&e{kit}&c' not found."
no-permission: "&cYou don't have permission to do that."
player-not-found: "&cPlayer '&e{player}&c' not found."
editing-started: "&aStarted editing kit '&e{kit}&a'. Use &e/gkits save &ato save changes."
editing-cancelled: "&cKit editing cancelled."
editing-reset: "&aKit editing reset to original state."
reload-complete: "&aGillKits reloaded successfully!"

Quick Start Guide
Creating Your First Kit

1. Fill your inventory with the items you want in the kit
2. Run the command: /gkits create starter
3. The kit is created and ready to use
4. Give the kit: /gkits give starter [player]

Editing Existing Kits

1. Start editing: /gkits edit starter
2. Modify items in the GUI editor
3. Save changes: /gkits save
4. Or cancel: /gkits cancel

Setting Up Permissions
Basic usage
- gillkits.use

Allow players to edit their own kits
- gillkits.edit

Allow editing of server default kits (admins)
- gillkits.edit.default

Allow giving kits to other players
- gillkits.give

Advanced Features
Per-Player Kit System
Players can create and manage their own personal kits:

• Each player has their own kit storage
• Players can only edit their own kits (unless they have admin permissions)
• Server admins can create default kits available to all players

GUI-Based Editing
The visual kit editor provides:

• Inventory Interface - Familiar chest-based editing
• Real-time Preview - See changes as you make them
• Easy Item Management - Drag and drop items
• Confirmation Dialogs - Prevent accidental changes

Performance Optimization
GillKits is built for performance:

• Asynchronous Saving - Non-blocking kit saves
• Memory Efficient - Minimal RAM usage
• Fast Loading - Quick server startup
• Cache System - Reduced file I/O operations

Kit File Format
Example kit file: starter.yml
kit:
name: "starter"
display-name: "&aStarter Kit"
created: "2025-01-01T00:00:00Z"
last-modified: "2025-01-01T00:00:00Z"
items:
- slot: 0
material: "WOODEN_SWORD"
amount: 1
- slot: 1
material: "WOODEN_PICKAXE"
amount: 1
- slot: 8
material: "BREAD"
amount: 16


Troubleshooting
Common Issues
Kits not saving:

• Check file permissions in the plugins/GillKits/ folder
• Ensure auto-save is enabled in config
• Check console for error messages

Permission errors:

• Verify permission plugin is installed and working
• Check permission node spelling
• Restart server after permission changes

Performance issues:

• Enable async-save in configuration
• Reduce max-kits-per-player if needed
• Check for plugin conflicts

Debug Mode
Enable debug logging in config.yml:

plugin:
debug: true

This will provide detailed console output for troubleshooting.

Support
Discord: https://discord.gg/KYDKxj8wwz

For bug reports, feature requests, or general support, join our Discord server where our development team and community can assist you.

Changelog
Version 1.0.0

• Initial release
• GUI-based kit editor
• Per-player kit system
• Performance optimizations
• Multi-world support
• Comprehensive permission system