CHARACTER RENAME

# Name Change — Character Rename System for FiveM

**Players change their name at a clerk, pay with money or a ticket, and the ID card updates on the spot.**

A complete FiveM name change script for ESX, QBCore and QBox: a clerk NPC or marker at city hall, live ID card preview, price in cash or bank, an optional name change ticket item, an optional waiting time and an optional limit of changes per character.

---

## Why this one

Most name change scripts are a command and a text box. This one is a place your players walk to.

- **A real ID card preview.** The player types a name and watches the card change live, before paying anything.

- **Pay the way you want.** Money, a ticket item, or both. Cash or bank, your currency symbol.

- **Waiting time and limit are yours.** Switch each one on or off in the config. When it is off, the menu does not even mention it.

- **No command, no abuse.** The menu opens at a clerk or a marker. The server checks distance, rules and payment again on every request.

---

## How a Name Change Works

| Step | What the player does |

| --- | --- |

| **1. Walk up** | Go to the clerk at city hall and press `E`, or use `ox_target` / `qb-target` |

| **2. Type** | Enter a new first name and last name, the ID card shows the result live |

| **3. Check** | The menu shows the price, what the player has and how many changes are left |

| **4. Confirm** | One click on **Pay & change name**, the name changes at once |

The new name is written straight into your framework, so your phone, ID card and character select scripts see it right away.

---

## Waiting Time and Change Limit

Two rules servers always ask for, both optional.

| Setting | What it does |

| --- | --- |

| **Waiting time** | Players have to wait a number of days between two changes. The menu shows the time left |

| **Change limit** | Players can change their name only a few times in total. The menu shows how many are used |

Both are saved in the database per character, so a restart or a relog never resets them. Turn either one off with a single `true / false` in the config and it disappears from the menu completely.

Admins can reset them with two separate commands: one for the waiting time, one for the counter.

---

## Name Rules That Protect Your Roleplay

| Rule | Why it matters |

| --- | --- |

| **Letters, hyphen, apostrophe** | Names like `Anne-Marie` or `O'Brien` work, `Xx_Killer_xX` does not |

| **Accents supported** | `José`, `Müller` and `Søren` are fine, capital letters are fixed automatically |

| **Length limits** | Set the minimum and maximum yourself |

| **Blacklist** | Block names like `admin`, `police` or `staff`, whole name or any part of it |

| **Unique names** | Optional: nobody else can have the same first and last name |

| **Married players** | With `risk-marry` running, married players can not change their last name |

---

## Pay With Money, a Ticket, or Both

| Mode | What happens |

| --- | --- |

| **Money** | The price is taken from cash or bank |

| **Item** | One `Name Change Ticket` is used up, sell it in your shop or hand it out as a reward |

| **Both** | Money and ticket, for servers that want a real price |

If anything fails after the payment, money and ticket are given back. The ticket can optionally open the menu anywhere.

---

## Looks Like Your Server

| | |

| --- | --- |

| **Your color** | One line in the config changes the whole menu color |

| **Your logo** | Replace `logo.png` and it shows on the ID card |

| **Your language** | 7 languages included, add your own with one file |

| **Any screen** | Sharp from 1080p to 4K and ultrawide |

---

## Built for Your Other Scripts

```lua

-- Open the name change menu from your own phone app, NPC or command

exports['risk-namechange']:OpenNameChange(source)

-- Married players keep their last name when risk-marry is running

Config.UseRiskMarry = true

-- Log every name change to your Discord channel

ServerConfig.Discord.Webhook = 'https://discord.com/api/webhooks/...'

```

---

## Compatibility

| | Supported |

| --- | --- |

| **Framework** | ESX / QBCore / Qbox, auto-detected |

| **Inventory** | ox_inventory / codem-inventory / qb-inventory / origen_inventory / framework native |

| **Target** | ox_target / qb-target / built-in `E` prompt |

| **Database** | oxmysql / mysql-async / ghmattimysql, table is created automatically |

| **Marriage** | risk-marry, optional |

| **Notify** | GTA notify, or plug in your own with one function |

| **Languages** | EN / DE / ES / FR / IT / NL / PT |

---

## What You Get

- ✅ Clerk NPC and ground marker with map blips, any number of places

- ✅ Live ID card preview while typing

- ✅ Price in cash or bank, a ticket item, or both

- ✅ Optional waiting time between changes

- ✅ Optional change limit per character

- ✅ Waiting time and limit saved in the database

- ✅ Two admin commands to reset waiting time and limit

- ✅ Name rules with blacklist, accents and unique names

- ✅ risk-marry support for married players

- ✅ Export to open the menu from other scripts

- ✅ Discord webhook log for every change

- ✅ Your color and your logo with one line and one file

- ✅ ox_inventory, ox_target and qb-target ready

- ✅ 7 languages, every string translatable

- ✅ Exploit-safe, server-authoritative

- ✅ Responsive from 1080p to 4K ultrawide

---

## Installation

1. Drop `risk-namechange` into your resources folder

2. Add `ensure risk-namechange` to your `server.cfg`

3. Add the ticket item from the `_items` folder to your inventory, if you use the item

4. Set price, waiting time and limit in `config/config.lua`, then restart

The database table is created automatically on the first start. No SQL import needed.

**Requirements:** `oxmysql`, `mysql-async` or `ghmattimysql` · ESX, QBCore or QBox

---

## FAQ

**What is Risk Name Change?**

A FiveM name change script where players change their character name at a clerk or marker, with a live ID card preview, a price and optional waiting time and change limit.

**Can I limit how often a player can change the name?**

Yes. Set `Config.UseLimit = true` and choose `Config.MaxChanges`. The menu shows how many changes are used, and the counter is saved in the database.

**Can I add a waiting time between name changes?**

Yes. Set `Config.UseCooldown = true` and choose the days. Turn it off and no waiting time is checked or shown.

**Can I switch the limit and the waiting time off?**

Yes. Each one has its own `true / false` switch. When it is off, the menu does not show it at all.

**Can admins reset a player?**

Yes. `/resetnamechange [id]` resets the waiting time and `/resetnamelimit [id]` resets the counter. Both work from the console too.

**Does it work with my inventory?**

Yes. `ox_inventory`, `codem-inventory`, `qb-inventory`, `origen_inventory` and the framework native API are detected automatically.

**Can I use it without a target script?**

Yes. The built-in `E` prompt is the default. Set `Config.UseTarget = true` and `ox_target` or `qb-target` is detected automatically.

**Can other scripts open the menu?**

Yes. Call the `OpenNameChange` export from your phone, your NPC script or your own command.

**Can I translate it?**

Yes. Seven languages ship complete, the language files are not locked and you can add your own.

https://youtu.be/MfGjjUJILzc