House Robbery

Tiered house, garage and office robbery for FiveM. Pick the lock, disable security, crack the safe, grab the loot, then sell it to a trader ped. Comes with a NUI tablet (progression, history, leaderboard, a contract marketplace), an in-game interior editor and crew co-op.

1. Dependencies

Install and ensure these before jj-houserobbery.

Required — ox_lib and oxmysql are manifest dependencies, so the server refuses to start jj-houserobbery without them:

• ox_lib
• oxmysql
• ox_inventory
• a framework: qb-core / qbx_core / es_extended / ND_Core / ox_core (auto-detected)
• a target resource: ox_target (recommended), qb-target, qtarget, interact or sleepless_interact (auto-detected)

Recommended:

• pd-safe — dial safe-cracking minigame (github.com/VHall1/pd-safe). Drop it in resources and ensure it before jj-houserobbery. Without it the safe step falls back to an ox_lib skill check.

Optional:

• jj-perks — XP/perk progression for the houserobbery category. Not a manifest dependency; must start before jj-houserobbery if you use it. Without it, jj-houserobbery runs standalone on its own built-in milestones progression.
• jj-minigames — themed security minigame. Bundled in install/jj-minigames/ — copy it into your resources and ensure it. Without it the security step falls back to an ox_lib skill check.
• jj-weaponsonback — shoulder-carry for bulky props (TVs, safes). Bundled in install/jj-weaponsonback/; auto-detected once ensured, no config.
• a dispatch resource — police alerts (ps-dispatch, qs-dispatch, cd_dispatch, origen_police, core_dispatch, kartik-mdt, or custom)
• a phone resource with group exports (e.g. yseries) — only needed if you set the crew to system = 'phone'. The default system = 'tablet' crew needs no phone.
• lb-phone — optional phone push notifications for new-contract dispatches and crew invites. Auto-detected, no config needed.

2. Drop in the resource

Place the jj-houserobbery folder in your resources directory. The folder must be named exactly jj-houserobbery — the inventory item export jj-houserobbery.openTablet depends on it.

3. Database

Import install.sql, or let the six jj_houserobbery_* tables auto-create on first boot.

If you're using jj-perks and haven't set it up yet, do that now too — its tables auto-create; follow its own installation guide for the perk_tablet item. If you're not using jj-perks, skip straight to step 4.

4. Items & images

1. Copy every entry from install/items.lua into ox_inventory/data/items.lua (inside the return { ... } table). This is all the jj_* loot items plus the jj_robbery_tablet item:

   ["jj_robbery_tablet"] = { label = 'Robbery Tablet', stack = false, weight = 1000,
       description = 'A burner tablet loaded with house-robbery contracts',
       client = { image = 'jj_robbery_tablet.png', export = 'jj-houserobbery.openTablet' } },

2. Copy the PNGs from install/images/ into ox_inventory/web/images/ (100x100, content <= 60x60).
3. Make sure the door tool exists in ox_inventory: every tier requires advancedlockpick by default (defined per tier in config/shared/tiers.lua under requiredItems.list). Register it if you don't already have it, or point requiredItems.list at a tool you do have.
4. If you're using jj-perks: register its perk_tablet item and copy its image (see the Perks installation guide). Skip this if you're running standalone.

5. server.cfg load order

Order is load-bearing. jj-houserobbery comes after the ox stack and your framework; jj-perks (if you use it) must come before jj-houserobbery.

ensure ox_lib
ensure oxmysql
ensure qb-core          # or qbx_core / es_extended / ND_Core / ox_core
ensure ox_inventory
ensure ox_target        # or another supported target resource

ensure pd-safe          # recommended: safe-cracking minigame
ensure jj-minigames     # optional: security minigame
ensure yseries          # optional: phone-group crew
ensure jj-perks         # optional: XP/perk integration, must start before jj-houserobbery if used

ensure jj-houserobbery

6. Start & verify

1. Restart the server, or ensure jj-houserobbery.
2. Give yourself the tablet: /giveitem <id> jj_robbery_tablet 1 (QBCore) or your inventory's give command.
3. Use the item — the tablet NUI should open.
4. Run /jjedit to confirm the editor loads (admin).
5. If using jj-perks: open the perks tablet, use its Admin tab to set a player's houserobbery category to level 3 (or add 1800 XP), then confirm a medium contract unlocks (needs jjhr_r3).
6. If running standalone: open the jj-houserobbery tablet's Admin > Robbers tab and set a player's rank to 3, then confirm a medium contract unlocks.

Next: head to Configuration to set up your trader, dispatch and loot tables.