Troubleshooting

Use these fixes when rcore_housing does not work as expected.

Players are evicted minutes after listing rent

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

Fix:

Config.Billing.TestMode = false

Restart rcore_housing. See billing configuration.

Furniture delivery never arrives

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.

Alarm fires but no dispatch alert appears

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

Fix:

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

Match the job names to your framework. See security configuration.

Sale signs are not visible

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

Fix:

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

See Sale Signs.

`/housing` page is blank for an agent

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.

Auto-detection picked the wrong inventory / framework

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

Fix: Override the bridge explicitly:

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.

Lockpicking is too easy or too hard

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.

A roommate cannot open `/peditor`

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.

I need more detailed logs

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

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 for the live three-lane console.

Furniture image gallery is broken on listings

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

Fix:

Config.MarketPlace.ImageService.Enable = true

If you require images, set RequireThumbnail = true or Validation.RequireImages = true. See marketplace configuration.

Owner SMS never arrives on alarm

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.

• Owner opens /housing → property → Alarm → register a phone number and confirm the PIN within Config.Alarm.Owner.CodeExpiry seconds.