The console says ore_sack / washed_ore are not in ox_inventory#
Copy the entries from install/items.lua into ox_inventory/data/items.lua and restart the server. ox_inventory reads its item list only at start. Freelance mining works without these two items, but contracts do not.
Item icons are missing#
Check Config.ImageBase. If it points at nui://ox_inventory/web/images/, the files from images/ have to be in that folder. Items created before you changed Config.ImageBase keep their old icon URL.
Using a service kit does nothing#
The item needs server = { export = 'glitch-miningJob.useServiceKit' } from install/items.lua, and the folder must be named exactly glitch-miningJob. A kit is only used up when one of your picks is below 100 condition.
The console says Config.Gems.item is not an ox_inventory item#
The Gem assessment perk hands out Config.Gems.item, which this package does not add. Set it to a gem item your server has, or to false to turn gems off.
The foreman only has Work tablet, no Talk option#
The dialogue needs rc-interactions running and the imported flow. Import rc-interactions/mining_foreman.json in /interactioneditor and press Save. The job looks for a flow named like Config.Interactions.projectName every 30 seconds and right after an editor save. Set Config.Interactions.useRcInteractions = false to always use the plain options.
Deep orders are locked for everyone#
They need mining level 12 and the mining_deep perk from glitch-xpSystem. Without glitch-xpSystem every player is level 1. Remove the two Deep entries from config/contracts.lua, or drop their perk and lower minLevel.
"Not enough of that ore is free at the site"#
A contract reserves its whole workload plus 25% of matching ore when it starts. Other crews and freelancers share the same veins, and worked-out veins take 20 to 40 minutes to recover. Add veins with /miningadmin or raise Config.Veins.reserveMax if your server has many crews.
A crew member cannot cut ore#
They need a pick. At the start of a contract the job lends a pick to anyone without one for the $100 tool deposit. A player with no pick and not enough money in the bank can still haul and wash, but cannot cut. A loaned pick only works on the contract it was lent for.
A loaned pick cannot be given away or stashed#
That is on purpose. Loaned picks stay in the borrower's inventory and go back to the company when the contract ends, or at the borrower's next login if they were offline then.
The truck does not spawn#
Something is standing in the truck bay, within 4 m of truckSpawn. The deposit is refunded straight away, and anyone on the crew can ask the foreman for a truck on the tablet once the bay is clear. A new truck takes a new deposit.
The crew cannot open the truck bed#
Only crew members of that contract can open it, standing within Config.Truck.actorRadius (8 m) of the truck. Only ore sacks and washed ore go in or out of it.
Changes to config/locations.lua do nothing#
data/locations.json exists and overrides the config. /miningadmin writes it. Delete it, or keep making changes through /miningadmin. If the console says it could not write the file, check that the data folder exists and the server can write to it.
A player says their pay is missing#
Pay that could not be given (an offline worker or a full inventory) waits in the claim locker on the foreman's tablet. If the console printed an entitlement as "mid-grant at shutdown", check the player's balance and set that row's status in mining_entitlements to paid or unclaimed by hand.
Known limits#
- The Gem assessment perk needs a gem item that is not part of this package.
- Item icons load from the Glitch Studios CDN until you change
Config.ImageBase. - Restart recovery pays only for ore already handed to the foreman. Ore in sacks, in the truck bed or in the hopper is not paid.
- Restart recovery refunds every deposit that was still held, including the truck deposit for a truck the crew had already lost before the restart.
Getting help#
Include the resource version, your qbx_core and ox_inventory versions, which optional resources you run, the steps to reproduce and any server or F8 errors in a support ticket.