Browse documentationqbx_properties
On this page
Resource guide

qbx_properties

Property ownership connected to practical garage access.

QboxOX LibOX MySQLOX InventoryLunar Garageqbx_garages
Resource page View source
Version
v0.0.1
Updated
Aug 15, 2026
License
GPL-3.0
01 / OVERVIEW

Start here

This Qbox property-system build adds a fuller garage workflow to the upstream buying, renting, shell, stash, clothing, and realtor systems. It supports separate garage entry and parking points, optional interiors, owner and keyholder registration, property discovery blips, and legacy garage JSON normalization.

02 / REQUIREMENTS

What you need

Frameworkqbx_core
Requiredox_lib, oxmysql, ox_inventory, and illenium-appearance
GarageLunar Garage preferred; qbx_garages fallback
Optionalbob74_ipl for added IPL interior choices
03 / INSTALLATION

Install and start

  1. 01

    Place qbx_properties in resources and ensure the Qbox, OX database, inventory, and appearance dependencies are available.

  2. 02

    Start bob74_ipl first when using its extra interior entries, then start the selected garage resource.

  3. 03

    Allow the resource to load property.sql, decorations.sql, and property_garages.sql on startup, then verify the properties table schema.

  4. 04

    Test /createproperty as a realestate employee and /myproperties as an owner or keyholder before using the workflow on a live server.

Recommended start orderplain text
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure illenium-appearance
ensure bob74_ipl           # optional extra interiors
ensure lunar_garage        # preferred experimental garage path
# ensure qbx_garages       # alternative basic fallback; use one garage path
ensure qbx_properties
04 / CONFIGURATION

Configuration checkpoints

01

Confirm the complete runtime set

ox_lib, qbx_core, and oxmysql are declared in the manifest. The active stash and clothing actions also call ox_inventory and illenium-appearance exports without guards, so install and start them for a complete property flow.

02

Choose a garage path

The build prefers lunar_garage and falls back to qbx_garages registration. The interior Enter Garage flow requires Lunar and the fallback does not provide identical lifecycle behavior.

03

Review interiors

Configure property interiors and garageInteriors in config/shared.lua. Start bob74_ipl first only when the added residential, premium, or business IPL entries are enabled.

04

Allow schema initialization

The resource loads property.sql, decorations.sql, and property_garages.sql. The garage migration adds a JSON garage column when it does not already exist.

05

Preserve access rules

The /createproperty command checks for the exact realestate job. Server creation also validates the realtor's proximity and limits property-to-entry and entry-to-spawn distances to 125 meters.

05 / USAGE

Validate the resource

Create a property as a realtor

Choose an interior, enter the name, price, and optional rent interval, enable a garage if wanted, select its interior, then place the on-foot entry and vehicle parking points.

Commandsplain text
/createproperty

Validate the player workflow

Buy or rent at the door, enter the property, use stash and clothing actions, ring the doorbell, enter the garage interior when configured, then park and retrieve an authorized vehicle.

Check property discovery

Confirm available properties use their configured blips, owned and keyholder properties appear distinctly, and the property list can set a GPS route.

Commandsplain text
/myproperties
06 / TROUBLESHOOTING

Common checks

Stash or clothing actions fail

Confirm ox_inventory and illenium-appearance start before qbx_properties. These feature paths call their exports directly even though the manifest does not declare them as dependencies.

A property garage does not appear

Confirm the selected garage resource is running, the garage JSON contains valid entry and spawn coordinates, and the player is the owner or a synchronized keyholder.

Enter Garage is unavailable

That interior handoff specifically requires the compatible Lunar Garage resource and a property configured with a large or small garage interior. The qbx_garages fallback is not equivalent.

An interior preview is empty or unsafe

Remove invalid shell entries, confirm bob74_ipl is running for its added IPLs, and test every configured exit, clothing, stash, and logout coordinate before publishing the property.

07 / REFERENCE

Source and release notes

  • Older garage JSON containing one coordinate remains supported and is normalized into matching entry and spawn positions.
  • The qbx_garages fallback does not currently mirror every Lunar unregister and interior lifecycle path.
  • The preferred Lunar path remains experimental until its manifest loads the Qbox adapters correctly.
  • This is a GPL-3.0 manual derivative of Qbox-project/qbx_properties; retain Qbox Project attribution.