Transcendence Community Wiki

User Tools

Site Tools

Trace: • transdata
modding:transdata

Table of Contents

TransData

TransData is a command line utility that interacts with the transcendence.exe file to allow modders to decompile the games xml's written in tscript and also to output tables of statistics in relation to the games.

For More information at the moment go to the TransData page.

Download

Current Version: TransData 3.3.11

Usage

After Downloading TransData21.zip extract the file and copy TransData into the same folder as the Transcendence.exe file.

  • >TransData.exe
    • extensionFolder
    • extensions
  • /help
    • /armorTable
    • /attributeList
    • /debug
    • /effectImage
    • /effectPerf
    • /entitiesReference
    • /hexarcTest
    • /images
    • /randomitems
    • /randomnumbertest
    • /runFile
    • /smoketest Tests the game
    • /stationfrequency
    • /stats
    • /topology
    • /topologyMap
  • /clearRegistered Clears registered flag on game file
    • /gameFile:filename Save file to clear
  • /decompile Extracts resources from .tdb (overwrites existing
    • /dataFile:filename TDB file to decompile
  • /encountercount Counts of encounters for a whole game
    • [/adventure:n] Load the given adventure (by UNID)
    • [/all] Include non-random stations
    • [/count] Number of games to create
  • /encounterFreq Outputs encounter tables
    • [/adventure:n] Load the given adventure (by UNID)
    • [/count] Number of games to create
    • [/fillLocations] Output tables from <FillLocations> directives
  • /encountersim Simulate an attack on the station
    • [adventure:n] Load the given adventure (by UNID)
    • /attackers:xxx Criteria specifying attacking ships
    • /defender:xxx Encounter criteria
    • [/count] Number of runs per attacker
    • [/viewer] Open viewer to watch the battle
  • /encounterTable Encounter table
    • [/adventure:n] Load the given adventure (by UNID)
    • [/all] Include non-random stations
    • [/criteria:xxx] Only encounters that match criteria
    • [/onlyNotRandom] Only non-random stations
    • [/abandonedDockScreen] Station dock screen when abandoned
    • [/armorClass] Armor class
    • [/armorLevel] Level of armor
    • [/balance] 100 = defenses balanced for level
    • [/canAttack] Station can attack
    • [/category] Friendly/enemy/debri
    • [/countDistribution] The number appearing in difference games
    • [/defenderStrength] Strength of defenders (relative to level)
    • [/dockScreen] Station dock screen
    • [/explosionType] Type of explosion when destroyed
    • [/fireRateAdj] Fire rate adjustment
    • [/hitsToDestroy] Number of hits to destroy with weapon of encounter level
    • [/hp] Initial hit points
    • [/maxLightRadius] Light radius for suns (in light-seconds)
    • [/regen] Repair rate in hp per 180 ticks
    • [/satelliteStrength] Strength of satellites (relative to level)
    • [/size] Size of object in km
    • [/totalCount] Total number appearing per game
    • [/treasureBalance] Treasure relative to defense (100 = balance)
    • [/treasureValue] Value of average treasure (in credits)
    • [/weaponStrength] Strength of weapons (relative to level)
  • /itemsim Simulation of items encountered.
    • [/adventure:n] Load the given adventure (by UNID).
    • /count:n Number of iterations
  • /itemtable Item table.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/byAttribute] Categorize by attribute.
    • [/byShipClass] Categorize by ship class using the item.
    • [/byShipClassUsage] Show ship classes using given item.
    • [/criteria:xxx] only items that match criteria.
    • [/adjustedHP] hp adjusted for damage type.
    • [/ammoType] UNID of ammo.
    • [/averageCount] average number appearing.
    • [/averageDamage] average damage (in HP).
    • [/balanceDamage] std damage for level and type (in HP per 180 ticks).
    • [/balanceStats] stats related to game balance.
    • [/cost] cost (in credits).
    • [/damage] average damage (in HP per 180 ticks).
    • [/damageAdj] damage type adjustment.
    • [/description] item description.
    • [/effectiveHP] effective hit points.
    • [/entity] XML entity to use.
    • [/fireDelay] time between shots (in ticks).
    • [/frequency] frequency found.
    • [/fuelCapacity] fuel capacity (He3 fuel rod = 1).
    • [/hp] hit points.
    • [/hpBonus] bonus by damage type adjustment.
    • [/installCost] cost to install (in credits).
    • [/mass] mass (in kg).
    • [/maxSpeed] maximum speed (in % of lightspeed).
    • [/power] power consumed (in MW).
    • [/powerPerShot] power per shot (in MW-minutes).
    • [/range] range of weapon (in light-seconds).
    • [/reference] reference column.
    • [/regen] regeneration (in HP per 180 ticks).
    • [/repairCost] cost to repair 1 hp of damage.
    • [/shieldInterference] True if armor prevents shield use.
    • [/thrust] thrust (in giganewtons).
    • [/totalCount] total number appearing per game.
    • [/unid] unid of item type.
    • [/variantCount] number of weapon variants.
    • [/weaponSuppress] shield prevents firing these damage types.
  • /lootsim Simulation of items encountered in a game.
    • [/adventure:n] Load the given adventure (by UNID).
    • /count:n n iterations.
    • /criteria:n Types of stations to sample.
    • /itemCriteria:n Types of items to include.
    • /asteroids Include all ore on asteroids.
    • /enemies Include all loot on enemy ships and stations.
    • /inventory Include all items for sale at friendly stations.
  • /perftest Performance test
    • [/adventure:n] Load the given adventure (by UNID)
  • /run:command Run a TransLisp command
    • [/adventure:n] Load the given adventure (by UNID)
  • /shieldtest Outputs capabilities of shield against weapons.
    • [/adventure:n] Load the given adventure (by UNID).
    • /unid:n unid or name of shield to test.
    • [/verbose] output weapon stats.
  • /shipimage Generates image of a specific ship.
    • [/adventure:n] Load the given adventure (by UNID).
    • /unid:n unid of ship.
    • [/driveimages] Show all rotations with exhaust images.
    • [/grid] Show a grid centered on ship.
    • [/output:file] Saves image to given filespec.
    • [/weaponpos] Show all rotations with weapon positions.
  • /shipimages Generates ship images.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/font:s] Use given font for labels.
    • [/output:file] Saves image to given filespec.
    • [/rotation:n] Specifies the rotation of all ships.
    • [/sort:xxx] Sort ships in given order.
      • largest Larger ships first.
      • name By ship name.
      • smallest Smaller ships first.
    • [/textBoxesOnly] Output textboxes only.
    • [/width:n] Width of image in pixels.
    • [/xMargin:n] Margin around ships.
    • [/xSpacing:n] Spacing between ships.
  • /shiptable Ship table.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/allClasses] include special classes (such as wingmen).
    • [/criteria:xxx] Ships must match criteria.
    • [/armorItems] installed armor items.
    • [/balanceType] designation based on combat strength.
    • [/cargoSpace] cargo space available (in tons).
    • [/combatStrength] combat power (absolute).
    • [/damage] damage done per 180 ticks.
    • [/defenseStrength] defense strength (absolute).
    • [/deviceSlots] number of device slots.
    • [/deviceSlotsNonWeapons] number of slots for non-weapons.
    • [/deviceSlotsWeapons] number of slots for weapons.
    • [/deviceItems] installed devices.
    • [/fireAccuracy] AI fire accuracy (%).
    • [/fireRangeAdj] AI fire range adjustment (% of normal).
    • [/fireRateAdj] AI fire rate adjustment (% of normal).
    • [/genericName] generic name.
    • [/hullMass] mass of hull only (in tons).
    • [/launcher] launcher.
    • [/maneuver] time for a complete rotation.
    • [/manufacturer] ship manufacturer.
    • [/maxArmorMass] max mass for armor (in kilograms).
    • [/maxCargoSpace] max cargo space (in tons).
    • [/maxSpeed] maximum speed (in % of lightspeed).
    • [/primaryArmor] primary armor.
    • [/primaryWeapon] primary weapon.
    • [/primaryWeaponRange] max effective weapon range (in ls).
    • [/primaryWeaponRangeAdj] adjusted effective weapon range (in ls).
    • [/score] score.
    • [/shield] shield generator.
    • [/thrustToWeight] thrust-to-weight ratio.
    • [/unid] unid of class.
  • /simtables Generates tables for sim counts.
    • [/adventure:n] Load the given adventure (by UNID).
    • /count:n n iterations.
  • /snapshot Generates a snapshot of an object.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/count:n] Number of snapshots to generate.
    • [/criteria:xxx] Object must match criteria.
    • [/node:ID] Look for object in given node.
    • [/noStars] Do not paint starfield.
    • [/objOnly] Paint the object only.
    • [/output:file] Saves image to given filespec.
    • [/size:n] Size of snapshot in pixels.
    • [/wait:n] Wait this many ticks before snapshot.
  • /stationSeparationSim Generate enemy station separation statistics.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/count:n] n iterations.
  • /stdarmor Shows stats about standard armors
  • /stdshield Shows stats about standard shields
  • /systemcount Counts systems in a game 1)
    • [/count:n]
    • [/noLogo;{true/false}]
    • [/all:{true/false}]
    • [/systemcount:n]
  • /systemimages Generate snapshots of system maps
    • [/width:n]
    • [/xSpacing:n]
    • [/xMargin]
    • [/font:xxx]
    • [/output:{name}{extension}]
    • [/zoom:n]
  • /systemlabels Generate counts for all labels.
    • [/adventure:n] Load the given adventure (by UNID).
    • /count:n n iterations.
    • [/nodes] Show node attribute counts instead.
    • [/nodeDebug] Output sample nodes with attributes instead.
  • /systemtest Generates sample of all systems.
    • [/adventure:n] Load the given adventure (by UNID).
    • /count:n n iterations.
  • /tradesim Generates statistics of item trading
    • [/count:n]
    • [/nologo:{true/false}]
  • /typeDependencies Show a list of all types and their dependencies
    • [/recursive:{true/false}]
    • [/reverse:{true/false}]
  • /typeIslands Show groups of types that depend on each other
  • /typeImages Generates chart of images
    • /criteria:n Type criteria of images to show
    • [/adventure:n] Load the given adventure (by UNID)
    • [/devicePos] Shows device positions on stations
    • [/font:s] Use given font for labels
    • [/itemCriteria:n] Item criteria of images to show
    • [/output:file] Saves image to given filespec
    • [/portPos] Show docking port positions
    • [/sort:xxx] Sort worlds in given order
      • largest Larger objects first
      • level By level (ascending)
      • manufacturer Categorize by manufacturer
      • name By name
      • smallest Smaller objects first
      • sovereign Categorize by sovereign
    • [/textBoxesOnly] Output textboxes only
    • [/width:n] Width of image in pixels
    • [/xMargin:n] Margin around images
    • [/xSpacing:n] Spacing between images
  • /typeTable Generates sample of all systems.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/criteria:xxx] Type of given criteria.
      • $ EconomyType.
      • a AdventureDesc.
      • b ItemTable.
      • c EffectType.
      • d DockScreen.
      • e SpaceEnvironmentType.
      • f OverlayType.
      • h ShipTable.
      • i ItemType.
      • m Image.
      • n MissionType.
      • p Power.
      • s ShipClass.
      • t StationType.
      • u SoundType.
      • v Sovereign.
      • x GenericType.
      • y SystemType.
      • z SystemMap.
      • _ TemplateType.
  • /weaponimages Generates images of weapon effects.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/criteria:xxx] only items that match criteria.
    • [/shipClass:x] UNID of ship class to use as platform.
    • [/output:file] Saves image to given filespec.
  • /wordgenerator Generate a list of random words.
    • /count:n Number of words to generate.
    • /input:filename List of words to use as examples.
    • [/novel] Exclude words in the input file.
  • /wordlist Lists all unique words
  • /worldimages Generates world images.
    • [/adventure:n] Load the given adventure (by UNID).
    • [/font:s] Use given font for labels.
    • [/output:file] Saves image to given filespec.
    • [/sort:xxx] Sort worlds in given order.
      • largest Larger worlds first.
      • name By name.
      • smallest Smaller worlds first.
    • [/textBoxesOnly] Output textboxes only.
    • [/width:n] Width of image in pixels.
    • [/xMargin:n] Margin around images.
    • [/xSpacing:n] Spacing between images.

Balance

Calculating item balance is one of TransData's most frequent functions. TransData works by assigning a “balance point” value to every item trait and then adding them all up to find the total. If the result is equal to 100, then the item is most likely balanced for a standard game. If it is greater, than the item is overpowered. And if it is lower, then the item is underpowered.

  • For an extension: 
    TransData.exe /itemTable /criteria:"* +extension:extensionUNID" /balanceStats
  • For a single item: 
    TransData.exe /itemTable /criteria:"* +unid:weaponUNID" /balanceStats

Utilities

Wolfy's Mod and Utilities manager may end up including a utility for TransData. Though this needs confirmation. H Iris's TransData1.6 Utility though out of date still has reported function with the current version of Transcendence. H Iris has reported that he is working on an updated version of the TransData Utility.

1)
Check for additional parameters
modding/transdata.txt · Last modified: 2018/11/22 05:27 by 0xabcdef