Item Commander

Shiny item do stuff

A simple Serverside Fabric mod that allows you to assign commands to Item(Stacks). It works by adding NBT data to the item, then when a player uses an item the NBT data for that item is checked, if it contains the ItemCommander tag tree it executes the specified command.

To embed a command in an item, hold it in your main hand and run /commander create "<command>" [CONSUME_ACTION] [COMMAND_SOURCE] [cooldownTicks] [CustomItemNBT]

consume actions:

Action	Description
CONSUME	Consumes the item
KEEP	Keeps the item

command sources:

Action	Description
SERVER	Command executed by the server
PLAYER	Command executed by the player
OP	Command executed by the player with OP
SERVER_AS_PLAYER	Command executed by the server as the player (like OP)
DANGEROUSLY_OP	Command executed by the player whilst being OP ⚠️

defaults in **bold***

Command placeholders

when creating a command you can use the following vanilla-like placeholders:

Placeholder	Action
`@itemname`	Item Name
`@pich`	Player pitch
`@yaw`	Player yaw
`@ix`	Item use X coordinate
`@iy`	Item use Y coordinate
`@iz`	Item use Z coordinate
`@x`	Player use X coordinate
`@y`	Player use Y coordinate
`@z`	Player use Z coordinate
`@p` and `@s`	The player using the Commander Item

To append more commands to one item, hold a Commander Item in your main hand and run /commander append "<command>" To save a Commander Item, hold it in your main hand and run /commander save <fileName> To load/give a Commander Item, run /commander give <fileName> [quantity] [player(s)]

This mod supports Patbox' Text Placeholders API.

You can use %modid:type% or %modid:type/data% inside a Commander Item to make use of a custom placeholder
Example: commander create

This mod supports LuckPerms' Fabric Permission API.

commander.command.create allows a player to use this mod to embed commands in items
commander.command.append allows a player to use this mod to append commands to Commander Items
commander.command.give allows a player to use this mod to give itself Commander Items
commander.command.save allows a player to use this mod to save Commander Items to a file on the server

Examples

Creating a Commander Item

/commander create "say Hello myself (@s), you clicked at @ix, @iy, @iz!" KEEP OP 20 paper{display:{Name:'[{"text":"Commander Test Item!","italic":false}]'}}

Appending an extra command to a Commander Item

/commander append "If you have Text Placeholder API, this will be your name: %player:name%"

Saving a Commander Item

/commander save commander_test_item

Giving/loading a saved item to a player

/commander give commander_test_item 1 @p

Bleeding edge builds

Upstream builds are available via GitHub Actions.

Setup

For setup instructions please see the fabric wiki page that relates to the IDE that you are using.

License

This template is available under the CC0 license. Feel free to learn from it and incorporate it in your own projects.

CamperSamu / ItemCommander

readme