--------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------
-------- German KS-Signals V9.8  - On the basis of "European Loco & Asset Pack"  -----
--------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------

The signals contained in the package are based on original Train Simulator 2013 signals.
Therefore, all signals after the installation available,
and not have to be enabled in the Editor.

All signals have been revised.
The scripts have been completely rebuilded to Train Simulator 2013.

For all main signals there are some special new variable available. in the script.
One called "gOptionEOTHp0". This controls whether the signal if passing link 0 fall
back to show stop aspect Hp0. All variable to use in a new file called "DEs KS Option.lua"
This file you find here: "...Assets\Kuju\RailSimulator\RailNetwork\signals\German KS"
All changes effected to all signals at the same time.
The description you find in this file.

The shunt signals (Sh1..Shunt) now automatic switch to clear aspect if a train
near the signal and the route is also clear.

All file names should be maintained as provided in the package so that
in case of an update the signale they are further working.
All signals if extendet on the number of tracks must stored as an additional signal.

Updateinfo:
Version 9.8
------------
- Integration of all Patche since version 9.5
- Follow several protective signals in a row only one Zs3 KF is required
- Premature CLEAR of the interlocking limits with Hp0 trigger (F) for train overhaul if the move in advance does not free the interlocking limits in good time
- ZS3 Trigger can now also use the distant signal speed
- GPA functions on the separate Zs3v with oppression from the 1000 Hz message from 80 km/h at the distant signal and a separate GPA module
- Group blocking signals guide the distant signal status from the following main signal

Version 9.5:
 - New: VrX Trigger can now also be set before signalink 0
 - Some bug fixes

Version 9.1:
 - Bugfix only

Version 9.0:
 - Further development together with the other signal systems from SignalTeam
 - Special shunt signals (Shunt_I) for interlocking limits because of false speed limits in HUD
 - Speed display and distant speed display show numbers up to 16
 - LZB Functions are included
 - Some bug fixes and the last patches have been included

Version 7.3:
 - make this signals compatible with new KS signals from SignalTeam
 - Some bug fixes and improvements

Version 6.2:
 - Trapez Board and Stopping Marker Board with blue signal light (state indicator)
 - Main signals without a post
 - Main-, Distant- and Shunt- signals to addon with main signals without a post

Version 5.11:
 - Small error corrections (Zs6 texture, distant repeater)

Version 5.1:
 - Small error corrections
 - Zs2 Destination indicator with more links, to set the destination in its own character fields

Version 5.01:
 - Small error corrections
 - Some new signal combination with speed indicators (light and plate)

Version V6:
 - Zs3 / Zs3v plate separately and in combination with distant and main signals
 - new Opt-Trigger to set options who are also set in option file different in a
   route or scenario for all signals or a single signalsystem or a single signal
 - new Zs8-Trigger
 - all main signals remains at Hp0 after passing in opposite direction.
   Either you switch a junction. Or set a Hp0-Trigger with "R"
   in the ID-Field before this signal

Version V3:
 - Attention! You find now all signals in editor with "DEs" not "ST"
 - manualy and random signal bugs
 - protection signals
 - automatic shift between Zs1 and Zs7 3d-model
 - many new triggers for special signal behavior

Version V2.1:
- new main/dist-signals without a Zs3/Zs3v for left post and gantrys
- distant signals and main/dist signals for a Zs3v plate
  (A Zs3v plate can be used from route Munich-Augsburg)

Version V2:
- The name of all signals are changed in editor from "DEs" to "ST"
- distant signal head is shorter new build
- to set a track as a yard entry, check the field in the signal flyout named "limited to yellow".
  This is possible at all main signals. If possible, the signal show "Sh1" in this case.
- If a common signal is next to a shunt signal, check the field "approach control"
  at the link from shunt signal to this common signal.
  Only if common signal is not at stop, shunt signal will be clear.
  It's also necessary to check "approach control" for signals in opposite direction,
  who have links to this common signal because the occupancy is deactivated then
- A most wanted feature is realised in this signal system...
  You can set shunt signals and distant signals between link 0 and link 1+ from main signals.
  Use the demo route (within this packet) to check out this new feature!
