HowTo:Edit units.csv

Create Ships in Wings3D

HowTo

Edit Unit Files

---

UNITS.CSV

The Units.csv file contains specific information on all Vessels and Installations and Upgrades in VegaStrike.

Units File

The units.csv is a comma delimited text file which can be edited with any spreadsheet program.

NOTE: Microsoft Works has problems with the long description columns. For a free alternative, use OpenOffice.

Columns in Units File

The original desciption of the xunit syntax from hellcatv is located in CVS

The columns of the units.csv file and their description are;

• Key
• Directory
• Name
• FoFID
• Object_Type
• Combat_Role
• Textual_Description
• Hud_image
• Unit_Scale
• Cockpit
  • CockpitX
  • CockpitY
  • CockpitZ
• Mesh
  • Shield_Mesh
  • Rapid_Mesh
  • BSP_Mesh
  • Use_BSP
  • Use_Rapid
• Mass
• Moment_Of_Inertia
• Convex_Hull_Volume
• Fuel_Capacity
• Hull
  • Armor_Front_Top_Right
  • Armor_Front_Top_Left
  • Armor_Front_Bottom_Right
  • Armor_Front_Bottom_Left
  • Armor_Back_Top_Right
  • Armor_Back_Top_Left
  • Armor_Back_Bottom_Right
  • Armor_Back_Bottom_Left
  • Shield_Front_Top_Right
  • Shield_Back_Top_Left
  • Shield_Front_Bottom_Right
  • Shield_Front_Bottom_Left
  • Shield_Back_Top_Right
  • Shield_Front_Top_Left
  • Shield_Back_Bottom_Right
  • Shield_Back_Bottom_Left
  • Shield_Recharge
  • Shield_Leak
• Warp_Capacitor
• Primary_Capacitor
• Reactor_Recharge
• Jump_Drive_Present
• Jump_Drive_Delay
• Wormhole
• Outsystem_Jump_Cost
• Warp_Usage_Cost
• Afterburner_Type
• Afterburner_Usage_Cost
• Maneuver_Yaw
• Maneuver_Pitch
• Maneuver_Roll
• Yaw_Governor
• Pitch_Governor
• Roll_Governor
• Afterburner_Accel
• Forward_Accel
• Retro_Accel
• Left_Accel
• Right_Accel
• Top_Accel
• Bottom_Accel
• Afterburner_Speed_Governor
• Default_Speed_Governor
• ITTS
• Radar_Color
• Radar_Range
• Tracking_Cone
• Max_Cone
• Lock_Cone
• Hold_Volume
• Can_Cloak
• Cloak_Min
• Cloak_Rate
• Cloak_Energy
• Cloak_Glass
• Repair_Droid
• ECM_Rating
• ECM_Resist
• Ecm_Drain
• Hud_Functionality
• Max_Hud_Functionality
• Lifesupport_Functionality
• Max_Lifesupport_Functionality
• Comm_Functionality
• Max_Comm_Functionality
• FireControl_Functionality
• Max_FireControl_Functionality
• SPECDrive_Functionality
• Max_SPECDrive_Functionality
• Slide_Start
• Slide_End
• Activation_Accel
• Activation_Speed
• Upgrades
• Prohibited_Upgrades
• Sub_Units
• Sound
• Light
• Mounts
• Net_Comm
• Dock
• Cargo_Import
• Cargo
• Explosion
• Equipment_Space
• Num_Animation_Stages
• Upgrade_Storage_Volume
• Heat_Sink_Rating

<Unit ...> </Unit> - Marks the begin and the end of the unit(file)

• Scale - Sets the scaling of the unit in the game
• <Cockpit .../> - Defines a cockpit for the ship.
  • file - Points to a cockpit file. Extension .cpt
  • x,y,z - Coordinates where the Cockpit should be in the Unit/Ship (in meters)
  • See also HowTo:Edit HUDs.
• <Meshfile .../>
  • file - Points to a xmesh-file of the ship. Extension .xmesh
  • texturestarttime - (optional) Defines the starting delay of a mesh animation. See forums for more.
    • RANDOM - Random start delay.
    • time until mesh animation starts
  • startframe - (optional) Defines the starting-frame of a mesh animation. See forums for more.
    • RANDOM - Random start-frame.
    • number of start-frame
