> For the complete documentation index, see [llms.txt](https://infinity-labs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinity-labs.gitbook.io/docs/free-scripts/il-alliances/config-options.md).

# Config Options

### Configuration (`config.lua`)

| Option                    | Default                     | Description                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Config.Debug`            | `false`                     | Enables the `/allianceseed` testing command (see below). Leave `false` in production.                                                                                                                                                                                                                                                                                                                     |
| `Config.Command`          | `'alliance'`                | The chat command that opens the UI (`/alliance`).                                                                                                                                                                                                                                                                                                                                                         |
| `Config.IncludedJobs`     | `{ 'police', 'ambulance' }` | Job names (must match your `qb-core` shared jobs) that count as factions alongside gangs. Add your own custom job names here, or set to `{}` to disable job factions entirely — gangs still work either way.                                                                                                                                                                                              |
| `Config.DefaultStatus`    | `'neutral'`                 | The status assumed between two factions that have never interacted.                                                                                                                                                                                                                                                                                                                                       |
| `Config.StatusColors`     | —                           | Maps each status to a CSS variable in `html/style.css`. Only needs editing if you're re-theming the UI.                                                                                                                                                                                                                                                                                                   |
| `Config.FactionLogos`     | `{}`                        | Optional logo images per faction, keyed by full faction id (e.g. `['gang:ballas'] = 'images/ballas.png'`). Path is relative to `html/`. Drop your images in `html/images/` and add a matching wildcard to `fxmanifest.lua`'s `files{}` block if you use a file type other than `.png`/`.webp` (both are already included). Any faction without a configured logo falls back to a generated letter avatar. |
| `Config.Webhook.url`      | `''`                        | A Discord webhook URL. Leave empty to disable — the webhook is fully optional and off by default.                                                                                                                                                                                                                                                                                                         |
| `Config.Webhook.username` | `'Alliance Log'`            | The name Discord shows for webhook messages.                                                                                                                                                                                                                                                                                                                                                              |

**A player's faction** is resolved as: their real gang if they're in one, otherwise their job if it's in `Config.IncludedJobs`, otherwise they have no faction and `/alliance` won't open for them.