Spawn Select
Step-by-step installation guide, common issues & solutions, code snippets, error codes, config previews, locales previews, SQL previews, and changelogs; all in 1 easily accessible place.
2. Unzip the
cd_spawnselect.zip folder and place this folder in your server's resource folder.3. Add the resource to your server start config:
ensure cd_spawnselect. If you are using a framework, it must be placed anywhere below your framework resource e.g., es_extended, not above.
Depending on your framework and dependencies, you may need to make some changes inside the
[cd_spawnselect/fxmanifest.lua]. We have made this easier by commenting on the lines you possibly need to change.
You MUST read all configurable options inside the
[cd_spawnselect/configs/config.lua] file and configure them to suit your server's needs. Please read the ”commented out help text” at the end of each line so you can understand what each config option does.
You MUST import the SQL file to your database. This SQL file is located inside the
READ_ME_AFTER_PURCHASING folder, the file is named SQL_main.sql. Watch this video if you are unsure how to do this HeidiSQL / PHPMyAdmin.
ESX
QBCore
vRP
No-framework
Other (custom framework)
There are no required changes you need to make. All you need to do is configure the
config.lua correctly.Step 1: Make sure the event named
qb-spawn:client:openUI has not been changed, or if it has been changed you need to change this event name in the cd_spawnselect/client_customise_me.lua to what your modified QBCore has named it because when this event is triggered it will open the spawn select UI.
Step 2: Until a future update, the qb-spawn resource is still required to handle the first spawn of new characters so they can choose an apartment. This code in the
client.lua of qb-apartments should look like this.qb-apartments client main.lua
RegisterNetEvent('apartments:client:setupSpawnUI')
AddEventHandler('apartments:client:setupSpawnUI', function(cData)
QBCore.Functions.TriggerCallback('apartments:GetOwnedApartment', function(result)
if result ~= nil then
DoScreenFadeOut(0)
TriggerEvent('cd_spawnselect:OpenUI')
TriggerEvent("apartments:client:SetHomeBlip", result.type)
else
TriggerEvent('qb-spawn:client:setupSpawns', cData, true, Apartments.Locations)
TriggerEvent('qb-spawn:client:openUI', true)
end
end, cData.citizenid)
end)
Step 3: Remove lines 52-56 client_customise_me.lua in cd_spawnselect.
--Comment out or remove these lines.
-- RegisterNetEvent('qb-spawn:client:openUI')
-- AddEventHandler('qb-spawn:client:openUI', function()
-- DoScreenFadeOut(0)
-- Citizen.Wait(2000)
-- TriggerEvent('cd_spawnselect:OpenUI')
-- end)
Apart from that there are no other required changes you need to make to external scripts if you are using version 3.1.0+. All you need to do is configure the
config.lua correctly.There are no required changes you need to make. All you need to do is configure the
config.lua correctly.There are no required changes you need to make. All you need to do is configure the
config.lua correctly.There are no required changes you need to make. All you need to do is configure the
config.lua correctly.This section is to help you understand how the built-in features of this resource work, and if applicable, how you can make them compatible with other resources. These features are not required, they are optional and can be configured in the
[configs/config.lua].
IF you want to open the spawn select UI for a player you can trigger the client event below. You can also send coordinates in the first argument; these coordinates will be used for the player's "Last Location". If the coordinates in the first argument are nil then the script will get the "Last Location" coordinates from the
GetLastPosition function in the server_customise_me.lua.client-side to client-side
From server to client
TriggerEvent('cd_spawnselect:OpenUI')
TriggerClientEvent('cd_spawnselect:OpenUI', source)
These chat commands can be renamed and/or disabled in the Keys and Commands section of the
[configs/config.lua].The exact usage for each command will be displayed in the chat suggestions when using the commands in-game.
Command | Description |
/personalspawn | The command to add/delete/show your personal spawn. |
/openspawnselect | (Test Command) This is a test command to open the spawn select UI. |
🔔 Folder Name Make sure the folder name is
cd_terminalhacker.🔔 Encrypted Files Do not edit the encrypted files in any way.
🔔 Not Using ESX If you do not use ESX, please read Step 1 again carefully; you must use the Custom Framework option.
🔔 Coords need to be floats not integers Make sure the coords in the config.lua and mapdata.js have a decimal place at the end.
xPlayer Error?eg., if you see this error:attempt to index a nil value (local 'xPlayer').✔️ This means you are triggering the TriggerEvent('cd_spawnselect:OpenUI') event before ESX has fully cached and loaded your player data. Some servers take longer than others due to lower VPS specs, bad optimization, etc... so it takes the SQL queries longer to complete. If you use a multicharacter script, you can fix this by increasing the wait timer by a few seconds before triggering the event from your multiple character script.
SQL Default Value?eg., if you see an error similar to this example when inserting an SQL query into your database -“BLOB/TEXT column 'personal_spawn' can't have a default value”.✔️ You can use “VARCHAR(256)” instead of “LONGTEXT” in the SQL query.
SQL Unknown Column?eg., if you see an SQL error in the server console similar to this example -ER_BAD_FIELD_ERROR: Unknown colum 'personal_spawn' in 'where clause'.✔️ You are missing one of the required database columns. The SQL file can be found in the "READ_ME_AFTER_PURCHASING" folder.
Ped visible on first spawn?eg., if you see your ped when first loading into the server before the character selection screen activates.✔️ This should not happen, there should be a black screen, so means another script is conflicting. This is most likely caused by 1 line of code in es_extended or essentialmode or spawnmanager. Search for DoScreenFadeIn in the client-side of either of these resources and remove it then restart your server. (It could be in other resources too but these are the common ones).
If you see an error code not listed below, please open a script support ticket in the Codesign Discord.
Server
Client
N/A
3456 - The
position in the users database table for this player's character was 0,0,0. The next time a player exits the game this should update the coordinates in the database.6874 - The player's last saved position was nil.
9871 - The player's job spawn coordinates were nil.
6433 - The player's personal spawn coordinates were nil.
3345 - The coordinates for the chosen spawn location were nil.
8897 - There was an error in the
GetJob function in the client customize me.2234 - There was an error in the
HasFullySpawnedIn function in the client customize me from something you have changed.
Files ChangedNot every update requires you to replace the whole folder. We do this because we understand it's a pain to redo the configs for every update.
- All Files - This means you should delete your old
cd_spawnselectfolder, download and add in the latest version, reconfigure the configs folder and restart your server. - All Files Except config.lua - This means you should do all of the above (in the All Files section) but additionally make a backup of the
config.luafile and replace the new config.lua file with the one you made a backup of. - Specific Files - This means you can copy and paste the SPECIFIC new files over the old ones and restart the server.
Update TypeOn rare occasions, you are forced to update to the latest version. Mostly due to authentication updates where the old versions will no longer work.
- Mandatory - This means you MUST update to this new version, or the old versions will no longer work.
- Optional - This means it's completely your choice whether you wish to update to the latest version. But we do not offer support for old versions for obvious reasons; they are old.
Skipping Updates
If you are attempting to update to the latest version but have skipped previous updates, you should update all files just to be safe. For example., let's say you are currently on v4.0.1, you did not update when v4.0.2 was released, and now v4.0.3 is released, and you want to update; you should always use the “All Files” update method.
v3.0.0
v4.0.0
v4.0.1
v4.0.2
v4.0.3
v3.0.0 - v3.1.2
Files Changed:
- All Files
- All Files Except config.lua
- Specific Files
Update Type:
- Mandatory
- Optional
Changelog:
Add
- Added locales for the UI.
- Added the ability to rename all esx events such as the setjob and playerloaded events.
- Added drag-and-drop QBCore compatibility.
Edit
- Minor code clean up.
- Updated the codesign error handlers.
- Changed the default police job spawn to MRPD.
- Moved the framework code and chat commands to the client customise me to allow for further customization.
- Rewrote a large majority of the code for optimisation and overall cleaned up the code.
- The script is now drag-and-drop with esx, qbcore, vrp and no framework without having to make changes to external scripts.
Fix
- Fixed random server error on server start.
- Fixed rare falling to death error.
- Fixed the issue where the OpenUI event would not register if the event was triggered before the script was authorised.
- Fixed the bug where you would be frozen and invisible after spawning.
- Temporary fix for the canary issue until the new Tebex FiveM license system is ready to launch, when this is released we will be fully switching over to the new system.
- Fixed an issue that sometimes caused players to be frozen in the sky.
- Reworked the camera animation after you have chosen your character. This should also resolve visual issues of clipping through landmarks when spawning in certain locations.
- Fixed an issue when using the "no framework" config option.
Files Changed:
- All Files
- All Files Except config.lua
- Specific Files
Update Type:
- Mandatory
- Optional
Changelog:
Authentication
- We are now using the official Authentication System provided by FiveM. The old auth system will be taken offline 1 week from now (give or take a few days if needed).
Add
- Added compatibility for oxmysq
Files Changed:
- All Files
- All Files Except config.lua
- Specific Files
fxmanifest.lua - (IMPORTANT)
server/main/server.lua - (IMPORTANT)
client/main/client.lua - (IMPORTANT)
html (FULL FOLDER) - (IMPORTANT)
Update Type:
- Mandatory
- Optional
Changelog:
Authentication
- Small authentication update to ensure stability.
Files Changed:
- All Files
- All Files Except config.lua
- Specific Files
fxmanifest.lua - (IMPORTANT)
server/server.lua
configs/client_customise_me.lua
Update Type:
- Mandatory
- Optional
Changelog:
Add
- Added compatibility with latest oxmysql.
Fix
- Fixed an issue where the UI would open before the script has fully loaded.
Last modified 2mo ago