wItemGive

# wItemGive **wItemGive** is a comprehensive and user-friendly Minecraft server plugin designed to simplify item distribution. It allows administrators to create custom commands for any item in the game through an intuitive Graphical User Interface (GUI). !(https://img.shields.io/badge/API-Paper%2FSpigot%201.19%2B-blue) !(https://img.shields.io/badge/Java-8%2B-orange) (https://img.shields.io/badge/Discord-7289DA?style=flat&logo=discord&logoColor=white)](https://coolnw.eu/wstudio/discord) --- ## 🎮 For Players The plugin offers a seamless way to receive special server items if you have the required permissions. * **Custom Commands**: If an admin creates an item named "Special Sword", you might be able to use `/specialsword` to receive it. * **Rich Formatting**: Items often feature vibrant names and descriptions thanks to support for HEX gradients and MiniMessage formatting. --- ## 🛠 For Administrators wItemGive is designed to minimize the time spent in configuration files by providing an in-game management system. ### Management GUI Access the main interface using `/witemgive` or `/wig` (Permission: `witemgive.admin`). * **Adding Items**: 1. Hold the desired item in your hand. 2. Click the **Green Emerald** in the GUI. 3. Type the desired command name in the chat (without the `/`). 4. The item is now saved, and the command is instantly registered. * **Distributing Items**: * **Left-click** an item in the GUI to give it to yourself. * Use `/{command} {player}` to give the item to someone else. * **Removing Items**: **Right-click** an item within the GUI to delete it and its associated command. ### Permissions * `witemgive.admin`: Full access to the GUI and the ability to give items to other players. * `wig.{command_name}`: Permission to use a specific dynamic command to give an item to oneself. --- ## ⚙️ For Developers & Configuration The plugin is highly flexible and follows a clean data structure, making it easy to tweak or integrate. ### File Structure ``` plugins/wItemGive/ ├── config.yml # Main configuration (Messages, Prefix, Settings) └── items/ # Directory containing individual item data ├── legendary_bow.yml # Each item is stored in its own YAML file └── super_potion.yml ``` ### Dynamic Command System When an item is added, the plugin dynamically registers a command. These commands support tab-completion for player names and handle permissions automatically. ### Configuration (`config.yml`) You can customize the following aspects: * **Prefix**: Change the plugin's chat prefix to match your server's branding. * **Localization**: Every message sent to players (success, error, no permission) is fully configurable. * **Formatting Engines**: Toggle support for: * **Legacy**: Standard `&c` codes. * **HEX**: `#RRGGBB` format. * **MiniMessage**: Advanced `<gradient>` and `<hover>` tags. ### Support If you encounter any issues or have questions, feel free to join our community! (https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://coolnw.eu/wstudio/discord) --- *Created by wStudio*