Перейти к содержимому
Mineforgian

Item Commander

A simple Serverside Fabric mod that allows you to assign commands to Item(Stacks)

Загрузки
7K
Подписчики
19
Обновлён
18 сентября 2024 г.
Лицензия
CC0-1.0

Опубликован 17 февраля 2022 г.

Исходный кодСообщить об ошибке

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.

Ченджлог

1.7.0-pre.2+1.21.1Бета1.21, 1.21.1 · 18 сентября 2024 г.

⚠️ THIS IS A PRE-RELEASE! LITTLE TO NO TESTING HAS BEEN DONE! PROCEED WITH CAUTION!

It was too good to be true...
This version fixes an issue where Commander data wouldn't be applied to new items (y'know, half of the mod functionality)

If you see any oddities, let me know!

GitHub Release: https://github.com/CamperSamu/ItemCommander/releases/tag/v1.7.0-pre.2+1.21.1

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.7.0-pre.1+1.21.1...v1.7.0-pre.2+1.21.1

1.7.0-pre.1+1.21.1Бета1.21, 1.21.1 · 12 сентября 2024 г.

⚠️ THIS IS A PRE-RELEASE! LITTLE TO NO TESTING HAS BEEN DONE! PROCEED WITH CAUTION!

Thank god, 1.21.1 didn't impact this.

This is a simple port of the previous release. I haven't gotten around to implement the datafixer and the new component structure, so I just decided to port this since Mojang still haven't removed the workarounds I am using to make this work.

If you see any oddities, let me know!

GitHub Release: https://github.com/CamperSamu/ItemCommander/releases/tag/1.7.0-pre.1+1.21.1

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.7.0-pre.1+1.20.5...1.7.0-pre.1+1.21.1

1.7.0-pre.1+1.20.5Бета1.20.5, 1.20.6 · 30 апреля 2024 г.

⚠️ THIS IS A PRE-RELEASE! LITTLE TO NO TESTING HAS BEEN DONE! PROCEED WITH CAUTION!

Damn, 1.20.5 got hands.
This is a rough port that uses the old NBT system instead of the custom component system I am planning for the stable release and doesn't feature a datafixer.
If you want to update to this version, you can update old commander items by putting them in an inventory and then updating to 1.20.5. All functionality should remain intact.

If you see any oddities, let me know!

GitHub: https://github.com/CamperSamu/ItemCommander/releases/tag/1.7.0+1.20.5-pre.1

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.6.2...1.7.0-pre.1+1.20.5

1.6.2+1.20.4Релиз1.20.3, 1.20.4 · 23 января 2024 г.

This update fixes issues with Placeholders API, as well as adding better logging on mod initialization to report integration support.

Changelog

  • Fix Placeholders API support
  • Log mod integration support at mod initialization
  • API: Add CommanderSource#vanilla to create a ServerCommandSource from a Commander Source

GitHub: https://github.com/CamperSamu/ItemCommander/releases/tag/1.6.2

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.6.1...1.6.2

1.6.2+1.20.2Релиз1.20, 1.20.1, 1.20.2 · 23 января 2024 г.

This update fixes issues with Placeholders API, as well as adding better logging on mod initialization to report integration support.

Changelog

  • Fix Placeholders API support
  • Log mod integration support at mod initialization
  • API: Add CommanderSource#vanilla to create a ServerCommandSource from a Commander Source

GitHub: https://github.com/CamperSamu/ItemCommander/releases/tag/1.6.2

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.6.1...1.6.2

1.6.1+1.20.4Релиз1.20.3, 1.20.4 · 13 января 2024 г.

This update brings two new command context options, SERVER_AS_PLAYER and DANGEROUSLY_OP, improving compatability with mods that don't use Brigadier or use altered permission checking such as WorldEdit.

Changelog

  • Two new command context
    • SERVER_AS_PLAYER
      • This is the same as running a command as the server with execute as @p, but in a way cleaner and faster way.
    • DANGEROUSLY_OP
      • This context is highly discouraged, it works by briefly giving OP to the player to execute the command; this is done sequentially in a code block synchronized to the server op list, so it should generally be ok to use, but try to avoid this one if possible.
  • Updated documentation

For the curious

If you are wondering how DANGEROUSLY_OP works, here's the (Yarn) code snippet:

case DANGEROUSLY_OP -> {
    synchronized (server.getPlayerManager().getOpList()) {
        server.getPlayerManager().addToOperators(player.getGameProfile());
        server.getCommandManager().executeWithPrefix(player.getCommandSource(), parsedCommand);
        server.getPlayerManager().removeFromOperators(player.getGameProfile());
    }
}

GitHub: https://github.com/CamperSamu/ItemCommander/releases/tag/1.6.1

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.6.0...1.6.1

1.6.1+1.20.2Релиз1.20, 1.20.1, 1.20.2 · 13 января 2024 г.

This update brings two new command context options, SERVER_AS_PLAYER and DANGEROUSLY_OP, improving compatability with mods that don't use Brigadier or use altered permission checking such as WorldEdit.

Changelog

  • Two new command context
    • SERVER_AS_PLAYER
      • This is the same as running a command as the server with execute as @p, but in a way cleaner and faster way.
    • DANGEROUSLY_OP
      • This context is highly discouraged, it works by briefly giving OP to the player to execute the command; this is done sequentially in a code block synchronized to the server op list, so it should generally be ok to use, but try to avoid this one if possible.
  • Updated documentation

For the curious

If you are wondering how DANGEROUSLY_OP works, here's the (Yarn) code snippet:

case DANGEROUSLY_OP -> {
    synchronized (server.getPlayerManager().getOpList()) {
        server.getPlayerManager().addToOperators(player.getGameProfile());
        server.getCommandManager().executeWithPrefix(player.getCommandSource(), parsedCommand);
        server.getPlayerManager().removeFromOperators(player.getGameProfile());
    }
}

GitHub: https://github.com/CamperSamu/ItemCommander/releases/tag/1.6.1

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.6.0...1.6.1

1.6.0+1.20.4Релиз1.20.3, 1.20.4 · 12 января 2024 г.

This version brings the mod to Minecraft 1.20.1 and Minecraft 1.20.2, adding the OP Player context as a bonus! This version also drops Placeholders API as a mandatory, embedded dependency along fixing some quirks and updating documentation.

Changelog

  • Backport to 1.20.1 and 1.20.2
  • OP Player command context
    • This allows players to run a command as administrator (SERVER execute as @p begone!)
  • /commander give can now give items to another player (or multiple players, like /give)
  • From now on, Placeholders API will not be included with this mod and won't be needed for basic functionality
  • If the player's hand is empty when trying to create a Commander Item (without a specified item), the command will now throw an error.
  • Improved error logging
  • Very minor code refactoring
  • This mod now suggests Placeholders API and LuckPerms
  • Updated documentation

GitHub: https://github.com/CamperSamu/ItemCommander/releases/tag/1.6.0

Full Changelog: https://github.com/CamperSamu/ItemCommander/compare/1.5.0...1.6.0

Комментарии

Загружаем…