[:AT:] Freight Train Versión 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.

**Hauling Cargo**
****************

Use the included cargo follow script, put that into objects you wish to be cargo, put them on the train and it will carry them while in motion, when stopped it releases them and lets you move them again.

Cargo will simcross as well as carriages, same rules apply, they are also affected by the bug mentioned above.

Alternatively you can freely link cargo to your train as well, and unlink it when done carrying it.

The included Flatcar will also haul cargo in a similar fashion.

**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 build 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!