Variable; Ship - HWRM/KarosGraveyard GitHub Wiki

<ShipTable> = StartShipConfig()
<ShipTable>.<Variable> = <Value>
(Can also be written as <ShipTable>["<Variable>"] = <Value>)

Within every ".ship" file, there are over a hundred variables defining such things as the ship's health (armor), maximum speed and manuverability, as well as many unseen statistics. They are all initialized using the StartShipConfig function, and are stored within a table-type variable, called NewShipType. (See the Table Constructor section in the Lua 4 Manual for more information on table type variables.)

NewShipType = StartShipConfig()
NewShipType.mainEngineMaxSpeed = 215

See below...

---

The following list needs a lot of work. If anyone with information about any of these values, please help fill in the details. Thanks!
Much of this information can also be found in "ShipTuning.xls", or Mikali's Updated ShipTuning.xls.
A complete list of variables can also be found in the Objects Dump (in the "ShipStatic" table).

• displayedName = <sShipName>: The name of the ship, displayed when you select the unit. Normally, the name is a reference to the "buildresearch.ucs" file with a value of "$1234", where 1234 is some number. However, you may use normal text here instead of the language table reference, such as "Hiigaran Battlecruiser". According to "ShipTuning.xls", it is not used in the game currently.
• sobDescription = <sDescription>: A brief description of the ship, displayed when you select the unit. Normally, the name is a reference to the buildresearch.ucs file with a value of "$1234", where $1234 is a localization ID.
• maxhealth = <iHealth>: Maximum health, or armor, of the ship.
• regentime = <fTime>: The time, in seconds, to repair the ship from 0 health to maximum health. If set to 0, the ship does not repair itself.
• minRegenTime = <fTime>: The minimum time, in seconds, to repair the ship from 0 health to maximum health. This caps the modifiers to health regeneration.
• sideArmourDamage = <fMultiplier>: Damage to the side of the ship is multiplied by this amount.
• rearArmourDamage = <fMultiplier>: Damage to the rear of the ship is multiplied by this amount.
• isTransferable = <bFlag>: If 1, can be transferred to allies in multiplayer. If 0, it can't.
• SquadronSize = <iSize>: Number of ships in the squadron when the unit is first built.
• buildBatch = <iValue>: Number of ships in a batch (for strikegroup formations).
• formationSpacing = <fDistance>: Distance between ships when in formation.
• batchFormation = <sStrikegroup>: Default strikegroup formation when built.
• addedUnitCaps = <iUnitCapsNumber> no longer used
• paradeData = <sName>: Supports Parade, such as Carrier, Building emplacements, etc. (e.g. "vgr_mothership_parade")
• NewShipType.holdSlots=3

• defaultROE = <sROE>: defines default Rules of Engagement for a ship. Valid values are Offensive, Defensive, and Passive.
• defaultStance = <sStance>: defines default Stance for a ship. Valid values are Aggressive, Evasive, and Neutral.
• NewShipType.canSurround=1
• NewShipType.agileFlight=1
• NewShipType.noCombatGrouping=1
• NewShipType.canJoinStrikeGroup=0
• NewShipType.strikeGroupRadius=350
• NewShipType.strikeGroupSpeed=5000

• mass = <fMass>: Mass in kilograms of the ship. Used to determine damage in a collision.
• collisionMultiplier = <fMultiplier>: Multiplier to collision damage from a kamikaze attack.
• thrusterMaxSpeed = <fSpeed>: Maximum forward speed in meters/second when the target is not in the forward cone (see acceleration Angle) [Changed by TheBlind]
• mainEngineMaxSpeed = <fSpeed>: Maximum forward speed in meters/second.
• rotationMaxSpeed = <fSpeed>: Maximum turning speed in degrees/second.
• thrusterAccelTime = <fTime>: Time, in seconds, it takes to accelerate to maximum speed when the target is not in the forward cone.
• thrusterBrakeTime = <fTime>: Time, in seconds, it takes to stop when the target is not in the forward cone.
• mainEngineAccelTime = <fTime>: Time, in seconds, it takes to accelerate to maximum speed.
• mainEngineBrakeTime = <fTime>: Time, in seconds, it takes to stop.
• rotationAccelTime = <fTime>: Time, in seconds, it takes to accelerate to maximum rotation (turning) speed.
• rotationBrakeTime = <fTime>: Time, in seconds, it takes to accelerate to stop rotating (turning).
• thrusterUsage = <fPercent> Float value between 0 and 1.
• accelerationAngle = <fAngle>: The angle (in degrees) of the forward cone of the ship that determines when a ship starts accelerating towards the goal. For fighter, this is usually a high number, because you want them to speed up immediately, while for a battlecruiser this is usually a low number, because the turning speed of the BC is so slow that you want to be pointing more at the target before it accelerates. [Description by TheDutch]
• mirrorAngle = <fAngle>: The angle of the cone behind the ship. If you give a move order within this cone behind the ship, the ships will to a mirror-maneuver, which is also defined in the ship file. [Description by TheDutch]
• secondaryTurnAngle = <fAngle>
• maxBankingAmount = <fAngle>
• descendPitch = <fAngle>: If set to 360, along with maxBankingAmount, ships can achieve rolls/dives/etc, however, depending on the ship, this can be really undesirable.
• goalReachEpsilon = <fDistance>: The minimal distance in meters between a ship and it's destination, before it is said to have reached that destination.
• slideMoveRange = <iRange>: vgr_shipyard=600 and hgn_scout=0 ; seemingly INT, as no hw2 ships use FL
• controllerType = <sControllerType>: (e.g. "Ship")
• relativeMoveFactor = <fMultiplier>: The value is multiplied by the ship's radius to determine how close, in meters, the ship can get to a piece of terrain, such as an asteroid.

