Configuration Reference

Every setting in oxide-newspaperjob, explained.

All settings live in plain text files you can open with any text editor (Notepad++, VS Code, etc.). After changing a setting, restart the resource (restart oxide-newspaperjob in the server console) for it to take effect.

Which File Has What

Main Settings

File: shared/config.lua

Pay

File: shared/config/job.lua, Config.Payment

Complaints

File: shared/config/job.lua, Config.Complaints

Route Timer

File: shared/config/job.lua, Config.Timer

Cancelling a Route

File: shared/config/job.lua, Config.Cancel

Players can drop the route they're on without clocking out, using the Cancel Current Task option in the shift menu or on the delivery bike. Cancelling costs them nothing except a short wait before the next route.

Config.Cancel = {
    cooldownSeconds = 60,   -- Wait before a new route can be requested after cancelling (0 = no cooldown)
}

The wait is stored against the character, not the player's connection, so relogging does not reset it. While it's running, asking for a route tells the player how many seconds are left.

Throwing

File: shared/config/job.lua, Config.Throw

Paper Supply

File: shared/config/job.lua, Config.Supply

Pickup Animation

File: shared/config/job.lua, Config.Animations.pickup — the short packing animation played at the depot before a route starts.

Newspaper Bag

File: shared/config/job.lua, Config.NewspaperBag — the bag prop shown on the player's back during a route.

Levels

File: shared/config/levels.lua

Five levels ship by default, from Paper Carrier through Route Legend. Each entry in Config.Levels sets:

You can add, remove, or re-tune levels freely — just keep requiredDeliveries increasing from one level to the next.

Depots and Houses

File: shared/config/locations.lua

Config.Locations is a list of depots. The script ships with 2 depots and 80 delivery houses between them, and you can have as many depots as you like. Each depot entry contains:

menuCamera is only used when Config.menuStyle = 'nui'. It's the shot the player sees behind the shift menu:

Each house in deliveryZones has:

Tip: don't edit this file by hand. The in-game builder (/newspaperbuilder) places depots and houses where you're standing and exports a ready-to-paste config. See Admin.

Adding another depot

Every entry in Config.Locations is a complete, self-contained depot. Add another table entry — a new block wrapped in { } inside the list — and you get a second newspaper depot with its own worker, its own map blip, its own bike spawn, and its own set of houses. Nothing else needs to be turned on.

Two things to know before you build one:

• Houses belong to the depot they're listed under. The deliveryZones list inside a depot entry is the only set of houses that depot hands out. A player who clocks in at depot 2 is never sent to depot 1's houses, so give each depot enough houses of its own (at minimum, more than the biggest route your top level can hand out — 16 houses at level 5 in the shipped config).
• A shift belongs to the depot the player clocked in at. Slots (Config.MaxSlotsPerLocation, 3 by default) are counted per depot, so three depots means three carriers each, nine in total. Players clock out at the depot where they started.

The worker, the map blip, and the interaction prompt are all created automatically for every entry in the list — you never have to register anything by hand.

The easiest way to build one is in-game with /newspaperbuilder (see Admin): stand where you want the worker, place the bike spawn and the houses by walking to them, and the builder prints a finished depot entry you can paste straight into shared/config/locations.lua.

If you'd rather write it by hand, copy an existing entry and change the values. The shape looks like this:

Config.Locations = {
    -- ... the depots that already ship with the resource ...

    {
        name = 'Vespucci Beach Press',            -- shown on the map and in the menu
        coords = vector3(-1300.00, -1200.00, 4.5), -- where the depot worker stands
        heading = 90.0,                            -- which way the worker faces
        vehicleSpawn = vector4(-1296.00, -1204.00, 4.5, 180.0), -- where the bike appears
        menuCamera = {
            coords = vector3(-1303.00, -1203.00, 6.0),
            heading = 270.0,
            fov = 50.0,
        },
        deliveryZones = {
            { coords = vector3(-1250.00, -1150.00, 4.6), minLevel = 1, label = 'Bay City Ave' },
            { coords = vector3(-1244.00, -1142.00, 4.6), minLevel = 1, label = 'Bay City Ave' },
            -- ... add as many houses as you want ...
        },
    },
}

Save the file and restart the resource (restart oxide-newspaperjob in the server console). The new depot's blip should appear on the map right away.

The Bike

File: shared/config/vehicles.lua, Config.Vehicle

Map Icons and the Depot Worker

File: shared/config/visuals.lua

Config.DeliveryMarker controls the marker drawn around the active house target — it only appears when Config.Debug is on, as a tuning aid:

Config.Waypoints tunes the floating house indicator (the one shown by holding H): how high it floats, how it scales with distance, and how often it refreshes.

Uniforms

File: shared/config/outfits.lua

Config.NewspaperOutfitMale and Config.NewspaperOutfitFemale define the outfits as lists of clothing component and prop values. The shipped values are placeholders — set your own before enabling uniforms.

Tutorials

File: shared/config/tutorials.lua

Nine first-time tips ship by default, keyed by moment (first_clockin, first_throw_hit, first_bike_lost, and so on). Each defines an icon and the title/body text keys. Entries can optionally set a screen position and a duration in seconds — when omitted, tips show top-right for 10 seconds.

The tip text itself lives in locales/en.json, so it can be translated.

Rate Limits

The server enforces short cooldowns on player actions to block spam. These are fixed in server/main.lua (not in a config file):

Next Steps

• Features
• Installation
• Admin
• Troubleshooting