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).

---

🎮 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!

---

Created by wStudio