Quick Stat Tweaks - Revision history

RandomX: Added closing bracket to the encoded string.

2023-12-22T19:54:00Z

Added closing bracket to the encoded string.

Sprung: oops

2023-12-21T01:48:15Z

oops

Sprung: Change used def keys (maxdamage/maxvelocity are now speed/health, add metalCost to illustrate lowerkeys)

2023-12-21T01:47:14Z

Change used def keys (maxdamage/maxvelocity are now speed/health, add metalCost to illustrate lowerkeys)

RandomX: more .Lua to .lua

2022-03-11T15:32:41Z

more .Lua to .lua

Sprung: Github dislikes case mismatch

2022-03-08T12:14:43Z

Github dislikes case mismatch

Sprung: Update tweak units modoption picture (tweakdefs since added)

2022-02-02T19:54:38Z

Update tweak units modoption picture (tweakdefs since added)

RandomX at 19:22, 9 January 2022

2022-01-09T19:22:20Z

RandomX at 19:17, 9 January 2022

2022-01-09T19:17:30Z

RandomX: Undo revision 8253 by RandomX (talk)

2022-01-09T19:16:20Z

Undo revision 8253 by RandomX (talk)

RandomX at 19:14, 9 January 2022

2022-01-09T19:14:09Z

@@ Line 77: / Line 77: @@
 }</syntaxhighlight>
 As before, we now take this text, [https://www.base64encode.org/ base64 encode] it, and copy it into Tweak Units. Encodings can be shortened by removing whitespace prior to encoding.
-<code style="display:block;overflow:auto">e2Nsb2FrcmFpZD17bWV0YWxDb3N0PTUwLHNwZWVkPTI0MCx9LHNoaWVsZHJhaWQ9e3dlYXBvbkRlZnM9e0xBU0VSPXtyYW5nZT02MDAsZGFtYWdlPXtkZWZhdWx0PTUwLH0sfSx9LH0s</code>
+<code style="display:block;overflow:auto">e2Nsb2FrcmFpZD17bWV0YWxDb3N0PTUwLHNwZWVkPTI0MCx9LHNoaWVsZHJhaWQ9e3dlYXBvbkRlZnM9e0xBU0VSPXtyYW5nZT02MDAsZGFtYWdlPXtkZWZhdWx0PTUwLH0sfSx9LH0sfQ==</code>
 == Mass post-processing ==
@@ Line 97: / Line 97: @@
 end</syntaxhighlight>
-UnitDefs is a Lua table indexed with unit names as above (for example "cloakraid" for Glaive) whose values are the unit def tables in a similar format as for tweakunits, BUT WITH ALL KEYS LOWERCASE (notice how it's metalcost and not metalCost!). This snippet increases unit speeds 10 times for all mobiles and health 5 times for all statics, and makes all units twice as expensive. Some fields may be <code>nil</code> (for another example, death explosions are weapons but don't have a reload time). Specific Tweak Units values override the values that result from Tweak Defs.
+<var>UnitDefs</var> is a Lua table indexed with unit names as above (for example "cloakraid" for Glaive) whose values are the unit def tables in a similar format as for tweakunits, BUT WITH ALL KEYS LOWERCASE (notice how it's <var>metalcost</var> and not <var>metalCost</var>!). This snippet increases unit speeds 10 times for all mobiles and health 5 times for all statics, and makes all units twice as expensive. Some fields may be <code>nil</code> (for another example, death explosions are weapons but don't have a reload time). Specific Tweak Units values override the values that result from Tweak Defs.
 Happy hacking!

@@ Line 77: / Line 77: @@
 }</syntaxhighlight>
 As before, we now take this text, [https://www.base64encode.org/ base64 encode] it, and copy it into Tweak Units. Encodings can be shortened by removing whitespace prior to encoding.
-<code style="display:block;overflow:auto">e2Nsb2FrcmFpZD17bWF4RGFtYWdlPTUwMCxtYXhWZWxvY2l0eT04LH0sc2hpZWxkcmFpZD17d2VhcG9uRGVmcz17TEFTRVI9e3JhbmdlPTYwMCxkYW1hZ2U9e2RlZmF1bHQ9NTAsfSx9LH0sfSw=</code>
+<code style="display:block;overflow:auto">e2Nsb2FrcmFpZD17bWV0YWxDb3N0PTUwLHNwZWVkPTI0MCx9LHNoaWVsZHJhaWQ9e3dlYXBvbkRlZnM9e0xBU0VSPXtyYW5nZT02MDAsZGFtYWdlPXtkZWZhdWx0PTUwLH0sfSx9LH0s</code>
 == Mass post-processing ==

@@ Line 22: / Line 22: @@
 == Simple Example ==
-In this example we make Glaive faster and healthier.
+In this example we make Glaive faster and cheaper.
 Start with an empty Lua table.
@@ Line 31: / Line 31: @@
      cloakraid = {},
 }</syntaxhighlight>
