CS_NAMECHANGE

A system for changing your in-game name at designated locations. Includes price handling, blacklisted name filtering, notifications, and Discord webhooks.

• Get the script

• Watch the preview

---

Installation

• Drag and drop into your resources folder

• Add to your server.cfg:

start cs_namechange

• Configure it to your liking.

---

Configuration

Config.lua

This configuration file controls name change locations, pricing, blacklisted names, notifications, and Discord webhook integration..

General Settings

• WebhookEnabled – true / false – Enable or disable webhook notifications.

• Price – Cost of changing your name. Example: 1000.

• Currency – Currency symbol. Example: $.

• blackListedNames – List of forbidden words in names.

Locations

Define where players can change their names:

• name – Location identifier.

• coords – Vector3 coordinates.

• heading – NPC heading.

• openMessage – Text displayed when near the NPC.

• NPC.spawn.key – Interaction key.

• NPC.spawn.type – Ped model.

• blips.spawn.name – Map blip name.

• blips.spawn.sprite – Blip icon.

• blips.spawn.scale – Blip size.

• blips.spawn.color – Blip color.

• blips.spawn.enabled – true / false.

Notifications

Custom client-side notification function:

function CustomClientSideNotification(msg)
    ESX.ShowNotification(msg, "error")
end

Locale

All UI texts, placeholders, and messages are in Locale:

• ChangedNameNotification – Shown after a successful name change.

• NotEnoughMoney – Shown when player cannot afford the change.

• InputEmpty – Shown when form fields are empty.

• SpacesNotAllowed – Shown when spaces are entered incorrectly.

• NameLengthExceeded – Maximum character length exceeded.

• NameLengthInvalid – Minimum character length not met.

• NameContainsInvalidChars – Invalid characters detected.

• ServerName – Display server name.

• NameChangeLabel – UI heading.

• FirstNamePlaceholder – Placeholder for first name.

• LastNamePlaceholder – Placeholder for last name.

• ConfirmButton – Confirm button label.

---

Webhook Configuration

webhooks.lua

Webhook.Link = "https://discord.com/api/webhooks/1113892270270328922/8_M8ZC47fBaB0o193N31b2v9HcpDVadrh4PgLGdebvYxtHJNiSR7qMFlQ9qjnSIhZqdX"

• Sends a message when a player changed his name, including old name, new name, and more information.

Tip: Leave the URL as an empty string "" if you do not want the webhook to trigger for that event.

---

Notes

• Supports both old and new ESX versions.

• Blacklisted names are automatically blocked.

• Multiple locations can be added by extending the locations table.

---

Support

If you have any further questions, open a ticket on our discord server: discord.gg/core-services