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

# Common Issues

> Troubleshooting guide for R_FFA

## Players Stuck in Arena

<AccordionGroup>
  <Accordion title="Can't leave arena" icon="door-open">
    **Solutions:**

    1. Use the leave command:

       ```
       /ffaleave
       ```
    2. Check command is configured:

       ```lua theme={null}
       R.Commands = {
           leave = "ffaleave",
       }
       ```
    3. Restart the resource:

       ```
       ensure r_ffa
       ```
  </Accordion>
</AccordionGroup>

## Wager System Issues

<AccordionGroup>
  <Accordion title="Winners not receiving wagers" icon="trophy">
    **Solutions:**

    * Check server console for errors
    * Verify framework money functions work
    * Check if player was eliminated before winning
  </Accordion>
</AccordionGroup>

## Weapon Issues

<AccordionGroup>
  <Accordion title="Weapons not spawning" icon="gun">
    **Solutions:**

    1. Verify weapon names are correct:

       ```lua theme={null}
       Weapons = {
           "weapon_pistol", -- Check exact spawn name
           "weapon_combatpistol",
       }
       ```

    2. Ensure ox\_inventory is running

    3. Test weapon spawn manually via `/ffaweapons`
  </Accordion>

  <Accordion title="Components not working" icon="screwdriver-wrench">
    **Solutions:**

    * Use `/ffacomp` command
    * Verify component images exist
    * Ensure weapons support the components
  </Accordion>
</AccordionGroup>

## Menu Issues

<AccordionGroup>
  <Accordion title="Menu won't open" icon="bars">
    **Solutions:**

    1. Check menu key:

       ```lua theme={null}
       R.MenuSettings = {
           Key = "G",
           UseRadialMenu = true,
       }
       ```
    2. Try different key (G might be used by other scripts)
    3. Ensure ox\_lib is running:

       ```cfg theme={null}
       ensure ox_lib
       ensure r_ffa
       ```
    4. Check for keybind conflicts
  </Accordion>

  <Accordion title="Radial menu not showing" icon="circle-dot">
    **Solutions:**

    * Enable radial menu:

      ```lua theme={null}
      UseRadialMenu = true
      ```
    * Or disable for context menu:

      ```lua theme={null}
      UseRadialMenu = false
      ```
    * Update ox\_lib to latest version
  </Accordion>
</AccordionGroup>

## Spawn Issues

<AccordionGroup>
  <Accordion title="Players spawning in wrong location" icon="location-dot">
    **Solutions:**

    * Verify spawn points in config:

      ```lua theme={null}
      SpawnPoints = {
          vec3(x, y, z), -- Check coordinates
          vec3(x, y, z),
      }
      ```
    * Ensure coordinates are valid
    * Add more spawn points to avoid overlap
    * Check if using correct arena MapId
  </Accordion>

  <Accordion title="1v1 spawns not working" icon="users">
    **Solutions:**

    1. Enable 1v1 mode:

       ```lua theme={null}
       Is1v1Map = true
       ```
    2. Configure both spawns:

       ```lua theme={null}
       P1Spawn = vector3(x, y, z),
       P2Spawn = vector3(x, y, z),
       ```
    3. Ensure spawns are in the arena zone
  </Accordion>
</AccordionGroup>

## Admin Issues

<AccordionGroup>
  <Accordion title="Admin command not working" icon="shield">
    **Solutions:**

    1. Verify admin permission:

       ```lua theme={null}
       R.AdminGroupd = "group.mod"
       ```
    2. Ensure you have the needed permissions
    3. Try the command:

       ```
       /ffaadmin
       ```
  </Accordion>
</AccordionGroup>

<Card title="General Quick Fixes" icon="wrench" href="/quickstart">
  Check general troubleshooting guide
</Card>
