The folder is not named qs-scoreboard. The script checks its own name on start and stops the server on purpose. Stop the server, rename the folder back to qs-scoreboard, fix the ensure line in server.cfg, and start again.

Work down the list:

• ox_lib must start before Scoreboard — the key is registered through it.

• The player may have rebound it under Settings → Key Bindings → FiveM.

• Another script — often an old scoreboard — may use the same key.

• With Config.ModifyKey = true the key mapping is ignored and only Config.NewKeyNumber opens it.

• Presses within Config.CooldownTime of the last one are ignored.

If none of these apply, open the F8 console and the server console — the next two entries cover the errors you may find there.

No framework was detected, so there is no bridge to read players from. es_extended, qb-core or qbx_core must start before Scoreboard. A core under another name must be added to the detection list — see Integrations.

A config entry is malformed. Every entry of Config.IllegalActions and Config.DisplayedJobs needs a numeric order, and minimumPolice must be a number, not text in quotes. Leave Config.CurrentPoliceExport as nil or a plain number.

Correct behaviour of FiveM key mappings: the default only applies to players who have never had the binding. Everyone who joined before keeps their key, and can change it under Settings → Key Bindings → FiveM. For a key nobody can change, use Config.ModifyKey — see Keybinds and Exports.

While the search box has the focus, no key closes the window — click outside it, or press the ESC button. With Config.ModifyKey = true, Config.NewKey must match the key exactly as the interface sees it: "e", not "E" or 38. Escape always works.

The icon sets and fonts are loaded from public CDNs when the window opens; a firewall or filter on the player's connection that blocks them leaves blank icons. If only one icon is missing, check that its class exists in Font Awesome 6 Free.

The interface hit an error and shows it rather than a blank screen. One known cause is a Quasar job table where the player's experience is empty (NULL) — give that row a number. Otherwise, screenshot the whole box and include it in a ticket.

Their job is not in Config.DisplayablePlayerJobs. Add the job's name exactly as the framework stores it — police, not Police. Anything not listed shows Config.DefaultJobName.

The job is displayed but has no entry in Config.PlayerJobs. Add one with a label and an icon.

The shipped config sets playerDutyExport = false for police and taxi, which always means Off. Set it to nil to use Config.DefaultDuty, or point it at your duty export.

gradeExport in Config.PlayerJobs is plain text appended to the label, not a lookup of each player's grade. Set it to nil to show the label alone.

Config.DisplayFivemName = true is the shipped default. Set it to false. If every name reads Config.HiddenName, Config.HideNames is on.

sv_maxclients is not set in server.cfg, so Config.MaxPlayers is used. Set either one to your real slot count.

Without an export, the count only sees jobs in Config.DisplayablePlayerJobs — and taxi, electrician, fisher and firefighter are not on that list in the shipped config. Add them, or give the job an onDutyExport. With an export, 0 means the call failed: check that the resource is started and that resource and fn are spelled exactly.

The police count is online players whose job is in both Config.PoliceJobNames and Config.DisplayablePlayerJobs — check both. Pacific needs 10 by default. And keep Config.CurrentPoliceExport at nil: a number there replaces the count.

Correct behaviour. Officers are counted while they are online with a police job; the count does not ask whether they are on shift.

The cards show the name, the status and the officer count. description is kept in the config for reference only.

It shows only in full screen, only with Config.ShowJobLevels = true, and only when the player has a row in at least one started Quasar job. A player who joined after the last refresh appears on the next one.

Levels are re-read every Config.UpdateJobExperienceTime minutes (5). Lower it for faster updates — but every refresh queries each started job for every online player, so on a busy server keep it at a few minutes.

The job's baseExperience and growthFactor in Config.JobsProgress do not match Config.LevelExperience in that job's own config. Copy the two numbers across.

Only the twelve supported resources are read, and only under their original folder names — qs-fishingjob, not qs-fishing. The full list is in Installation.

