> 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/integrations/framework.md).

# Framework

`rcore_housing` supports ESX, QBCore, and QBox. The framework provides player identity, jobs, banking, and the inventory bridge.

## 🔎 Auto Detection

```lua
Config.Framework = AUTO_DETECT
```

Auto detection checks the active resource list and picks the first match. Override with `Framework.ESX`, `Framework.QBCORE`, or `Framework.QBOX` only when detection is wrong.

## 🧩 Per-Framework Setup

{% tabs %}
{% tab title="ESX" %}
Resource: `es_extended`

* `rcore_housing` listens for `esx:playerLoaded` and `esx:playerLogout`.
* Society / banking uses `esx_society` and `esx_addonaccount` by default - see [society integration](/paid-resources/rcore_housing/integrations/society.md).
* Make sure ESX is started **before** `rcore_housing`.

```cfg
ensure es_extended
ensure rcore_housing_assets
ensure rcore_housing
```

{% endtab %}

{% tab title="QBCore" %}
Resource: `qb-core`

* Listens for `QBCore:Server:OnPlayerLoaded`, `QBCore:Server:OnPlayerUnload`, `QBCore:Server:OnJobUpdate`.
* Banking via `qb-banking` and `qb-management` - see [society integration](/paid-resources/rcore_housing/integrations/society.md).

```cfg
ensure qb-core
ensure rcore_housing_assets
ensure rcore_housing
```

{% endtab %}

{% tab title="QBox" %}
Resource: `qbx_core`

* Listens for the same events as QBCore (QBox preserves the `QBCore:*` event names by default).
* Banking via `qbx_management`.

```cfg
ensure qbx_core
ensure rcore_housing_assets
ensure rcore_housing
```

{% endtab %}
{% endtabs %}

## 🛡️ Admin Groups

Per-framework admin groups are defined in [integrations configuration](/paid-resources/rcore_housing/configuration/integrations.md):

| Framework | Default groups                   |
| --------- | -------------------------------- |
| ESX       | `admin`                          |
| QBCore    | `god`, `admin`, `mod`, `support` |
| QBox      | `god`, `admin`, `mod`, `support` |

Admin groups receive every `nil`-permission action in the property creator - see [Commands and Permissions](/paid-resources/rcore_housing/features/commands-and-permissions.md).

## 🛠️ Custom Event Names

If you've forked your framework and renamed events, override them in `Config.Events` - see [integrations configuration](/paid-resources/rcore_housing/configuration/integrations.md).