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

# Troubleshooting

> Common issues and how to fix them

<Note>
  If your error mentions the FiveM escrow system (for example "Failed to verify protected resource" or "You lack the required entitlement"), see the dedicated [Escrow errors](/jaksams-scripts/escrow-errors) page instead.
</Note>

<AccordionGroup>
  <Accordion title="Fix server crash on script start">
    If your server crashes when starting the script, it means you are using an old version of the `mysql-async` script.

    Fixing this issue is very simple and fast, you have 2 options:

    <CardGroup cols={2}>
      <Card title="Install OxMySQL" icon="database" href="https://overextended.dev/docs/oxmysql">
        **Strongly recommended.** Replaces `mysql-async` with improved performance and full compatibility, allowing an easy swap. Check the installation guide for details.
      </Card>

      <Card title="Update mysql-async" icon="download" href="https://github.com/brouznouf/fivem-mysql-async">
        **Not recommended.** Install the updated script instead of your current `mysql-async`. Be sure to rename the script folder to `mysql-async`.
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Issues with items">
    It may happen that if you have particular inventories, item addition or removal causes errors in server console.

    In this case, to try fixing the issue try doing the following steps:

    <Steps>
      <Step title="Disable item exists check">
        Go in the script folder in `integrations/sv_integrations.lua` file and set this option from

        ```lua theme={null}
                SKIP_ITEM_EXISTS_CHECK = false
        ```

        to

        ```lua theme={null}
                SKIP_ITEM_EXISTS_CHECK = true
        ```
      </Step>

      <Step title="Enable canAlwaysCarryItem">
        If the script has a `default_config.json` file, edit this option in the `"server"` section from

        ```json theme={null}
                "canAlwaysCarryItem": false,
        ```

        to

        ```json theme={null}
                "canAlwaysCarryItem": true,
        ```

        <Frame caption="Before">
          <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/can_always_carry_item_before.jpg?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=bf85c4a3cd2ecb3928d062778023526d" alt="Before" width="581" height="193" data-path="images/can_always_carry_item_before.jpg" />
        </Frame>

        <Frame caption="After">
          <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/can_always_carry_item_after.jpg?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=15a94363a2ad6f0847bb57da29959eaf" alt="After" width="540" height="168" data-path="images/can_always_carry_item_after.jpg" />
        </Frame>

        If the script has a `current_config.json` file (which is a different file from the previous one), edit the `canAlwaysCarryItem` option to `true` there as well.

        <Frame caption="Before">
          <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/current_config_can_always_carry_before-1.jpg?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=ec6a23334fe9fd4020587aa28efacecd" alt="Before" width="333" height="43" data-path="images/current_config_can_always_carry_before-1.jpg" />
        </Frame>

        <Frame caption="After">
          <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/current_config_can_always_carry_after.jpg?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=8119fab914caa11c105ff20a4cc8082e" alt="After" width="335" height="47" data-path="images/current_config_can_always_carry_after.jpg" />
        </Frame>

        <Accordion title="What to do if I don't have the canAlwaysCarryItem option?">
          If you don't have the `canAlwaysCarryItem` option, you simply need to add it. Be sure to add it at the **beginning** of the `server` part.

          <Frame caption="Before">
            <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/no_can_always_carry_item_before.jpg?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=cca225af1369fb11624cb58791bb63b1" alt="Before" width="551" height="156" data-path="images/no_can_always_carry_item_before.jpg" />
          </Frame>

          <Frame caption="After">
            <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/no_can_always_carry_item_after.jpg?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=72f7d37f914ade1946ebf0a0de34b94f" alt="After" width="520" height="165" data-path="images/no_can_always_carry_item_after.jpg" />
          </Frame>
        </Accordion>
      </Step>

      <Step title="Verify the item exists">
        The item you are working on must exist to be used in the scripts. To be sure the item exists, you can try to give it to yourself.

        Creating the item depends on your framework and/or on your inventory, so creating it will be up to you.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Manually set ESX shared object">
    On ESX, it may happen for many reasons that you encounter the following error (in F8 console or in server console):

    <Frame>
      <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/esx_shared_object_error.png?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=48d565d2542d220e44ad55786eef23e7" alt="ESX shared object error" width="453" height="39" data-path="images/esx_shared_object_error.png" />
    </Frame>

    This usually happens because the script cannot find the *ESX shared object* of your `es_extended` script automatically.

    To solve the issue, you have to find the shared object name of your `es_extended` script in the file `es_extended/client/common.lua`.

    This is an example of what you can find (you may have something else):

    <Frame>
      <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/esx_shared_object_example.png?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=2accb28f63435e86ecb1a93fdea49767" alt="ESX shared object example" width="545" height="165" data-path="images/esx_shared_object_example.png" />
    </Frame>

    After you found your *ESX shared object* name, you can manually set it in the files `integrations/sv_integrations.lua` **and** `integrations/cl_integrations.lua`, replacing `nil` with the name of your shared object **(between double quotes)**.

    Do **not** replace the left side, only replace the right side.

    An example:

    <Frame>
      <img src="https://mintcdn.com/jaksam/cS_rA3IcGZ7NTj0G/images/edited_shared_object.png?fit=max&auto=format&n=cS_rA3IcGZ7NTj0G&q=85&s=795530d44d477bee9d325483216fc032" alt="Edited shared object example" width="1130" height="117" data-path="images/edited_shared_object.png" />
    </Frame>
  </Accordion>
</AccordionGroup>


## Related topics

- [How to](/jaksam-inventory/how-to-update.md)
