The snippet file should be named balance.<PR Number>.md.

{% unit <BlueprintID> %}
<Formatted Unit Name>
{% endunit %}
<Description> (#<PR Number>)
- <Category>:
  - <Parameter Name>: <value before> -> <value after>
  • PR Number: The number of the pull request on GitHub.
  • Description: A 1-sentence summary of the changes and then a short explanation behind the reasoning for the changes.
  • Formatted Unit Name: <UnitName>: <Tech> <Unit Role> For example: Exodus: T2 Destroyer. This is similar to the format visible in unit dbs and the in-game UI when hovering over a unit.
  • Blueprint ID: Blueprint ID of the unit. If the change is an enhancement, the Blueprint ID is enhancements/faction/name. You can find out the correct name by looking into the enhancements icon folder.
  • Category: A subheader to categorize parameters. Usually a blueprint subtable name (ex: Physics) or a weapon name.
  • Parameter Name: The name for the value that was changed. It doesn’t need to be the exact blueprint field name; it should be a name that players can understand.
  • Value before/after: The value before/after the change. If relevant, derived values like DPS can be put in parentheses after the value as such: <damage> (<dps>) -> <damage> (<dps>).

When the same change has been applied to multiple units, you can just write the group in the title. The unitID still loads the unit icon, so choose a unit that is most representative. (UEF when all factions are affected). Alternatively, or when a balance change affects multiple units in different ways, you can also put the description text first and then list the affected units with their changed stats.

Example snippets

{% unit URS0201 %}
Salem Class: T2 Destroyer
{% endunit %}
Reduced Salem’s anti-torpedo flare target check interval from 1.0s to 0.4s—the standard for anti-projectile weapons. This improves torpedo detection and flare response, especially against torpedo bombers. In turn the movement speed has been tuned down (#6339).
- Anti Torpedo:
    - Target Check Interval: 1s -> 0.4s
- Movement:
    - Max speed : 5 -> 4
{% unit UEA0102 %}
All T1 Interceptors
{% endunit %} 
Reduce the distance at which T1 Interceptors hover instead of turning when given a move order (#6342).
- Air Movement:
    - Start Turn Distance: 10 -> 5
{% unit enhancements/cybran/torp %}
Nanite Torpedo Launcher
{% endunit %}
Further increase the MuzzleSalvoSize of the Cybran ACU's Nanite Torpedo upgrade to 4, as it still had difficulties penetrating torpedo defenses after (#6476) increased it to 3. Its DPS remains unchanged (#6542).
- Torpedo weapon:
    - Damage (DPS): 60 (225) -> 45 (225)
    - Muzzle Salvo Size: 3 -> 4