![[IMG]](http://proxy.spigotmc.org/c65fc5ee6a8c522a937c3f7f366eb949a19e8ba1?url=https%3A%2F%2Fi.imgur.com%2FF11dsyZ.png)
What's that ?
ItemCommand is a plugin that allows you to add various functions to items, it can be used for gameplay features, or as simple objects to provide an additional experience.
Features
- Allows to do multiple things with the item, not only use a single command
- Support for BungeeCord (Server connection, broadcast)
- In-Game creation support
- Block the sell of the items (Configurable)
- Smooth interface, easy to use commands
- Language change support (see lang.yml)
- Easy-to-use configuration
- Configurable admin-permission
Functions supported
![[IMG]](http://proxy.spigotmc.org/7f2652cca8b2336a7d37ff6ea1f091d61baab12c?url=https%3A%2F%2Fi.imgur.com%2FjIFSzHj.png)
In-game interface
In order to work, you need an item with a custom displayname and a custom lore, and then, you'll just have to do /ic createhand <name>. You'll be guided trough this interface in your hotbar, and you'll just have to write the function that you want inside you chat.
You can add up to 6 functions directly in-game, but it is unlimited if you edit this in the config later.
![[IMG]](http://proxy.spigotmc.org/a5e8639a6e619b731e42dd12b75cda4cdf16469d?url=https%3A%2F%2Fi.imgur.com%2FC5DW4kq.png)
Sell protection
If you don't want your players to sell the items that they got, you just have to put the sell command(s) inside the config.yml, and do a /ic sellable <name> false, they won't be able to perform the command anymore when they have the item in hand.
Configuration
Spoiler: config.yml
By default, there's an item called test-item inside the configuration file.
Code (YAML):
# #------------------------------
# Configuration informations
# ------------------------------
# admin-permission » Gives access to /ic
# sell-commands » Commands that are blocked when the flag "sellable" is set to false in an ItemCommand, please include the slash
#
# ItemCommands syntax:item: item: <The Material you want to use, do not use Command Blocks>
# sellable: <true/false>
# display-name: <Display name of the item you want to use, you can use & or §>
# lore:
# - <The lore of the item you want to use>
# commands:
# - <Commands that'll be executed upon use>
# - <msg>Test » Will send a message to the player
# - <teleport>world;0;0;0 » Will teleport the player to given location
# - <effect>INVISIBILITY;255;0 » Will set the player invisible 1 for 255 seconds
# - <playercmd>home bed » Will force the player to execute a command
# - <broadcast>message » Will broadcast a message to the entiere server
# - <connect>hub » Will connect the player to given server
# - give %player% paper 1 » Will give an item to player
admin-permission : hadaria.admin
sell-commands :
- /hdv
- /sell
- /ah
- /auction
- /ya
items:
test-item:
item : PAPER
sellable : true
display-name : '&6Chèque &7 (50$ )'
lore :
- '&7&oCliquez sur ce chèque pour'
- recevoir 50$ !
commands :
- eco give %player% 50
# Configuration informations
# ------------------------------
# admin-permission » Gives access to /ic
# sell-commands » Commands that are blocked when the flag "sellable" is set to false in an ItemCommand, please include the slash
#
# ItemCommands syntax:item: item: <The Material you want to use, do not use Command Blocks>
# sellable: <true/false>
# display-name: <Display name of the item you want to use, you can use & or §>
# lore:
# - <The lore of the item you want to use>
# commands:
# - <Commands that'll be executed upon use>
# - <msg>Test » Will send a message to the player
# - <teleport>world;0;0;0 » Will teleport the player to given location
# - <effect>INVISIBILITY;255;0 » Will set the player invisible 1 for 255 seconds
# - <playercmd>home bed » Will force the player to execute a command
# - <broadcast>message » Will broadcast a message to the entiere server
# - <connect>hub » Will connect the player to given server
# - give %player% paper 1 » Will give an item to player
admin-permission : hadaria.admin
sell-commands :
- /hdv
- /sell
- /ah
- /auction
- /ya
items:
test-item:
item : PAPER
sellable : true
display-name : '&6Chèque &7 (50$ )'
lore :
- '&7&oCliquez sur ce chèque pour'
- recevoir 50$ !
commands :
- eco give %player% 50
Spoiler: lang.yml
Spoiler: English
prefix : '&9ItemCommand &f&l»'
hover:
help : '&eHelp'
hover-mouse : '&7&oHover the commands to see help!'
ic-give : '&fThis command allows you to give an ItemCommand to a player'
ic-sellable : '&fThis command allows you to set the sellable status of an ItemCommand'
ic-createhand : '&fThis command allows you to create a new ItemCommand with the item in hand'
ic-remove : '&fThis command allows you to delete an ItemCommand'
ic-listitems : '&fThis command sends you the list of ItemCommands'
ic-reload : '&fThis commands allows you to reload the configuration file'
other:
item-list : '&eItemCommand list : &7'
config-reloaded : '&aConfig reloaded!'
unable-to-sell : '&eYou can''t sell this item!'
player-not-online : '&ePlayer &a %player% is not online!'
item-creation:
already-exists : '&cThis ItemCommand already exists!'
item-created : '&aThe ItemCommand &e %item% &ahas been created!'
need-lore-and-displayname : '&eItem must have a display-name and a lore!'
item-deleted : '&cThe ItemCommand &e %item% &chas been deleted!'
item-does-not-exist : '&cThe item &e %item% &cdoes not exists !'
now-sellable : '&eThe ItemCommand %item% is now &asellable'
no-longer-sellable : '&eThe ItemCommand %item% is &cno longer sellable'
action-cancelled : '&cAction cancelled'
enter-true-or-false : '&ePlease enter true or false'
added-command : '&aCommand added : &e%cmd%'
must-be-on-commandblock : '&cYou must have a command block in hand to write the command'
help-creating :
- '&eStarting editing of &a %item%'
- '&eTo cancel, type &a!cancel'
- '&eTo add a command, &atype it in the chat'
- '&eTo send a message, &atype <msg>Message'
- '&eTo teleport the player, &atype <teleport>world;x;y;z'
- '&eTo add a potion effect to the player, &atype <effect>effect;duration;amplifier'
- '&eTo force the player to run a command, &atype <playercmd>command'
- '&eTo broadcast a message, &atype <broadcast>message'
- '&eTo connect the player to a server, &atype <connect>server'
- '&eTo broadcast a message in the network, &atype <bungeebroadcast>message'
- '&eTo set the player''s health, &atype <health>9.5'
- '&eTo set the player''s food level, &atype <food>20'
- '&eYou can use the player''s name with &a %player%'
- '&eTo terminate, type &a/ic createhand %item%'
give:
inventory-is-full : '&ePlayer %player% inventory is full!'
given : '&eItemCommand &a %item% &ehas been given to &a%player% &ex%amount%'
Code (YAML):
prefix : '&9ItemCommand &f&l»'
hover:
help : '&eHelp'
hover-mouse : '&7&oHover the commands to see help!'
ic-give : '&fThis command allows you to give an ItemCommand to a player'
ic-sellable : '&fThis command allows you to set the sellable status of an ItemCommand'
ic-createhand : '&fThis command allows you to create a new ItemCommand with the item in hand'
ic-remove : '&fThis command allows you to delete an ItemCommand'
ic-listitems : '&fThis command sends you the list of ItemCommands'
ic-reload : '&fThis commands allows you to reload the configuration file'
other:
item-list : '&eItemCommand list : &7'
config-reloaded : '&aConfig reloaded!'
unable-to-sell : '&eYou can''t sell this item!'
player-not-online : '&ePlayer &a %player% is not online!'
item-creation:
already-exists : '&cThis ItemCommand already exists!'
item-created : '&aThe ItemCommand &e %item% &ahas been created!'
need-lore-and-displayname : '&eItem must have a display-name and a lore!'
item-deleted : '&cThe ItemCommand &e %item% &chas been deleted!'
item-does-not-exist : '&cThe item &e %item% &cdoes not exists !'
now-sellable : '&eThe ItemCommand %item% is now &asellable'
no-longer-sellable : '&eThe ItemCommand %item% is &cno longer sellable'
action-cancelled : '&cAction cancelled'
enter-true-or-false : '&ePlease enter true or false'
added-command : '&aCommand added : &e%cmd%'
must-be-on-commandblock : '&cYou must have a command block in hand to write the command'
help-creating :
- '&eStarting editing of &a %item%'
- '&eTo cancel, type &a!cancel'
- '&eTo add a command, &atype it in the chat'
- '&eTo send a message, &atype <msg>Message'
- '&eTo teleport the player, &atype <teleport>world;x;y;z'
- '&eTo add a potion effect to the player, &atype <effect>effect;duration;amplifier'
- '&eTo force the player to run a command, &atype <playercmd>command'
- '&eTo broadcast a message, &atype <broadcast>message'
- '&eTo connect the player to a server, &atype <connect>server'
- '&eTo broadcast a message in the network, &atype <bungeebroadcast>message'
- '&eTo set the player''s health, &atype <health>9.5'
- '&eTo set the player''s food level, &atype <food>20'
- '&eYou can use the player''s name with &a %player%'
- '&eTo terminate, type &a/ic createhand %item%'
give:
inventory-is-full : '&ePlayer %player% inventory is full!'
given : '&eItemCommand &a %item% &ehas been given to &a%player% &ex%amount%'
Spoiler: French
Code (YAML):
prefix
: '&9ItemCommand &f&l»'
hover:
help : '&eAide'
hover-mouse : '&7&oPasse ta souris au dessus des commandes pour avoir de l''aide !'
ic-give : '&fCette commande permet de give un ItemCommand à un joueur'
ic-sellable : '&fCette commande permet d''activer ou de désactiver la vente d''un ItemCommand'
ic-createhand : '&fCette commande permet de créer un ItemCommand avec l''objet tenu en main'
ic-remove : '&fCette commande permet de supprimer un ItemCommand'
ic-listitems : '&fCette commande permet de voir la liste des ItemCommand'
ic-reload : '&fCette commande permet de recharger la configuration'
other:
item-list : '&eListe des ItemCommand : &7'
config-reloaded : '&aConfiguration rechargée !'
unable-to-sell : '&eImpossible de vendre cet objet'
player-not-online : '&cLe joueur &e %player% &cest hors-ligne'
item-creation:
already-exists : '&cCet ItemCommand existe déjà !'
item-created : '&eL''ItemCommand &a %item% &ea été crée !'
need-lore-and-displayname : '&cL''item doit avoir un nom et une description !'
item-deleted : '&cL''ItemCommand &e %item% &ca été supprimé !'
item-does-not-exist : '&cL''ItemCommand &e %item% &cn''existe pas !'
now-sellable : '&eL''ItemCommand &a %item% &eest désormais &avendable'
no-longer-sellable : '&eL''ItemCommand &a %item% &en''est &cplus vendable'
action-cancelled : '&cAction annulée'
enter-true-or-false : '&eMerci d''entrer &atrue&e/&cfalse'
added-command : '&aCommande ajoutée : &e%cmd%'
must-be-on-commandblock : '&cVous devez avoir un command block dans la main pour écrire une commande'
help-creating :
- '&eÉdition de &a %item%'
- '&ePour annuler, tapez &a!cancel'
- '&ePour ajouter une commande, &atapez la dans le tchat, sans slash'
- '&ePour envoyer un message au joueur, &atapez <msg>Message'
- '&ePour téléporter le joueur, &atapez <teleport>world;x;y;z'
- '&ePour ajouter un effet au joueur, &atapez <effect>effect;duration;amplifier'
- '&ePour forcer un joueur à executer une commande, &atapez <playercmd>command'
- '&ePour faire une annonce, &atapez <broadcast>message'
- '&ePour connecter un joueur à un serveur, &atapez <connect>server'
- '&ePour faire une annonce BungeeCord, &atapez <bungeebroadcast>message'
- '&ePour changer la vie du joueur, &atapez <health>9.5'
- '&ePour changer la nourriture du joueur, &atapez <food>20'
- '&eVous pouvez utiliser le pseudo du joueur avec &a %player%'
- '&ePour enregistrer, tapez &a/ic createhand %item%'
give:
inventory-is-full : '&e %player% a l''inventaire plein !'
given : '&a %item% &ea été donné a &a%player% &7(&ex%amount%&7)'
hover:
help : '&eAide'
hover-mouse : '&7&oPasse ta souris au dessus des commandes pour avoir de l''aide !'
ic-give : '&fCette commande permet de give un ItemCommand à un joueur'
ic-sellable : '&fCette commande permet d''activer ou de désactiver la vente d''un ItemCommand'
ic-createhand : '&fCette commande permet de créer un ItemCommand avec l''objet tenu en main'
ic-remove : '&fCette commande permet de supprimer un ItemCommand'
ic-listitems : '&fCette commande permet de voir la liste des ItemCommand'
ic-reload : '&fCette commande permet de recharger la configuration'
other:
item-list : '&eListe des ItemCommand : &7'
config-reloaded : '&aConfiguration rechargée !'
unable-to-sell : '&eImpossible de vendre cet objet'
player-not-online : '&cLe joueur &e %player% &cest hors-ligne'
item-creation:
already-exists : '&cCet ItemCommand existe déjà !'
item-created : '&eL''ItemCommand &a %item% &ea été crée !'
need-lore-and-displayname : '&cL''item doit avoir un nom et une description !'
item-deleted : '&cL''ItemCommand &e %item% &ca été supprimé !'
item-does-not-exist : '&cL''ItemCommand &e %item% &cn''existe pas !'
now-sellable : '&eL''ItemCommand &a %item% &eest désormais &avendable'
no-longer-sellable : '&eL''ItemCommand &a %item% &en''est &cplus vendable'
action-cancelled : '&cAction annulée'
enter-true-or-false : '&eMerci d''entrer &atrue&e/&cfalse'
added-command : '&aCommande ajoutée : &e%cmd%'
must-be-on-commandblock : '&cVous devez avoir un command block dans la main pour écrire une commande'
help-creating :
- '&eÉdition de &a %item%'
- '&ePour annuler, tapez &a!cancel'
- '&ePour ajouter une commande, &atapez la dans le tchat, sans slash'
- '&ePour envoyer un message au joueur, &atapez <msg>Message'
- '&ePour téléporter le joueur, &atapez <teleport>world;x;y;z'
- '&ePour ajouter un effet au joueur, &atapez <effect>effect;duration;amplifier'
- '&ePour forcer un joueur à executer une commande, &atapez <playercmd>command'
- '&ePour faire une annonce, &atapez <broadcast>message'
- '&ePour connecter un joueur à un serveur, &atapez <connect>server'
- '&ePour faire une annonce BungeeCord, &atapez <bungeebroadcast>message'
- '&ePour changer la vie du joueur, &atapez <health>9.5'
- '&ePour changer la nourriture du joueur, &atapez <food>20'
- '&eVous pouvez utiliser le pseudo du joueur avec &a %player%'
- '&ePour enregistrer, tapez &a/ic createhand %item%'
give:
inventory-is-full : '&e %player% a l''inventaire plein !'
given : '&a %item% &ea été donné a &a%player% &7(&ex%amount%&7)'
Developper API
Code (Java):
@EventHandler
public void onIC (ItemCommandUsedEvent e ) {
ItemCommand ic = e. getItemCommand ( ) ;
Player p = e. getPlayer ( ) ;
//Do what you want here
}
public void onIC (ItemCommandUsedEvent e ) {
ItemCommand ic = e. getItemCommand ( ) ;
Player p = e. getPlayer ( ) ;
//Do what you want here
}
Code (Java):
ItemCommandManager icm
=
new ItemCommandManager
(
)
;
//Create an ItemCommand, will return false if it already exists
//Set the durability (data) to 0 if you don't want one, and set the skull_owner to null if it isn't neccessary
icm. createItemCommand ( String name, Material m, String display_name, List <String > lore, List <String > commands, boolean sellable, int durability, String skull_owner )
//Delete an ItemCommand, will return false if it doesn't exists
icm. removeItemCommand ( String name )
//Set the sellable status of an ItemCommand, will return false if it doesn't exists
icm. setSellable ( String name, boolean sellable )
//Create an ItemCommand, will return false if it already exists
//Set the durability (data) to 0 if you don't want one, and set the skull_owner to null if it isn't neccessary
icm. createItemCommand ( String name, Material m, String display_name, List <String > lore, List <String > commands, boolean sellable, int durability, String skull_owner )
//Delete an ItemCommand, will return false if it doesn't exists
icm. removeItemCommand ( String name )
//Set the sellable status of an ItemCommand, will return false if it doesn't exists
icm. setSellable ( String name, boolean sellable )
If you want to pay me a coffee, then visit https://paypal.me/dbzjp
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ItemCommand - Add functions to items ! is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 1,421 times (via Spigot). Download it and open it directly in the game.