> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_housing/configuration/integrations.md).

# Integrations

Edit `rcore_housing/configs/config.integrations.lua` to define admin groups, boss-grade detection, and framework event names.

## 🛡️ Admin Groups

```lua
Config.AdminGroups = {
    [Framework.ESX]    = { 'admin' },
    [Framework.QBCORE] = { 'god', 'admin', 'mod', 'support' },
    [Framework.QBOX]   = { 'god', 'admin', 'mod', 'support' },
}
```

Admin groups receive every `nil`-permission action in `Config.PropertyCreator.Permissions` (see [main config](/paid-resources/rcore_housing/configuration/config.md)). Add or remove group names to match your framework setup.

## 🏷️ Job & Boss Detection

```lua
Config.Job = {
    BossGrades = {
        'chief', 'boss', 'captain', 'commander', 'director', 'superintendent',
        'chef', 'patron', 'commandant', 'commissaire', 'directeur', 'capitaine',
        'kommandant', 'direktor', 'hauptmann', 'leiter', 'vorgesetzter',
        'jefe', 'capitan', 'comandante', 'comisario', 'superintendente',
    },
    BossIncludesSecondHighest = true,
}
```

| Option                      | Description                                                                                    |
| --------------------------- | ---------------------------------------------------------------------------------------------- |
| `BossGrades`                | Grade names always treated as boss, regardless of numeric grade. Localized for EN, FR, DE, ES. |
| `BossIncludesSecondHighest` | When `true`, both the highest and second-highest grades are treated as boss.                   |

## 📡 Framework Events

`Config.Events` maps internal player-load/job-update event names to each framework's actual event names:

```lua
Config.Events[Framework.QBCORE].client = {
    playerLoaded   = 'QBCore:Client:OnPlayerLoaded',
    playerUnloaded = 'QBCore:Client:OnPlayerUnload',
    jobUpdate      = 'QBCore:Client:OnJobUpdate',
    setDuty        = 'QBCore:Client:SetDuty',
}
```

Only override these if you've forked your framework and renamed the events. The defaults match stock ESX, QBCore, and QBox.

`Config.Events.shared.addonAccount` (`esx_addonaccount:getSharedAccount`) is used to obtain ESX society accounts for the business system.