> For the complete documentation index, see [llms.txt](https://nayzeee-dev.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nayzeee-dev.gitbook.io/docs/nayzeee-scripts/nayzeee-reports/events.md).

# Events

***

### Client Events

<details>

<summary>nayzeee-reports:openPlayerMenu</summary>

Opens the player report submission menu.

```lua
TriggerEvent('nayzeee-reports:openPlayerMenu')
```

</details>

<details>

<summary>nayzeee-reports:openStaffPanel</summary>

Opens the staff report management panel.

```lua
TriggerEvent('nayzeee-reports:openStaffPanel')
```

</details>

<details>

<summary>nayzeee-reports:openMonitor</summary>

Opens the staff monitor panel.

```lua
TriggerEvent('nayzeee-reports:openMonitor')
```

</details>

<details>

<summary>nayzeee-reports:newReport</summary>

Notifies staff of a new report.

```lua
TriggerClientEvent('nayzeee-reports:newReport', staffId, reportData)
```

**Report Data:**

```lua
{
    id = number,
    player = string,
    playerId = number,
    category = string,
    message = string,
    timestamp = number
}
```

</details>

<details>

<summary>nayzeee-reports:reportClaimed</summary>

Notifies when a report is claimed.

```lua
TriggerClientEvent('nayzeee-reports:reportClaimed', -1, reportId, staffName)
```

</details>

<details>

<summary>nayzeee-reports:reportClosed</summary>

Notifies when a report is closed.

```lua
TriggerClientEvent('nayzeee-reports:reportClosed', -1, reportId)
```

</details>

<details>

<summary>nayzeee-reports:chatMessage</summary>

Sends a chat message in a report.

```lua
TriggerClientEvent('nayzeee-reports:chatMessage', playerId, reportId, message, isStaff)
```

</details>

***

### Server Events

<details>

<summary>nayzeee-reports:submitReport</summary>

Submits a new player report.

```lua
TriggerServerEvent('nayzeee-reports:submitReport', category, message)
```

</details>

<details>

<summary>nayzeee-reports:claimReport</summary>

Staff claims a report.

```lua
TriggerServerEvent('nayzeee-reports:claimReport', reportId)
```

</details>

<details>

<summary>nayzeee-reports:closeReport</summary>

Staff closes a report.

```lua
TriggerServerEvent('nayzeee-reports:closeReport', reportId, resolution)
```

</details>

<details>

<summary>nayzeee-reports:sendMessage</summary>

Sends a message in a report.

```lua
TriggerServerEvent('nayzeee-reports:sendMessage', reportId, message)
```

</details>

<details>

<summary>nayzeee-reports:teleportToPlayer</summary>

Staff teleports to reporting player.

```lua
TriggerServerEvent('nayzeee-reports:teleportToPlayer', reportId)
```

</details>

<details>

<summary>nayzeee-reports:bringPlayer</summary>

Staff brings reporting player to them.

```lua
TriggerServerEvent('nayzeee-reports:bringPlayer', reportId)
```

</details>

***

### ox\_lib Callbacks

<details>

<summary>nayzeee-reports:getReports</summary>

Gets all active reports.

```lua
local reports = lib.callback.await('nayzeee-reports:getReports', false)
```

</details>

<details>

<summary>nayzeee-reports:getMyReports</summary>

Gets player's own reports.

```lua
local myReports = lib.callback.await('nayzeee-reports:getMyReports', false)
```

</details>

<details>

<summary>nayzeee-reports:getStaffStats</summary>

Gets staff statistics.

```lua
local stats = lib.callback.await('nayzeee-reports:getStaffStats', false)
```

**Returns:**

```lua
{
    claimed = number,
    closed = number,
    avgResponseTime = number
}
```

</details>

<details>

<summary>nayzeee-reports:getOnlineStaff</summary>

Gets list of online staff.

```lua
local staff = lib.callback.await('nayzeee-reports:getOnlineStaff', false)
```

</details>

***

### Integration with nayzeee-admin

When `Config.Integrations.Reports = true` in nayzeee-admin:

```lua
-- Reports are accessible from admin panel
-- Staff can view/manage reports directly
-- Stats are synced between both scripts
```
