How does it work ?

This is very simple, yet it's quite early to use this completely...

Using any third party app/script at your disposal, you can now upload a file to the Mods Manager and use it almost as usual.

This is still early, and we don't have any turn-key solution to extract your mods. Still... We are sharing the file format, so any PowerShell Gurus, Reverse Engineering Kings, and other Software Geniuses can provide their solutions.

Online ressources to Export your mods in a compatible format :

If you have a way to extract and create a file compatible with the import format, please share it with us ! We will list them below to help everyone find a solution !

  • Mods Manager Importer (using Google Spreadsheet). : Import a player’s mods from swgoh.gg ; Cache the data until swgoh.gg re-sync the profile ; Export in our format. There's a support Discord Server : discord.gg/2AYfBf3 for all your needs. Thanks to PopGoesTheWza
  • A practical PowerShell solution for Windows users is available in this repository with a quick start tutorial
  • You can find in this same repository, a very rough mods extractor [here]https://github.com/code-pm/CrouchingRancor.ModExtractor/tree/master/Electron). Using Electron but not being compiled, you'll need to tinker with it yourself. I tested it, it works but unfortunately, packaging it is somewhat a nonsense, with a 100MB file just to extract a few mods. Thanks goes to SomeCallMeTim for his work !

Sample file

You can download a very basic file here

File Format in details :

Sample data :

[
  {
  "mod_uid":"12abc34efg56hi-",
  "slot":"square",
  "set":"speed",
  "level":"15",
  "pips":"5",
  "primaryBonusType":"Offense",
  "primaryBonusValue":"+5.88%",
  "secondaryType_1":"Speed",
  "secondaryValue_1":"+6",
  "secondaryType_2":"Potency",
  "secondaryValue_2":"+2.09%",
  "secondaryType_3":"Health",
  "secondaryValue_3":"+347",
  "secondaryType_4":"Defense %",
  "secondaryValue_4":"+1.4",
  "characterName":"Jawa Engineer"  
  },
  {"another":"one"},
  {"and":"so on"}
]

File description and possible values

The JSON file should be an array of mods object.
Don't forget to include a unique mod identifier (mod_uid), which will be needed to flag mods in the Squad Simulator
There's no need to sort the mods. just dump all of them in the (correct) file format

Describing the SET

Here's the possible values for the Sets :

  • 'health'
  • 'offense'
  • 'defense'
  • 'speed'
  • 'critchance'
  • 'critdamage'
  • 'potency'
  • 'tenacity'

Describing the Slot

Here's the possible values for the Slots :

  • 'square'
  • 'arrow'
  • 'diamond'
  • 'triangle'
  • 'circle'
  • 'cross'

Pips and Level

Flat numeric value.

  • Level : 1 to 15
  • Pips : 1 to 5 (6 and 7 are supported)

Primary Bonuses :

Labels

  • 'Protection'
  • 'Offense'
  • 'Defense'
  • 'Critical Chance'
  • 'Tenacity'
  • 'Health'
  • 'Potency'
  • 'Speed'
  • 'Critical Damage'
  • 'Accuracy'
  • 'Critical Avoidance'

Values

  • '+26' (ex: Speed Arrow)
  • '+23.5%' (ex: Protection Circle)

Secondary Bonuses

Labels

  • 'Critical Chance'
  • 'Speed'
  • 'Offense'
  • 'Offense %'
  • 'Defense'
  • 'Health %'
  • 'Protection %'
  • 'Potency'
  • 'Defense %'
  • 'Tenacity'
  • 'Protection'
  • 'Health'

Values

  • '+1.46%' (ex: 'Potency' secondary bonus)
  • '+6' (ex: 'Speed' secondary bonus)
  • '+64' (ex: 'Offense' secondary bonus)
  • '+482' (ex: 'Health' secondary bonus)
  • '+2.16' (ex: 'Protection %' secondary bonus)

Warning : Percentage and whole values

Some secondary bonuses have either percentage or whole values :

  • Health
  • Protection
  • Offense
  • Defense

In the case of percentage values, the bonus label must be postfixed with the string " %" (i.e. "Health %") and the "%" character should be dropped from the value

This will enable correct filtering and mod rating calculation.

example :

{
  "...",
  "secondaryType_1":"Defense",
  "secondaryValue_1":"+6",**
  "..."
  "secondaryType_4":"Defense %",
  "secondaryValue_4":"+1.4",
  "...."  
  }