• <ShieldMesh> - (optional) xmesh-file to use for the shield instead of a sphere. Extension .xmesh
• <RapidMesh> - (optional) xmesh-file to load and use for collisions with other units/ships/... instead of the Meshfile from above (not drawn) Extension .xmesh
• <BspMesh> - (optional) xmesh-file to use for beam and bolt collisions (not drawn) Extension .xmesh
• <Mount .../> - (optional)(repeatable) Specifies a weapon mount
  • weapon - Type of weapon (see weapon_list.xml in the data directory)
  • size - size class(es)/type(s) and if they are capable of autotracking. The single entries are seperated by spaces. e.g: size="LIGHT MEDIUM AUTOTRACKING"
    • LIGHT
    • MEDIUM
    • HEAVY
    • SPECIAL
    • CAPSHIP-LIGHT
    • CAPSHIP-MEDIUM
    • CAPSHIP-HEAVY
    • AUTOTRACKING
    • SPECIAL-MISSILE
    • LIGHT-MISSILE
    • MEDIUM-MISSILE
    • HEAVY-MISSILE
    • LIGHT-CAPSHIP-MISSILE
    • MEDIUM-CAPSHIP-MISSILE
    • HEAVY-CAPSHIP-MISSILE
  • ammo - how much ammo the gun holds (only needed for ammo needing weapons e.g. missiles,torpedos,...)
  • volume - (optional see "ammo") how much ammo the gun can hold if you refill
  • x,y,z - location of weapon (in meters ;-))
  • ri,rj,rk - (optional) R-vector forward vector) of gun (assume 0,0,1)
  • qi,qj,qk - (optional) Q-vector (up vector) of gun (assume 0,1,0)
• <Sound> </Sound> - FIXME nothing yet ???
• <Defense ...> </Defense> - FIXME
  • HudImage - sprite file to use when targetted FIXME relative to what?
  • ExplosionAni - (optional) special explosion to use
  • RepairDroid - (optional) strength of repair system (0-6)
  • ECM - (optional) type of ECM (Electronic Counter Measure)
  • <Armor .../> - Specifies the ships physical armor
    • front - Forward max armor in VSD
    • right - Right armor in VSD
    • left - Left armor in VSD
    • back - Back armor in VSD
  • <Shields .../> - Specifies the ships Shield (electric armor)
    • front - Forward max shields in VSD
    • back - Back shields in VSD
    • recharge - Shield regeneration if not violating speed limit in VSD/s
    • leak - (optional) how much leak these shields have (usually 0%) between 0 and 100
    • left - (optional) Left shields in VSD
    • right - (optional) Right shields in VSD
    • top - (optional) Top shields) in VSD
    • bottom - (optional)bottom shields in VSD
  • <Hull .../> - Specifies the ships Hull
    • strength - Max hull in VSD
  • <Cloak .../> - (optional) Specifies the ships cloak device
    • missing - if 1, then no cloak is here. also missing in abserce of optional tag
    • cloakmin - minimum percentage of cloakedness
    • cloakglass - boolean whether or not effect 2 is used
    • cloakrate - time per second to cloak in decimal per second
    • cloakenergy - how much energy this takes in 100kJ
• <Stats .../> - Specifies the statics of the ship
  • mass - mass in metric tonnes (kkg)
  • momentofinertia - mass*m*m in (metric tonnes * meter * meter)
  • fuel - amount of fuel
• <Thrust>...</Thrust> - Specifies the ships thrust
  • <Engine /> - Specifies the ships engine
    • Afterburner - Thrust with afterburners in metric tonnes meters per second squared
    • Forward - Thrust without afterburners in kkg*m/s^2
    • Retro - Reverse thrust in kkg*m/s^2
    • Left - Left thrust in kkg*m/s^2
    • Right - Right thrust in kkg*m/s^2
    • Top - Top thrust in kkg*m/s^2
    • Bottom - Bottom thrust in kkg*m/s^2
  • <Maneuver .../> - Specifies the ships maneuver data
    • yaw - Right yaw in metric tonnes degrees per second squared
    • pitch - Right pitch in kkg*deg/s^2
    • roll - Right roll in kkg*deg/s^2
