What goes wrong most often, what it actually means, and what to do about it. Most of these are setup, not faults — and the server console or the F8 console usually says exactly which piece is missing.
Installation and Setup#
"No webhook or Fivemanage token is configured"
DEFAULT_WEBHOOK in qs-camera/server/webhook.lua is empty, and neither camera opens until it is filled in. The console says so at start. Paste a Fivemanage token — or a Discord webhook ending in ?wait=true — and restart qs-camera. See Photo Uploads.
"The photo could not be uploaded"
The picture was taken but the upload service refused it or never answered. The usual causes:
The Fivemanage token is wrong, revoked or out of quota — check it in the Fivemanage dashboard.
A Discord webhook without
?wait=trueat the end: Discord then sends back no link, so every digital photo fails. Add it.The Discord webhook was deleted.
For printed cards the server console prints Upload failed with status <code>: 401 or 403 is the token, 404 a deleted webhook.
"screenshot-basic is not running, so photos cannot be uploaded"
Add ensure screenshot-basic to server.cfg, above ensure qs-camera. Without it neither camera can take a picture.
"You have renamed the script!" every ten seconds
The folder is not called qs-camera — perhaps qs-camera-main or qs-camera-2.0.0 from the download. Rename it back and update the ensure line.
"pool.json not found in qs-camera-props; is it started before qs-camera?"
Printed in F8 when the props resource is missing, renamed or starts after the script. Cards, frames, boards and albums then show no photos. Make sure the folder is called exactly qs-camera-props and that ensure qs-camera-props comes before ensure qs-camera.
"Could not load qs_camera_frames; did you run database/sql.sql?"
The tables were never imported — the same goes for the boards line. Import sql.sql into the database oxmysql connects to, and restart. Only the settings table is created by the script on its own.
The start line says standalone, or the wrong inventory
The framework or inventory starts after Camera, and detection only sees what is already running. Move its ensure above ensure qs-camera. If it runs under another name, add that name to shared/config.lua — see Overriding Detection.
"You do not have permission to open the camera settings"
The player lacks the command.cameraconfig ace. The server console prints their name and the exact line to add. Nine times out of ten the line is in server.cfg but the server was not restarted, or the identifier belongs to another account — typing the line in the server console applies it at once.
Nobody can open /cameraconfig any more
The ace under Commands in the panel was changed to one nobody holds. Put it back from the database and restart the resource:
DELETE FROM qs_camera_settings WHERE skey = 'config_permission';"The interface is not ready yet"
The script's interface did not load on that player's game. The interface ships complete in the download; if its files are missing or half-copied, nothing opens. Download Camera again from the CFX Portal and replace the whole qs-camera folder, keeping your server/webhook.lua.
Cameras and Photos#
Using an item does nothing
On ox_inventory, the definition is missing
server = { export = 'qs-camera.useItem' }— copy it from Inventory Items.On qs-inventory or qb-inventory, the item is not marked
useable = true.The item has a different name from the one in the panel's Items section. Keep the shipped names.
The wrong inventory was detected — check the start line in the console.
"The camera is out of film" on a brand-new camera
Correct behaviour: new cameras come with an empty roll. Use a camera_film, or press Load film on the panel. To change it, switch on New bodies come loaded — or switch film off — under Wear, repair & film.
"You have no paper for the camera"
The instant camera needs at least one instant_film to open. Paper is only taken when a card is printed; Film per shot set to 0, under Instant camera, makes it free.
"That image host is not allowed"
A printed card came back from an address that is not on the Uploads list. Put back the defaults with Reset list, or add the host your upload service now answers from.
Cameras break too often
Lower Wear per photo, Base failure chance or Extra chance per wear, or switch off Sudden failures so a camera only breaks when it is worn out. Everything is under Wear, repair & film.
Old photos show 404
The address stored on the photo no longer works. Discord attachment links expire, and a file deleted from Fivemanage is gone. The item cannot be repaired — the image itself is lost. Use Fivemanage on a live server so new photos keep their pictures.
A player is stuck looking at a photo
Somebody nearby showed them a photo. It stays on their screen until they close it — ESC or the Close button. To keep shown photos to the photographer only, switch off Show to players, or lower Show radius, under Showing a photo.
Walls, Boards and Albums#
Some cards, boards or albums look blank
Correct behaviour when there are many nearby: at most 12 hung cards, 4 boards, 4 albums and 8 cards in hands show their photos at once — the closest ones. Walk closer and they fill in. If every one is blank, qs-camera-props is not started before the script — look for pool.json not found in F8.
"That is not yours to take" or "That is not your board"
Only the character who hung a card or placed a board can take it down, arrange it or pick it up. There is no admin command for somebody else's. To remove one, delete its row from qs_camera_frames or qs_camera_boards and restart qs-camera — the cards on a deleted board are lost with it.
"No wall here"
Cards and boards only hang on walls, and only within reach — 5 m for a card, 8 m for a board. Aim at a wall closer to you; the ghost turns solid when the spot is valid.
"The board is full" or "This page is full"
A board holds 28 cards and an album page 7. Raise Cards per board, Pages or Cards per page in the settings panel.
"Hanging is disabled"
Wall frames enabled is off under Wall frames. Cork boards and the card album have their own switches in their sections.
Error Keys#
The server answers refusals with a key, and the player reads the matching sentence in their own language. The ones you are most likely to meet:
Key | Player sees | Means |
|---|---|---|
| No webhook or Fivemanage token is configured |
|
| The photo could not be uploaded | The upload service refused the image or did not answer. |
| That image host is not allowed | A card's address is not on the Uploads list. |
| Wait for the last action to finish | The player's previous action is still being processed. |
| Give the camera a second | A shot came sooner than the camera's cooldown allows. |
| The camera is out of film | The roll is empty — load a |
| You have no paper for the camera | No |
| You cannot use the camera in here | Shooting from vehicles is switched off. |
| Too far away | The player is not where the server expects them — too far from a wall, a board or another player. |
| Nobody is close enough | No player within reach to give a card to. |
| They cannot carry it | The receiving inventory has no room. |
| That album has no free pockets | Every pocket of that photo album is used. |
| The interface is not ready yet | The script's interface did not load on that game. |
Still stuck? Open a ticket and include the
qs-camera v2.0.0 startedline and any red lines from the server console, your framework and inventory with their versions, and a screenshot of the F8 console for anything that happens in game.



