server consolestarting
  1. > ensure fivestacks_namechange
  2. [fivestacks_namechange] v1.0.0 started, framework: qbx, price: $25,000, cooldown: 30 days, fivestacks.dev
resmonidle

fivestacks_namechange

0.00ms

Take the tour

What each part of the menu does. Hover or tap a point.

The name change menu in game: ID card and earlier names on the left, steps, name fields, rules, fee and continue button on the right

What Name Change does

Players walk up to a clerk at City Hall, type their new name and pay a fee. The ID card next to the form follows every keystroke and gets a stamp when the change is done. The server checks the rules, the cooldown and the payment again before the name is saved.

  • $25,000 per change and a 30 day cooldown by default
  • 2 to 16 characters per first and last name
  • Block lists for exact names and for words anywhere in a name
  • One office at City Hall by default, add more in the config
  • Admin rights by ACE permission or framework group
  • Exports, events and hooks for other scripts
  • MySQL, MariaDB and PostgreSQL through oxmysql

Live ID card

Photo of the character, name, date of birth, document number and a machine readable zone with correct check digits. It follows every keystroke and gets a stamp when the change is done.

Fee from the config

A fixed fee, an optional increase per earlier change, an upper limit and a free first change. Players pay by bank or cash, and the fee can go into a society account.

Cooldowns and limits

30 days between changes by default and an optional maximum per character. A cooldown or a used-up limit gets its own screen, the cooldown with the time left.

Name rules

Length, accents, spaces, hyphens, apostrophes and repeated letters. Names are capitalised automatically, block lists stop unwanted names, and unique names are optional.

Checked on the server

The server checks the office distance, the rules, the cooldown, the price and the balance again, with a rate limit on requests. If saving fails, the money is paid back.

Admin commands

/setname renames a player for free and /resetnamecooldown clears the cooldown, in game or from the server console. Discord logs cover every change.

Fits into your server

The interaction is picked automatically. The society account is off by default and set in config/server.lua.

Interaction

  • ox_target
  • qb-target
  • built-in key prompt

Society account

  • esx_addonaccount
  • qb-banking
  • qb-management
  • Renewed-Banking

Notifications

  • framework
  • GTA feed

Database

  • MySQL
  • MariaDB
  • PostgreSQL

Controls

  • Talk to the clerk, without a target scriptE
  • Continue to paymentEnter
  • Back from payment, or closeEsc

Config and exports

The config, locales and framework bridges are plain Lua you can edit. These snippets come straight from the files you get.

config/config.lua

Config.Price = {
    Amount = 25000,
    Increase = 0,                -- added for every earlier change of the character
    Max = 0,                     -- upper limit when Increase is used, 0 = no limit
    FirstChangeFree = false,     -- the first change of every character costs nothing
    Methods = { 'bank', 'cash' },-- payment methods offered in this order
}

Config.Limits = {
    CooldownDays = 30,           -- days between two changes of the same character, 0 = no cooldown
    MaxChanges = 0,              -- changes per character in total, 0 = unlimited
}

-- free, 10k, 20k ... 50k
-- Config.Price = { Amount = 10000, Increase = 10000, Max = 50000, FirstChangeFree = true, Methods = { 'bank' } }

Installation

6 steps from download to a running script. Pick a step to see what goes where.

  1. resources
    resources/└─ [fivestacks]/ └─ fivestacks_namechange/    ├─ bridge/    ├─ client/    ├─ config/    ├─ locales/    ├─ server/    ├─ shared/    ├─ sql/    ├─ web/    ├─ fxmanifest.lua    └─ README.md
    Step 1 of 6

Frameworks

FrameworkMoneyDetected by
QboxCash and bank through player functions, society fee to Renewed-Banking or qb-bankingqbx_core
QBCoreCash and bank through player functions, society fee to qb-banking or qb-managementqb-core
ESXMoney and bank accounts, society fee to an addon accountes_extended

Changelog

  1. v1.0.0Sep 29, 2026

    • First release

How buying works

Sales open on October 16. Until then you can look around and ask questions on Discord.

  1. 1

    Open a ticket

    Pick a script and open a ticket on our Discord to buy it.

  2. 2

    Get the resource

    You receive the resource folder, with the config, locales and framework bridges open to edit.

  3. 3

    Ensure it

    Drop it into your resources, add ensure to server.cfg and restart.

More scripts