[:AT:] GP-4-2 Train Version 1.0

A realistic train simulator system for Second Life!
This train will simulate torque, brake effort, traction, and it will require you to throttle up for uphill tracks, and brake when going downhill!

***Train Operator Handbook***
****************************

**How to use the train**
*********************

Rez the train near a track, that has guide prims, the train will snap to the guide prim of the track

Sit in the train, or optionally open the door and left click the driver seat, to sit in the driver seat

Click the train to get a menu dialog, you can use the buttons in the menu to control features, or get the hud for more features!

You can also rez railway carriages if you have any, they'll also snap to the track when rezzed.

Click the train's rear hook to toggle between seeking mode enabled or disabled!
In seeking mode, the hook will connect to another hook in seeking mode when close by to it
Use this to hook up the railway carriages to the train, or to another carriage!

**How to drive the train**
**********************

While driving the train, use the following keys for following results

W/Up arrow: Combined power handle up
W/Down arrow: Combined power handle down
E/PGUP: Reverser up
C/PGDN: Reverser down

The combined power handle controls the throttle and brake together, when your throttle is zero, it goes into brake notches, when brakes are zero, it goes into throttle notches

Reverser is what sets the direction of the train, the reverser states are, FWD, Neutral, RWD, reverser handle's positions are: forward is up, neutral is middle, and reverse is downward

During a simcrossing, it's possible the train object simcrosses faster than the avatar, and when it detects no driver, it does an emergency stop, and IMs an SLURL of its location to the user, if this happens to be a false positive, as it occurs and you are still sitting in the train fine, you have to stand up, and sit back down in the driver seat, to continue operating the train!

There is a known issue with simcrossings on mainland!
https://jira.secondlife.com/browse/BUG-231293

When simcrossing, if your towed carriages may get returned after it crossed, just go to a rez zone, and rez the carriage back, reset all scripts in it
Click the hook on the train to unhook the now nonexistant carriage, and click it again to turn on seeking mode, then hook up your carriage as normal.

When the carriage has been re-rezzed after such simcrossing return, it becomes "immune" to this issue, and will simcross fine afterward, until rezzed and taken while not on mainland.

The dashboard of the train is fully functional

Clickable interactions are
- Horn lever
- Sander
- Emergency Brake
- Interior Light
- Rear Light switch
- Front Light Switch
- Emergency Engine Stop
- Left Window
- Right Window
- Doors
- Breaker door
- Breakers

To turn on the engine of the train the realistic way, open the breaker panel box which is located next to the opposite of the driver side door, and turn on the two middle breakers, then turn on the red breaker on the right

Light switches are to be twisted towards the motion of the train, left is forward, right is backward, this governs which lights are going to be red, and which are going to be illuminating.

**Train Dialog**
**************

Give HUD ------ Gives the train HUD to you as inventory item, wear this
FuelSystem --- Disable or enable the fuel simulation
AI Pilot --------- Enable the AI to drive the train
ReRail ---------- Snap the train back to the guided track
Flip ------------- Flip directions, the front of the train will be facing opposite to where it was facing before
InstaStop ------ Instantly stop the train from moving, use this in emergencies!
Engine --------- Toggle the train's engine on or off
HeadLight ----- Toggle the train's headlight on or off
InteriorLight --- Toggle the train's interior light on or off
Access -------- Select who can access the train, Owner, Group, or Everyone
Cameras ------ Opens the Camera selection menu; Camera options are: TopDown, Cab (default), Forward, Reverse
Customiser ---- Opens the customisation menu where you can select a built in color or put in a uuid for your own color

**Fuel System**
The train operates with GFS Diesel fuel, use any GFS fuel source to refill your train's diesel fuel tanks!
If Fuel System is not disabled from the train menu, the train can run out of fuel and will fail to start it's engine without fuel!

**Train AI pilot**
**************
Enable the AI autopilot from the train menu, same button disables it, once the AI is on, it will listen to commands given to it, it will fire up the train engine if its not on, and operate the train by itself based on commands given.

See item in Second Life