- Another new feature are some trigger who modify the behavior of signals in scenario.
  These trigger named like "DEs KS Scenario Hp0 Trigger" are all set only in scenario!
  Look first at the pictures in the german manual to set them properly.
  With those triggers you shape a scenario special.
- The demo route is filled in with all new features

Version V1:
- new main head for signals without distant function
- new distand head, now whith repeater an reduced function
- all heads can used without post for gantrys
- speed indicator Zs3 / Zs3v are fixed with signal head
- last prepared main signal in forward direction shows "expect stop" (KS2) if it has a distant head
- several script changes to prepare for our new DEs-PZB-package.
- central configuration file "DEs KS Option.lua" for behavior of signals
  - various options to delay Hp0 in case of passing link 0 forward
  - if consist is finishing passing link 0 delay signalstate possible
  - switch Sh1 per TAB-Key or automatic if consist is near
  - set the distance between consist and Sh1 if switch automatic
  All these options are documented in the file "DEs KS Option.lua"
  and in the german documentation
- There ar no siganls for yard entrys! In this case you can use all signals for this.
  You only must check the field "limited to yellow" in the signal-flyout.
  For more see useful pictures at german description.
- Debug a single signal to enter his postnumber in variable "gDebug" at option file.

My thanks go to the Rail Sim-user "4711", for the work of the 3D models.
I also thank "StS", also from the German forum for the implementation,
the extensive testing and the creation of the scenarios of the test track.
All changes to the scripts I've ("Schuster") done.

The package is available as freeware on www.Rail-Sim.de , www.oldtimerklubben.dk
----------------------------------------------------------------------------
licence agreement
----------------------------------------------------------------------------
The package is available as freeware on:
 www.Rail-Sim.de , www..dksimulators.dk, www.railworks.dk
and not on other platforms without my permission.
The signals may be used only at freeware routes.
The signals may not be distributed as a part of routes with their installation
but install it separate from the original package.

Use on Payware routes is not allowed and requires prior licensing by me.
----------------------------------------------------------------------------

Sorry but a extensive doku only exists in german,
but there are a lot of pictures which explain a lot.
You can find the file "Deutsche KS-Signale_V1.pdf" within the package.

E-mail-adress in case of problems/suggestions: railworks@mgundlach.de

Have fun with the German KS-Signals wishes
Mathias Gundlach  /Schuster at Rail-Sim

----------------------------------------------------------------------------

The following signals are included in the package:

----------------------------------------------------------------------------
----------------------------------------------------------------------------
Distant KS-Signals (Dist)
----------------------------------------------------------------------------

DEs KS Dist  0T				Distant signal shows KS2 / KS1
DEs KS Dist Zs3v  0T		Distant signal shows KS2 / KS1 / KS1_Slow
DEs KS Dist Zs3vP  0T		Distant signal with Zs3v plate shows KS2 / KS1 / KS1_Slow

Here are also versions of Distant signals repeater and reduced distant
for special use between main and distant signal:

DEs KS Dist  0T Repeater
DEs KS Dist  0T Reduced
DEs KS Dist Zs3v  0T Reduced
DEs KS Dist Zs3v  0T Repeater
DEs KS Dist Zs3vP  0T Reduced				with Zs3v plate
DEs KS Dist Zs3vP  0T Repeater				with Zs3v plate

DEs KS Dist [Zs3v]  0T						for Zs3v plate
DEs KS Dist [Zs3v]  0T Reduced				for Zs3v plate
DEs KS Dist [Zs3v]  0T Repeater				for Zs3v plate


DEs KS Dist le  0T					for left trackside
DEs KS Dist le  0T Reduced
DEs KS Dist le  0T Repeater

DEs KS Dist le Zs3v  0T
DEs KS Dist le Zs3v  0T Reduced
DEs KS Dist le Zs3v  0T Repeater

DEs KS Dist le [Zs3v]  0T 					for Zs3v plate
DEs KS Dist le [Zs3v]  0T Reduced			for Zs3v plate
DEs KS Dist le [Zs3v]  0T Repeater			for Zs3v plate


DEs KS Dist Gty  0T					to use at gantrys
DEs KS Dist Gty  0T Reduced
DEs KS Dist Gty  0T Repeater

