Installation Guide

Prerequisites

Required Resources

o-link Features Used

This resource uses o-link for:

• callbacks
• character identity lookups
• notifications
• phone/email delivery
• local entity targets
• help text
• progress bars
• context menus
• clothing appearance changes
• fuel and vehicle key helpers
• money transactions
• player-ready / player-unload lifecycle events

Make sure your o-link installation is working before starting this resource.

Installation

ensure ox_lib
ensure oxmysql
ensure o-link
ensure xsound
ensure oxide-landscapingjob

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;

Config.Debug = false
Config.usePhone = true
Config.shiftSummary = 'text'
Config.menuStyle = 'nui'
Config.MaxSlotsPerLocation = 3

Verification

Startup Check

Start your server and watch the console. On a healthy startup you will see a resourceInitialized log line from oxide-landscapingjob (if you use oxide-logger with file or Discord logging, it appears there instead of the console).

If a required resource (o-link, ox_lib, or oxmysql) is missing or started in the wrong order, you will instead see a clear red error from oxide-landscapingjob telling you which one — fix that and restart.

In-Game Check

Mowing Check

Optional Setup

Phone / Email Shift Messages

When Config.usePhone = true, the job sends players service emails for the shift welcome message and the end-of-shift pay summary.

These messages are delivered through o-link, which supports popular phone resources like qb-phone, lb-phone, gksphone, okokPhone, qs-smartphone, and yseries. If your server doesn't run a supported phone, the emails simply won't arrive — set Config.usePhone = false so players aren't left waiting on messages. Important moments (pay received, van destroyed, etc.) always also show as regular on-screen notifications, with or without a phone.

Shift Summary Mode

Config.shiftSummary controls how the end-of-shift summary is delivered:

• "text": send the summary through the phone/email flow
• "nui": show the summary in the NUI flow

Menu Mode

Config.menuStyle controls the manager UI:

• "nui": Vue NUI shift menu, default
• "menu": o-link context menu fallback

Uniforms

Uniform support is controlled in shared/config/outfits.lua:

Config.uniformsEnabled = true

When enabled, players can equip and remove uniforms from the shift menu while clocked in.

Admin Permission for the Yard Builder

The yard builder commands (for creating your own offices and yards) require admin permission. Add this line to your server.cfg:

add_ace group.admin admin allow

This gives everyone in your admin group access to the builder commands. Standard QBCore/QBX/ESX admins pass the check automatically. See the Admin Commands Reference for the full command list.

Next Steps