Setup and Items

Quick installation guide and required item setup for 0r-heistpack

This page covers the minimum setup required to get the script running correctly: dependencies, server.cfg start order, and required item installation.

Required Dependencies

• oxmysql

• ox_lib

• 0r_lib

Recommended server.cfg Start Order

Use a clean start order so the script loads after its dependencies:

start oxmysql
start ox_lib
start framework -- es_extended, qb-core, qbx_core, etc.
-- other resources
start 0r_lib
start 0r-heistpack

The profile table is created automatically by the script on resource start. You do not need to import SQL manually for normal setup.

Database Setup

You do not need to run a manual SQL import for this script.

The resource automatically creates the required profile table on start:

CREATE TABLE
    IF NOT EXISTS `0resmon_heist_profiles` (
        id INT AUTO_INCREMENT PRIMARY KEY,
        identifier VARCHAR(255) NOT NULL UNIQUE,
        illegal_nickname VARCHAR(255) DEFAULT NULL,
        photo INT DEFAULT 1,
        exp INT DEFAULT 0,
        credits INT DEFAULT 0,
        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
    );

That means your only job is making sure:

• oxmysql is installed and starts before 0r-heistpack

• The script starts without SQL errors in console

• You do not block the table creation with an old broken database setup

Localization Setup

This script uses ox_lib localization.

Set your server language in server.cfg:

set ox:locale "en"

If you want another language, create or edit the matching locale file by following the same structure as the default locale file included in the script.

Localization belongs to setup because it is part of the first install. You normally finish this once, then move on to scenario balancing later.

Where Do I Add The Items?

• If you use OX Inventory, add the items to ox_inventory/data/items.lua and the required weapons to ox_inventory/data/weapons.lua.

• If you use QB Core, add the items to qb-core/shared/items.lua.

• Copy the item images into the image folder used by your inventory.

• The script item images are already included in ui/build/items.

The script source also includes a generated full reference list in:

read-me/items.lua

Use that file if you want to copy the complete item list used by the resource, not only the minimum startup items shown on this page.

Make sure heistpack_tablet exists if your package uses the tablet-based access flow.

heistpack_tablet is automatically registered as a usable item by the script when Config.heistMenu.openWithItem.enabled = true in config/main.lua. If you disable item-based menu opening, the tablet item is no longer required for menu access.

OX Inventory

weapons.lua

['WEAPON_HACKINGDEVICE'] = {
	label = 'Hacking Device',
	weight = 1000,
	durability = 0.0,
},

items.lua

QB Core

shared/weapons.lua

[`WEAPON_HACKINGDEVICE`] = { name = 'weapon_hackingdevice', label = 'Hacking Device', weapontype = 'Miscellaneous', ammotype = nil, damagereason = 'Miscellaneous' },

shared/items.lua

Final Checklist

After setup, verify these points:

• 0r_lib starts without errors

• 0r-heistpack starts without errors

• The automatic database table is created without errors

• Your ox:locale value matches the locale you want to use

• Required items exist in game

• Item images load correctly

• The scenario flow can start without missing dependency errors