DEs KS Dist Zs3v Gty  0T
DEs KS Dist Zs3v Gty  0T Reduced
DEs KS Dist Zs3v Gty  0T Repeater

DEs KS Dist Zs3vP Gty  0T					with Zs3v plate
DEs KS Dist Zs3vP Gty  0T Reduced			with Zs3v plate
DEs KS Dist Zs3vP Gty  0T Repeater			with Zs3v plate

DEs KS Dist [Zs3v] Gty 0T					for Zs3v plate
DEs KS Dist [Zs3v] Gty 0T Reduced			for Zs3v plate
DEs KS Dist [Zs3v] Gty 0T Repeater			for Zs3v plate

----------------------------------------------------------------------------
Sign to mark a distant head at a gantry:
----------------------------------------------------------------------------

DEs KS_Postshield Gty Dist

----------------------------------------------------------------------------
Sign to mark a distant head at a straight post:
----------------------------------------------------------------------------

DEs KS_Postshield Dist

----------------------------------------------------------------------------
----------------------------------------------------------------------------
Main signals
----------------------------------------------------------------------------
Main signal shows HP0 / KS1
----------------------------------------------------------------------------

DEs KS Main  0T
DEs KS Main  1T
DEs KS Main  2T
DEs KS Main  3T
DEs KS Main  4T

DEs KS Main le  0T				for left trackside
DEs KS Main le  1T
DEs KS Main le  2T
DEs KS Main le  3T
DEs KS Main le  4T

DEs KS Main Gty 0T				to use at gantrys
DEs KS Main Gty 1T
DEs KS Main Gty 2T
DEs KS Main Gty 3T
DEs KS Main Gty 4T

----------------------------------------------------------------------------
Main signal shows HP0 / KS1 with speed indicator Zs3
----------------------------------------------------------------------------

DEs KS Main Zs3 0T
DEs KS Main Zs3 1T
DEs KS Main Zs3 2T
DEs KS Main Zs3 3T
DEs KS Main Zs3 4T
DEs KS Main Zs3 5T
DEs KS Main Zs3 6T
DEs KS Main Zs3 7T
DEs KS Main Zs3 8T
DEs KS Main Zs3 9T
DEs KS Main Zs3 10T
DEs KS Main Zs3 11T
DEs KS Main Zs3 12T

DEs KS Main Zs3P  0T			with Zs3 plate
DEs KS Main Zs3P  1T
DEs KS Main Zs3P  2T
DEs KS Main Zs3P  3T
DEs KS Main Zs3P  4T

DEs KS Main le Zs3  0T			for left trackside
DEs KS Main le Zs3  1T
DEs KS Main le Zs3  2T
DEs KS Main le Zs3  3T
DEs KS Main le Zs3  4T

DEs KS Main Zs3 Gty 0T			to use at gantrys
DEs KS Main Zs3 Gty 1T
DEs KS Main Zs3 Gty 2T
DEs KS Main Zs3 Gty 3T
DEs KS Main Zs3 Gty 4T

DEs KS Main Zs3P Gty 0T			with Zs3 plate to use at gantrys
DEs KS Main Zs3P Gty 1T
DEs KS Main Zs3P Gty 2T
DEs KS Main Zs3P Gty 3T
DEs KS Main Zs3P Gty 4T

----------------------------------------------------------------------------
Main signal with distant head shows HP0 / KS1 / KS2
without speed indicator Zs3 / Zs3v
----------------------------------------------------------------------------

DEs KS MainDist 0T
DEs KS MainDist 1T
DEs KS MainDist 2T
DEs KS MainDist 3T
DEs KS MainDist 4T

DEs KS MainDist le 0T		for left trackside
DEs KS MainDist le 1T
DEs KS MainDist le 2T
DEs KS MainDist le 3T
DEs KS MainDist le 4T

DEs KS MainDist Gty 0T		to use at gantrys
DEs KS MainDist Gty 1T
DEs KS MainDist Gty 2T
DEs KS MainDist Gty 3T
DEs KS MainDist Gty 4T

