Project Navigator

The Navigator Project was started to make a public database of routes that can be used for any type of vehicles. This project is public and anyone can take part of.

Make a route, drive/ride/fly/walk along it, share it with everyone.

Routes are designed for:

* Airplanes, helicopters
* Boats, submarines
* Cars, trucks
* Horses, walking
* Convertible vehicles.

## Basics

The *Navigator HUD* shows to pilots/drivers/sailors/explorers the way to go. The way to go is shown both with arrows and hovering text. The HUD uses notecards. Each route is stored on one notecard.

The *Compass HUD* allows anyone to make a route notecard. There are a few other HUDs that allow routes to be configured.

The *Navigator Server* allows anyone to upload new routes for general use and anyone to download routes into the Navigator HUD for use. It can be installed anywhere.

The *Navigator Library* is placed inside the Second Life Geography Institute, at *Valarian (182, 17, 1281)*. Anyone can upload new routes to the common database or download routes to a navigator HUD.

The **Notecard Route** is a notecard which hosts all navpoints of a route. To work, it must be properly configured.

## Navigator Pack

The pack is available from marketplace on the name Navigator (create, use & share routes (with money) or can be obtained for free from Second Life Geography Institute at *Valarian (182, 17, 1281)*. It contains:

* *Compass HUD* which enables residents to create routes
* *Navigator HUD* which enables residents to follow routes
* *Navigator Server* which can be placed anywhere to share routes
* *Checker HUD* & *Back Reader HUD* which help residents check routes and write them backwards
* *Navigator Info* (a HUD that can be worn anytime for quick info).

**Navigator Library** where anyone can upload routes or download them. It is located inside the Second Life Geography Institute *Valarian (182, 17, 1281)*.

## How To Make Routes

You need to get the navpoints along the route, configure a route notecard and upload it to the database.

### How to get navpoints

1. Go to the start point of the route you plan to follow.
2. Wear the *Compass HUD* and press the anchor to start.
3. Ride/drive/sail your vehicle or go by foot along the route.
4. As you travel along the route, the *Compass HUD* will say the navpoints in chat.
5. At the end of the route, copy all the navpoints on a notecard.

### How to configure navpoints in a route notecard

1. Copy-paste all navpoints on the notecard.
2. Edit the notecard so that navpoints are listed smoothly one after another, without extra text and without blanks.
3. Configure the name of the route notecard.
4. Use the *Checker HUD* to check for errors.

A **Navpoint** looks like this:

```
3,<257053,260845,0>

```

**GOOD: Navpoints are listed one after another:**

```
D,Usery,<136,132,6>
0,<287113,281214,0>
1,<287125,281161,0>
2,<287120,281111,0>
1,<287114,281056,0>
3,<287109,281007,0>
3,<287110,280953,0>
1,<287147,280914,0>
1,<287181,280876,0>
D,Valarian,<7,159,13>

```

**BAD: These are some common mistakes:**

```
[3,<257053,260845,0>
[10:46] Navigator Compass: 3,<257053,260845,0>
: 3,<257053,260845,0>

```

Extra text was not removed.

```
_3,<257053,260845,0>
3,<257053,260845,0>_

```

A blank is before or after text.

```
3,<287110,280953,0>1,<287147,280914,0>
3,<287110,280953,0> 1,<287147,280914,0>

```

Two navpoints on the same line.

```
,<257053,260845,0>
<257053,260845,0>
3,<257053,260845,0
257053,260845,0>

```

Part of the navpoint's instruction is missing.

### How to configure the name of a route notecard

The name of a route notecard must have four parts:

1. **Brand** (who made it). It can have any form.
2. **Starting sim** (region where it starts) It must be written exactly as it is, WITHOUT BLANKS before or after commas.
3. **Destination** (place where it goes). It can be destination sim or area where the route ends.
4. **Further info** (a short description). Good to say the type of vehicle the route is made for.

**IMPORTANT:**

* Don't put blanks close to commas.
* Use only four commas to separate the four parts.
* The name must not be over 72 characters.

**GOOD: Here are a few examples of names.**

```
Navigator,Tuliptree,Bhaga,Railway
Angela,Ahab's Haunt,Blake Sea,Sailing
Mark,Subak,Sansara,Airplane
My Route,Camrro,South Nautilus,Horse

```

**BAD: Here are a few wrong examples of names.**

```
Navigator,Tliptree,Bhaga,Railway

```

The starting sim was not spelled properly.

```
Navigator Tuliptree Bhaga Railway

```

Missing commas.

```
Navigator, Tuliptree, Bhaga, Railway

```

Blanks should not be placed before or after commas.

```
Navigator,Tuliptree,Bhaga,Railway,Road

```

Don't use commas in route description. Use something like *Railway & Road* or *Railway Road*.

### Additional entries on a notecard route

* You can use **T,** to add a comment that the HUD will say when you reach a navpoint.
* You can use the **/,** to add a comment on the notecard for yourself. The HUD will not say it.

```
0,<287113,281214,0>
T,Entering Dire Strait
1,<287125,281161,0>
2,<287120,281111,0>
/,Here we pass Ahab's Haunt
1,<287114,281056,0>

```

### Adding Landmarks

When you press the *anchor* button on the HUD you get a landmark, which looks like this:

```
D,Valarian,<7,159,13>

```

Use this at the beginning or at the end of the route.

### Check the route notecard

Wear the *Checker HUD* and put the route notecard inside. The HUD will check for errors. It will tell you where the route notecard has a mistake.

### Configure the route back

Wear the *Back Reader HUD* and put the notecard inside. It will tell you the navpoints backwards. Copy them into a notecard. This is the route back.

## How To Use Routes

1. Put the notecard route inside the *Navigator HUD*.
2. Press **Route**. You will see all routes that start from the sim where you are. If no route starts from there, you will see no route.
	1. You will see a *dialog box* with the options *Yes* (to use that route), *Next* (look for another route) and *Cancel* (no navigation).
3. Press **Info**. You will see all routes in database.
	1. You will see a *dialog box* with the options *Yes* (to use that route), *Next* (look for another route) and *Cancel* (no navigation).
4. If the route starts in another sim and the route is configured with a landmark, the world map will open and you will have an option to teleport there.
5. **Hovering text** will be seen above the HUD, showing distance and angle (left/right) to the next navpoint. **Arrows** can be seen beneath the HUD, showing which way to go (the more arrows are visible, the more you must turn left/right).
6. Once you arrived close to a navpoint, the next one will be shown.
7. At the end of the route, the HUD will tell you that you have arrived at the destination.

## How To Set A Server

1. Put the **Navigator Server** on your land. Additionally, you can take the scripts out and put them into any prim to configure a server.
2. To **upload** a route notecard, drag it from your inventory while holding CTRL during the process until the server turns red.
3. To **download** a route notecard, press the *Receive* button of the *Navigator HUD* when you are close to a server. Routes will download automatically.

## Navigator Library

The library allows anyone to upload or download routes. This is how it works:

1. Go to the library, inside the Second Life Geography Institute, at *Valarian (182, 17, 1281)*.
2. To **upload** to database, drag navigation routes from your inventory to the server (it is a green, glowing cube, in the middle, with a compass on it). HOLD CTRL WHILE DRAGGING NOTECARDS FROM INVENTORY.
3. The server will process the notecard and if it is ok it will store in the database.
4. To **download** from database, go to the coloured cubes. There are five terminals, each one hosting different routes (for protected land, mostly protected land, abandoned land, mixed land, private land). TOUCH the terminal then touch the *Receive* button of the *Navigator HUD*.
5. You can get the navigator HUDs from the library FOR FREE.

### Navigator Compass

It is designed to make routes. **Buttons:**

* **Find navpoint**. Click the *light bulb*. It will open a text bubble. Write there a navpoint and press *submit*. A hovering text will show you the way to go (distance and how much to turn left or right).
* **On/Off**. Click them to turn it on or off.
* **Land type**. Land type is color coded: *blue* - protected land Rezz Zone, *green* - Protected Land, *yellow* - Abandoned Land, *red* - private Inhabited Land, *black* - Land With Restricted Access.
* **HUD body**. Click to get a quick navpoint.
* **Straight line**. Set navpoints every 100 m.
* **Slight curves**. Set navpoints every 50 m (it is set this way by default).
* **Tight curves**. Set navpoints every 20 m.
* **anchor**. Press it for a landmark. Good at the beginning and at the end of route. If the person using the navigator HUD is not within the sim, he/she will be given the option to teleport there.
* **Hovering text**. show if it is off and distance from previous navpoint. Text color indicates the type of land you are into at the moment.

### Navigator HUD

It is designed to show you the way to go. **Buttons:**

* **Info**. Click to chose from all routes in database (see below).
* **Stop**. While navigating, click to stop. It will reset.
* **Directions**. While navigating, it allows you to look at previous or next navpoint.
* **Reset**. Hold for 3 seconds. It will reset the entire database.
* **Route**. Click to chose from all routes that start from the sim you are in (see below).
* **Receive**. When you are close to a server, click to receive routes from the server.
* **Hovering text** (while not navigating). It shows you how many routes are in memory.

While navigating, a few extra commands are available:

* **Dialog menu**. It activates when you chose *info* or *route*. If you chose *route* and there are no routes starting from the sim you are in, you will receive a message in chat that there are no available routes.
	+ **Dialog text**. The dialog comes with a description of the route (for example *Route from Ahab's Haunt to Degrand, sailing, by Angel*). You have 3 options: yes, no, cancel.
	+ **Yes**. Chose this route to drive/ride/sail/fly/walk.
	+ **Next**. Take a look at the next route available. If you reached the end of the line, you will see the first route again.
	+ **Cancel**. Stop navigation.
* **Hovering text** (while navigating). It shows you distance and angle to the next navpoint (for example *Distance: 35, 49 R*, which means distance is 35 m and you must go 49 degrees to right).
* **Arrows**. They can be seen under the HUD and show you the way to go. One arrow means turn 10 degrees more to left or right. Two arrows means 30 degrees, while three arrows means 90 degrees.
* **Text color**. This is helpful to asses the risk of entering land with restrictions. The text shows you what type of land was there when the navpoint was calculated. They are: *blue* - protected land rezz zone, *green* - protected land, *yellow* - abandoned land, *red* - private (inhabited) land and *black* - land with restricted access.
* **Landmarks**. If the route starts in another sim and has a landmark, you will be given the option to teleport there.

### Navigator Instructions

This is a HUD designed to give you instructions about how to use the navigator systems. It has 12 pages (images) that can be changed by using two buttons (forward and back):

* 0: cover
* 1: compass HUD instructions
* 2: how to make a route (part 1)
* 3: how to make a route (part 2)
* 4: how to find a navpoint with the compass HUD
* 5: how to name a route notecard
* 6: how to check a route for errors and how to make the return route
* 7: useful extra commands for making a route
* 8: how to upload a route to navigator HUD or to a server
* 9: navigator HUD instructions
* 10: navigator HUD (how to navigate using it)
* 11: how to set your navigator server
* 12: the SLGI route library.

### Notecard Back Reader

It is a small HUD. Drop a route notecard inside and it will read all the navpoints backwards. Copy them from chat and write them on another notecard to use them as the return route. After reaching the last line, you will hear *Finished* in chat and the note is deleted from HUD's inventory.

### Notecard Checker

It is a HUD that checks if a route is corrupt. Insert a route notecard in it and listen.

1. First, it checks the notecard's name format.
2. Then it checks if the starting sim is written correctly.
3. The HUD checks each row and looks for spelling errors.
4. After this, it checks for safety and shows you the amount of navpoints on protected, abandoned or private land. The notecard is deleted from HUD's inventory.

### Navigator Server

It is a simple prim, a cube that hosts two scripts: one that deletes double entries (it is turned on every a few hours) and one that uploads routes to a HUD if the HUD's owner presses the *receive* button. The server comes with a hovering text, explaining that, in order to upload routes, one must drag them from inventory and *hold CTRL button* during the whole process.

## See Also

* Second Life Geography
* Second Life Geography Institute
* SLGI Projects