HowTo:Edit units.csv

From VsWiki
Revision as of 06:20, 1 April 2005 by 202.50.187.13 (talk)
Jump to: navigation, search
arrow_left.png Create Ships in Wings3D arrow_up.png HowTo Edit Unit Files arrow_right.png

This article is in need of attention. Please improve it in any way you see fit.

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; FIXME Copy Descriptions from HowTo:Edit Unit Files


  • Key (Key)
  • Directory (String)
  • Name (string)
  • FoFID (string)
  • Object_Type (string)
  • Combat_Role (string)
  • Textual_Description (string)
  • Hud_image (string)
  • Unit_Scale (float) - Sets the scaling of the unit in the game
  • Cockpit (string) - Defines a cockpit for the ship. Points to a cockpit file. Extension .cpt. See also HowTo:Edit HUDs.
    • CockpitX (x=float) - Coordinates where the Cockpit should be in the Unit/Ship
    • CockpitY (y=float) - Coordinates where the Cockpit should be in the Unit/Ship
    • CockpitZ (z=float(meters)) - Coordinates where the Cockpit should be in the Unit/Ship
  • Mesh ({filename(string);frame(int);texturetime(float)})
filename - Points to a xmesh-file of the ship. Extension .xmesh
frame - (optional) Defines the starting-frame of a mesh animation. See forums for more.
texturetime - (optional) Defines the starting delay of a mesh animation. See forums for more.
    • Shield_Mesh (string) - (optional) xmesh-file to use for the shield instead of a sphere. Extension .xmesh
    • Rapid_Mesh (string) - (optional) xmesh-file to load and use for collisions with other units/ships/... instead of the Meshfile from above (not drawn) Extension .xmesh
    • BSP_Mesh (string) - (optional) xmesh-file to use for beam and bolt collisions (not drawn) Extension .xmesh
    • Use_BSP (boolean)
    • Use_Rapid (boolean)
  • Mass (metric tons)
  • Moment_Of_Inertia (metric tons * meters*meters)
  • Convex_Hull_Volume (meters * meters * meters)
  • Fuel_Capacity (metric tons)
  • Hull (VSD)
    • Armor_Front_Top_Right (VSD)
    • Armor_Front_Top_Left (VSD)
    • Armor_Front_Bottom_Right (VSD)
    • Armor_Front_Bottom_Left (VSD)
    • Armor_Back_Top_Right (VSD)
    • Armor_Back_Top_Left (VSD)
    • Armor_Back_Bottom_Right (VSD)
    • Armor_Back_Bottom_Left (VSD)
    • Shield_Front_Top_Right (VSD)
    • Shield_Back_Top_Left (VSD)
    • Shield_Front_Bottom_Right (VSD)
    • Shield_Front_Bottom_Left (VSD)
    • Shield_Back_Top_Right (VSD)
    • Shield_Front_Top_Left (VSD)
    • Shield_Back_Bottom_Right (VSD)
    • Shield_Back_Bottom_Left (VSD)
    • Shield_Recharge (VSD/second)
    • Shield_Leak (percentage)
  • Warp_Capacitor (800MJ)
  • Primary_Capacitor (100MJ)
  • Reactor_Recharge (100MJ/s)
  • Jump_Drive_Present (Boolean )
  • Jump_Drive_Delay (seconds)
  • Wormhole (boolean)
  • Outsystem_Jump_Cost (800MJ)
  • Warp_Usage_Cost (800MJ/second)
  • Afterburner_Type (int type )
  • Afterburner_Usage_Cost (100MJ/s)
  • Maneuver_Yaw (metric tons*degrees/second^2)
  • Maneuver_Pitch (metric tons*degrees/second^2)
  • Maneuver_Roll (metric tons*degrees/second^2)
  • Yaw_Governor (degrees/sec)
  • Pitch_Governor (degrees/sec)
  • Roll_Governor (degrees/sec)
  • Afterburner_Accel (metric tons*m/s^2)
  • Forward_Accel (metric tons*m/s^2)
  • Retro_Accel (metric tons*m/s^2)
  • Left_Accel (metric tons*m/s^2)
  • Right_Accel (metric tons*m/s^2)
  • Top_Accel (metric tons**m/s^2)
  • Bottom_Accel (metric tons*m/s^2)
  • Afterburner_Speed_Governor (meters/second)
  • Default_Speed_Governor (meters/second)
  • ITTS (boolean)
  • Radar_Color (boolean)
  • Radar_Range (meters)
  • Tracking_Cone (Degrees)
  • Max_Cone (Degrees)
  • Lock_Cone (Degrees)
  • Hold_Volume (m^3)
  • Can_Cloak (boolean)
  • Cloak_Min (percentage) - minimum percentage of cloakedness
  • Cloak_Rate (percentage/second) - time per second to cloak
  • Cloak_Energy (800MJ/s) - how much energy this takes.
  • Cloak_Glass (boolean) - boolean whether or not effect 2 is used
  • Repair_Droid (int)
  • ECM_Rating (int)
  • ECM_Resist (int)
  • Ecm_Drain (800MJ/s)
  • Hud_Functionality (1 normalized fraction)
  • Max_Hud_Functionality (1 normalized fraction)
  • Lifesupport_Functionality (1 normalized fraction)
  • Max_Lifesupport_Functionality (1 normalized fraction)
  • Comm_Functionality (1 normalized fraction)
  • Max_Comm_Functionality (1 normalized fraction)
  • FireControl_Functionality (1 normalized fraction)
  • Max_FireControl_Functionality (1 normalized fraction)
  • SPECDrive_Functionality (1 normalized fraction)
  • Max_SPECDrive_Functionality (1 normalized fraction)
  • Slide_Start (seconds)
  • Slide_End (seconds)
  • Activation_Accel (m/s^2)
  • Activation_Speed (m/s)
  • Upgrades ({filename(string);mountoffset(int);subunoffset(int)})
