> For the complete documentation index, see [llms.txt](https://xeavin.gitbook.io/the-insurgents-curated-shades/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xeavin.gitbook.io/the-insurgents-curated-shades/overview/configuration.md).

# Configuration

### General

All configurable parameters are defined in the `{game}/x64/scripts/config/TheInsurgentsCuratedShadesConfig.lua` file.

This configuration file can be modified via any text editor.

### Layout

```lua
local function config(actions)
  local selection = {
    {actionId0, chance0},
    ...
  }

  return selection
end

return config
```

#### Parameters <a href="#parameters" id="parameters"></a>

The following lists all configurable parameters and their purposes:

#### `config`

A function that returns all configurable parameters.

It is called with the following arguments:

<table><thead><tr><th width="155.59991455078125">Name</th><th width="351.00006103515625">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>actions</code></td><td>A metatable that maps action names to numeric identifiers and vice versa.</td><td><code>actions.sleep</code></td></tr></tbody></table>

For more information on how these arguments can be used, you can refer to the [Name vs Identifier](/the-insurgents-curated-shades/overview/configuration/name-vs-identifier.md) page.

#### `actionId`

The identifier of the action that should be cast.

#### `chance`

The chance for the action to be chosen.

### Notes

{% hint style="warning" %}
Parameters are processed top to bottom and anything past the sum of 100 of all action chances is ignored. For example:

* If there are 3 actions with the following chances: 80%, 21%, 10%. The chance of the second one is actually 20%, not 21% and the third one is ignored.
* If there are 2 actions with the following chances: 50%, 20%. There is a 30% chance that Shades of Black will fail.
  {% endhint %}

{% hint style="info" %}
For a list of action identifiers, you can view the battlepack spreadsheet in [Resources](/the-insurgents-curated-shades/getting-started/resources.md). All actions are available, even those of foes.
{% endhint %}