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

# Installation

> How to install nex_povrequest on your FiveM server — resource placement, start order, and the ACE permission grant.

## Requirements

[`ox_lib`](https://github.com/overextended/ox_lib) is the only dependency. It must be installed and started **before** `nex_povrequest`.

No framework and no SQL — the resource is otherwise standalone.

## Steps

1. Drop the `nex_povrequest` folder into your `resources/` directory. Any subfolder is fine, e.g. `resources/[nex]/nex_povrequest/`.

2. Add it to your `server.cfg` **after** `ox_lib`:

   ```cfg theme={null}
   ensure ox_lib
   ensure nex_povrequest
   ```

3. Grant admins access in `server.cfg`:

   ```cfg theme={null}
   add_ace group.admin nex_povrequest.use allow
   ```

   <Info>
     If you use txAdmin's default admin group, `group.admin` already covers your admins. The permission check runs server-side, so it cannot be bypassed from the client. To let **everyone** use `/pov`, set `Config.RequiredAce = nil` in `lua/config.lua`.
   </Info>

4. Open `lua/config.lua` and set `Config.WebhookURL` to your own Discord webhook.

   <Warning>
     The shipped `config.lua` contains an example webhook URL. Replace it with your own webhook — or set it to `''` to disable Discord logging.
   </Warning>

5. Adjust the rest of `lua/config.lua` to taste (see [Configuration](/nex_povrequest/configuration)) and start or restart the server.

## Checking it worked

From F8:

```
lua print(GetResourceState('nex_povrequest'))
```

Should print `started`. Then run `/pov` as an admin — the panel should open with the online player list.

## Updating

`lua/config.lua` is listed under `escrow_ignore`, so your settings survive updates.

1. Replace the resource files with the new version (keep your edited `lua/config.lua`).
2. Restart the resource: `restart nex_povrequest`.

<Info>
  The resource includes a server-side version check. When a newer release exists, an update notice with the changelog and download links prints to the server console shortly after startup. It only reads a public version manifest — nothing is sent from your server.
</Info>