Bucky Housing

Preview. Bucky Housing is in development (version 0.6.0) and isn't on sale yet. This page covers what's built so far and will grow as it gets closer to release.

#Overview

Bucky Housing is a government real estate system for QBCore. Housing is run by the San Andreas Land & Housing Authority, a government job paid from the Central Reserve. Licensed agents survey land, price it by the zone's circle rate and sell homes with a signed offer and a title deed.

#Requirements

No ox_lib and no target resource: Bucky Housing brings its own freecam, gizmo, zones and tablet. Works on FiveM and FiveM Enhanced.

#Installation

1. Put bucky-housing in your resources.
2. Remove qb-houses and qb-apartments.
3. Add it to server.cfg after its dependencies:

ensure oxmysql
ensure qb-core
ensure bucky-reserve   # optional
ensure bucky-hud       # optional

ensure bucky-housing

Database tables (bh_*) are created automatically on first start. Circle rates are copied from Config.CircleRates into the database once; after that the database is the source.

#The Authority

Bucky Housing defines the realestate job itself at startup, in memory only, so qb-core/shared/jobs.lua is never edited.

• Pay: base pay per paycheck, plus the margin the agent adds on each sale. With Bucky Reserve running, salaries are paid from the Reserve through its payroll; don't also list realestate in Bucky Reserve's Config.GovernmentPayroll.Jobs.
• The roster is the source of truth. With enforceRoster, anyone given the job another way (/setjob, a boss menu) is set back.
• Live servers: on first start, everyone who already has the job joins the roster at their current grade (adoptExistingStaff).
• Hiring: citizens apply at the office kiosk, read the handbook, take a timed written test and wait for a live interview with a Director. The first Director is appointed by an admin with /restaff.

#Pricing and money flow

A new home's price is built from the government cost plus the agent's margin:

Construction rates per sq ft: basic $80, standard $120, premium $180, luxury $260. Areas are always recomputed on the server from the surveyed corners; the client's numbers are never trusted.

Citizens can also buy a listing themselves from its door. The listing agent still gets the margin if they're online; otherwise it goes to the Reserve.

#Properties

• One citizen can own up to 3 properties (Config.Property.maxOwned).
• Each property has up to 6 key holders and up to 3 extra entrances.
• Each property gets its own routing bucket, so interiors never collide.
• Plots are private: GTA's ambient pedestrians don't appear on listed or owned plots.
• Police can breach a door; it stays open until the owner locks it.
• A lost deed can be reissued for $250, paid to the Reserve.
• The office kiosk at the Arcadius Business Centre is public: anyone can browse listings, see their properties and verify a registry number.

#Commands and keys

Keys are defaults; players can rebind them under Settings → Key Bindings → FiveM.

#Configuration

Everything is in config.lua, with the interior, garage and furniture catalogues in interiors.lua, garages.lua and furniture.lua.