• tumbleStaticX = <fAmount> Pitch.
• tumbleStaticY = <fAmount> Heading.
• tumbleStaticZ = <fAmount> Roll.
• tumbleDynamicX = <fAmount> Pitch.
• tumbleDynamicY = <fAmount> Heading.
• tumbleDynamicZ = <fAmount> Roll.
• tumbleSpecialDynamicX = <fAmount> Pitch.
• tumbleSpecialDynamicY = <fAmount> Heading.
• tumbleSpecialDynamicZ = <fAmount> Roll.

• swayUpdateTime = <fTime> possibly no longer used
• swayOffsetRandomX = <fAmount> possibly no longer used
• swayOffsetRandomY = <fAmount> possibly no longer used
• swayOffsetRandomZ = <fAmount> possibly no longer used
• swayBobbingFactor = <fAmount> Looks to be between 0 and 1. possibly no longer used
• swayRotateFactor = <fAmount> Looks to be between 0 and 1. possibly no longer used

• NewShipType.useLayoutBounds=1
• NewShipType.layoutBoundX=200
• NewShipType.layoutBoundY=1250
• NewShipType.layoutBoundZ=280
• NewShipType.layoutCenterX=0
• NewShipType.layoutCenterY=0
• NewShipType.layoutCenterZ=20

• dustCloudDamageTime = <fTime>
• nebulaDamageTime = <fTime>

• mirrorAboveManeuver = <sManeuverName>: The ship performs the specified flight maneuver when an enemy is above it.
• mirrorBelowManeuver = <sManeuverName>: The ship performs the specified flight maneuver when an enemy is below it.
• NewShipType.specialTurnLeftManeuver="EmergencyLeftTurn, NinetyDegLeftTurn, None"
• NewShipType.specialTurnRightManeuver="EmergencyRightTurn, NinetyDegRightTurn, None"

• MinimalFamilyToFindPathAround = <sFamilyName>: The minimal family of ships that this ship will fly around instead of attempting to fly past. See AvoidanceFamily in the "familylist.lua" file for possible values.
• BuildFamily = <sBuildFamilyName>: Race-specific build family. See the "familylist.lua" file for possible values.
• AttackFamily = <sAttackFamilyName>: Determines how the AI reacts to the unit in combat. See the "familylist.lua" file for possible values.
• DockFamily = <sDockFamilyName>: See the "familylist.lua" file for possible values.
• AvoidanceFamily = <sAvoidanceFamilyName>: See the "familylist.lua" file for possible values.
• DisplayFamily = <sDisplayFamilyName>: See the "familylist.lua" file for possible values.
• AutoFormationFamily = <sAutoFormationFamilyName>: See the "familylist.lua" file for possible values.
• CollisionFamily = <sCollisionFamilyName>: See the "familylist.lua" file for possible values.
• ArmourFamily = <sArmuorFamilyName>: The type of armor the ship has. See the "familylist.lua" file for possible values.
• NewShipType.CombatFamily="Fighter_Lance"

• NewShipType.AttackPriorityMultiplier=0.96
• fighterValue = <fAmount>
• corvetteValue = <fAmount>
• frigateValue = <fAmount>
• neutralValue = <fAmount>
• antiFighterValue = <fAmount>
• antiCorvetteValue = <fAmount>
• antiFrigateValue = <fAmount>
• totalValue = <fAmount>

• buildCost = <iCost>: RU cost to build the unit.
• buildTime = <fTime>: How long it takes, in seconds, to build the unit.
• buildPriorityOrder = <iOrder> The order by which the ships will be displayed in the global build queue UI. The mothership is at the top of the list so it gets the lowest value. This value is only applicable to ships with build queues.

