Skip to content

Module Reference: TestFlightFailure

Starstrider42 edited this page Jun 5, 2017 · 14 revisions

TestFlightFailure

Properties

  • configuration // an alias for the configuration in the corresponding TestFlightCore
  • duFail = 0 // amount of data collected when the failure occurs
  • duRepair = 0 // amount of data collected when the failure is fixed
  • failureTitle = "Failure" // human-friendly title to display in the MSD for the failure. 25 character limit. May be used by third-party repair mods.
  • severity // "minor" or "major"; used to indicate the severity of the failure to the player in the MSD. May be used by third-party repair mods.
  • weight // chances of the failure occurring relative to other failure modules on the same part. Should never be anything except: 2 = Rare, 4 = Seldom, 8 = Average, 16 = Often, 32 = Common. May be used by third-party repair mods.
  • failureType // "mechanical" indicates a physical failure that requires physical repair. "software" indicates a software or electric failure that might be fixed remotely by code. Not used by TestFlight, but may be used by third-party repair mods.

Description

TestFlightFailure is the base module for every failure in TestFlight. The base module by itself does nothing.

It is normal to have multiple TestFlightFailure modules on a part, one for each failure mode, but you should never have more than one of a specific type

Derived Modules

TestFlightFailure_Explode Generic failure for any part, goes boom. Cannot be repaired (obviously!)

TestFlightFailure_AblatorCover For ModuleAblator to crack / let heat through. Repair stops extra heat transfer but does not replace ablator.

  • minDegradation = 5.0 //minimum percent of ablator lost; shield's heat conductivity goes up proportionally.
  • maxDegradation = 10 //maximum percent

TestFlightFailure_Animation For ModuleAnimateGeneric, will break an animation, and in many causes modules that depend on that animation to complete before performing their function. Repair re-enables animation but does not run it.

  • animationName = ALL //name of animation to break

TestFlightFailure_AvionicsXXXXX For ModuleCommand, controlling the ship from this part will cause flight problems until it's repaired:

  • TestFlightFailure_AvionicsAxis loses use of random axis (pitch/yaw/roll/X/Y/Z), or either all rotations or all translations
  • TestFlightFailure_AvionicsClamp clamps max control range of random axis
  • TestFlightFailure_AvionicsDeadzone a random deadzone, up to 25%, in an axis control range
  • TestFlightFailure_AvionicsGlitch random on/off loss of control of an axis
    • maxDeadtime = 1 //max time loss of control can happen before toggling back on
    • maxWorkTime = 1 //max time working control can happen before toggling off
  • TestFlightFailure_AvionicsInvert inverts an axis, up means down
  • TestFlightFailure_AvionicsPartial loses a random % of sensitivity for an axis
  • TestFlightFailure_AvionicsThrustJam throttle jammed at current position
  • TestFlightFailure_AvionicsTotal total loss of use of all 6 axis

TestFlightFailure_SolarMech For ModuleDeployableSolarPanel, break off panel. Cannot fail unless panel is extended. Cannot be repaired.

TestFlightFailure_SolarTracking For ModuleDeployableSolarPanel, panel cannot track Sun until repaired.

TestFlightFailure_DockingClamp For ModuleDockingNode, forces immediate undock. No repairs are needed to dock again.

TestFlightFailure_DockingFeed For ModuleDockingNode, disables crossfeed until repaired.

TestFlightFailure_EngineCoolant For engines, increase heat generation until repaired.

  • engineID = all // the ModuleEngine(s) to fail. May be a comma-separated list or "all"
  • heatMultiplier = 3 // factor by which engine heat generation is boosted

TestFlightFailure_EnginePerformanceLoss For engines, reduce specific impulse until repaired.

  • engineID = all // the ModuleEngine(s) to fail. May be a comma-separated list or "all"
  • ispMultiplier = 0.7 // reduce to around 70%
  • ispMultiplierJitter = 0.1 // actual reduction will be 60-80% of rated value (despite "jitter" name, failed I_sp is constant)

