Common Errors

Common Errors — Miner Job | Quasar Store | Quasar Store

"Illegal mix of collations" or an empty leaderboard

The job aligns its identifier columns to your framework's collation on every start. If the database user is not allowed to ALTER, the console prints the exact statement instead — run it by hand in HeidiSQL and restart:

bash

[qs-minerjob] could not align `qs_miner`.`identifier` to utf8mb4_uca1400_ai_ci (users.identifier uses it).
  The leaderboard will fail with "Illegal mix of collations" until it matches. Run by hand:
    ALTER TABLE `qs_miner` MODIFY `identifier` varchar(46) COLLATE utf8mb4_uca1400_ai_ci NOT NULL;

I changed config.lua and nothing happened

Either the resource has not been restarted, or that setting was saved from /mineradmin and the database value wins. The panel marks it "Changed from the panel"; press Back to the file's value and restart. The console lists saved settings that no longer fit your config:

bash

[qs-minerjob] 2 saved setting(s) no longer fit this config and were ignored: ...

"You are not a miner"

The player's job is not in Config.MinerJob. On QBCore and Qbox, make sure the miner job exists in shared/jobs.lua and the player was given it. To let everyone mine, set Config.RequireJob = false.

"You need to have a pickaxe in your hand"

The pickaxe is on the belt or still in the bag. Use the item, or press Z to bring it to your hand.

Using the pickaxe item does nothing

The item definition is missing its client = { export = 'qs-minerjob.togglePickaxe' } line, or it is not usable. Copy the pickaxe entries again from Inventory Items and restart the inventory.

"You don't have enough level, you have to be level …"

Correct behaviour. Each tier of the mine has its own minimum level in Config.MinesLevels — 1, 3 and 6 by default.

"That ore is busy!"

Someone else is mining that rock. If nobody is, it frees itself when the player who claimed it leaves or gives up.

"This item does not exist: …"

The named item is in the config but not in your inventory's item list. The console says which and where:

bash

[qs-minerjob] blue_diamond is listed in Config.Minerals but no such item exists in the inventory.
[qs-minerjob] diamond_ring is configured as the result of furnace recipe Diamond Ring but no such item exists in the inventory.

Add it from Inventory Items. Buying a pickaxe that is not registered fails the same way, and no money is taken.

"Your inventory is full"

The drops did not fit. Raw ore is heavy (150–250 per unit in the shipped lists); sell or smelt some, or lower the weights in your item list. A craft that does not fit hands the materials back.

"You already have a pickaxe"

Correct behaviour — one pickaxe at a time. Use the one you have until it breaks, or destroy it from the shop to buy another.

Rocks on a custom cave map are not found

On large maps where the tiers are far apart, set Config.InstantOreCollection = true: it streams props from 500 m and searches every rock nearby instead of the nearest tier. For the K4MB1 Cave, use the commented positions under each tier and under Config.Locations.

Installation and Access#

Common Errors

Installation and Access#

Mining and Pickaxes#

Missions and Crews#

Furnace, Selling and Leaderboards#