C3Fire

Station Configuration

From C3LearningLabs
Revision as of 18:42, 31 July 2021 by Rego Granlund (talk | contribs) (Created page with "{{DISPLAYTITLE:Station Configuration}} = Stations = The configuration element '''<Stations>''' defines all the Stations in a session. The <Stations> element is located in t...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Stations

The configuration element <Stations> defines all the Stations in a session. The <Stations> element is located in the root element, at top level in the session configuration file. The <Stations> element can be moved to a separate configuration file, by using session include parameter ConfigIncludeFileStations in the main configuration file. For more instruction how to use session include, see Session Include. It is recommended to move the session configuration to a separate file.

<Stations>
  <Station> ... </Station>
  <Station> ... </Station>
  ...
  <Station> ... </Station>
</Stations>

Station

The configuration element <Station> defines a station and contain a set of basic properties. Beside the basic properties the activated modules can add properties for the Station. See documentation for each module.

A station is defined with the following properties:

    <Station
      IDName = "Army Post"
      NameShort = "Army Post"
      NameLong = "Army Post"
      Type = "Heltid"
      ControledBy = "AutoC3Basic"
      Description = ""
      DescriptionHTML = ""
      Location = "Army Post"
      Personnel = ""
      Points = "0.0"
      Pos = "10,10"
      Vehicle = "" >

        <Texts> ... </Texts>
        <Images> ... </Images>
        <StationUI> ... <StationUI>

        <ItemObjects> ... </ItemObjects>
        <ItemInteractions> ... </ItemInteractions>

        <!-- Module specific configuration -->
        <Aid> ... </Aid>
        <Bomb> ... </Bomb>
        <Fuel> ... </Fuel>
        <Money> ... </Money>
        <Supply> ... </Supply>
        <Transport> ... </Transport>
        <Water> ... </Water>

    </Station>

Main properties

A station is defined with the following main properties.

Station Parameters

Parameters

Description

Only Used In

IDName

The identification name. Should be unique, and are used in the configuration.

Example value: "S1", "Army Post", "Hospital"

NameShort

A standard short name
This parameter can be used, but will be deprecated, and should be removed in future versions. It will be replaced with the usage of the <Texts> ... </Texts> element described below.

NameLong

The size of the panel.

A standard long name
This parameter can be used, but will be deprecated, and should be removed in future versions. It will be replaced with the usage of the <Texts> ... </Texts> element described below.

Type

The stations type, based on Swedish standard.

Possible values are "Heltid" and "Deltid".

C3Rescue

ControledBy

How the station in controlled.

Possible values are "Player","AutoC3Basic".

Description

A standard description
This parameter can be used, but will be deprecated, and should be removed in future versions. It will be replaced with the usage of the <Texts> ... </Texts> element described below.

DescriptionHTML

A standard html description
This parameter can be used, but will be deprecated, and should be removed in future versions. It will be replaced with the usage of the <Texts> ... </Texts> element described below.

Location

The position this station is on, defined by a location ID.
This values is used if not parameter Pos is defined below.
The location should be defined in the <Locations> ... </Locations> element, described at Locations.

Personnel

The personnel that have their home station in this station is defined here.
The personnel is defined by personnel IDNames separated with ,.

Value Example = ""

Points

The number of points this station have.
The personnel is defined by personnel IDNames separated with ,.

Value Example = "234.5"

Pos

The position this station is on.
This values is used if it is defined. if this value is not defined the position will be defined by the if not parameter Location.

Vehicle

The vehicles that have their home station in this station is defined here.
The vehicles is defined by vehicle IDNames separated with ,.

Value Example = ""

Template:C3System/Config/Session/Texts Template:C3System/Config/Session/Images


StationUI

The startion UI element defines what UI configuration to use for this startion.
The startion UI is defined with the following properties:

Text Parameters

Parameters

Description

Only Used In

ActivityControlPanelName

The identification name of the station activity control user interface specification.
The specification should be defined in the <StationActivityControls> ... <StationActivityControls> element in the <UserInterfaceGlobal> element.

Example value: "Army Post"

ActivityControlPanelText

The text displayed at the border of the activity control panel.
The text should be defined in the <Texts> element.

Exampe values: "PanelText"

MapRealPosImage

The station image displayed on the map
The image should be defined in the <Images> element.

Exampe values: "MapReal"

MapRealPosText

The text displayed near the station image on the map
The text should be defined in the <Texts> element.

Exampe values: "MapReal"

Xml configuration example:

      <StationUI
        ActivityControlPanelName = "Army Post"
        ActivityControlPanelText = "PanelText"
        MapRealPosImage = "MapReal"
        MapRealPosText = "MapReal" />