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

!API !Java

---

🎮 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