Config File

All the Scorpion tools are at varying levels just UI to generate a configuration file. This configuration file is the what is ultimatley passed to the Scorpion build system to generate the final binary.

When using the CLI, you can modify the configuration file directly to change the settings, without any UI. This is the most advanced way of modifying Scorpion settings and should only be used by those comfortable with the inner workings of Scorpion.

The configuration file is a JSON file that is heavily validated. We check every value to make sure it’s semi reasonable. You can still do stupid things, but we try to catch as many as possible.

If there is a feature you do not wish to utilize, you can simply remove the entire section from the configuration file. As such, the following configuration is completley valid:

{
  "rpm_limit": {
    "limit": 7300,
    "instrument": 7300
  }
}

Please refer to the documentation for each feature to understand the available options before modifying them.

A sample configuration file can look like this:

{
  "launch_control": {
    "enabled": true,
    "adjustable": {
      "enabled": true,
      "maps": 3
    },
    "ignition": {
      "advance": {
        "enabled": true,
        "amount": [10, 10, 10]
      },
      "retard": {
        "enabled": true,
        "amount": [-15, -15, -15],
        "start_rpm": [2200, 2500, 2700],
        "min_time": [300, 300, 300],
        "stop_rpm": [2000, 2300, 2500],
        "enrichment": {
          "enabled": true,
          "amount": 20
        }
      },
      "cut": {
        "enabled": true,
        "mode": "dwell",
        "rpm": [2500, 2800, 3000],
        "amount": 1
      }
    },
    "staging_mil": {
      "enabled": true
    }
  },
  "traction_control": {
    "enabled": false,
    "wheel_slip_mode": "avg",
    "min_pedal": 50,
    "mil": {
      "enabled": true
    },
    "wheel_slip_torque": [
      {
        "rpm": 0,
        "min_wheel_slip": 20,
        "max_wheel_slip": 100,
        "min_torque_limit": 0,
        "max_torque_limit": 700
      },
      {
        "rpm": 2000,
        "min_wheel_slip": 15,
        "max_wheel_slip": 150,
        "min_torque_limit": 0,
        "max_torque_limit": 500
      },
      {
        "rpm": 4000,
        "min_wheel_slip": 15,
        "max_wheel_slip": 150,
        "min_torque_limit": 0,
        "max_torque_limit": 1000
      }
    ]
  },
  "watchdog": {
    "enabled": true,
    "mil": {
      "enabled": true
    },
    "limp_mode": {
      "enabled": true,
      "max_time": 3000,
      "max_load": 150
    },
    "lpfp": {
      "enabled": true,
      "trigger": 350,
      "limp": true,
      "min_relative_load": 250,
      "min_time": 300
    },
    "hpfp": {
      "enabled": true,
      "trigger": 0.3,
      "limp": true,
      "min_relative_load": 250,
      "min_time": 300
    },
    "knock_avg": {
      "enabled": true,
      "trigger": -10,
      "limp": true,
      "min_relative_load": 250,
      "min_time": 100
    },
    "knock": {
      "enabled": true,
      "triggers": [-10, -10, -10, -10, -10, -10, -10, -10],
      "limp": true,
      "min_relative_load": 250,
      "min_time": 100
    },
    "overboost": {
      "enabled": true,
      "trigger": 300,
      "limp": true,
      "min_relative_load": 250,
      "min_time": 100
    },
    "stft": {
      "enabled": true,
      "trigger_rich": {
        "enabled": true,
        "value": 0.2
      },
      "trigger_lean": {
        "enabled": true,
        "value": 0.2
      },
      "limp": true,
      "min_relative_load": 300,
      "min_time": 0
    }
  },
  "flames": {
    "enabled": true,
    "time": 2500,
    "stalk": {
      "enabled": true,
      "position": 1
    },
    "enabled_gears": {
      "enabled": true,
      "gears": [2, 3, 4, 5, 6, 7, 8]
    },
    "min_entry_rpm": {
      "enabled": true,
      "rpm": 4000
    },
    "retard": {
      "enabled": true,
      "amount": -10
    },
    "enrichment": {
      "enabled": true,
      "amount": 10
    },
    "cut": {
      "enabled": true,
      "delay": 50,
      "duration": 100
    }
  },
  "antilag": {
    "enabled": true,
    "max_activation_time": {
      "enabled": true,
      "time": 3000
    },
    "activation_cooldown": {
      "enabled": true,
      "time": 10000
    },
    "rpm_hold": {
      "enabled": true,
      "mode": "fuel",
      "amount": 6
    },
    "retard": {
      "enabled": true,
      "mode": "dynamic",
      "ignition_gain": 45,
      "ignition_offset": -10,
      "min_ignition": -35,
      "max_ignition": 0
    },
    "auto_launch": {
      "enabled": true,
      "boost_target_offset": -300,
      "min_activation_time": 300,
      "stalk": 8
    },
    "trigger": {
      "enabled_maps": [0, 1, 2, 3, 4, 5, 6, 7, 8],
      "min_rpm": 3000,
      "min_pedal": 50,
      "stalk": [5, 8]
    },
    "mil": {
      "enabled": true
    },
    "enrichment": {
      "enabled": true,
      "amount": 20
    }
  },
  "pops": {
    "enabled": true,
    "duration": 500,
    "min_timing_offset": 0
  },
  "cat_heating": {
    "enabled": true,
    "duration": 75000,
    "rpm": 1300
  },
  "rpm_limit": {
    "limit": 7300,
    "instrument": 7300
  },
  "hem": {
    "enabled": true,
    "enabled_gears_normal": [1, 2, 3, 4],
    "enabled_gears_efficiency": [1, 2, 3, 4]
  },
  "dtc_off": {
    "disabledCodes": []
  }
}