Multijob

Overview

Multijob lets a character keep every job they're given and switch between them. Every job change on the server is remembered, whichever script makes it, so a deputy who also runs a shop can swap between the two without asking staff.

• A jobs menu (/multijob, or /mj on its own) listing every job with its grade, the working one marked.
• /mj 2 switches straight to the 2nd job.
• Go unemployed, quit one job, or quit them all.
• A staff panel (/mjadmin) for online and offline characters, with job presets.
• An API for other scripts, and poggy_core's jobs provider, so shop and business scripts hire and fire through it.

Multijob is free. You can use it and change it on your own servers; please don't sell it or re-upload it (see LICENSE.md).

Requirements

• poggy_core (free), version 0.25.0 or newer.
• oxmysql.
• One of VORP, RSG Core or QBCore RedM (poggy_core connects the script to it).
• No other multijob running at the same time (Poggy Multijob, VORP's or RSG's own). poggy_core accepts one jobs provider.

Install

1. Download Britannia_Multijob free from playbritannia.co.
2. Put the Britannia_Multijob folder in your server's resources folder.
3. Add ensure Britannia_Multijob to server.cfg, after ensure oxmysql and ensure poggy_core.
4. If you run another multijob, remove its ensure line.
5. Set who counts as staff and your job presets in shared/config.lua (see Configuration).
6. Restart the server.

The table britannia_multijob is created automatically.

Coming from Poggy Multijob? On the first start, every saved job in the poggy_multijob table is copied across, so players keep their jobs. The old table is left untouched as a rollback.

Configuration

Settings are in shared/config.lua, and every option is commented. Text is in locales/en.lua.

server/sv_config.lua holds the Discord webhook for the staff and quit log (SvConfig.Webhook).

Commands and permissions

Staff are anyone with the ace britannia_multijob.admin, anyone in Config.AdminGroups, and poggy_core admins. For example: add_ace group.admin britannia_multijob.admin allow.

How it works

For players. The menu lists every job held, numbered, with its grade. The working one is marked. Pick a job to switch to it, or choose Go unemployed (the list is kept), Quit a job or Quit every job, each with a confirm. Quitting the job you're working puts you on Config.DefaultJob.

Every job is remembered. Whenever a script, boss menu or admin command changes a character's job, both the job they left and the one they took are saved. Online players are also saved when they open the menu and every Config.SyncInterval seconds.

The staff panel. Three ways in:

• Online players: pick a player.
• Find a character: search by name, offline characters included.
• Who holds a job: pick a job and see everyone holding it.

For any character, staff can make a job their working job, change a grade, remove a job, or add a job from the presets or by typing it in. Offline characters work too; their working job is changed in the framework's own table.

For other scripts. Server exports (call them from a thread):

local ok, reason = exports.Britannia_Multijob:AddJob(target, job, grade, label)
local ok, reason = exports.Britannia_Multijob:RemoveJob(target, job)
local ok, reason = exports.Britannia_Multijob:SetJobGrade(target, job, grade)
local has, reason = exports.Britannia_Multijob:HasJob(target, job)
local jobs, reason = exports.Britannia_Multijob:GetJobs(target)

target is an online player's server id (a number) or a character id (a string, which works offline too). It also registers as poggy_core's jobs provider, so any script using poggy_core's jobs.of, jobs.holders, jobs.add, jobs.remove or jobs.setGrade reads and changes these lists without naming this script.

Troubleshooting

The console says another script "already is" the jobs provider

Another multijob is running. Stop it (stop poggy_multijob, for example), remove its ensure line, then restart Britannia_Multijob.

Players' old jobs are missing

The copy from poggy_multijob only runs while this script's table is empty and Config.ImportPoggyMultijob = true. Check the server console for "Copied N saved job(s)".

"You are not allowed to use the staff panel."

Give the player the ace britannia_multijob.admin, or add their group to Config.AdminGroups.

A fired employee still has the job on their list

A plain "set job" is saved like any job change. Remove it from the staff panel, or have the employer's script call RemoveJob or jobs.remove.

"They already hold 3 jobs, the most allowed."

The character is at Config.MaxJobs. Remove a job first, or raise the limit.

Switching says to wait

Config.SwitchCooldown stops rapid switching. Lower it, or set it to 0.

Version history

• 1.0.0: first public release.