• retaliationRange = <fRange>: Distance to an enemy unit within which this ship will move to engage if this ship is set to defensive or aggressive attack mode.
• retaliationDistanceFromGoal = <fDistance>:
• visualRange = <fRange>:
• prmSensorRange = <fRange>: Range of the primary sensors, shown in the Sensor Manager by the blue sphere.
• secSensorRange = <fRange>: Range of the secondary sensors. This range is always greater than the primary sensors range. Secondary sensors are not shown in the Sensors Manager, and not all enemy ships appear in the secondary sensors range.
• detectionStrength = <fStrength> Detection strength used on ships in visual range. If the detection on a ship is higher than the cloaking, then it is visible.

• TOIcon = <sIconName>: The Tactical Overlay icon to use. Known values are "InvertedY", "Square", "Diamond", "Hexagon", "InvertedPentagon", "Triangle", "Parallelogram", and "Rectangle".
• TOScale = <fScale>: Ship's screen size multiplied by this scale for final on-screen size.
• TODistanceFade0 = <fDistance>
• TODistanceDisappear0 = <fDistance>
• TODistanceFade1 = <fDistance>
• TODistanceDisappear1 = <fDistance>
• TODistanceFade2 = <fDistance>
• TODistanceDisappear2 = <fDistance>
• TOGroupScale = <fScale>: Group's screen size multiplied by this for final on-screen size.
• TOGroupMergeSize = <fSize>: Screen size at which a group's TOs will be merged. Measured in percentage of screen size.
• mouseOverMinFadeSize = <fSize>: Size of ship where the mouseover starts to fade, in screen percentage. Must be smaller that "MouseOver Max Fade Size".
• mouseOverMaxFadeSize = <fSize>: Size of ship where the mouseover is totally faded.
• healthBarStyle = <iStyle> The visual style of the health bar. By default this can only be either 0, 1, or 2.
• nlips = <fScale>: The non-linear scaling factor.
• nlipsRange = <fRange>: If the camera distance is less than this entry, then the N-LIPS value is used.
• nlipsFar = <fRange>: The second stage N-LIPS value. This is used when objects are within this distance.
• nlipsFarRange = <fRange>: The camera distance at which the N-LIPS Far value kicks in. Between N-LIPS Range and N-LIPS Far Range, the nlips value is linearly interpolated between N-LIPS and N-LIPS Far.
• SMRepresentation = <sRepresentation>: The appearance of the ship on the Sensor Manager. Can be either HardDot or Mesh
• NewShipType.pixelSize=2.5
• NewShipType.pixelColour={0.69411, 0.545, 0.41176, 1.0}
• NewShipType.SMFadeDistance = 150000
• NewShipType.SMFadeMinAlpha = 0.1
• NewShipType.SMPixelSize = 2.5
• NewShipType.hideNormalAttackUICooldown=1

• AlwaysInRenderList = <bAlways>: 1 or 0, if set to 1 the ship will be always visible in the detector map even for enemies
• meshRenderLimit = <fDistance>: The screenspace size that defines when the mesh stops rendering and only TO remains. The distance at which the ship disappears from view.
• dotRenderLimit = <fDistance>: The camera distance at which the dot stops being rendered.
• visibleInSecondary = <bVisible>: Relic User: Is this object's mesh visible when spotted with secondary sensors? 0 = Not visible in secondary sensors. 1 = Visible in secondary sensors. [Need to verify.]
• minLOD = <fLevel>: Minimum level of detail. Range: 0 - 1. Default: 0.1.
• goblinsStartFade = <fDistance>: rsaville: at this distance the goblins will start to fade off the ship. The distance at which the ship's textures begin to fade.
• goblinsOff = <fDistance>: rsaville: At this distance the goblins turn off. The distance at which the ship's textures disappear.
• upLOD = <nDistance>: When the camera moves closer than this, increase the LOD. Not sure if it's a Float or an Int. Can be defined multiple times for multiple levels of detail; most ships have three upLOD and downLOD lines.
• downLOD = <nDistance>: Similar to above, but decreases the LOD when the camera moves farther than the specified distance.
• minimumZoomFactor = <fFactor>: Adjusts how close the camera can get to a ship. 1.0 is normal, 0.75 means the camera can get 75% closer. for example. MinimumZoomFactor is based on the collision sphere of the ship. So 1.0 is zoomed in all the way such that the collision sphere hits the edges of the screen.

• selectionLimit = <fRange>: Screen area below which object is unselectable, in normalized screen area. The object may only be selected when its distance from the camera is less than or equal to this number in meters.
• preciseSelectionLimit = <fRange>: Screen area above which to do precise selections, in normalized screen area.
• preciseATILimit = <fRange> Some sort of a range.
• selectionPriority = <iPriority> Some type of a priority. 0 means you can't select a ship using the mouse.
• militaryUnit = <bIsMilitary>: 1 if it's a military unit, 0 if it's civilian (harvesters, etc). Only of relevance for the Military Selection Priority setting as far as I know.

