CS_NAMECHANGE

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


Installation

start cs_namechange

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

Last updated

Was this helpful?