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

# Weed - Installation

> Step by step instructions to install this resource

<Steps>
  <Step title="Install (or update) dependencies" stepNumber={1}>
    <Warning>
      Verify all dependencies below are started *before* this script in your `server.cfg`.
    </Warning>

    <Columns cols={2}>
      <Card title="oxmysql" icon="arrow-up-right-from-square" href="https://github.com/CommunityOx/oxmysql/releases/latest">
        Download oxmysql
      </Card>

      <Card title="ox_lib" icon="arrow-up-right-from-square" href="https://github.com/CommunityOx/ox_lib/releases/latest">
        Download ox\_lib
      </Card>

      <Card title="bob74_ipl" icon="external-link">
        Download bob74\_ipl
      </Card>
    </Columns>
  </Step>

  <Step title="Add items to your inventory">
    Open the `install` folder and add the `items` & their `images` to your inventory.

    <Tabs>
      <Tab title="ox_inventory">
        * Copy items from `/install/items/ox_inventory.txt` into `ox_inventory/data/items.lua`
        * Copy images from `/install/images` into `ox_inventory/web/images`
      </Tab>

      <Tab title="qb-inventory">
        * Copy items from `/install/items/qb-inventory.txt` into `qb-core/shared/items.lua`
        * Copy images from `/install/images` into `qb-inventory/html/images`
      </Tab>

      <Tab title="other">
        <Info>
          Refer to the documentation for your specific inventory system.
        </Info>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Create a new subfolder">
    <Info>
      This is an optional step, but is *highly recommended*.
    </Info>

    If you haven't already, create a new subfolder named `[lation]` in your server's root resources directory. Unzip (*extract*) this script into the newly created `[lation]` subfolder.
  </Step>

  <Step title="Add ACE permissions">
    Open your `server.cfg` and add the following ACE permission:

    ```text theme={null}
    add_ace group.admin lation_weed.admin allow
    ```

    <Warning>
      If you are on the Qbox framework, the recommended place to paste the above permission is inside the `permissions.cfg` file instead of `server.cfg`.
    </Warning>
  </Step>

  <Step title="Update server.cfg & perform a full restart">
    Once all other steps are completed, open your `server.cfg` & add `ensure [lation]` to the very **bottom** of your resource start list. Finally, perform a full server restart. Failure to perform a full restart after installation will cause errors.
  </Step>
</Steps>

<Note>
  Once completed, use the command `/weedadmin `in-game to get started!
</Note>