malfunctions.xml
The malfunctions.xml configuration file contains configuration for malfunctions that can occur in buildings,
vehicles and equipment. New malfunctions can be added and existing ones edited.
A "malfunction" element has a unique "name" attribute. It also has the following child elements:
- severity: The severity of the malfunction as an integer value between 1 and 100 (100 being most-severe).
This is used to determine the order that people will attempt to fix multiple malfunctions. This element is required
for all malfunctions.
- probability: The probability weight of the malfunction happening as a decimal value between 1.0 and 100.0
(100.0 being most probable). This is its probability relative to other possible malfunctions for an entity. This
element is required for all malfunctions.
- repair-time: The normal repair time (millisols) (See Time) required
to fix the malfunction. This element is optional and its absence means the malfunction doesn't need normal repairs.
- emergency-repair-time: The emergency repair time (millisols) (See Time)
required to fix the malfunction. This element is optional and its absence means the malfunction doesn't need emergency
repairs.
- eva-repair-time: The EVA (Extra Vehicular Activity) repair time (millisols) (See Time) required
to fix the malfunction. This element is optional and its absence means the malfunction doesn't need EVA repairs.
- entity-list: This is a list of entities that are susceptible to this malfunction. The malfunction must have at least
one entity in the list. The following entities are supported:
- Vehicle: Any vehicle.
- Rover: A pressurized, long-range, all-terrain, ground vehicle that carries a crew.
- EVA Suit: An Extra Vehicular Activity suit.
- Building: This represents any building, regardless of its functions.
- Life Support: A building with the "life-support" function (see buildings.xml).
- Living Accommodations: A building that has the "living-accommodations" function (see buildings.xml).
- Research: A building that has the "research" function (see buildings.xml).
- Communication: A building that has the "communication" function (see buildings.xml).
- EVA: A building that has the "EVA" function (see buildings.xml).
- Recreation: A building that has the "recreation" function (see buildings.xml).
- Dining: A building that has the "dining" function (see buildings.xml).
- Cooking: A building that has the "cooking" function (see buildings.xml).
- Exercise: A building that has the "exercise" function (see buildings.xml).
- Resource Processing: A building that has the "resource-processing" function (see buildings.xml).
- Storage: A building that has the "storage" function (see buildings.xml).
- Power Generation: A building that has the "power-generation" function (see buildings.xml).
- Medical Care: A building that has the "medical-care" function (see buildings.xml).
- Farming: A building that has the "farming" function (see buildings.xml).
- Ground Vehicle Maintenance: A building that has the "ground-vehicle-maintenance" function (see buildings.xml).
- Manufacture: A building that has the "manufacture" function (see buildings.xml).
Basically any building function is supported as a malfunctionable entity, only replace the hyphens in the function name with spaces.
As we add more vehicles, equipment and building functions, they well be supported malfunctionable entities as well.
- effects-list: A list of effects that this malfunction will produce. The "effect" element has a "type" attribute that can have
the value of either "resource" or "life support".
Resource effects mean that the malfunction is causing a reduction of a resource in the entity's inventory. Any valid resource can be
used for the "name" attribute (see Resources). The "change-rate" attribute is the amount
the resource changes (kg) per millisol (see Time).
Life support effects mean that the malfunction is changing the life support system in the entity. The "name" attribute can be any of the
following: "Oxygen", "Water", "Temperature" or "Air Pressure". Oxygen and water affect the rate that people can consume those resources
from the life support system. Temperature affects the temperature of the life support system and is in degrees of Celsius per millisol.
Air pressure affects the air pressure of the life support system and is in Atm per millisol.
- medical-complaint-list: A list of possible medical problems that can be directly caused by this malfunction (see medical.xml). The "medical-complaint" element has a name that must match a medical complaint
in the medical.xml configuration file. The "probability" attribute is the percentage chance that any person directly affected by the
malfunction will get this medical complaint. It is possible a person can get multiple medical complaints from one malfunction.