> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youba.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Common issues

> Resolve common installation, permissions, inventory, evidence, and monitoring problems.

Use this page to diagnose the most common setup and integration problems.

<AccordionGroup>
  <Accordion title="The admin menu says access is denied" icon="shield-x">
    Add the correct license or Discord identifier to `Config.Owners` in `editable/server.lua`. Restart `yb-admin` after changing bootstrap owners. If you use ACE, verify the principal is `yb-admin.group.<groupname>`.
  </Accordion>

  <Accordion title="The mini menu opens, but actions do not work" icon="power">
    Select **Go On Duty** first. Confirm the assigned group contains `admin.open` and the permission required by the selected action.
  </Accordion>

  <Accordion title="The UI is blank, old, or unstyled" icon="panel-top-close">
    FiveM loads `web/dist`, not `web/src`. Rebuild the production interface after frontend changes:

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    cd web
    npm install
    npm run build
    ```

    Restart `yb-admin` after the build completes.
  </Accordion>

  <Accordion title="The wrong framework is detected" icon="blocks">
    Set `Config.Framework` to `qbox`, `qb`, or `esx`. Update `Config.FrameworkResources` if the resource was renamed. Start the framework before `yb-admin`.
  </Accordion>

  <Accordion title="Staff, settings, bans, or jails do not persist" icon="database-zap">
    Start `oxmysql` before `yb-admin` and verify the database connection. No SQL import is required. Reports and panel logs are intentionally cleared on resource start when their `clearOnResourceStart` option is enabled.
  </Accordion>

  <Accordion title="Discord logs or evidence are not sent" icon="webhook-off">
    Set a valid URL in `editable/server/webhooks.lua`. Confirm `Config.DiscordLogs.enabled` is true and the category has a URL or a valid default fallback. Report evidence uses the `screenshots` route.
  </Accordion>

  <Accordion title="A screenshot provider is unavailable" icon="camera-off">
    Start `screencapture` or `screenshot-basic` before YB Admin. Match the resource names in `Config.Screenshot.resources`. Use `provider = 'auto'` for automatic selection. Video evidence requires `screencapture`.
  </Accordion>

  <Accordion title="Live screen view stays on Connecting" icon="screen-share-off">
    Confirm both players are online and can reach external signaling services. Check firewalls and restrictive networks. Lower capture width, height, frame rate, or bitrate on weak connections. The viewer also needs `admin.monitoring.view`.
  </Accordion>

  <Accordion title="Reports or report chat do not update live" icon="message-circle-warning">
    Ensure every client uses the same current resource build. Do not mix an older `web/dist` with newer Lua files. Restart the resource and reconnect affected clients after updating.
  </Accordion>

  <Accordion title="QBox properties or apartment money are missing" icon="house-plug">
    Start `qbx_properties` and `ox_inventory`, then set:

    ```lua theme={"theme":{"light":"github-light","dark":"github-dark"}}
    Config.Economy.properties.script = 'qbx_properties'
    ```

    Saved records must use `qbx_properties_<property_name>` as the inventory name and the citizen ID as `owner`. Restart YB Admin to clear its economy cache.
  </Accordion>

  <Accordion title="Items cannot be delivered" icon="package-x">
    Start a supported inventory, verify the spawn code exists, and check the player's weight and free slots. The target must be online. The staff member needs `admin.items.view` and `admin.items.give`.
  </Accordion>

  <Accordion title="Weather or time does not change" icon="cloud-sun">
    Start the configured weather resource and verify the adapter export names in `editable/server.lua`. Renewed-Weathersync and qb-weathersync presets are included. Keep `nativeFallback = true` when no adapter is used.
  </Accordion>

  <Accordion title="Resource controls are denied" icon="server-off">
    The target may be listed in `Config.ProtectedResources`. Only owners can bypass protection when `Config.AllowOwnerProtectedResourceActions` is true.
  </Accordion>

  <Accordion title="The monitoring map is empty or inaccurate" icon="map-pinned">
    Enable OneSync and grant `admin.monitoring.view`. Check that the tile URL is reachable from FiveM. Adjust the selected projection and calibration values in `Config.Monitoring.map` when blips are offset.
  </Accordion>

  <Accordion title="Voice notes fail or cannot be played" icon="mic-off">
    Keep recordings below `Config.StaffChat.maxVoiceSeconds` and `maxVoiceBytes`. Confirm FiveM can access the microphone and every staff member is using the same rebuilt interface.
  </Accordion>

  <Accordion title="Noclip or developer tools feel slow" icon="gauge">
    Keep debug mode disabled during normal use. Avoid aggressive scanner intervals, reduce scanner radius and result limits, and close developer tools when they are not needed.
  </Accordion>
</AccordionGroup>

## Collect diagnostics

<Steps />