• canBlink = <bEnable>: Can Blink in Sensors Manager.
• NewShipType.shadowType=2
• alternativeHyperspaceV = <sHyperspaceVisual>: Hyperspace visual effect file override.
• alternativeHyperspaceA = <sHyperspaceSound>: Hyperspace audio effect file override.
• alternativeHyperspaceTime = <fHyperspaceTime>: Hyperspace effect duration override.
• NewShipType.blobName="$1575"
• blobNamePriority = <iPriority>
• SMHighlightDistMin = <fDistance>: Cedric Lee: Minimum distance between ship and camera before SM ship highlighting starts kicking in. Leave this blank for no highlighting.
• SMHighlightDistMax = <fDistance>: Cedric Lee: Maximum distance between ship and camera at which the SM ship highlighting reaches its max. The max alpha is a SM specific tuning value. Leave this blank for no highlighting.
• nbRestrictedHardpoints = <iNumberOfHardpoints>: Number of Restricted Hardpoints. smmatte: currently only used by the mothership because of keeper subsystem.
• NewShipType.canRetireSubSystems=1
• NewShipType.unavailableWhenCaptured=1
• NewShipType.homingDelay=0.5
• NewShipType.homingDistance=2000

• dockTimeBetweenTwoFormations = <fTime>
• dockTimeBeforeStart = <fTime>
• dockNrOfShipsInDockFormation = <iNumberOfShips>
• dockFormation = <sFormationName>: Formation used while the ship waits to dock. Typically has a value of dockline.
• queueFormation = <sFormationName> (e.g. "dockline")
• dontDockWithOtherRaceShips = <bEnable>: This allows you to disable docking with ships that are not of the same race. Needs to be enabled for most frigate and up ships, except the single player ships. (Otherwise, you would be able to recycle ships.)
• ignoreRaceWhenDocking = <bEnable>: 0 = cannot dock with allies of another race, 1 = can dock with allies of another race.

• launchTimeBetweenTwoFormations = <fTime>
• launchTimeBeforeStart = <fTime>
• launchNrOfShipsInDockFormation = <iNumberOfShips>
• launchFormation = <sFormationName>: Formation used after the ship launches. Typically has a value of dockline.

• NewShipType.battleScarCoverage=2
• NewShipType.battleScarBudgetLow = 400
• NewShipType.battleScarBudgetNext = 600
• sobDieTime = <fTime>: Time between when a ship loses all it's health and when the ship is removed from the renderlist.
• sobSpecialDieTime = <fTime>
• specialDeathSpeed = <fSpeed>: Speed above which there will be a chance on a special death (used for interceptors spawning a fire trail
• chanceOfSpecialDeath = <fChance>: Chance of a special death. Must be between 0 and 1.
• deadSobFadeTime = <fMultiplier>: Multiplier [0..1] that is used to compute the time it takes for a dead sob to fade out. The fade time is computed by multiplying this with sobDieTime.
• shipHoldActive = <bEnable>: By default, ship holds are active if the ship hold ability is present. Set this to 0 to disable docking-mouse-over.
• NewShipType.trailLinger=3
• NewShipType.normalCollisionDamageMultiplier = 2

• NewShipType.allowScuttle=0
• NewShipType.minFalloffDamageDist=1450
• NewShipType.maxFalloffDamageDist=1450*1.5
• NewShipType.maxFalloffScuttleDamageDist=1450*3
• NewShipType.explosiveScuttleDamageOnDeath=3302*3
• NewShipType.maxFalloffForce=500*10
• NewShipType.explosiveDamageOnDeath=660*3
• NewShipType.radiusDamageEvadeMod=1.1 Fear: radiusDamageEvadeMod is presumably a modifier on the distance a ship will interact with a scuttling ship, not sure if it means avoid distance or distance to move to

StartShipConfig
Variable Reference

Renamed page to VariableShip.

--Thought (2003-10-14 18:27:02)

Thrusters and main engine speeds are used regardless of the accelerationAngle cone. See the tanis shipyard for more info in a thread called "thruster vs engine". Komninosm

--ppp72-182.patras.access.acn.gr (2003-11-29 15:36:27)

The munition-specific Ship variables (clusterDistance, proximityDetonationDist, numberSubMunitions, etc.) are missing. These should probably either be added here, or a new variable page created for them.

--RN243-153.resnet.uoguelph.ca (2003-12-03 22:50:34)

You could add them here, but place <Munition-Ship Only>, or something, in the description.

--Mikali (2004-01-24 16:50:12)

Added spawnShipOnDeath, selectionSizeMax, selectionSizeMin and pixelColour.

--Mikali (2006-01-29 03:19:09)

This page should be renamed VariableObjectShip.

--Mikali (2006-01-29 03:21:02)

Updated Formatting? Initial
Updated for HWRM? Initial