> For the complete documentation index, see [llms.txt](https://docs.sonoransoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonoransoftware.com/store/dashcam/troubleshooting.md). # Troubleshooting Resolve common Dashcam installation, eligibility, recording, permission, replay, and evidence problems. Begin with the FXServer console and confirm both resources are current. Enable debug output only temporarily on a test server. ## Dashcam will not start Confirm the exact folder names and start order: ```cfg ensure eventsCore ensure eventsDashcam ``` Each fxmanifest.lua must be directly inside its resource folder. Dashcam requires OneSync and a compatible Events Core version. Review the first eventsDashcam startup error instead of only the later follow-on messages. ## F7 does not open the terminal Confirm eventsDashcam is running, the configured Panel key is registered, and no other resource has taken the same key. Try /dashcam. If the command works, review the player's FiveM key bindings. ## The terminal opens but the evidence list is empty The list only includes recordings the player may review. Grant the appropriate dashcam.review\.own, dashcam.review\.department, or dashcam.review\.all permission, then confirm the recording has finalized. Framework users must also be on duty when their job context requires it. ## Recording is denied Check all of the following: * The driver has dashcam.record through ACE or the configured framework grade * The player is in the driver's seat * The vehicle is networked and eligible by class, model, plate, job, fleet, or inventory policy * Events Core is running and Dashcam completed startup * The trigger and request cooldowns have expired Passenger requests and stale vehicle bindings are intentionally denied. ## An automatic trigger does not start Confirm the trigger is enabled in eventsDashcam/config/config.lua and the driver is in an eligible vehicle. For collisions, verify the damage change exceeds CollisionDamageDelta. For speeding, remember SpeedMps uses metres per second. For gunshots, verify the event occurred within GunshotRadius. If a recording is already active, the trigger is added to that recording's timeline instead of creating another recording. ## F10 does not add a marker Markers require an active recording, access to that recording, and dashcam.annotate or a qualifying framework job grade. Wait for the marker cooldown before trying again. ## A user can record but cannot review Recording and review are separate permissions. Grant review\.own for personal evidence, review\.department for matching department evidence, or review\.all for broad review. Department access also requires the current framework department to match the department stored on the recording. ## Replay does not show a video file This is expected for the standard workflow. Dashcam uses structured in-game replay rather than a conventional video file. Select a recording and choose **Open Structured Replay**. Encoded video generation or upload requires a separately configured compatible processing setup. ## Replay is empty or stops Check the Events Core console for finalization, storage, reconstruction, or permission errors. Confirm eventsCore/data/recordings is writable and has available disk space. Create a new short recording with the shipped capture settings before increasing limits or testing custom integrations. ## A replay view is positioned incorrectly Vehicle layouts and bone positions can vary between custom models. Adjust the matching view in eventsDashcam/config/cameras.lua on a test server, then verify every view on every supported vehicle model. Keep all six unique view IDs. ## Classification or custody actions are denied Evidence access alone does not grant every action. Check dashcam.annotate, dashcam.classify, dashcam.archive, dashcam.lock, and dashcam.delete separately. Locked records cannot be edited or deleted, and protected records cannot be deleted. ## Retention is not what you expected Changing classification applies the matching value from eventsDashcam/config/retention.lua. A value of 0 means no automatic expiry. To change retention manually, confirm the reviewer has dashcam.archive and the requested value is between 0 and 3,650 days. ## Problems after an update Replace both resources as complete packages, merge supported customer configuration into the new files, and start Events Core before Dashcam. Do not mix protected runtime files from different versions or restore old configuration without comparing its schema. ## Still need help? Collect the relevant startup and error lines, installed resource versions, reproduction steps, vehicle model and plate, permission method, and the trigger or evidence action that failed. Remove tokens, webhooks, player identifiers, and other private information before contacting [Sonoran Software support](https://support.sonoransoftware.com/). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.sonoransoftware.com/store/dashcam/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.