Vector Tutorial Stages


A stage is a node in a vector state machine, which specifies the parameters on which to simulate the disease.

There are various stages available with different purposes:


Each stage has the following fields:

<Name>


  • Defines the name of the stage, for use in referencing it in other stages.
  • The Name must be unique within the vector
  • This field must exist or you will receive an error.

<Type>


  • Defines the type of stage, which determines which of the fields will be used, and how the disease will affect the environment during the stage.
  • Stage Types are listed here : Vector Tutorial Constants
  • You may defines any number of types for the stage, but you must have at least one

<InfectionRate>


  • Defines the general infections rate for all types of virulence
  • This value is only used during "Contagious" stage types
  • This is numeric value between 0 and 1 (inclusive)

<OutdoorInfectionRate>


  • Defines the infections rate while the sim is outdoors
  • This value is only used during "Contagious" stage types
  • If not given, the value defaults to <InfectionRate>
  • This is numeric value between 0 and 1 (inclusive)

<RoomInfectionRate>


  • Defines the infections rate while the sim is indoors
  • This value is only used during "Contagious" stage types
  • If not given, the value defaults to 1.5 times <OutdoorInfectionRate>
  • This is numeric value between 0 and 1 (inclusive)

<SocialInfectionRate>


  • Defines the infections rate while the sim is engaged in a standing social interaction
  • This value is only used during "Contagious" stage types
  • If not given, the value defaults to 1.5 times <RoomInfectionRate>
  • This is numeric value between 0 and 1 (inclusive)

<FightInfectionRate>


  • Defines the infections rate while the sim is fighting
  • This value is only used during "Contagious" stage types
  • If not given, the value defaults to <SocialInfectionRate>
  • This is numeric value between 0 and 1 (inclusive)

<WoohooInfectionRate>


  • Defines the infections rate while the sim is woohooing
  • This value is only used during "Contagious" stage types
  • If not given, the value defaults to1.5 times <SocialInfectionRate>
  • This is numeric value between 0 and 1 (inclusive)

<MutationRate>


  • Defines the rate of mutation during a "Mutate" stage.
  • The <Mutable>fields define the actual mutation parameters
    • When a mutation chance succeeded, one element amongst the <Mutable> will be chosen
  • A chance roll occurs once every 30 sim-minutes during the duration of the stage
  • This is numeric value between 0 and 1 (inclusive)

<NumMutables>


  • Defines the number of <Mutable> fields available in the stage
  • This is numeric value between 0 and N

<MutableN>


  • "N" is defined as a number between 1 and <NumMutables> (inclusive)
  • Defines a mutation field used by one of the stages in this vector
  • The field is formatted as <Name>,<Minimum>,<Maximum>where:
    • <Name> is a unique name amongst the mutable elements
    • <Minimum> is an integer value defining the minimum mutation delta
    • <Maximum> is an integer value defining the maximum mutation delta

<NumResistances>


  • Defines the number of <Resistance> fields available in the stage
  • This is numeric value between 0 and N

<ResistanceN>


  • "N" is defined as a number between 1 and <NumResistances> (inclusive)
  • Specifies the GUID for a Resistance entry.
  • Each resistance is processed during any non-Remission stage

<NumSymptoms>


  • Defines the number of <Symptoms> fields available in the stage
  • This is numeric value between 0 and N

<SymptomsN>


  • "N" is defined as a number between 1 and <NumSymptoms> (inclusive)
  • This is a comma separated list of GUIDs for existing Symptom entries
  • A symptom has a chance of being processed every 30 sim-minutes during the duration of a "ShowingSigns" stage
    • <SymptomChanceN> defines the chance of processing

<SymptomChanceN>


  • "N" is defined as a number between 1 and <NumSymptoms> (inclusive)
  • Defines the chance of the associated <SymptomsN> field being processed during each 30 sim-minute interval of a "ShowingSigns" stage
  • This is numeric value between 0 and 1 (inclusive)

<BadRelationshipDelta>


  • Defines the delta change in long-term relationship for any sim in infection range of the sim that has not been infected with the disease.
  • Delta changes are processed every 30 sim-minute interval of a "ShowingSigns" stage
  • Sims living in the same household are not affected by this field
  • This is an integer value
    • Long Term relationship is defined as a value between -100 and 100 (inclusive

<GoodRelationshipDelta>


  • Defines the delta change in long-term relationship for any sim in infection range of the sim that has already been infected with the disease
  • Delta changes are processed every 30 sim-minute interval of a "ShowingSigns" stage
  • This is an integer value
    • Long Term relationship is defined as a value between -100 and 100 (inclusive

<CustomStoryUnknown>


  • Defines the translation key for a story displayed when this stage is entered, and the sim has not yet been to the Virologist to identify the infection.
  • The value is prefixed with NRaas.Vector.Story:
  • If not given, no story is displayed for the stage

<CustomStoryIdentified>


  • Defines the translation key for a story displayed when this stage is entered, and the sim has been to the Virologist and identified the infection.
  • The value is prefixed with NRaas.Vector.Story:
  • If not given, no story is displayed for the stage

<CanInoculate>


  • Defines whether the sim can request an inoculation during this stage.
  • Note if the <InoculationCost> for the vector is set to "0", this field is unused
  • This field is a boolean : True or False