The folder is not named qs-scoreboard. The script checks its own name on start and stops the server on purpose. Stop the server, rename the folder back to qs-scoreboard, fix the ensure line in server.cfg, and start again.

Work down the list:

• ox_lib must start before Scoreboard — the key is registered through it.

• The player may have rebound it under Settings → Key Bindings → FiveM.

• Another script — often an old scoreboard — may use the same key.

• With Config.ModifyKey = true the key mapping is ignored and only Config.NewKeyNumber opens it.

• Presses within Config.CooldownTime of the last one are ignored.

If none of these apply, open the F8 console and the server console — the next two entries cover the errors you may find there.

No framework was detected, so there is no bridge to read players from. es_extended, qb-core or qbx_core must start before Scoreboard. A core under another name must be added to the detection list — see Integrations.

A config entry is malformed. Every entry of Config.IllegalActions and Config.DisplayedJobs needs a numeric order, and minimumPolice must be a number, not text in quotes. Leave Config.CurrentPoliceExport as nil or a plain number.

Correct behaviour of FiveM key mappings: the default only applies to players who have never had the binding. Everyone who joined before keeps their key, and can change it under Settings → Key Bindings → FiveM. For a key nobody can change, use Config.ModifyKey — see Keybinds and Exports.

While the search box has the focus, no key closes the window — click outside it, or press the ESC button. With Config.ModifyKey = true, Config.NewKey must match the key exactly as the interface sees it: "e", not "E" or 38. Escape always works.

The icon sets and fonts are loaded from public CDNs when the window opens; a firewall or filter on the player's connection that blocks them leaves blank icons. If only one icon is missing, check that its class exists in Font Awesome 6 Free.

The interface hit an error and shows it rather than a blank screen. One known cause is a Quasar job table where the player's experience is empty (NULL) — give that row a number. Otherwise, screenshot the whole box and include it in a ticket.

Their job is not in Config.DisplayablePlayerJobs. Add the job's name exactly as the framework stores it — police, not Police. Anything not listed shows Config.DefaultJobName.

The job is displayed but has no entry in Config.PlayerJobs. Add one with a label and an icon.

The shipped config sets playerDutyExport = false for police and taxi, which always means Off. Set it to nil to use Config.DefaultDuty, or point it at your duty export.

gradeExport in Config.PlayerJobs is plain text appended to the label, not a lookup of each player's grade. Set it to nil to show the label alone.

Config.DisplayFivemName = true is the shipped default. Set it to false. If every name reads Config.HiddenName, Config.HideNames is on.

sv_maxclients is not set in server.cfg, so Config.MaxPlayers is used. Set either one to your real slot count.

Without an export, the count only sees jobs in Config.DisplayablePlayerJobs — and taxi, electrician, fisher and firefighter are not on that list in the shipped config. Add them, or give the job an onDutyExport. With an export, 0 means the call failed: check that the resource is started and that resource and fn are spelled exactly.

The police count is online players whose job is in both Config.PoliceJobNames and Config.DisplayablePlayerJobs — check both. Pacific needs 10 by default. And keep Config.CurrentPoliceExport at nil: a number there replaces the count.

Correct behaviour. Officers are counted while they are online with a police job; the count does not ask whether they are on shift.

The cards show the name, the status and the officer count. description is kept in the config for reference only.

It shows only in full screen, only with Config.ShowJobLevels = true, and only when the player has a row in at least one started Quasar job. A player who joined after the last refresh appears on the next one.

Levels are re-read every Config.UpdateJobExperienceTime minutes (5). Lower it for faster updates — but every refresh queries each started job for every online player, so on a busy server keep it at a few minutes.

The job's baseExperience and growthFactor in Config.JobsProgress do not match Config.LevelExperience in that job's own config. Copy the two numbers across.

Only the twelve supported resources are read, and only under their original folder names — qs-fishingjob, not qs-fishing. The full list is in Installation.