----------------------------------------------------------------------------
Main signal with distant head shows HP0 / KS1 / KS2
with announcing speed indicator Zs3
----------------------------------------------------------------------------

DEs KS MainDist Zs3  0T
DEs KS MainDist Zs3  1T
DEs KS MainDist Zs3  2T
DEs KS MainDist Zs3  3T
DEs KS MainDist Zs3  4T

DEs KS MainDist Zs3P  0T			with Zs3 plate
DEs KS MainDist Zs3P  1T
DEs KS MainDist Zs3P  2T
DEs KS MainDist Zs3P  3T
DEs KS MainDist Zs3P  4T

DEs KS MainDist le Zs3  0T			for left trackside
DEs KS MainDist le Zs3  1T
DEs KS MainDist le Zs3  2T
DEs KS MainDist le Zs3  3T
DEs KS MainDist le Zs3  4T

DEs KS MainDist Zs3 Gty 0T			to use at gantrys
DEs KS MainDist Zs3 Gty 1T
DEs KS MainDist Zs3 Gty 2T
DEs KS MainDist Zs3 Gty 3T
DEs KS MainDist Zs3 Gty 4T

DEs KS MainDist Zs3P Gty 0T			with Zs3 plate to use at gantrys
DEs KS MainDist Zs3P Gty 1T
DEs KS MainDist Zs3P Gty 2T
DEs KS MainDist Zs3P Gty 3T
DEs KS MainDist Zs3P Gty 4T

----------------------------------------------------------------------------
Main signal with distant head shows HP0 / KS1 / KS2
with announcing speed indicator Zs3v
----------------------------------------------------------------------------

DEs KS MainDist Zs3v  0T
DEs KS MainDist Zs3v  1T
DEs KS MainDist Zs3v  2T
DEs KS MainDist Zs3v  3T
DEs KS MainDist Zs3v  4T

DEs KS MainDist le Zs3v  0T		for left trackside
DEs KS MainDist le Zs3v  1T
DEs KS MainDist le Zs3v  2T
DEs KS MainDist le Zs3v  3T
DEs KS MainDist le Zs3v  4T

DEs KS MainDist Zs3v Gty 0T		to use at gantrys
DEs KS MainDist Zs3v Gty 1T
DEs KS MainDist Zs3v Gty 2T
DEs KS MainDist Zs3v Gty 3T
DEs KS MainDist Zs3v Gty 4T

----------------------------------------------------------------------------
Main signal with distant head shows HP0 / KS1 / KS2
with speed indicator Zs3 / Zs3v
----------------------------------------------------------------------------

DEs KS MainDist Zs3/v  0T
DEs KS MainDist Zs3/v  1T
DEs KS MainDist Zs3/v  2T
DEs KS MainDist Zs3/v  3T
DEs KS MainDist Zs3/v  4T
DEs KS MainDist Zs3/v  5T
DEs KS MainDist Zs3/v  6T
DEs KS MainDist Zs3/v  7T
DEs KS MainDist Zs3/v  8T
DEs KS MainDist Zs3/v  9T
DEs KS MainDist Zs3/v 10T
DEs KS MainDist Zs3/v 11T
DEs KS MainDist Zs3/v 12T

DEs KS MainDist Zs3P/vP  0T			with Zs3 plate and Zs3v plate
DEs KS MainDist Zs3P/vP  1T
DEs KS MainDist Zs3P/vP  2T
DEs KS MainDist Zs3P/vP  3T
DEs KS MainDist Zs3P/vP  4T

DEs KS MainDist le Zs3/v 0T			for left trackside
DEs KS MainDist le Zs3/v 1T
DEs KS MainDist le Zs3/v 2T
DEs KS MainDist le Zs3/v 3T
DEs KS MainDist le Zs3/v 4T

DEs KS MainDist Zs3/v Gty 0T			to use at gantrys
DEs KS MainDist Zs3/v Gty 1T
DEs KS MainDist Zs3/v Gty 2T
DEs KS MainDist Zs3/v Gty 3T
DEs KS MainDist Zs3/v Gty 4T
DEs KS MainDist Zs3/v Gty 5T
DEs KS MainDist Zs3/v Gty 6T
DEs KS MainDist Zs3/v Gty 7T
DEs KS MainDist Zs3/v Gty 8T
DEs KS MainDist Zs3/v Gty 9T

