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

# Business

Edit `rcore_housing/configs/config.business.lua` to define real estate agency jobs and grade permissions.

## 🔌 Master Switch

```lua
Config.Business.Enable = true
```

Set to `false` to disable the entire business/job system. Players keep their personal properties but `/realestate` is hidden.

## 🗂️ Permission Map

`Config.Business.PermissionMap` defines five permission categories, each with one or more actions. Every action has a `default` value applied to newly created grades.

| Category       | Actions                                               |
| -------------- | ----------------------------------------------------- |
| `dashboard`    | `view`                                                |
| `properties`   | `view`, `manage`                                      |
| `listings`     | `create`, `modify`, `delete`                          |
| `transactions` | `sell`, `buy`, `rent`, `terminate_rental`, `transfer` |
| `boss_menu`    | `access`, `manage_employees`, `manage_finances`       |

Example structure:

```lua
listings = {
    label       = 'Listings',
    description = 'Create and manage property listings',
    actions = {
        create = { label = 'Create Listing', description = 'List properties for sale/rent', default = false },
        modify = { label = 'Modify Listing', description = 'Edit existing listings',          default = false },
        delete = { label = 'Delete Listing', description = 'Remove listings',                  default = false },
    },
},
```

Only `dashboard.view` and `properties.view` default to `true`. Everything else must be granted per grade from the boss menu.

## 🧑‍💼 Jobs

```lua
Config.Business.Jobs = {
    ['realestate'] = {
        Label   = 'Real Estate Agency',
        Society = 'society_realestate',
        Blip = {
            enable = false,
            coords = vector3(-141.29, -620.94, 168.82),
            sprite = 475,
            color  = 47,
            label  = 'Real Estate Office',
        },
    },
}
```

| Field     | Description                                          |
| --------- | ---------------------------------------------------- |
| `Label`   | Display name shown in the UI.                        |
| `Society` | Society / boss-menu account linked to this job.      |
| `Blip`    | Optional office blip (set `enable = false` to hide). |

Add more entries with the same shape to register additional agencies. The job key must match the framework job name. See the [society integration](/paid-resources/rcore_housing/integrations/society.md) for picking the right society account format per banking resource.