filename -
mountoffset -
subunoffset -
  • Prohibited_Upgrades (Semicolon delineated list of prohibited upgrades, allowing up to a certain number if specified with colon.)
  • Sub_Units ({filename(string);x(meters);y(meters);z(meters);forex(meters);forey(meters);forez(meters);upx(meters);upy(meters);upz(meters);restricted(meters)}) - 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
filename - unit file that can be referenced from toplevel units
x, y, z - location of subunit
forex, forey, forez - (optional) Forward vector of subunit (assume 0,0,1)
upx, upy, upz - (optional) Up vector of subunit (assume 0,1,0)
restricted - (optional) minimum dot with forey that the turret can have so it can't turn inside itself
  • Sound (shieldhit(string);armorhit(string);hullhit(string);jump(string);explode(string);cloak(string);engine(string))
shieldhit, armorhit, hullhit -
jump -
explode -
cloak -
engine -
  • Light ({meshfile(string);x(meters);y(meters);z(meters);scale(meters);r(percentage);g(percentage);b(percentage);a

(percentage);activationspeed(meters/second)}) - Specifies an engine-flame/light/glow/whatever on your ship

meshfile - meshfile (sans .xmesh) for this engine model
x, y, z - location of light (in meters)
scale - size of engine (radius, in meters)
r, g, b, a - (optional)red/blue/green colour of engine
activationspeed - FIXME
  • Mounts ({type(string);ammo(int);volume(meters);SIZE(string);x(meters);y(meters);z(meters);xyscale(meters);zscale(meters);forex(meters);forey(meters);forez(meters);upx(meters);upy(meters);upz(meters);functionality(percentage);maxfunctionality(percentage)})
type - Type of weapon (see weapon_list.xml in the data directory)
ammo - how much ammo the gun holds (only needed for ammo needing weapons e.g. missiles,torpedos,...
volume -
SIZE - size class(es)/type(s) and if they are capable of autotracking.
x, y, z - location of weapon
xyscale, zscale - FIXME
forex, forey, forez - (optional) Forward vector of mount (assume 0,0,1)
upx, upy, upz - (optional) Up vector of mount (assume 0,1,0)
  • Net_Comm (?)
  • Dock ({INTERNAL(boolean);x(meters);y(meters);z(meters);size(meters);minsize(meters)})
  • Cargo_Import ({Cat(string);price(percentage);pricestddev(percentage);quant(percentage);quantstddev(percentage)})
Cat - A category to use from Master_part_list.csv eg Natural_Products/Natural_Resources"
price - price scale (multiplied by price in list)
pricestddev - price scale variation (above adjusted by this)
quant - quantity of this sort of cargo
quantstddev - quantity variation
  • Cargo ({filename(string);Category(string);price(credits);quant(int);mass(metric Tons);volume(meters*meters*meters);functionality(percentage);maxfunctionality(percentage);description(string);missionCargo(bool)})
filename - name of cargo
Category -
price - price of cargo
quant - ammount of cargo
mass - mass in tonnes
volume - size of cargo in m3
functionality, maxfunctionality - FIXME ???
description - (optional/unused)
missionCargo - FIXME ???
  • Explosion (string)
  • Equipment_Space (m^3)
  • Num_Animation_Stages (int)
  • Upgrade_Storage_Volume (float)
  • Heat_Sink_Rating (float)

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.


Example Row


See also

arrow_left.png Create Ships in Wings3D arrow_up.png HowTo Edit Unit Files arrow_right.png
Retrieved from "https://wiki.vega-strike.org/mediawiki/index.php?title=HowTo:Edit_units.csv&oldid=1688"