﻿CAWS plugin for openBVE
=======================

This plugin is a minimalistic and not very realistic plugin that implements the Continuous Automatic Warning System, or CAWS for short.


Overview
--------

CAWS displays the aspect of the previous signal in the cab. When the next signal is closer than 350 meters, CAWS displays the aspect of that signal instead.

Whenever the displayed aspect improves, called an Upgrade, a momentary sound is played. Whenever the displayed aspect worsens, called a Downgrade, a continuous sound is played for 7 seconds. During this time, the driver has to acknowledge the downgrade, otherwise the emergency brakes are engaged for 60 seconds.

This plugin implements CAWS "magically", meaning any train using this plugin will employ CAWS on all routes. There is nothing needed on the route-coding side to make this work except for placing signals via Track.Section (or Track.Signal).


Keys
----
S     Spacebar     Acknowledges the downgrade


Panel Indices
-------------
0     0-1     Indicates that an acknowledgement is required
1     0-1     Indicates that the emergency brakes are engaged
2     any     Indicates the aspect (values depend on the route)


Sound Indices
-------------
0     once        The upgrade sound
1     looping     The downgrade sound