DEs KS MainDist Zs3P/vP Gty 0T			with Zs3 plate and Zs3v plate
DEs KS MainDist Zs3P/vP Gty 1T			to use at gantrys
DEs KS MainDist Zs3P/vP Gty 2T
DEs KS MainDist Zs3P/vP Gty 3T
DEs KS MainDist Zs3P/vP Gty 4T

----------------------------------------------------------------------------
Main signal with distant head shows HP0 / KS1 / KS2
with speed indicator Zs3 / Zs3v for reduced distant to next main signal
----------------------------------------------------------------------------

DEs KS MainDist Zs3/v  0T Reduced
DEs KS MainDist Zs3/v  1T Reduced
DEs KS MainDist Zs3/v  2T Reduced
DEs KS MainDist Zs3/v  3T Reduced
DEs KS MainDist Zs3/v  4T Reduced

DEs KS MainDist le Zs3/v  0T Reduced	for left trackside
DEs KS MainDist le Zs3/v  1T Reduced
DEs KS MainDist le Zs3/v  2T Reduced
DEs KS MainDist le Zs3/v  3T Reduced
DEs KS MainDist le Zs3/v  4T Reduced

DEs KS MainDist Zs3/v Gty  0T Reduced	to use at gantrys
DEs KS MainDist Zs3/v Gty  1T Reduced
DEs KS MainDist Zs3/v Gty  2T Reduced
DEs KS MainDist Zs3/v Gty  3T Reduced
DEs KS MainDist Zs3/v Gty  4T Reduced

----------------------------------------------------------------------------
Main signal without a head and a post always in HpX-Mode
----------------------------------------------------------------------------

DEs KS HP_Dummy HpX 1T
DEs KS HP_Dummy HpX 2T
DEs KS HP_Dummy HpX 3T
DEs KS HP_Dummy HpX 4T

These signals are used if you have some linking problems.
----------------------------------------------------------------------------
Sign to mark a main head at a gantry:
----------------------------------------------------------------------------

DEs KS_Postshield Gty Main

----------------------------------------------------------------------------
Sign to mark a main head with distant function at a gantry:
----------------------------------------------------------------------------

DEs KS_Postshield Gty Main+Dist

----------------------------------------------------------------------------
Sign to mark a main head at a straight post:
----------------------------------------------------------------------------

DEs KS_Postshield Main

----------------------------------------------------------------------------
Sign to mark a main head with distant function at a straight post:
----------------------------------------------------------------------------

DEs KS_Postshield Main+Dist

----------------------------------------------------------------------------
----------------------------------------------------------------------------
Shunt signals
----------------------------------------------------------------------------

DEs KS shunt Bracket  0T			Shunt signal to show Hp0 /Sh1
DEs KS shunt Bracket  1T			on a bracket
DEs KS shunt Bracket  2T
DEs KS shunt Bracket  3T
DEs KS shunt Bracket  4T

DEs KS shunt Post  0T			Shunt signal to show Hp0 /Sh1
DEs KS shunt Post  1T			on a post
DEs KS shunt Post  2T
DEs KS shunt Post  3T
DEs KS shunt Post  4T

DEs KS shunt Ground  0T			Shunt signal to show Hp0 /Sh1
DEs KS shunt Ground  1T			near the ground
DEs KS shunt Ground  2T
DEs KS shunt Ground  3T
DEs KS shunt Ground  4T

----------------------------------------------------------------------------
----------------------------------------------------------------------------
Indicators
----------------------------------------------------------------------------

DEs KS Zs2

DEs KS Zs2v

DEs KS Zs3 Fix		(Zs3v plate)

DEs KS Zs3v Fix		(Zs3v plate)

DEs KS Zs6
DEs KS Zs6  2T		for two destination tracks

----------------------------------------------------------------------------
----------------------------------------------------------------------------
Triggers
----------------------------------------------------------------------------

There some helpful pictures in the german manual.

