UltimateVouches

Plugin Name: Ultimate Vouches
Version: 1.0
Minecraft Version: 1.21.1
API: Spigot

Description:
The Ultimate Vouches plugin allows server admins to create and distribute custom vouchers that players can redeem. By right-clicking the voucher, players trigger a predefined command executed by the server. The plugin integrates seamlessly with Spigot and uses custom NBT data to ensure secure and flexible voucher functionality.

Features:

• Custom Commands: Assign any console command to a voucher with dynamic placeholders such as {player} to represent the player's name.
• Interactive Items: Vouchers are items with custom NBT tags to store commands securely.
• Simple Admin Commands: Admins can easily create and distribute vouchers using a simple set of commands.
• Persistent Data: Vouchers remain intact across server restarts, thanks to the use of unique identifiers and NBT data.
• Customizable Appearance: Admins can modify the item type and display name of vouchers.
• Easy Redemption: Players can redeem the voucher by right-clicking the item, triggering the associated console command.

Commands:

• /ultimatevouches give ""
  
  • Description: Creates a voucher with a specified command and gives it to a player.
  • Arguments:
    • : The target player who will receive the voucher.
      : The command to execute when the voucher is redeemed. {player} can be used as a placeholder for the player's name.
• Example:
  • /ultimatevouches give Steve "/give {player} diamond 5"
    • This creates a voucher that gives 5 diamonds to the player who redeems it.

• /ultimatevouches name
  • Description: Changes the name of the voucher item currently held by the player.
  • Arguments:
    • : The new name to set for the voucher (supports color codes).
  • Example:
    • /ultimatevouches name "&6Epic Voucher"
      • This changes the name of the item to "Epic Voucher" with a gold color.

• /ultimatevouches item
  • Description: Change the material of the voucher item that you are holding.
  • Arguments:
    • : The new material to set for the voucher.
  • Example:
    • /ultimatevouches item DIAMOND
      • This changes the voucher's material to a diamond.

Usage:

• Create a Voucher: Use the /ultimatevouches give command to create and distribute a voucher to a player.
• Redeem a Voucher: Players can right-click the voucher in their inventory to execute the associated command.
• Change Voucher Material: Use /ultimatevouches item to change the material of the voucher item.
• Change Voucher Name: Use /ultimatevouches name to change the display name of the voucher item.

Events:

• Player Interaction: The plugin listens for the PlayerInteractEvent to detect when a player uses a voucher.
• Voucher Removal: Once a voucher is redeemed, it is automatically removed from the player's inventory.

Requirements:

• NBT-API: The plugin uses the NBT-API to manage custom NBT tags on items.
• Spigot: A compatible server version running Minecraft 1.21.1 or higher.

Installation:

1. Download the plugin JAR file and place it in the plugins folder of your server.
2. Install the NBT-API plugin (if not already installed).
3. Restart the server.

Permissions:

• ultimatevouches.admin: Grants access to the /ultimatevouches commands.

Images: