Official Homeworld Balance Mod

Since the release of Homeworld: Remastered the development team has been hard at work supporting the Mod Community and improving the Multiplayer Beta.

Today is a big day. We are opening up the testing of the Balance Mod to the entire community!

This is still VERY MUCH a work in progress. Our small private testing of the mod has gone really well over the past number of months, and we feel like we can now grow our balance community, to you!

The Official GBX Balance Mod is packed full of new and improved ship stats, behaviors, AI, abilities, feedback, and mod support. (See the list below for a sampling of these changes!)

We are not done, but we are getting much much closer.

Below are the notes from our lead designer who has been heading up this effort, Stephen Cole.

We really appreciate everyone who is part of this community and we are excited to take this next step with you.

BIG NOTE – DO NOT run this mod with a campaign. This mod will break your campaign save progress and is not intended for SP testing yet.

The Homeworld Team

Special thanks to:

A foreword about balance:

The Balance Mod contains edits to about 627 files. The complexity of the interactions the changes have on the game would make itemizing every change lunacy so instead we will speak to some of the general changes that affect the game as a whole and include individual sections on races. It will not and can not be an exhaustive, comprehensive list. You will have to play to really feel it out.

New changes to the game-at-large:

  • Frigates are a more viable option and are not just exploding armor for your Destroyers/Cruisers. Frigate health has been increased across the board while Destroyer and Battlecruiser health have been lowered to more appropriate levels.

  • Probe cost/time adjustments. Base probes were never worth their cost compared to the utiltiy of the scout.

  • Cloak Detection and Cloak technology cost normalized. Previously cloaking tech was expensive while cloaking detection was cheap.

  • Fire Control Tower/Vaygr Command Corvette weapon accuracy and damage boost lowered from 15% to 7%.

  • Weapon and Accuracy accrued cap lowered from 40% to 20%

  • Retaliation ranges increased on all Motherships, Carriers and Shipyards. In Homeworld 2 Classic these ships would frequently perseverate on targets well outside their weapon ranges leading to them not utilizing their defense weapons on attackers.

  • New defense weapons on capital ships to help counter strikecraft swarms

  • Cruiser/Battlecruiser unitcap set to 2

  • New scuttle damage set for most ships

  • Single tiered upgrades. Yes, there was a definite strategy between the original HW2 races that is lost but now there are two races without upgrades who must remain a viable play option. HW2 base stats for ships are higher than Classic and when upgraded ships usually fall close to where they would have been at the level 2 upgrade. For HW2 races this frees up Resources that can be used elsewhere. Vaygr, with their particularly expensive family-wide upgrades benefit from this.

Race specific changes and improvements (not comprehensive):


  • Gunship Corvettes now have less banking to allow their turrets to more properly do their job
  • DefenseField Frigate duration increased, unit cap lowered to 2 to reflect their effectiveness
  • DefenseField Frigate can now fire its turret (HW2 Classic bug)
  • Marine Frigate attack family now set to Frigate instead of Capturer. Utilizes AttackPriorityMultiplier instead of making every weapon have 100% accuracy against it
  • MineLayer Corvette has increased health
  • Ion Cannon Frigate now has increased anti-corvette capability to help surgically remove Salvage Corvettes.
  • Ion Turrets have greater declineation values to minimize a deadspot they had right at the horizon against certain ships
  • Resource Collector health boost
  • Destroyer health lowered to reflect its cost
  • Destroyer damage against resourcers lowered. Hyperspacing a single Hiigaran Destroyer into a Resource patch and wiping out all the collectors should be a lessened threat
  • Battlecruiser health and damage lowered to reflect its cost. It is still a heavily armored projection of force but does not have 3x the health of a Destroyer
  • Increased subsystem health on select production modules


  • Assault Frigate has been updated to provide Vaygr with a more viable anti-strikecraft frigate platform and has been refitted to more closely reflect its high cost
  • Vaygr Command Corvette health increased and has gained the Sensor “Ping” ability
  • Lance Fighter damage against resourcers increased to supplement their role
  • Laser Corvette firing rate normalized. Vaygr Laser Corvettes have always been good at frontloading damage on their first pass but:
  • upgrading their speed meant that when targets move towards them they occasionally could not realign their weapons after a pass, resulting in a large loss of dps and:
  • they have an unusual firing cycle that could prevent their weapons from firing until they were passing over their target
  • Vaygr Missile Corvette effectiveness against fighters slightly upgraded to provide Vaygr with a moderately more viable anti-fighter corvette platform. Their overall loss of DPS due to firing weapons into their wingmen has been erased.
  • Vaygr Hyperspace Gate is now slightly faster and has a minor built-in sensor distortion ability to incentivize its use

