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.

Hold an Emerald in hand.
/commander addCommand "give @s gold_ingot 3"
/commander addConsumable 1 false
/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.

Hold Paper in hand.
/commander addCommand "tp @s 0 64 0"
/commander addConsumable 5 true
/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.

Fairy сommander