Bukkit

This is a guide to make a map of your world so you can start using Navigator.

Maps are required since it's very hard for the plugin to detect the actual roads in your game world. How can you tell a toen square from a roof? How can you tell a dirt track from a piece of bare ground? Minecraft servers sadly don't match our brains yet.

There is a mapping program available, Mapper. This program still works, but is a bit hard to use and its' use is deprecated.
http://dev.bukkit.org/server-mods/navigator/pages/using-mapper/

The guide below only applies to Navigator after version 1.3. Use Mapper or update the plugin if your version is older.
You need the navigator.edit permission node or operator status to edit maps.

Ok, let's get started, shall we?
All commands stated below are not case-sensitive, except for destination names, and to be typed without the quotes.

First of all, open Minecraft, log in to your server, and enter the world you wish to map. Then send the command:
"/nav edit createmap"
This will create an empty map of your world, and you're ready to start working.
(Note: There appears to be a bug where newly created maps cannot be edited properly. Restart or reload the server to fix this.)

There are now some things you need to know about:

If you saw this page before version 1.6, you might remember that Navigator maps were flat, 2D. They aren't anymore!

- Saving your map is really important, or you will lose any changes. To save your map, say "/nav edit save".

- To be able to see your map, send the command "/nav edit drawmap". Anything this command does is purely visual and does not affect the game nor the plugin in any way. The blocks used to draw the map are only client-side ghost blocks and don't exist server-side. They do appear to modify blocks around them in the world if you break them due to a bug, so don't unless you have to. (No risk if they don't touch anything.). If you need the map drawn at another height or you cannot see it because you moved, just give the command again. Use "/nav edit drawmap false" to hide the map.

- A node is where roads are connected to eachother. Place these wherever there's an intersection or a turn. It might also be a good idea to place nodes at possible future intersections, to save you some time when you build them. These should NOT be placed where roads cross but shouldn't interact. (When a bridge passes over another road for example.) .

To place a new node, move your character to the desired position. Place it in the middle of the road or intersection, try to be accurate.
Then send "/nav edit addnode". You can also say "/nav edit addnode A/B" to select the node you just created.
You can select up to two nodes using "/nav edit selnode A" and "/nav edit selnode B".
You can delete a node by selecting it and then say "/nav edit delnode A" or "/nav edit delnode B" (depending on which command you used to select it)

- A road is a straight line that connects two nodes with eachother and should be within 2 blocks (better max 1) from the center of the actual roads in your game world. To make a new road, you first need two nodes. Place them if you haven't already. Approach one of the nodes and say "/nav edit selnode A" and then approach the other one and say "/nav edit selnod eB". Then, say "/edit say addroad". This will create a new road between the two nodes.

- A destination is a point where you can navigate to using /nav go "<destination>". To place one, move your character to where you want it to be and say "/nav edit addDest <name>" where <name> is to be replaced by the name of the destination. WARNING: The name must be case-insensitively unique. If you start navigation to this destination, it will lead you to the nearest point on the nearest road from it. You can delete the destination "/nav adit delDest <name>".

- Other commands can be found using "/nav edit" without other arguments.

That's basically it. Now, once again, don't forget "/nav edit save".