TestFlightFailure_IgnitionFail When turning engines on, chance to turn off.

  • engineID = all // the ModuleEngine(s) to fail. May be a comma-separated list or "all"
  • restoreIgnitionCharge = false // if the engine has a ModuleEngineIgnitor, setting to true keeps the failure from wasting a charge. Charge is never lost if the engine fails on the pad.
  • baseIgnitionChance // Float curve from data to probability of successful ignition. Defaults to constant 1.0.
  • pressureCurve // Float curve from dynamic pressure (in Pa, not kPa) to multiplier for baseIgnitionChance. Defaults to constant 1.0.
  • ignitionUseMultiplier // Float curve from number of ignition attempts (including this one) to multiplier for baseIgnitionChance. Defaults to constant 1.0.
  • additionalFailureChance = 0.0 // probability (on scale of 0-1) that, if the ignition fails, another random failure will happen

TestFlightFailure_ReducedMaxThrust For engines, to reduce thrust until repaired.

  • engineID = all // the ModuleEngine(s) to fail. May be a comma-separated list or "all"
  • thrustReduction = 0.5 //reduces to 50%

TestFlightFailure_ShutdownEngine For engines, shuts down the engine

  • engineID = all // the ModuleEngine(s) to fail. May be a comma-separated list or "all"

TestFlightFailure_LockGimbal For ModuleGimbal, forces all gimbals to center until repaired.

TestFlightFailure_GimbalCenter For ModuleGimbal, center position is moved. Repair restores original center.

  • gimbalTransformName = RANDOM //default random, or pick name

TestFlightFailure_GimbalSpeed For ModuleGimbal, movement speed is slower until repaired.

  • gimbalTransformName = RANDOM //default random, or pick name

TestFlightFailure_LightBroken For ModuleLight, makes light break until repaired.

TestFlightFailure_LightFlicker For ModuleLight, makes light turn on and off randomly until repaired.

  • minFlickerTime = 0.1 // minimum time light spends on/off
  • maxFlickerTime = 0.4 // maximum time light spends on/off

TestFlightFailure_ReactionBroken For ModuleReactionWheel, disables controls until repaired.

TestFlightFailure_ReactionTorque For ModuleReactionWheel, weakens and possibly inverts one or more rotation axes until repaired.

TestFlightFailure_ResourceLeak For tanks to leak until repaired.

  • resourceToLeak = random //or pick specific resource by name to leak
  • initialAmount = 10 //amount to leak immediately upon failure
  • perSecondAmount = 0.1 // amount leaked per second until fixed
  • calculatePerTick = false //set to true, perSecondAmount leak is to be updated during leak, only needed if the amount is to be based off current amount, see below
  • initialAmount and perSecondAmount may be flat values such as 10, 1.5, etc, or percentage based such as 5%c 10%t etc, %t denoting tank total capacity for that resource, while %c is current existing amount

TestFlightFailure_ResourcePump For tanks, cannot pump resources in or out until repaired.

  • resourceName = ANY // or ALL, or pick specific resource by name
  • resourceBlacklist // comma-separated list of resources that are immune to this failure

TestFlightFailure_ScienceBroken For ModuleScienceExperiment, prevent experiment from running until repaired. Previously stored results are unaffected.

  • experimentID // pick experiment to break

TestFlightFailure_ScienceXmit For ModuleScienceExperiment, reduce science transmission value by a random amount until repaired.

  • experimentID // pick experiment to break

TestFlightFailure_WheelBrake For ModuleWheelBrakes, disables brakes until repaired.

TestFlightFailure_WheelMotor For ModuleWheelMotor, disables wheel motor until repaired. Wheel can still turn, just as if motor were disabled manually.

TestFlightFailure_WheelSteer For ModuleWheelSteering, locks steering until repaired.

Derived Modules Mod Specific

TestFlightFailure_FARCtrlSrfGlitch FAR FARControllableSurface, causes random motion in control surface. Repair resets surface to medium deflection.

TestFlightFailure_FARCtrlSrfMech FAR FARControllableSurface, lose use of control surface. Repair restores all previous deflections.

TestFlightFailure_RemoteBroken RemoteTech ModuleRTAntenna, breaks antenna until repaired.

TestFlightFailure_RemotePassiveBroken RemoteTech ModuleRTAntennaPassive, breaks antenna until repaired.