Fairy Commander — Command-Infused Items

Fairy Commander is a 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 expiring items.

• 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. Enter the command without quotes, as plain raw command text.

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