DEs KS_Opt-Trigger Route
DEs KS_Opt-Trigger Scenario
DEs KS_Opt-Trigger Single

 - new Opt-Trigger to set options who are also set in option file different in a
   route or scenario for all signals or a signalsystem or a single signal
   To use these triggers, you have to take a look at the german manual, please. ;)

DEs KS_Hp0 Trigger

- this trigger set a main signal to Hp0 although the route is clar to stop the train
  for ever or a few seconds
- set this trigger directly after link 0 from main signal before all link 1+
- in the left Id-Field from signal-flyout possible write a number like:
   "0" for all trains who blocked with Hp0 aspect
   "1" for the first train  who blocked with Hp0 aspect
   "2,3" for the second and third train who blocked with Hp0 aspect
- in the rigth Id-field from signal-flyout possible write a value of seconds
  like "40" after the Hp0 aspect is switched to Hp1 or Hp2 if possible
- example: "2" "20" -> stop the second train for 20 seconds
  (the time begins to run when the train stops)
- special new application:
  - manually main or distant signal bug possible (ID-field: "H0000" or "H0010V0011") check it out!
  - switch yard entries on or off (ID-field: "A2" or "A2,3" or "A-8")
  - switch follow main signal on or off (ID-field: "G0" or "G1" or "G1,2")
  - after passing a main signal backwards set this trigger with ID-field: "R" to
    make this signal clear if possible

DEs KS_Hp0 Trigger 1T Scenario

- switch anim state with link 1, perhaps from a AI-Train

DEs KS_Hp0 Trigger X

- set this trigger before link 0 to make a main signal void (white cross)

DEs KS_HpX Trigger Route

- this trigger deactivate a main signal and set the marker light on
- set this trigger prior the main signal in drive direction
- Sometimes a main signal is set to deactivated if the block range is to short

DEs KS_VrX Trigger Route

- this trigger deactivate a distand head on a main signal, if you set the link number
  in the id field from it
- this trigger deactivate the marker light from a distand head on a main signal,
  if you set an "R" and the link number in the id field from it
- set this trigger prior the main signal in drive direction
- Sometimes a distant head is set to deactivated if no main signal after

- deactivate the marker light from a distand signal with "R"
- deactivate the complete distant signal and let the marker light on with "X"
- the char "H" let show a higher number on Zs3v if the number at Zs3 is lower

Look for the german manual at page 40 for more informations.

DEs KS_Sh1-Trigger Scenario

- set this trigger after link 0 from main signal and also after junctions
  but before all link 1+
- in the left Id-Field from signal-flyout possible write a number like:
   "0" for all trains who passed signal with Sh1 aspect
   "1" for the first train  who passed signal with Sh1 aspect
   "2,3" for the second and third train who passed signal with Sh1 aspect

DEs KS_Zs1-Trigger Scenario

- set this trigger after link 0 from main signal and also after junctions
  but before all link 1+
- in the left Id-Field from signal-flyout possible write a number like:
   "0" for all trains who passed signal with Zs1 aspect
   "1" for the first train  who passed signal with Zs1 aspect
   "2,3" for the second and third train who passed signal with Zs1 aspect

DEs KS_Zs3-Trigger

- this trigger possilbe change a speed limit entry for one or all links
- set this trigger after link 0 from main signal and also after junctions
  but before every link 1+
- you can input every value of speed limit like "60" or "120" or "30"
- after a comma you can input a link as a number on with the speed limit must be changed
- example: "60,2" -> cange speed limit to "60" on link 2
- example: "40" -> cange speed limit to "40" on all link 1+

DEs KS_Zs8-Trigger

 - set a Counter Line Indicator for the line
 - only in combination with a Zs6 on main signal possible

DEs KS_TAB-Trigger Scenario

- set this trigger before link 0 from main signal
- this trigger is useful if you must press the TAB key otherwise to change signal aspect
- if trigger is set, no messages displayed if passing TAB trigger and switching signal

----------------------------------------------------------------------------
----------------------------------------------------------------------------
Protection dependent signal (Sh)
----------------------------------------------------------------------------

DEs Sem Sh2

This signal can use as a substitute for the EndOfTrack-Signal.


Have much fun!

Schuster at www.rail-sim.de