Fairy Commander — Command-Infused Items

Fairy Commander is a powerful utility mod for Fabric that allows server administrators and creators to turn any item into a functional tool, magical artifact, or temporary pass by attaching commands and usage logic directly to them via NBT.

No more complex command block arrays or heavy plugins — just brand an item and give it to a player.

🌟 Core Features

🛠️ Command Binding

Bind any console command to an item. When a player right-clicks with the item, the command is executed from their position. Supports multiple commands on a single item.

🔋 Consumable Charges

Limit how many times an item can be used.

• Set a specific number of uses.
• Choose whether the item should vanish when empty or stay in the inventory as an "exhausted" tool.

⏳ Periodic Recharging

Make your artifacts even more powerful by allowing them to regain charges over time.

• Set a recharge period (e.g., 1 charge every hour, day, or week).
• Perfectly balances powerful "Limited-Use" items.

⌛ Time-Based Self-Destruction

Create temporary passes, trial items, or "ticking bombs."

• Set a countdown timer (in seconds).
• The item automatically disappears from the player's inventory when time runs out, regardless of whether it was used.

⌨️ Commands Guide

All features are managed via the /commander root command:

• /commander addCommand "<command>" — Adds a command to the item in your hand.
• /commander addConsumable <uses> <deleteWhenZero: true/false> — Sets the usage limit.
• /commander addRechargeable <seconds> — Sets the recharge interval.
• /commander addTimeSelfDestroy <seconds> — Sets the expiration timer.

💡 Practical Use Cases

💎 The Daily Reward Token

Give players an item they can keep and use once every 24 hours to get resources.

1. Hold an Emerald in hand.
2. /commander addCommand "give @s gold_ingot 3"
3. /commander addConsumable 1 false
4. /commander addRechargeable 86400 Result: An emerald that gives 3 gold every day.

🚀 VIP Teleportation Scroll (Temporary)

A scroll that teleports the player to a hub, has 5 uses, and expires in 3 days.

1. Hold Paper in hand.
2. /commander addCommand "tp @s 0 64 0"
3. /commander addConsumable 5 true
4. /commander addTimeSelfDestroy 259200 Result: A teleportation scroll that disappears after 5 uses or after 3 days have passed.

🔍 Visuals (I18n Supported)

The mod features detailed, localized tooltips (English and Russian supported) that show:

• Remaining charges.
• Time remaining until the next recharge.
• Expiration countdown for self-destructing items.