Installation Guide

Step-by-step setup for oxide-pizzajob.

Prerequisites

Required resources

o-link expectations

This resource depends on your server's o-link setup for:

• player identity and character lookup
• notifications
• phone messages for shift updates (texts or mail)
• money handling
• clothing and uniform management
• fuel level setting
• vehicle keys
• targeting for NPC and vehicle interactions
• menu support when Config.menuStyle = 'menu'
• progress bars and help text

Installation

ensure ox_lib
ensure oxmysql
ensure o-link
ensure oxide-pizzajob

CREATE TABLE IF NOT EXISTS `job_progression` (
    `char_id`            VARCHAR(60)      NOT NULL,
    `job`                VARCHAR(40)      NOT NULL,
    `level`              TINYINT          NOT NULL DEFAULT 1,
    `total_count`        INT              NOT NULL DEFAULT 0,
    `daily_streak`       INT              NOT NULL DEFAULT 0,
    `last_activity_date` DATE             NULL,
    `complaints`         TINYINT UNSIGNED NOT NULL DEFAULT 0,
    `timeout_until`      DATETIME         NULL,
    PRIMARY KEY (`char_id`, `job`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Verification

Optional Setup

Phone messaging

When Config.usePhone is true (the default), the pizza shop sends the player phone messages for the welcome with their first batch of orders, vehicle destruction, going down on shift, being taken to hospital, and the detailed pay summary at clock-out. Make sure your o-link phone module is configured for the phone resource your server uses.

Supported phones: qb-phone, lb-phone, gksphone, okokPhone, qs-smartphone, qs-smartphone-pro, yseries and Oxide Phone. How the messages arrive depends on the phone:

• Text message from the shop on Oxide Phone, gksphone, okokPhone and qs-smartphone (Quasar V3).
• Mail on qb-phone, lb-phone, yseries, qs-smartphone-pro and older qs-smartphone versions.

Gigs app on Oxide Phone: if you run Oxide Phone, its Gigs app shows the pizza shops (and whether each has room), the player's current shift, and their level. While the player carries an Oxide Phone and the Gigs app is on, shift updates arrive there as Gigs notifications instead of texts. The pay summary at clock-out still arrives as a text or mail. You don't need to set anything up beyond running Oxide Phone and this job.

Config.shiftSummary still controls the immediate on-screen clock-out summary:

Config.shiftSummary = 'nui'   -- popup summary
Config.shiftSummary = 'text'  -- notification summary

Admin permission for the settings editor and builder

The /pizza settings editor and the pizza builder commands (/pizzacreate, /pizzavehicle, /pizzadeliv, /pizzaexport, and /pizzacancel) are admin-only and use the standard admin check.

If you run QBCore, Qbox, or ESX, your existing framework admins pass automatically — no extra setup is needed.

To make someone an admin manually, add them to the admin group and grant that group the admin ace in your server.cfg:

add_principal identifier.license:<their-license> group.admin
add_ace group.admin admin allow

Replace <their-license> with the player's license identifier.

Uniform customization

Notes for UI developers

The packaged web/dist build is already included and referenced by the manifest. Rebuilding the UI is only necessary if you edit files under web/src.

Next Steps