-The [https://springrts.com/wiki/Gamedev:UnitDefs SpringRTS wiki page on unitdefs] says that a unit's health is 'maxDamage' and its speed is 'maxVelocity'. [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/cloakraid.lua The Glaive file] shows us the current value of these parameters, as well as their position in the structure of a unitdef. We can change these values like so:
+The [https://springrts.com/wiki/Gamedev:UnitDefs SpringRTS wiki page on unitdefs] says that a unit's cost is 'metalCost' and its speed is just 'speed'. [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/cloakraid.lua The Glaive file] shows us the current value of these parameters, as well as their position in the structure of a unitdef. We can change these values like so:
 <syntaxhighlight lang="lua">{
      cloakraid = {
-         maxDamage = 500,
+         metalCost = 50,
-         maxVelocity = 8,
+         speed = 240,
      },
 }</syntaxhighlight>
 Copy this text into a [https://www.base64encode.org/ base64 encoder] and click encode. Here is the resulting encoding.
-<code style="display:block;overflow:auto">ewogICAgY2xvYWtyYWlkID0gewogICAgICAgIG1heERhbWFnZSA9IDUwMCwKICAgICAgICBtYXhWZWxvY2l0eSA9IDgsCiAgICB9LAp9</code>
+<code style="display:block;overflow:auto">ewogICAgY2xvYWtyYWlkID0gewogICAgICAgIG1ldGFsQ29zdCA9IDUwLAogICAgICAgIHNwZWVkID0gMjQwLAogICAgfSwKfQ==</code>
 Set the Tweak Units modoption to your encoding and start the game. Your infolog should indicate that the modoption loaded successfully.
 <samp><pre>[f=-000001] Loading UnitDefs_posts
-[f=-000001] Loading tweakunits modoption
+[f=-000001] Loading tweakunits modoption        <------
-[f=-000001] Loading tweakunits for cloakraid
+[f=-000001] Loading tweakunits for cloakraid    <------
 [f=-000001] Loading FeatureDefs_posts
 [f=-000001] Loading WeaponDefs_posts
@@ Line 54: / Line 54: @@
 <syntaxhighlight lang="lua">{
      cloakraid = {
-         maxDamage = 500,
+         metalCost = 50,
-         maxVelocity = 8,
+         speed = 240,
      },
      shieldraid = {},
@@ Line 62: / Line 62: @@
 <syntaxhighlight lang="lua">{
      cloakraid = {
-         maxDamage = 500,
+         metalCost = 50,
-         maxVelocity = 8,
+         speed = 240,
      },
      shieldraid = {
@@ Line 77: / Line 77: @@
 }</syntaxhighlight>
 As before, we now take this text, [https://www.base64encode.org/ base64 encode] it, and copy it into Tweak Units. Encodings can be shortened by removing whitespace prior to encoding.
-<code style="display:block;overflow:auto">e2Nsb2FrcmFpZCA9IHttYXhEYW1hZ2UgPSA1MDAsbWF4VmVsb2NpdHkgPSA4LH0sc2hpZWxkcmFpZCA9IHt3ZWFwb25EZWZzID0ge0xBU0VSID0ge3JhbmdlID0gNjAwLGRhbWFnZSA9IHtkZWZhdWx0ID0gNTAsfSx9LH0sfSx9</code>
+<code style="display:block;overflow:auto">e2Nsb2FrcmFpZD17bWF4RGFtYWdlPTUwMCxtYXhWZWxvY2l0eT04LH0sc2hpZWxkcmFpZD17d2VhcG9uRGVmcz17TEFTRVI9e3JhbmdlPTYwMCxkYW1hZ2U9e2RlZmF1bHQ9NTAsfSx9LH0sfSw=</code>
 == Mass post-processing ==
-The above examples deal with specific values for a single unit (e.g. "make Glaive have 500 health").
+The above examples deal with specific values for a single unit (e.g. "make Glaive have 240 speed").
 It is also possible to write Lua code that works on units, including changing values for all units or doing some sort of logic. This time, the option is not "Tweak Units" but "Tweak Defs". Again, it should be encoded to base64.
 Here's an example:
 <syntaxhighlight lang="lua">for name, ud in pairs(UnitDefs) do
-	if ud.maxvelocity then
+	if ud.speed then
-		ud.maxvelocity = ud.maxvelocity*10
+		ud.speed = ud.speed*10
 	else
-		ud.maxdamage = ud.maxdamage*5
+		ud.health = ud.health*5
 	end
 end</syntaxhighlight>
-UnitDefs is a Lua table indexed with unit names as above (for example "cloakraid" for Glaive) whose values are the unit def tables in a similar format as for tweakunits, BUT WITH ALL KEYS LOWERCASE. This snippet increases unit speeds 10 times for all mobiles and health 5 times for all statics. Some fields may be <code>nil</code> (for another example, death explosions are weapons but don't have a reload time). Specific Tweak Units values override the values that result from Tweak Defs.
+UnitDefs is a Lua table indexed with unit names as above (for example "cloakraid" for Glaive) whose values are the unit def tables in a similar format as for tweakunits, BUT WITH ALL KEYS LOWERCASE (notice how it's metalcost and not metalCost!). This snippet increases unit speeds 10 times for all mobiles and health 5 times for all statics, and makes all units twice as expensive. Some fields may be <code>nil</code> (for another example, death explosions are weapons but don't have a reload time). Specific Tweak Units values override the values that result from Tweak Defs.
 Happy hacking!

@@ Line 31: / Line 31: @@
      cloakraid = {},
 }</syntaxhighlight>
-The [https://springrts.com/wiki/Gamedev:UnitDefs SpringRTS wiki page on unitdefs] says that a unit's health is 'maxDamage' and its speed is 'maxVelocity'. [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/cloakraid.Lua The Glaive file] shows us the current value of these parameters, as well as their position in the structure of a unitdef. We can change these values like so:
+The [https://springrts.com/wiki/Gamedev:UnitDefs SpringRTS wiki page on unitdefs] says that a unit's health is 'maxDamage' and its speed is 'maxVelocity'. [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/cloakraid.lua The Glaive file] shows us the current value of these parameters, as well as their position in the structure of a unitdef. We can change these values like so:
 <syntaxhighlight lang="lua">{
      cloakraid = {
@@ Line 51: / Line 51: @@
 In this example we will change Bandit's damage and range, and add it to the Glaive changes.
-As in the simple example, we find the [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/shieldraid.Lua Bandit's file] and see that it's called shieldraid. To change Bandit and Glaive at the same time, we add a new sub-table to the table from the previous example.
+As in the simple example, we find the [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/shieldraid.lua Bandit's file] and see that it's called shieldraid. To change Bandit and Glaive at the same time, we add a new sub-table to the table from the previous example.
 <syntaxhighlight lang="lua">{
      cloakraid = {

@@ Line 27: / Line 27: @@
 <syntaxhighlight lang="lua">{
 }</syntaxhighlight>
-A search through the [https://github.com/ZeroK-RTS/Zero-K/blob/master/units unitdef repository] reveals that Glaive is known as cloakraid internally. [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/cloakraid.Lua This] is the file. Add an empty table with key 'cloakraid'.
+A search through the [https://github.com/ZeroK-RTS/Zero-K/blob/master/units unitdef repository] reveals that Glaive is known as cloakraid internally. [https://github.com/ZeroK-RTS/Zero-K/blob/master/units/cloakraid.lua This] is the file. Add an empty table with key 'cloakraid'.
 <syntaxhighlight lang="lua">{
      cloakraid = {},

@@ Line 1: / Line 1: @@
 The Tweak Units modoption can be used to modify many unit and weapon parameters. It can be used for rapidly testing balance changes or just for making a quick game mode. It has limitations and should not be used for large mod projects, see [[Mod Creation]] and [[How To Play Mods]] to get started on full modding.
-[[File:Tweakunitswindow.jpg]]
+[[File:Tweakunitsdefs.png]]
 Stat tweaks can be saved and shared as a [[Custom Modes | Custom Mode]].