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

# Troubleshooting

Use these fixes when `rcore_housing` does not work as expected.

<details>

<summary>Players are evicted minutes after listing rent</summary>

**Cause:** `Config.Billing.TestMode` is left on. Cycle, grace, and in-game grace are all interpreted in seconds.

**Fix:**

```lua
Config.Billing.TestMode = false
```

Restart `rcore_housing`. See [billing configuration](/paid-resources/rcore_housing/configuration/billing.md).

</details>

<details>

<summary>Furniture delivery never arrives</summary>

**Cause:** Either the property has no DELIVERY zone, or `Config.Furniture.DeliverySystem = FURNITURE_DELIVERY.REALISTIC` and the delivery time hasn't elapsed (5 minutes by default).

**Fix:**

* Add a DELIVERY zone to the property - open `/housing` → property → edit zones.
* Or switch to `FURNITURE_DELIVERY.SIMPLE` for instant delivery while testing.

See [Furniture Delivery](/paid-resources/rcore_housing/features/furniture-delivery.md).

</details>

<details>

<summary>Alarm fires but no dispatch alert appears</summary>

**Cause:** `Config.Alarm.Dispatch.Enable = false`, or the police job names don't match.

**Fix:**

```lua
Config.Alarm.Dispatch.Enable = true
Config.Alarm.Dispatch.Jobs   = { 'police', 'sheriff' }
```

Match the job names to your framework. See [security configuration](/paid-resources/rcore_housing/configuration/security.md).

</details>

<details>

<summary>Sale signs are not visible</summary>

**Cause:** Either signs are disabled or the render distance is too low.

**Fix:**

```lua
Config.SaleSign.Enable         = true
Config.SaleSign.RenderDistance = 100.0
```

See [Sale Signs](/paid-resources/rcore_housing/features/sale-signs.md).

</details>

<details>

<summary>`/housing` page is blank for an agent</summary>

**Cause:** The agent's job grade is below the minimum required by `Config.PropertyCreator.Permissions` for that page.

**Fix:** Raise the agent's grade, or lower the threshold for the relevant `PAGE_*` permission. Admin groups (`Config.PropertyCreator.AdminGroups`) bypass these checks. See [Commands and Permissions](/paid-resources/rcore_housing/features/commands-and-permissions.md).

</details>

<details>

<summary>Auto-detection picked the wrong inventory / framework</summary>

**Cause:** Multiple competing resources are running, or your fork has a different resource name.

**Fix:** Override the bridge explicitly:

```lua
Config.Inventory = Inventory.OX
Config.Framework = Framework.QBCORE
```

Check the startup order in `server.cfg` - every bridge dependency must `ensure` before `rcore_housing`. See [main config](/paid-resources/rcore_housing/configuration/config.md).

</details>

<details>

<summary>Lockpicking is too easy or too hard</summary>

**Cause:** Default minigame difficulty doesn't match your gameplay target.

**Fix:** Edit `Config.Raid.Lockpick.MinigameConfig[0-3]` in `configs/config.raid.lua`. Indices `0` to `3` map to the property's Anti-Burglary Door upgrade level. See [raid configuration](/paid-resources/rcore_housing/configuration/raid.md).

</details>

<details>

<summary>A roommate cannot open `/peditor`</summary>

**Cause:** They lack the Furniture editor permission on the property's access list.

**Fix:** Owner opens `/housing` → property → **Access** → toggle Furniture permissions for the member. See [Access and Permissions](/paid-resources/rcore_housing/features/access-and-permissions.md).

</details>

<details>

<summary>I need more detailed logs</summary>

**Fix:** Enable debug, then optionally restrict to specific channels:

```lua
Config.Debug = true
Config.UseDebugLevels = true
Config.DebugLevels = { 'DEBUG', 'DB', 'BRIDGE' }
```

Restart `rcore_housing`. For React/NUI logs, also set `Config.DebugFrontend = true`. See [Debug Console](/paid-resources/rcore_housing/features/debug-console.md) for the live three-lane console.

</details>

<details>

<summary>Furniture image gallery is broken on listings</summary>

**Cause:** `Config.MarketPlace.ImageService.Enable = false`, or the image storage is unreachable.

**Fix:**

```lua
Config.MarketPlace.ImageService.Enable = true
```

If you require images, set `RequireThumbnail = true` or `Validation.RequireImages = true`. See [marketplace configuration](/paid-resources/rcore_housing/configuration/marketplace.md).

</details>

<details>

<summary>Owner SMS never arrives on alarm</summary>

**Cause:** Either the phone bridge is Standalone (SMS silently dropped) or the owner hasn't completed PIN registration.

**Fix:**

* Confirm a supported phone resource (`lb-phone`, `npwd`) is running. See [phone integration](/paid-resources/rcore_housing/integrations/phone.md).
* Owner opens `/housing` → property → **Alarm** → register a phone number and confirm the PIN within `Config.Alarm.Owner.CodeExpiry` seconds.

</details>