Vaygr Resourcing:

  • Vaygr Resource Collector load increased from 200 to 208
  • Vaygr Mothership resourcer exit paths altered to expel resourcers faster (to compensate for Vaygr Resourcers ejecting from the opposite side of Resourcing patches)
  • Vaygr Mothership resourcing paths altered to allow for faster resourcing.
  • Vaygr players start matches with 7 resourcers instead of 6

Note: Due to the immense size of the Mothership resourcers have to travel much further than the other races to complete a resourcing cycle. Ejecting from the opposite side of a huge ship and having to navigate either over or under it to begin resourcing can mean that Vaygr fall behind in the number of RU loads. All of these changes allow Vaygr to remain competitive with the other races and provide a larger margin of error in the exact positioning of ship for optimal resourcing cycles.

  • Infiltrator Frigate attack family now set to Frigate instead of Capturer. Utilizes AttackPriorityMultiplier instead of making every weapon have 100% accuracy against it
  • Vaygr Heavy Missile Frigate range slightly increased to help it compete at the same level as Ion Cannon Frigates
  • Increased subsystem health on select production modules


  • Cost/Health/Performance adjustments for almost all ships


  • Scouts now suitable for harassment and can take down Interceptors with numbers
  • Interceptor effectiveness now carries through HW2 fighter upgrades
  • Cloaked Fighter cloaking rate adjusted. They do not cloak while attacking but they do have a cloaking rate that allows for hit and run harassment. Effectiveness vs fighters adjusted to reflect their research cost
  • DefenseFighters updated with a smaller version of the MagneticField to help block projectile munitions.
  • Defense Fighter anti-missile laser adjusted downwards to help reduce their overwhelming effectiveness against Vaygr (being the most missile based race)
  • Defenders are less of a DPS monster but are still effective against fighters and corvettes with their high rate of fire and high health


  • Light Corvettes now properly effective against fighters.
  • New AttackStyles for circle strafing and facing targets
  • Heavy Corvettes now moderately effective against fighters and have the punch and health to hurt Frigates
  • Properly utilize frontal attack styles
  • Multigun Corvettes now very effective against fighters and have the fire rate to hunt Corvettes
  • Properly face their targets and turrets adjusted to reflect their coverage


  • Assault Frigates now properly effective against Corvettes and Frigates.
  • Equipped with the health to properly form the backbone of your strike groups
  • Ion Cannon Frigates now equipped with the range and damage to attack Frigates/Capitals/Subsystems
  • Field Frigates now equipped with a fulltime MagneticField
  • Drone Frigates remain an effective anti-strikecraft frigate platform
  • Drone duration greatly increased to reduce the need to constantly monitor the deployment of drones


  • Missile Destroyers are now effective at their anti-strikecraft roles
  • Carrier/Cruiser engine health matches HW2 numbers


  • Repair and Support Frigate healing rates adjusted upwards
  • Healing ranges increased to allow for repairing larger ships like the Taiidan Mothership and increase the overall repair effectiveness


  • Gravwell ability range more closely matches the original HW1 radius
  • Hyperspace Inhibitor range set to 10,500 to help protect Motherships from hyperspacing cruiser attacks
  • Gravwell now can not be regenerated once activated
  • Gravwell innate hyperspace ability now self disables upon activation


  • Kushan Resource Controller resourcing path altered to compensate for the rotation of resourcers when dropping off their RU loads
  • Drop-off rates specifically tuned by race to allow HW1 races to remain competitive
  • Kushan Carrier’s innate resource drop-off altered. Attackers will no longer attempt to attack from the top of the carrier, preventing their weapon fire from striking the drop-off
  • Kushan/Taiidan resourcers have their innate hyperspacing ability restored
  • Resource Controllers no longer have pre-requisite research and can now be built at map start


  • Research Ship build times adjusted to more smoothly move through research timings. It is now more desirable to build all Research Hubs.
  • Research time/costs adjusted to allow a HW1 player to choose to start at either fighters, vettes or frigates and not be at such a severe disadvantage when matched against a HW2 opponent
  • attack bomber research removed to give HW1 races more options upon completion of “FighterChassis” research
  • Repair Corvettes no longer have a prerequisite research
  • Light Corvettes are now granted upon completion of “CorvetteDrive”
  • Salvage Corvettes are now granted upon completion of “CorvetteChassis”
  • SuperCapitalDrive now grants Carriers instead of Destroyers to give HW1 players more flexibility in choosing their next upgrade path and to help match the HW2 Shipyards/Carriers they are likely facing
  • Destroyers and Cruisers now require “IonCannons” to be researched first due to their Ion based weaponry

