Troubleshooting
aty_housing: Troubleshooting
Overview · Installation · Configuration · Features and commands · Living · Home security · Economy, upgrades and the player market · Furniture, lighting and yards · Apartments, buildings and motels · Exports and events · Webhooks and migration · Troubleshooting
Troubleshooting
| Problem | Solution |
|---|---|
| The console prints a database error at start and the resource does nothing | The migration could not reach the database (it retries three times). Check that oxmysql (or your SQL resource) runs before aty_housing and that its connection string is valid, then restart aty_housing |
/housingadmin says you have no permission |
Give yourself a framework admin level or group listed in Config.AdminPermission (qb-core: qbcore.admin / qbcore.god), or add the ACE (add_ace group.admin aty_housing.admin allow) and make sure your identifier is in that group. The ACE option name is Config.AdminAce |
| An IPL property shows an empty or invisible interior | bob74_ipl is not running, or not started before the player enters. Ensure it in server.cfg |
| A player appears inside the floor or at a wrong spot in an IPL property | The catalog coordinates are unverified defaults. Capture the spawn, exit and stash points for that property in the creator (inside points must be within Config.InteriorPointRadius of the interior, otherwise point_outside_interior) |
The stash does not open (stash_unavailable) |
No supported inventory is running (aty_inventory, qb-inventory, ox_inventory, qs-inventory), or aty_lib detected an inventory without stash support. Check Admin tab > Diagnostics |
| A new owner finds the old owner's items are gone, or the old owner wants them back | Stashes are renewed on every ownership change. The old stash id is printed to the console ("previous stash ... keeps its items"); recover the items with your inventory's admin tools. Automatic clearing exists only for aty_inventory (Config.EvictionClearStash and related options) |
| Using the tablet item does nothing | The item name in your item list must equal Config.Tablet.item. On ox_inventory the item needs the client.export = 'aty_housing.useTablet' entry (docs/INSTALL-tablet-item.md). /housing works either way |
| The panel stays on screen and the mouse is stuck | Type /housingfocus |
| A player is stuck inside a property because the exit target is missing | Type /housingexit |
| A player logs in at the fallback spawn | The property they were inside was deleted and no entrance was saved with their stay. Change the spot with Config.FallbackSpawn |
| No target prompt at entrances | Start a target script (ox_target, qb-target or aty_interactions), or set Config.InteractMode = 'marker' or 'both' to use the E key at the marker. Check Config.Markers.enabled |
An action answers not_ready right after a restart |
The property cache, finance, seal or realtor data is still loading. Wait a few seconds; if it persists read the console for database errors |
| Rent, installments or bills were not charged while the player was offline | By design: nobody is charged while offline. Autopay runs only while the player is online, arrears are collected at the next login, and server downtime never counts against players |
The console prints PAYMENT UNCERTAIN |
Money was taken but the database did not confirm the change. The resource never refunds in that case: look at the property or unit named in the line and correct it by hand |
The house garage does not appear in aty_garage_v2 |
The property must be owned or rented and have a garage point (or set Config.Garage.requireGaragePoint = false). aty_garage_v2 needs a build with aty_housing support and Config.Housing.script = 'auto' (or 'aty_housing'). A police seal closes the garage |
| No "wake up at home" card in the spawn selector | aty_multicharv2 needs Config.HousingSpawn = true and the default spawn selector; the owner or tenant has to choose the property under My properties > Settings; a sealed property or one without the enter permission is not offered |
| The Decor Studio will not open, or opens read-only | The player needs the decor permission on the property, the property must not be sealed, its tier must reach Config.Decor.minTier, and in an MLO property the player must be near the stash point or entrance. Another player editing gives read-only mode until they finish |
| The gizmo handles do not react | Use /housingdecor gizmo off (mouse dragging) or set Config.Decor.gizmo = false |
| The Style tab has no controls, or a lamp keeps its warm light | Config.Colours.enabled must be true (restart after changing it). Changes need the player inside the property (not in a preview) with the decor permission, a saved lamp or switch for those scopes, and the property not sealed. With the power cut lamps stay dark and the switch key is refused |
| A yard is missing, or the Studio will not open in the garden | Config.Exterior.enabled must be true. Automatic yards exist only for IPL and shell houses whose interior is not an apartment, with no other property entrance within autoYard.minEntranceGap and no overlap with another yard; draw one with /housingyard. The player must stand in the yard (within margin metres, outside any interior) and hold the exterior permission |
| The building prompt or the directory does not appear | Config.Buildings.enabled must be true. Stand within interactRange of the lobby or a floor stop; the directory closes when you walk away. The elevator needs a floor stop on each floor you want to reach and, with elevator.restricted, a unit or key on that floor |
| A furniture item is missing or invisible | Check the console for data/props.json entry #n is invalid lines. The model must exist in your game build: Admin tab > Diagnostics lists missing models |
| A robbery cannot be started | The server checks: robbery enabled, lockpick in the inventory, the property is owned, locked, not sealed, not an MLO and not the robber's own; owner and key holders offline (targets); minPolice on duty; the time window; cooldowns of the property, the robber and the last attempt |
| Police alerts do not reach your dispatch | The resource named in Config.Robbery.dispatch must be started; otherwise 'builtin' is used and a line is printed once. For anything else use 'custom' with customDispatch |
| An officer cannot seal or raid | The officer must be on duty, in Config.PoliceJobs, at or above the grade in Config.Police.grades, and give a case number of 3 to 24 letters, digits or dashes |
| The Realtor tab is missing | The job and grade must be listed in Config.RealtorJobs (a grade below the lowest listed one is not a realtor), and with Config.Realtor.requireDuty the player must be on duty. Config.RealtorJobs is read once per start |
| The Storage units tab is empty or hidden | Config.StorageUnits.enabled must be true and data/storage_facilities.json needs at least one valid facility. Run /housingunits reload and /housingunits list and read the console |
| A text shows a raw key | The key is missing from your language file. English is the fallback, so check locales/en.lua and the feature folder of that text |
| Routing buckets collide with another script | Move Config.BucketBase (and Config.AdminBucketBase) to a range no other script uses |
Known limitations
- Stash security depends on the inventory. A property stash id contains a secret key that is renewed on every ownership change.
ox_inventorymay let a modified client open a registered stash by its id (not tested here), so there a player who has seen an id once could reopen it until the next ownership change.qs-inventoryopens stashes from the client, which is weaker still. - MLO door locks are client-side. The game's door system locks doors on each client; the server cannot stop a modified client walking through one. MLO properties also have no private instance and cannot be robbed.
- Offline players cannot be charged. No framework exposes offline money here, so debts accumulate and are collected at login.
- Decor styling is limited. Light scenes colour the game light of a lamp (and, best effort, the prop's own light), but a lamp model keeps the glow baked into it when its switch is off. Wall paint cannot be changed from the Studio: IPL homes only offer the detail sets of
data/ipl_styles.json, built shells are painted in the Shell Creator, and MLO properties have no interior style. Only 18 catalog items have colour variants. - One yard per property, shared world. A yard is one flat outline with a height band, drawn on the ground; its pieces are local objects on each player's game, so a very large number of yards or pieces near each other costs frame time (see
streamRadius,maxLoadedYards). - Coordinates that ship with the package are unverified: the 17 IPL interiors and the two example storage facilities. Check and replace them on your server.
- Interiors and catalog data are not included for shells and MLOs. Catalog thumbnails ship for 786 of the 796 items; the other 10 show a category glyph.
- Languages: English, Turkish, German, French, Spanish and Brazilian Portuguese. Furniture catalog names are English or Turkish only.
Third-party notices
docs/LICENSES.md lists every third-party component that ships inside aty_housing and every component it depends on but does not ship. It is in English and ships with the resource.