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

# Showcase

### Key Features

#### Admin Duty System

Staff can toggle admin duty mode before using protected admin tools.

Admin duty can enable:

* Godmode
* On-screen duty indicator
* Staff visuals
* Staff blips
* Staff badges
* Permission-locked menu access

***

#### Permission-Based Admin Menu

DZ Admin uses ACE permissions for every major action.

This means server owners can create different staff levels such as:

```
Moderator
Admin
Superadmin
```

Each group can have different access to tools like:

* Spectate
* Ban
* Warn
* Cleanup
* Logs
* Reports
* Offline lookup
* Vehicle tools
* World controls

***

#### Dashboard Overview

The dashboard gives staff a quick overview of the server.

It can show:

* Online players
* Staff on duty
* Open reports
* Active bans
* Quick access buttons
* Staff duty viewer

***

#### Player Management

Staff can manage online players through a clean context menu.

Player tools include:

* Player lookup
* Goto player
* Bring player
* Return player
* Freeze player
* Unfreeze player
* Spectate player
* Open inventory
* View owned vehicles
* Revive
* Heal
* Give armor
* Kill
* Kick
* Warn
* Ban
* Add admin notes
* View warning history
* View ban history
* View admin notes

***

#### Offline Player Lookup

DZ Admin includes offline player lookup support for ESX users.

Staff can search offline characters and view:

* Character name
* Identifier
* Job
* Cash
* Bank
* Date of birth
* Sex
* Height
* Warning count
* Ban count
* Owned vehicles
* Offline warnings
* Offline bans
* Offline notes

Staff can also:

* Warn offline players
* Ban offline players
* Add offline notes

***

#### Reports System

Players can submit reports using the configured report command.

Default:

```
/report
```

Staff can then:

* View open reports
* Claim reports
* Close reports
* Goto reporter
* Spectate reporter

Reports are stored in the database and can be used for staff tracking and moderation history.

***

#### Punishment System

DZ Admin includes a full punishment system.

Supported actions:

* Kick player
* Warn player
* Ban player
* Unban player
* Warn offline player
* Ban offline player
* View warning history
* View ban history
* View active bans

Ban durations support formats such as:

```
15m
2h
1d
1w
permanent
```

***

#### Admin Notes

Admin notes are internal staff-only records.

They are useful for tracking information that does not need to be a formal warning or punishment.

Example notes:

```
Player was verbally warned for Fail RP.
Player may need help understanding server rules.
Possible combat logging report, no proof yet.
Refunded vehicle due to garage issue.
```

Notes work for both online and offline players.

***

#### Admin Logs

DZ Admin includes database and Discord logging support.

Logs can track actions such as:

* Duty toggles
* Kicks
* Warnings
* Bans
* Unbans
* Reports
* Notes
* Teleports
* Vehicle actions
* Cleanup actions
* Announcements
* Staff chat
* Weather/time changes

The logs menu includes clickable entries with detailed log information.

***

#### Staff Chat

Staff can communicate privately using the configured staff chat command.

Default:

```
/sc <message>
```

Staff chat can optionally require staff to be on duty.

***

#### Announcements

Staff can send server-wide announcements.

Default:

```
/announce <message>
```

Announcements are permission protected, logged, and configurable.

***

#### Staff List

Players or staff can view staff currently on duty.

Default:

```
/staff
```

This can be configured so either everyone can use it or only staff can use it.

***

#### Vehicle Tools

DZ Admin includes useful vehicle tools for staff.

Vehicle actions include:

* Repair current vehicle
* Clean current vehicle
* Fill vehicle fuel
* Flip vehicle
* Delete current vehicle
* Delete nearest vehicle
* View owned vehicles
* Spawn owned vehicles
* Copy vehicle plate

Fuel integration is modular.

Supported fuel types can include:

```
native
legacyfuel
lc_fuel
ox_fuel
cdn-fuel
ps-fuel
lj-fuel
custom
```

***

#### Cleanup Tools

Staff can clean up nearby entities with configurable radius limits.

Cleanup tools include:

* Delete nearby vehicles
* Delete empty vehicles
* Delete nearby peds
* Delete nearby objects
* Delete area entities

Dangerous cleanup actions can use confirmation prompts to prevent accidental wipes.

***

#### World Management

Staff can control weather and time from the admin menu.

World tools include:

* Change weather
* Freeze weather
* Change time
* Set custom time
* Freeze time

Weather and time are synced using GlobalState.

***

#### Health Tools

Staff can manage player health states.

Health tools include:

* Revive player
* Heal player
* Give armor
* Kill player
* Revive self
* Heal self
* Armor self

Revive logic is configurable so servers can use their own ambulance/death resource.

***

#### Vanish, NoClip, and Spectate

DZ Admin includes core staff movement and investigation tools.

Tools include:

* Toggle NoClip
* Toggle Vanish
* Spectate player
* Stop spectating