New Multiplayer Gametype Options:

  • Disallow Cruisers - Enable/Disable

New Player vs CPU AI Improvements:

  • HW1 race AI now has better logic for calculating the number of resource drop-offs required and Resource Controllers should no longer circle a resourcing patch like sharks
  • Vaygr AI now better at upgrading its ships
  • Hiigaran AI now more frequently upgrades
  • HW1 races now apply separate scalars to fighters and corvettes to make itself more aware that one interceptor is not equal to 5 or 7 interceptors
  • classdef improvements, ie Vaygr laser corvettes is not an effective anti corvette strategy
  • HW1 races now more likely to utilize their multiple build production queues
  • HW1 AI does not understand how to effectively utilize repair ships so they won’t build them just like HW2 won’t make platforms
  • HW1 AI now knows about CloakedFighters and Defenders
  • HW1 AI now has a better concept of building mixed units and is less likey to forget about strikecraft when frigates and higher are at play

HW1 races in general should be more challenging and fun to play. The underlying chassis determination system is still in effect.


  • New art for Taiidan MagneticField
  • New hit FX for Taiidan MagneticField
  • Fixed missing hit FX for Hiigaran DefenseField
  • New weapon FX for HW1 bombers
  • New weapon FX for HW1 Assault Frigate Plasma Bombs
  • New hit FX for select rapid firing HW1 strikecraft to minorly reduce overdraw
  • New missile/torpedo trails


  • Many improvements to lifetime/maneuverability, etc.
  • Kushan/Taiidan Missile Destroyers are now effective anti-strikecraft platforms
  • Vaygr frigate concussion missile launchers have had a complete overhaul. Instead of having too short of a lifetime and such poor maneuvering stats to ever hit anything, Vaygr Assault and Heavy Missile Frigates have top mounted concussion launchers with separate stats that complement the role of the ship they are mounted to.
  • Mine duration increased from 3 minutes to 10 minutes

For Modders

New Systems:

Dynamic Target Priorities

doscanpath & dofilepath
Race research has been broken out into separate files using the new ‘doscanpath’ function
doscanpath(“data:Scripts/Races/Vaygr/Scripts/Research”, “*.lua”)

The above script reads all the .lua files in the path and internally builds a research index.

This directory looks like:

This allows future mods to explicitly pick and choose which base research or upgrades to use and to insert the modders own .lua into the research index
dofilepath(“data:Scripts/Races/Vaygr/Scripts/Research”, “Ability_Ugrades.lua”)
dofilepath(“data:Scripts/Races/Vaygr/Scripts/Research”, “CapitalShip_Upgrades.lua”)
dofilepath(“data:Scripts/Races/Vaygr/Scripts/MyModsResearch”, “Corvette_Upgrade_Health.lua”)
dofilepath(“data:Scripts/Races/Vaygr/Scripts/MyModsResearch”, “Corvette_Upgrade_Speed.lua”)
The above example mixes in the mods Corvette Health and Speed upgrade settings so that you don’t have to maintain a single research list.

  • AttackPriorityMultiplier
    This system allows you to specify which ships are more dangerous amongst groups of ships of the same class. As Homeworld 2 Classic shipped, Marine and Infiltrator frigates had their own AttackFamily that was very high on the targeting priority list of almost every ship. AttackPriorityMultiplier allows you to move the ship higher (or lower) in the targeting priority list dynamically. When bandbox attacking a group of enemy ships, ships with an AttackPriorityMultiplier are weighted more towards being attacked.


