Bukkit

Getting Started

Administrator Permissions

All of the commands shown on this page require administrator permissions. Grant all administrator permissions with the following parent node:

lodestar.admin

Permission to use LodeStar items is granted to all players by default.

A full list of permissions can be found on the Permissions page.

Setting Destinations

To get started with LodeStars on your server, you first need to set some destinations. You do this by standing at the location you would like to make a destination, and issue the 'set' command, like so:

/lodestar set Destination

Make sure you are looking in the direction you want your players to be facing when they arrive at the destination!

You can use formatting codes to add color to your destination name, and underscores will be transformed into spaces. Example:

/lodestar set &aMy_Destination

There are two reserved destination names that cannot be set; 'spawn' and 'home'. These predefined destinations will transport a player to the world spawn, or their bedspawn respectively when using an item that has been bound to these destinations. If a bedspawn is not set, it will send the player to the world spawn instead.

It is important to note that responsibility for protecting the area around a destination falls solely on the server administrator. There are no built-in means of protecting a destination given by the LodeStore plugin. I urge all administrators who create destinations to protect them with WorldGuard or another protection mechanism. Otherwise, nasty little griefers will place lava pools below the destinations, or obsidian monoliths that unsuspecting LodeStar users will suffocate inside, or any other of a number of crafty death traps to await users upon arrival at their destination.

Creating a LodeStar Item

Now you need to create an item that is bound to your destination. The quickest and easiest way is to hold an item in hand, and use the bind command. You can also use this command to change the destination of an existing LodeStar item.

/lodestar bind my_destination

Note that destination names are case insensitive, and it is not necessary to type the color codes, if any, when referencing a destination. You must use an underscore in place of spaces, however. As of version 1.1, you may now use spaces or underscores interchangeably in all commands. Underscores will be converted to spaces by the plugin.

You can now place the LodeStar items in shops for your players to purchase, or give them away.

The give command is very flexible, and can be used to put newly created items in your own inventory if you specify your own name. The fastest way to give an existing LodeStar item to a player is to hold the LodeStar item in hand, and then issue the give command to send a copy of the item to a player:

/lodestar give savage

You can also specify a quantity to give:

/lodestar give savage 10

If you'd like to give a player a newly created LodeStar, rather than one that you already have in your inventory, simply specify an existing destination. This will place a LodeStar of the default material in the target player's inventory. The default is a nether star, but this can be changed in the configuration file.

/lodestar give savage my_destination

Again, you can add a quantity on to the end of the command to give more than one default LodeStar item at a time:

/lodestar give savage 10 my_destination

The items given should display the destination as given when the destination was set, including colors or other formatting. Spaces will be displayed where underscores were placed.