Vanish, NoClip, and Spectate are designed to work together without fighting over visibility, collision, or invincibility states.

***

#### Staff Visuals

Optional staff visuals help on-duty staff identify each other.

Staff visuals can include:

* Staff blips
* Staff badges
* On-screen duty indicator

These are configurable and can be disabled.

***

#### System Diagnostics

DZ Admin includes a diagnostics menu to help server owners troubleshoot setup issues.

Diagnostics can check:

* Framework status
* Inventory status
* oxmysql status
* Required SQL tables
* Locale
* Logging configuration
* Discord logging status
* Database logging status
* Version information

This helps reduce support issues during setup.

***

#### Quick Commands

DZ Admin includes configurable quick commands for staff who prefer commands over menus.

Default quick commands:

```
/dzgoto <id>
/dzbring <id>
/dzreturn <id>
/dzfreeze <id>
/dzunfreeze <id>
/dzrevive <id>
/dzheal <id>
/dzarmor <id>
/dzkill <id>
/dzkick <id> <reason>
/dzwarn <id> <reason>
/dzban <id> <duration> <reason>
```

Commands use the `dz` prefix by default to avoid conflicts with ESX, EasyAdmin, vMenu, txAdmin, or other resources.

***

#### Server Exports

DZ Admin includes server-side exports for external resources.

Examples:

```
exports['dz_admin']:HasPermission(source, 'dz_admin.ban')
exports['dz_admin']:IsOnDuty(source)
exports['dz_admin']:GetPrimaryIdentifier(source)
exports['dz_admin']:GetCharacterIdentifier(source)
```

External resources can also create admin logs:

```
exports['dz_admin']:AdminLog('Custom Action', source, nil, {message = 'Details here'})
```

***

### Requirements

DZ Admin requires:

```
ESX Legacy
ox_lib
oxmysql
ox_inventory
```

Recommended start order:

```
ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure dz_admin
```

***

### Screenshots

#### Main Menu

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2FAG9bEgvW1gctsqlBeFXx%2Fmainmenu.png?alt=media&amp;token=3675a68a-ee6c-4b65-a2fb-68c6adcc518e" alt=""><figcaption></figcaption></figure></div>

#### Dashboard

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2FZpXdq4ufpzhS2FzJV22M%2Fdashboard.png?alt=media&amp;token=9cd7393b-f2f5-4638-8ff0-b848439c34a1" alt=""><figcaption></figcaption></figure></div>

#### Player Actions

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2FMsVLEQnwrU3MoR5kxRkE%2Fplayeractions.png?alt=media&amp;token=31adb9cc-e18b-4ff3-af82-becab72f6bab" alt=""><figcaption></figcaption></figure></div>

#### Offline Lookup

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2FScWodFvj6gA8yDC75gII%2Fofflinelookup.png?alt=media&amp;token=89b4c861-0852-4b85-bf2b-91cbc6399629" alt=""><figcaption></figcaption></figure></div>

#### Reports

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2Fk17IB5RhdfPi4OOz7i0w%2Freports.png?alt=media&amp;token=e1300249-1c00-47ab-baaf-48a6260de9f5" alt=""><figcaption></figcaption></figure></div>

#### Logs

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2FKFYCwnlFP37IuiheWkxe%2Flogs.png?alt=media&amp;token=0544d9a6-994b-4c0a-a1b6-c7a1fc917744" alt=""><figcaption></figcaption></figure></div>

#### Utility Tools

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2F6IivJtLtXcNFmilD70TG%2Futility.png?alt=media&amp;token=6f4b9e2d-b2b5-41fb-b28e-1c3a1c8abf81" alt=""><figcaption></figcaption></figure></div>

#### World Management

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2FxacaHv3Wl4krahvGhRik%2Fworld.png?alt=media&amp;token=a1b04834-0f3b-40d6-a7cf-2bed9d2a95eb" alt=""><figcaption></figcaption></figure></div>

#### System Diagnostics

<div align="left"><figure><img src="https://2958011398-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5z87maVNAxcmUYPwx6D%2Fuploads%2Fh7mt8Xatfo3tcFLqR5zn%2Fdiagnostics.png?alt=media&amp;token=988db51e-068e-43da-8fba-aae60fb91704" alt=""><figcaption></figcaption></figure></div>

***

### Video Showcase (Coming Soon)

Preview video will be added soon!

***

### Why Use DZ Admin?

DZ Admin is built to be:

* Clean
* Modular
* Permission-based
* Easy to configure
* Easy to troubleshoot
* Suitable for staff teams with multiple permission levels

It is designed to give server owners a complete admin system without forcing them into one specific workflow.

***

## Support

Found a bug? Or have a suggestion for features to add?

Head over to the [**Duddzy Scripts Discord**](https://discord.gg/SUy95QJWev) and drop a message in the **duddzy-admin-support** channel.