Many ships in the Balance Mod have been updated with an AttackPriorityMultiplier - capturer frigates, salvage corvettes, defenders, resourcers, etc. AI understands this system and will now attack resourcers. This system is only active during bandbox, AI, and automatic retaliation attacks, explicit player targeting overrides the multiplier.

Dynamic Target Priorities
In conjunction with AttackPriorityMultiplier, the Balance Mod updates many ships with the ability to make smarter choices when attacking ships they are less effective against.

Example of the default targeting priority of an Hiigaran Interceptor:
“Fighter, Fighter_hw1, Corvette, Corvette_hw1, Frigate, Utility, SmallCapitalShip, BigCapitalShip, Mothership”

Example of an updated targeting priority of an Hiigaran Interceptor:
“Fighter, Fighter_hw1, Corvette, Corvette_hw1, Frigate, Utility, SmallCapitalShip, BigCapitalShip, Mothership”

The extra commas create a delineation point in the targeting priority. Homeworld 2 Classic/Remastered prioritizes targets on 0 to 10000 scale (lowest is highest priority) but it’s fixed, linear and weighted by distance. Inserting blank commas into this example means that the Hiigaran Interceptor will be more likely to retarget and attack ships that it is better against (Fighter through Utility) even if they are a little further away then ships that it might be closer to (in this case Destroyers, Cruisers, Motherships). This system is designed to reduce ships from fixating on targets just because they are closer. This system is only active during bandbox, AI, and automatic retaliation attacks, explicit player targeting overrides the priority.

This is a new function in the Research system that works in conjunction with “RequiredSubsystem” and “RequiredResearch”.
RequireTag = “VaygrCorvette”,

This system allows Homeworld Remastered and mods to explicitly allow or disallow upgrading of specific ships which ships research applies to, even through family class upgrades.
Name = “CorvetteSpeedUpgrade1”,
RequiredResearch = “”,
RequiredSubSystems = “CorvetteProduction & Research”,
RequireTag = “VaygrCorvette”,
Cost = 1000,
Time = 60,
DisplayedName = “$7763”,
DisplayPriority = 201,
Description = “$7764”,
UpgradeType = Modifier,
TargetType = Family,
TargetName = “Corvette”,
UpgradeName = “MAXSPEED”,
UpgradeValue = 1.3,
Icon = Icon_Speed,
ShortDisplayedName = “$7341”,

This example allows for upgrading the speed of all corvettes (“Family”) by 30% but only to ships that are tagged as being “VaygrCorvette”. This prevents another race from donating their races corvettes to a Vaygr player and having those corvettes enjoy the same Vaygr benefits of upgrading their entire class. This also allows future mods to apply family upgrades to only certain ships, ie you could upgrade the maximum speed of all fighters except those that are not tagged (Scouts, Interceptors, Bombers but not Cloaked Fighters or Defenders, for instance).
// this goes in a research lua
RequireTag = “xxx”,

// inside any given ship’s folder, in a folder called ‘Tags’ (or a sub-folder for that Game Rule), any .lua file can contain tags
Tags = “xxx,yyy,zzz”

RequireTag only supports one tag but a ship can contain multiple tags.
// this is what the tags of the Vaygr_Carrier look like
Tags = “VaygrCapital,VaygrBuilder”

In this example the Vaygr Carrier can have its health and speed upgraded (via a “VaygrCapital” RequireTag) and also have its build speed improved (via a separate “VaygrBuilder” RequireTag). The Balance Mod updates many ships with preset tags for future use by modders.

This system allows for the specificity of the invulnerability and collision of missiles/torpedos for X number of seconds after launch.


Any missile/torpedo with a noCollisonTime set will have its invulnerability flag set and collsion disabled for the specified time. Vaygr Missile Corvette wingmen and Taiidan pilots who foolishly fly too close to a Taiidan Missile Destroyer are particularly grateful for this new technology.

Taiidan Field Frigates now utilize this new system which allows for the fulltime projection of a protective magnetic field.
// this ability is inserted into a .ship file
addMagneticField(NewShipType,, , , , , , , , )

