esx_core/readme.md

Requirements

• ESX Legacy
• MySQL Async
• ESX Identity
• ESX Skin
• Spawnmanager

Installation

• Modify your ESX config with Config.Multichar = true
• Set your database name for Config.Database in server/main.lua
• All owner and identifier columns should be set to VARCHAR(60) to ensure correct data entry
• Use the varchar command from the console to update your SQL tables
• Once you have used the command you should just remove it for sanity's sake

Conflicts

• The following resources should not be used with ESX Legacy and can result in errors
  • essentialsmode
  • basic-gamemode
  • fivem-map-skater
  • fivem-map-hipster
  • default_spawnpoint
  • cui_character (or other resources that modify spawn behaviour)

Common issues

Black screen / loading scripts

- Download and run all requirements
- Ensure none of the conflicting resources are enabled

mysql-async duplicate entry

- You have not increased the VARCHAR size of your tables (use the command)

The menu interface is esx_menu_default - you can use any version if you want a different appearance

Relogging

• Modify the config with Config.Relog = true
• Use the latest version of ESX Status
• If you have any threads running with while true do I recommend using while ESX.PlayerLoaded do instead
  • For threads that are triggered by a spawn/load event this will ensure they do not start a second time
  • You can clear loops that may break after ESX.PlayerData is cleared
  • For an example, refer to my boilerplate
• Add the following event to any resources that will benefit from clearing ESX.PlayerData

RegisterNetEvent('esx:playerLoaded')
AddEventHandler('esx:playerLoaded', function(xPlayer)
	ESX.PlayerData = xPlayer
 	ESX.PlayerLoaded = true
end)

RegisterNetEvent('esx:onPlayerLogout')
AddEventHandler('esx:onPlayerLogout', function()
	ESX.PlayerLoaded = false
	ESX.PlayerData = {}
end)

Notes

• This resource is not compatible with ExtendedMode or previous versions of ESX
• Legacy, skin, and identity must be updated to at least the minimum commits specified above
• Characters are stored in the users table as char#:license - if you need to use a different identifier then you need to modify ESX itself
• Character deletion does not require manual entries for the tables to remove
• As characters are stored with unique identifiers, there is no excessive queries being executed

Kashacters

• This project is forked from the kashacters multicharacter resource
• Most of the code has been entirely rewritten
• KASH has given permission for this resource to use his code and the addition of a license
• The license obviously does not apply to previous versions and KASH has stated his resource is free to be used however

Notice

Copyright© 2021 Linden and KASH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses.

Thanks to KASH, XxFri3ndlyxX, and all those who have contributed