Bukkit

GPS is an Essentials warp location plotter that shows the closest defined warps along with the compass heading and difference in elevation. The warps are ordered from closest to furthest. Optionally, your compass may be set to a specific warp.

Compass Orientation

Your compass is calibrated to line up with the standard, Minecraft coordinate system when listing warps. These are the same compass directions shown when pressing [F3]. This is also optionally turned off in the config file to prevent compass calibrating when listing warps. The default is switched on. This setting is ignored if GPS is asked to set the compass to a warp.

Navigation

If you decide not to set your compass to a warp you can navigate to it instead. With your calibrated compass and a distance and heading combination from the list, you have what you need to get to the warp. Any time you need an update on your position simply invoke /gps. This is an alternative way to get to the desired warp using a compass the way it is normally used outside of Minecraft. The benefit of navigating to a destination is that you remain aware of where you are in relation to all the listed warps instead of just one. You may also remain aware of where you are in relation to distance and heading combinations provided by other plugins ie: Pplot, gpsTowny and Postal.

Elevation

The elevation of the warp is shown relative to the player. The distance is in blocks. Negative numbers are lower than the player, positive numbers are above the player. Sometimes warps are underground, or in the clouds. Now you know for sure.

Essentials

Essentials is a depend, and not optional. GPS will look for Essentials and hook it if found, but abort if not.

Installation

Just drop into your plugin directory and go.

Command

/gps [warp] (alias: /gpse)

Invoked without parameters this command delivers the geographically aware list of warps. Used with a warp name sets your compass to the warp. If you have a conflict with the command ‘/gps’, use ‘/gpse’. /gpse is a little more than an alias, it is an alternate command name.

Confirmation

GPS will complete complicated warp names with just a few characters, if possible. You are given a chance to confirm the completed name with a single ‘/’. The warp names GPS considers when completing a warp name are narrowed down to the ones listed when listing the nearby warps. The length of this list is set in the config file and may be as long or short as desired. This dramatically reduces the amount of characters needed to identify the desired warp.

Permissions

Permissions are turned off by default to make it easy to get started. Turn on in 'config.yml' as well as set a custom permission node. Standard nodes are ‘gps.admin' and 'gps.gps’ or op.

Settings

Other settings in 'config.yml' are the number of warps to list, and, whether to line your compass up with Minecraft coordinates when listing warps. GPS automatically determines the availability of Essentials, and won't start if it can't find it. Vault is a soft depend, and will be used, if found, to determine the desired permission system.

To change your settings go to the /va_gps directory, off of the /plugins directory you dropped this plugin into and find the file name 'config.yml'. Use a text editor like Notepad (plus plus) to change settings as desired. Avoid changing the structure of the file, and avoid using tabs. Getting a new config.yml file is very easy if it gets messed up. Just delete it and let GPS create a new one.

History

GPS is from a larger plugin, Postal. Postal has a /gps command that provides a similar location list, but lists Postal addresses instead of Essential warps. This plugin contains proven code from Postal, but adapted to Essentials.

Comments