• <Computer ...> ... </Computer>-
  • yaw - max yaw in degrees per second
  • pitch - max pitch in dps
  • roll - max roll in dps
  • afterburner - Max safe speed with afterburners in m/s
  • maxspeed - Max safe speed without afterburner in m/s
  • slidestart - (optional) number of tenths of seconds before fully reacting to keyboard (smoothing)
  • slideend - (optional) number of tenths of seconds to stop
  • <Radar .../> - Specifies the ships radar system
    • itts - if the unit has ability to target track with lead
    • color - if unit has color radar
    • range - maximum range of radar
    • error - (optional) currently unused
    • trackingCone - cosine of cone at which guns may track
    • lockcone - cosine of cone at which missiles gain locking time
    • mintargetsize - unused...but supposedly minimum target this can do
• <Energy> ... </Energy> -
  • <Reactor .../> - Specifies the ships poer unit (reactor)
    • recharge - recharging of reactor in 100 MJ/s
    • limit - max storage of reactor in 100 MJ/s
• <Jump .../> - (optional)
  • delay - seconds before jump drive initiates
    • jumpenergy - energy to jump
  • wormhole - forces units to teleport upon touching this one
  • missing - boolean whether the jump drive is missing (assumed missing in absence of tag)
• <description ...>... </description> - (repeatable)
  • combatrole - combat role that the ship has (see ai/VegaPriorities.csv )
  • lang - (optional) Language code for the language the description is written in.
    • e.g lang='DE' for german language
    • See this link for all codes:
    • If no lang attribute is specified the description is meant to be english. (is this correct'?')
  • Some cool description of the ship.
• <Hold ...> ... </Hold>
  • volume - volume in cargo units
  • <Category ...> ... </Category> - (optional)(repeatable) A category to use from the Vs-MasterPartList'.
    • file -
      • e.g. file="Natural_Products/Natural_Resources"
    • <import .../> (optional)
      • price - price scale (multiplied by price in list)
      • pricestddev - price scale variation (above adjusted by this)
      • quantity - quantity of this sort of cargo
      • quantitystddev - quantity variation
    • <Cargo .../> (optional)(repeatable)
      • file - name of cargo
      • price - price of cargo
      • quantity - ammount of cargo
      • mass - mass in tonnes
      • volume - size of cargo in cargo units
      • description - (optional/unused)
• <Light .../> - (optional)(repeatable) Specifies an engine-flame/light/glow/whatever on your ship
  • file - meshfile (sans .xmesh) for this engine model
    • e.g. "supernova.bmp" it's actually a xmesh file
  • x,y,z - location of light (in meters ;-))
  • size - size of engine (radius, in meters ;-))
  • red,blue,green - (optional)red/blue/green dye of engine
• <Dock .../> - (optional)(repeatable) A place where another unit can dock.
  • x,y,z - location of dock (in meters ;-))
  • size - size of dock port (radius, in meters ;-))
  • dockinternal - (optional/unused) whether the dock port makes the ship disappeared. The ship must be smaller than the size of the dock, otherwise it will remain in open space.
• <SubUnit .../> - (optional)(repeatable) A Subunt is a (not necessarily) small independant part of your unit. In fact the main unit and the subunit are two different ships (units) patched together at a certain point (x,y,z see below). If a subunit is destroyed the remaining parts will fly into space like the remainings of any other ship ... e.g turrets
  • file - unit file that can be referenced frmo toplevel units
  • siz - size class (which sizes it can hold)
  • x,y,z - location of subunit (in meters ;-))
  • ri,rj,rk - (optional) R-vector (forward vector) of subunit (assume 0,0,1)
  • qi,qj,qk - (optional) Q-vector (up vector) of subunit (assume 0,1,0)
  • restricted - (optional) minimum dot with rj that the turret can have so it can't turn inside itself
• <CockpitDamage .../> - (optional)(repeatable up to 1+NUMGAUGES+MAXVDUS or 29)
  • NOTE: If you have more, strange things may happen, as it will probably overrun the cockpitdamage buffer.
  • damage - float between 0 and 1 depending on the amount of static the vdu has.
• <Upgrade .../> - (optional)(repeatable) an upgrade unit that adds its stats onto this unit (as if you had bought it from the shop).
  • file - the file to upgrade it with.

Editing Units.csv File

• Open the units.csv file in a spreadsheet application and if you are adding a new item, add a new line.
• FIXME ADD INFO
• Save the file as a csv file.

See also

• Units.csv in CVS
• Edit Unit Files
• Add Descriptions
• Adding Cargo
• Adding Upgrades
• Editing Master_part_list.csv

---

Create Ships in Wings3D

HowTo

Edit Unit Files