Give Command
/lodestar give <player> [quantity] [material][:data] [destination_name]
Note: If the configuration option 'default-material-only' is true, the give command will ignore the material:data if given, so the effective usage becomes this:
/lodestar give <player> [quantity] [destination_name]
The give command is used to place a LodeStar item directly into a player's inventory. The command has many incantations. The simplest takes just a player name:
/lodestar give savage
If the issuing player has a pre-made LodeStar item in hand when the command is used, a copy of this item with the same destination and material will be placed in the target player's inventory. If the issuing player does not have a LodeStar item in hand when the command is used, it will give the player a LodeStar item with the default material from the configuration, with a destination of the world spawn. This usage mimics the behavior of the original SpawnStar plugin. A quantity may also be specified after the player name:
/lodestar give savage 10
It is also possible to use the give command to generate a new item to be placed in the target player's inventory. This may also be evoked from the console, since it does not use an item in hand as a reference item:
/lodestar give savage my_destination
Also, with a specified quantity:
/lodestar give savage 10 my_destination
When used this way, the target player will be given a LodeStar item that is linked to the specified destination, and is of the default material type defined in the configuration file. With a default installation, a nether star is specified as the default material, but this may be changed to any Minecraft block type in the configuration file.
It is also possible to specify a material type in the give command, for example:
/lodestar give savage PAPER my_destination
Again, with a quantity specified:
/lodestar give savage 10 PAPER my_destination
Some Minecraft materials have an associated data value. You can specify the numeric data value after the material type, separated by a colon. For instance, the Oxeye Daisy material type is RED_ROSE, with a data value of 8. To give a player an Oxeye Daisy LodeStar item, the command would be used like this:
/lodestar give savage RED_ROSE:8 my_destination
Or with a quantity specified:
/lodestar give savage 10 RED_ROSE:8 my_destination
The plugin will attempt to match the material given, which is case insensitive, with a known bukkit material type. If no match can be made, an item of the default material specified in the configuration file will be given. However, if an invalid material data value is given, the object given will not have a block texture, and will appear as a black and pink checkered cube. Be sure to use a valid material name and data value for predictable results.
You may also use a numeric item id in place of the name, however this functionality may cease to be supported in future versions of bukkit. For example, the numeric item id for RED_ROSE is 38, so to use this method to produce the same Oxeye Daisy LodeStar item shown above, you would invoke the command as follows:
/lodestar give savage 38:8 my_destination
Or with the optional quantity:
/lodestar give savage 10 38:8 my_destination
As you can see, the give command is very flexible. However, the safest method to manually give a LodeStar item directly to a player would be to use the bind command on an existing inventory item, and then use the simple
give <player> version of the command to give a copy of the LodeStar item in hand to the player. The advanced versions of the give command are included to enable giving items when logged into the console, or for use in scripting the command, perhaps with BuyCraft or other plugins that can issue commands. It is advisable to first test the command by giving items to yourself to be sure of the intended result.
<-- Back to command overview
