first commit

README.md

@@ -0,0 +1,48 @@
+# PvP Kits Plugin for PaperMC 1.21.4
+
+A customizable PvP kit plugin with GUI selection and player-specific kit layouts.
+
+## Features
+
+- **GUI-based kit selection** - Inventory menu for choosing kits
+- **Persistent kit layouts** - Saves each player's item arrangement per kit
+- **Hardcoded default kits** - Pre-configured with balanced PvP loadouts
+- **Easy customization** - Simple to add new kits or modify existing ones
+- **Modern 1.21.4 support** - Includes all new weapons and items
+
+## Included Kits
+
+| Kit Name   | Icon Item | Special Features |
+|------------|-----------|------------------|
+| Warrior    | Diamond Sword | Diamond armor, strength effect |
+| Archer     | Bow       | Speed boost, arrows |
+| Tank       | Shield    | Damage resistance |
+| Assassin   | Netherite Sword | Speed/jump boost, ender pearls |
+| Mace       | Mace      | Wind Burst enchantment, netherite armor |
+
+## Commands
+
+- `/kits` - Open the kit selection GUI
+- `/kits save <kitname>` - Save your current inventory as a kit layout
+
+## Installation
+
+1. Download the latest `.jar` from Releases
+2. Place in your server's `plugins/` folder
+3. Restart your server
+
+## Configuration
+
+Kits are hardcoded in `KitManager.java`. To modify kits:
+
+1. Edit the `initializeKits()` method
+2. Rebuild the plugin (`gradlew build`)
+3. Replace the JAR file
+4. Restart server
+
+Example kit addition:
+```java
+Kit mage = new Kit("Mage", Material.BLAZE_ROD);
+mage.setHelmet(new ItemStack(Material.LEATHER_HELMET));
+// ... other armor/items ...
+kits.put("mage", mage);