Transcendence Community Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====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 [[functions|tscript]] and also to output tables of statistics in relation to the games.

For More information at the moment go to the [[http://neurohack.com/transcendence/design/TransData.html|TransData]] page.
====Download====
Current Version: [[http://http://kronosaur.com/downloads/TransData.zip|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 ((Check for additional parameters))
      * [/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: <code>TransData.exe /itemTable /criteria:"* +extension:extensionUNID" /balanceStats</code>
  * For a single item: <code>TransData.exe /itemTable /criteria:"* +unid:weaponUNID" /balanceStats</code>
====Utilities====
Wolfy's [[tmu|Mod and Utilities manager]] may end up including a utility for TransData. Though this needs confirmation.
H Iris's [[https://sites.google.com/site/lachlanproject/filing-cabinet/TransData1.6Utility0.1.0.exe.zip?attredirects=0&d=1|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.