// weapon penetrations can be defined against this field type
setMagneticFieldPenetration(NewWeaponType, , {,}, …)


New field art and hit effects have been created for this. I also fixed up the existing hit effect for the Hiigaran DefenseField that shipped with Homeworld 2 Classic/Remastered.

Note: Due to the technical difficulty creating systems capable of targeting ballistic munitions in the Homeworld 2 engine, Taiidan DefenseFighters have been updated with miniaturized versions of the Taiidan MagneticField in order to help them reclaim their original purpose.


  • New and tweaked AttackStyles for many ships
  • HW1 scouts/interceptors fly a little crazier than their more measured HW2 counterparts
  • HW1 corvettes now properly face their targets when needed and should be closer to the behavior of their original intent

This attackstyle has been updated with a few new options

        minBreakDelay = 8,
        maxBreakDelay = 12,

If set (defaults to inactive) the break distance will be a factor of time instead of the break distance.

        approachAngle = 17,
        approachFloor = 1700,

These are used to describe how far the unit’s weapons can adjust from ship heading, as well as the ‘min distance’ to stay off-axis. Less than ‘floor’ and the weapons are unlikely on target. Should be some fraction of max Weapon engagement distance.

Parade Data:

  • New parade data for Vaygr to minimize ships turning into each other and helps prevent the shipyard from hyperspacing in out of the playspace on smaller maps where the mothership spawns close to the edge
  • New parade data for Taiidan to minimize certain edge cases of the carrier hyperspacing in and becoming stuck

Starting Fleets:

  • Vaygr now begins a multiplayer game with 7 resourcers to compensate for the Vaygr Mothership’s large collision necessitating resourcing dock paths to extend further from the ship than other motherships. More on Vaygr resourcing later.


  • Familylist.lua updated:
    - New Attack families added for HW1 fighters and corvettes
    - New Armor families added for HW1 fighters, corvettes and gravitywells
    - New Unitcap families for:
    - Defenders
    - DefenseFighters
    - CloakedFighters

Before anyone asks:
- No, formation changes are not part of the Balance Mod. Any improvements there will be part of a future patch, which BitVenom has noted could be a major change to the engine. Keeping them apart for right now reduces complexity and helps everyone focus!


Runs around screaming

Also first?

:grinning: :sob:


Awesume! :smile:

1 Like

Nice, thanks for the testing guys Alpha_1_SLS, BlackBaps, Cloaked, Kadeshi, P3G4SU5, and ratamaq.



1 Like

Time for some fun! Can’t wait for everyone to play this!

Ooh, need to play around with this one :smiley:

This could definitely help with a “shield” system, projectiles would not be collected on your own shield bubble collision mesh (or a subsystem’s shield bubble collision mesh) any more! Is there any proviso for bullets/beams etc?

Who’s up for a game tonight!? :smiley:


Freakin’ A. I can’t wait to dig into the attackstyles, and so much else.

Also thank you for the detailed changelog!

1 Like


have to check it out, great!

To play it online just insert the -mpbeta command, like this:


I just want to say that I think my name really shouldn’t be up there, I came in late to the testing and was far less active than all the others listed. While I did assist a little I feel I did far less in helping than all of the others so I just want to say thanks to the following for doing all the actual REAL work:



Well, they seem to be preforming better, maybe, even if it’s… messy.

It is pretty much like in hw1, that missile shower is so pretty =D

If you add this to the steam properties you wont have to do it every time you start it.

Lol, I’d hate to be those 2 fighters

A first skirmish game. My first impression is that the whole Frigate / Destroyer / Battlecruiser balance feels healthier (that’s a good word for that). I also love the new Assault Frigates, they’re actually really good now, maybe I simply just did not expect that. :slight_smile:

One thing I don’t get is that the Vaygr BC shows 3869 DPS while the Hiigaran one 4640 DPS. Is that because of Trinity Alpha damage, or because of the kiting thing? I’m not complaining, I have a full faith in you, I’m just curious.

Excited to try this out.


I think it would be easier for some players to understand if

“Disallow Cruisers - Enable/Disable”

were written and set like this

“Allow Cruisers - Enable/Disable” with it enabled by default.

By having it written as “disallow” and disable to keep cruisers, I suspect some players might get confused on whether it should be enabled or disabled.