> For the complete documentation index, see [llms.txt](https://zynoxdev.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://zynoxdev.gitbook.io/docs/zynox-resources/zx_nameguard.md).

# ZX - Name Guard

Zynox Studio Documents > ZYNOX RESOURCES

## 🛡️ ZX - Name Guard

Next-gen character name synchronization and queue protection system — zero-bypass Adaptive Card deferrals, interactive glassmorphism warning HUD with 1-click clipboard copy, grace period onboarding, and automated Discord audit logs.

An elite identity enforcement resource for FiveM servers. When players connect, zx\_nameGuard verifies that their FiveM profile name strictly matches their registered in-game character identity across Qbox, QB-Core, ESX Legacy, or Standalone databases. Features a seamless first-time onboarding grace period, interactive in-game preview command, customizable HEX color accents, and full immunity against queue script lockups.

```lua
author 'Zynox Development'
```

```lua
dependencies { 'oxmysql' }
```

![Version](https://img.shields.io/badge/version-1.0.0-0088ff.svg) ![Compatibility](https://img.shields.io/badge/FiveM-Standalone%20%7C%20Qbox%20%7C%20QBCore%20%7C%20ESX-00a2ff.svg) ![Resmon](https://img.shields.io/badge/Resmon-0.00ms-0066ff.svg) ![Author](https://img.shields.io/badge/Author-Zynox%20Development-0055ff.svg)

***

### 📑 Resource Pages

* [📥 Installation & Setup](/docs/zynox-resources/zx_nameguard/installation.md)
* [⚙️ Configuration Guide](/docs/zynox-resources/zx_nameguard/configuration.md)
* [🎨 Customization & Styling](/docs/zynox-resources/zx_nameguard/customization.md)
* [❓ Troubleshooting & FAQ](/docs/zynox-resources/zx_nameguard/troubleshooting.md)

***

### Overview

* **Zero-Bypass Queue & Connection Guard** — Intercepts players during the connection handshake (`playerConnecting`) using native FiveM Adaptive Cards or instant text rejection modals to ensure identity consistency.
* **Modern Glassmorphism Warning NUI** — Sleek in-game notification HUD with ambient glow, animated badges, and responsive dark glass aesthetics.
* **1-Click Character Name Copy** — Built-in copy-to-clipboard functionality with tactile frontend audio cues allowing players to instantly paste their correct character name into FiveM settings.
* **First-Time Player Grace Period** — New players or newly created characters can join immediately without disruption, receiving a polite in-game warning to update their name prior to their next session.
* **Comprehensive Framework Compatibility** — Native, automatic support for Qbox (`qbx_core`), QB-Core (`qb-core`), ESX Legacy (`es_extended` with multi-character slot support `char1:` - `char10:`), and standalone MySQL.
* **Rich Discord Webhook Logging** — Real-time security audit trails logging player FiveM names, required character names, Discord account mentions (`<@id>`), Rockstar licenses, timestamps, and action types.
* **Dynamic HEX Color Palette** — Change the primary theme accent color directly in `config.lua` (`Config.UI.ThemeColor`) without ever touching CSS.
* **In-Game Preview Test Command** — Admins can test and preview the warning card UI instantly anytime with `/testnamecheck`.

***

### 🛠️ Technical Specifications

| Property             | Details                                                       |
| -------------------- | ------------------------------------------------------------- |
| **Framework**        | Native Auto-Detect: Qbox, QB-Core, ESX Legacy, Standalone     |
| **Idle Resmon**      | **0.00ms** (Strict zero-tick idle performance)                |
| **Active Resmon**    | Under **0.01ms** during in-game NUI display                   |
| **Database Library** | `oxmysql` (v2.0.0+)                                           |
| **UI Technology**    | Vanilla HTML5 / CSS3 / JavaScript + FiveM NUI Focus           |
| **Deferral System**  | Native FiveM Adaptive Cards + 12s safety timeout & Text Modes |

#### ⚡ 0.00ms Performance Benchmark Proof

Strict **0.00ms idle resmon** verified on live FiveM client threads. Zero CPU overhead during regular gameplay:

![0.00ms Resmon Benchmark](https://4065368773-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTi619DEDVAIquYQeLZwX%2Fuploads%2Fgit-blob-38f4f570dca1941ad16ba6147ecbb1f3d42c64ec%2Fresmon.png?alt=media)

***

-# © 2026 Zynox Development • [Official Store](https://zynoxdev.tebex.store/) • [Discord](https://discord.gg/2yuPTmsqjX)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://zynoxdev.gitbook.io/docs/zynox-resources/zx_nameguard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.