Weapon creation plugin

addons/weapon_creator/README.md

@@ -0,0 +1,57 @@
+# Weapon Creator 3D Plugin
+
+A powerful Godot editor plugin that streamlines the creation of 3D weapons with all required resources.
+
+## Features
+
+- **User-Friendly UI**: Intuitive dock panel with organized input fields
+- **Real-time Feedback**: Live output log showing creation progress and errors
+- **Auto-generation**: Automatically generates item keys from weapon names
+- **Full Validation**: Input validation with helpful error messages
+- **Complete Integration**: Creates WeaponResource, LootItem, and adds to ItemsDatabase automatically
+- **Customizable Stats**: Fine-tune all weapon parameters through the UI
+
+## Installation
+
+1. The plugin is already installed in `addons/weapon_creator/`
+2. Go to **Project → Project Settings → Plugins**
+3. Enable "Weapon Creator 3D"
+
+## Usage
+
+1. Open the **Weapon Creator** panel from the bottom dock
+2. Fill in the weapon details:
+   - **Basic Information**: Name, key, description
+   - **Weapon Statistics**: All gameplay parameters
+3. Click **Create Weapon** button
+4. Check the output log for results
+5. Find your new weapon resources in:
+   - `Resources/Weapons/[WEAPON_KEY].tres`
+   - `Resources/Items/[WEAPON_KEY]_Item.tres`
+
+## Tips
+
+- Item Key is auto-generated from Weapon Name (converts to UPPERCASE_WITH_UNDERSCORES)
+- The bullet path defaults to the simple ice bullet - change if needed
+- All fields have tooltips explaining their purpose
+- Use "Clear Log" to reset the output display
+
+## What Gets Created
+
+1. **WeaponResource** - Contains all weapon stats and bullet data
+2. **LootItem** - Makes the weapon pickupable in-game
+3. **Database Entry** - Automatically added to ItemsDatabase.tres
+
+## After Creation
+
+Remember to:
+1. Add weapon sounds (shoot, reload) to the WeaponResource
+2. Add an inventory sprite to the LootItem
+3. Test the weapon in-game
+
+## Troubleshooting
+
+- **"Resource already exists"**: Choose a different weapon name/key
+- **"Bullet resource not found"**: Verify the bullet path is correct
+- **No output**: Check the Godot console for errors
+