Releases: esx-framework/esx_core
1.10.8
We are pleased to announce the release of ESX Core version 1.10.8!
🚨 BREAKING CHANGES:
With 1.10.8, due to a major bug fix, the synchronization of metadata and xPlayer.set via statebags has been removed.
So now neither metadata nor xPlayer.set data are synchronized via statebagen. An older logic has been implemented that updates ESX.PlayerData
via this event esx:updatePlayerData
, which currently includes the metadata.
🚑 Urgent bug fix:
Currently, everything flowing through xPlayer.set is being put into a statebag, aswell as all metadata , resulting in crashes. #1407
🛠️ General Improvements:
- Updated license year:
Updated the license year in cron to reflect the current year and some other license changes #1387
- Using cached ped value:
Instead of PlayerPedId() we now use ESX.PlayerData.ped in progressBar #1385
- Lowercase account check:
Account function are not case sensitive anymore. You can use money
or Money
#1379
- General improvements of ESX.Streaming functions:
More in pull request #1303
- Cache resource states:
Now the status of addon resources such as esx_progressbar for better performance #1303
- Vehicle change check:
Implemented a better way of checking if player changed vehicle #1400
🌱 Fixes:
- xPlayer validation:
In chatMessage handler we now validate if xPlayer is not nil value #1384
- ESX.PlayerData.name fix:
Fix ESX.PlayerData.name value being nil #1388
- Spelling mistake:
Fixed spelling mistake in German locales (de.lua) #1383
- Prevent awaiting script:
Prevent scripts from awaiting when multicharacter is set to false. Learn more in the pull request #1396
- Typo fix
Fixed a parameter typo for printing "ignoring invalid .setJob() usage" #1403
- Fix job creation function
Fixed job creation function with full transaction for jobs
and job_grades
tables #1404
- Fix notify no valid icon
Fixed notify no valid icon #1406
What's Changed
- 🔀 Sync main to dev by @Gellipapa in #1376
- tweak(Server/Classes/Player) Lowercase account check by @Mycroft-Studios in #1379
- fix(es_extended/locales/de.lua): fixed translation by @Mirrrrrow in #1383
- fix(server): attempt to index a nil value (local 'xPlayer') by @someone005 in #1384
- refactor: used cached esx ped and fixed some lua ls annotations by @Mirrrrrow in #1385
- 🚑 Fix player data name value by @Gellipapa in #1388
- fix(esx_core): correct licenses, remove license from package, update license years, create license for progressbar by @Arctos2win in #1387
- fix(ex_extended): prevent scripts from awaiting when multicharacter is false by @RrybaN in #1396
- 📦 disabled police scanner sound by @Gellipapa in #1397
- refactor(es_extended/client/functions.lua) and (es_extended/client/modules/streaming.lua) by @feelfreetofee in #1303
- fix(client/modules/actions.lua): check if vehicle changed by @Arctos2win in #1399
- fix(client/modules/actions.lua): better solution by @Arctos2win in #1400
- Typo fix by @STACHY225 in #1403
- Dev - Fix job creation with full transaction for
jobs
andjob_grades
tables by @Mesrine67 in #1404 - fix(notify): no valid icon by @someone005 in #1406
- !Refactor(core): Statebag removal and changes by @Mycroft-Studios in #1407
New Contributors
- @Mirrrrrow made their first contribution in #1383
- @someone005 made their first contribution in #1384
- @RrybaN made their first contribution in #1396
- @STACHY225 made their first contribution in #1403
- @Mesrine67 made their first contribution in #1404
Full Changelog: 1.10.7...1.10.8
1.10.7
Hotfix update
Hotfix update for 1.10.7
🌱 Fixes
- Remove duplicate common/functions.lua file in fxmanifest
- xPlayer.getCoords backwards compatibility
What's Changed
- fix(es_extended): xPlayer.getCoords backwards compatibility by @Arctos2win in #1374
- 📦 Hotfix 1.10.7 by @Gellipapa in #1375
Full Changelog: 1.10.6...1.10.7
1.10.6
ESX Core Update 1.10.6: Bug Fixes and New Features
We are pleased to announce the release of ESX Core version 1.10.6! This update primarily focuses on fixing bugs and introducing new features to improve the overall functionality of our framework.
🛠️ General Improvements:
- Updated License Year: Updated the license year to reflect the current year #1335 #1336.
- Better Resource Descriptions: Enhanced descriptions for resources to improve clarity and usability #1310.
- Optimized Loops: Converted some pairs & ipairs loops to numeric loops for better performance #1334.
- Enhanced Burst Tyre Saving: Improved the process for saving burst tyre data #1333.
- Typo Fixes: Corrected several misspellings in our resources #1312 #1357.
- Heading Data Storage: Player heading is now saved to the database upon leaving the game like before #1330.
- Improved CreateJob Handling: Enhanced error handling and overall functionality for the
ESX.CreateJob
feature #1355. - New Locales: Added new locales for German (
de.lua
) and Greek (gr.lua
). Thanks to JustZeroo and RoyaleWind 🚀 #1271 #1302.
🆕 New Additions:
- Group Event Trigger: After setting a group, an event
esx:setGroup
is triggered allowing the client to retrieve the group viaESX.PlayerData.group
#1351. - Vehicle and Seat Data: In the action module, the player's vehicle and seat data are now automatically set in
ESX.PlayerData.vehicle
andESX.PlayerData.seat
#1311.if ESX.PlayerData.vehicle then print('Player is in vehicle ID: ' .. ESX.PlayerData.vehicle) print('Player is sitting in seat: ' .. ESX.PlayerData.seat) end
- Type Validation Functions: Introduced new functions
ESX.ValidateType
andESX.AssertType
as part of PR #1309. Usage described in this pull request. Soon available in new documentation. - Random Math Function: Added a new function
ESX.Math.Random
to the math module #1330.local randomNumber = ESX.Math.Random(1, 100) print('Random number: ' .. randomNumber)
- Trigger Client Event: New function
ESX.TriggerClientEvent
to trigger events for one or more clients #1342.--- @param eventName string The name of the event to trigger. --- @param playerIds table|number If a number, represents a single player ID. If a table, represents an array of player IDs. --- @param ... any Additional arguments to pass to the event handler. ESX.TriggerClientEvent('esx:test', {1, 2, 3}, test)
⛔ Removals:
- Unnecessary Code: Deleted unnecessary code and removed redundant waiting for vehicle properties in
StateBagChangeHandler
#1296.
🌱 Fixes:
- Inventory Weight Sync: Fixed the client-side sync issue with
ox_inventory
setMaxWeight #1343. - Default Spawn Position: Fixed the issue with getting a random DefaultSpawn position #1356.
- Fixed Header Parameter: Fixed the header parameter in DefaultSpawnPosition #1339.
- jQuery Element Handling: Fixed jQuery issue with element IDs containing colons by using
document.getElementById
and wrapping with$()
, preventingUncaught TypeError
inesx_menu_default
#1359. - SQL Query Fix: Fixed SQL query in
main.lua
to allow deletion of rows where the table name contains special characters like hyphens #1358.
What's Changed
- Remove or statements that don't do stuff by @Arctos2win in #1298
- minimize DoesJobExist function by @Arctos2win in #1299
- Fix VehicleProperties function and remove credits by @Arctos2win in #1296
- 1.10.4 hotfix sync by @Thekuca in #1301
- main🔁dev - sync by @Thekuca in #1305
- Added Greek language to multicharacter by @RoyaleWind in #1302
- refactor: add better descriptions to the fxmanifests by @Mycroft-Studios in #1310
- hotfix(es_extended/client/main.lua):reinitiating backwards compatibility with spawnmanager by @Arctos2win in #1313
- fix(es_extended/config.lua): Fix Typo Errors by @KeeganAI in #1312
- 🚑 1.10.5 merge to main by @Gellipapa in #1317
- 🔀 Main to dev sync by @Gellipapa in #1328
- chore(LICENSE): update copyright year by @Thekuca in #1335
- chore(©️) by @Thekuca in #1336
- perf/refactor(client/functions): replace pairs loops with for loops where possible by @itsmaty in #1334
- refactor(client/functions): refactor getting burst tyres on vehicle by @itsmaty in #1333
- fix(multicharacter/config): predefined spawn with incorrent defined heading by @itIsMaku in #1339
- added heading again for xPlayer.getCoords() by @TrymTube in #1330
- fix: ox_inventory setMaxWeight client-side sync by @tomson701 in #1343
- refactor(es_extended): put identical object related code into one file by @Arctos2win in #1346
- feat(es_extended/server/functions): add ESX.TriggerClientEvent by @Kenshiin13 in #1342
- feat: add TypeCheck to check value types by @CENSOR1337 in #1309
- Update actions.lua by @Marlox4 in #1311
- feat(Player): implement
esx:setGroup
event by @tomiichx in #1351 - Adding German Language Support by @JustZerooo in #1271
- 📦 Implemented new better createJob method by @Gellipapa in #1355
- 🚑 Fix random default spawn coords by @Gellipapa in #1356
- fix(es_extended/server/functions.lua): fixed mistyped variable by @KeeganAI in #1357
- fixed sql query main.lua by @ethandudu in #1358
- fix(esx_menu_default): jquery handling element id by @itIsMaku in #1359
- 🔧 Added manual run option to lint github action by @Gellipapa in #1361
- 🔧 Fix lint errors by @Gellipapa in #1362
- 📄 1.10.6 Release by @Gellipapa in #1363
New Contributors
- @RoyaleWind made their first contribution in #1302
- @KeeganAI made their first contribution in #1312
- @itsmaty made their first contribution in #1334
- @itIsMaku made their first contribution in #1339
- @tomson701 made their first contribution in #1343
- @Marlox4 made their first contribution in #1311
- @JustZerooo made their first contribution in #1271
- @ethandudu made their first contribution in #1358
Full Changelog: 1.10.5...1.10.6
1.10.5
Hotfix update
Hotfix update for 1.10.4
🌱 Fixes
- Backwards compatibility playerSpawned event
What's Changed
- hotfix(es_extended/client/main.lua):reinitiating backwards compatibil… by @Arctos2win in #1314
Full Changelog: 1.10.4...1.10.5
1.10.4
1.10.3
Updates in version ESX 1.10.3
Core Scripts Update :
Thanks to the people behind the scenes who make this update possible, especially our translators, developers, team leaders and all contributors 😍
The major change is that the 6188 artifact is now needed to run the ESX Framework due to the use of the GetPlayerIdentifierByType native
🛠️ General Improvements:
- Resolved various lint errors, including unused values and extra whitespaces.
- Some formatting of the code
- Update some translations (
Slovenian
,Finnish
,German
,Swedish
,Hebrew
,French
,Czech
) and created some new translations (Indonesian
) - Improved
ESX.Game.SpawnObject
function by removing the callback and using the network function directly with a native - Optimization and overall improvement of functions
ESX.SearchInventory
,ESX.Game.GetPeds
,ESX.Game.GetPlayers
,ESX.ShowInventory
and of an eventremoveInventoryItem
- Add underflow check for
removeAccountMoney
- General improvement of
setJob
function - Use ESX.RegisterInput for
/showinv
- The
loadESXPlayer
function has been rewritten and improved - We do not save a player unless he is spawned
⛔ Removed:
- Remove of the calback for spawn object networking. Now we handle that with natives.
🌱 Fixes:
- Add missing onCancel callback method to progressbar
- Fixed bug in metadata. Now the metadata value can be set to
false
- Fixed bug with DisableHealthRegeneration (It needs to be re-setted on ped change)
- Fixed player collision bug when spawning using HasCollisionLoadedAroundEntity property
- Fixed date of birth checking in esx_identity
- Added default value for skin_male and skin_female.
- Added missing columm label to banking table
Addons Scripts Update :
-
Overall, a few addon resources have been improved. We also prevent exploits in
esx_drugs
. -
In
esx_barbershop
we are caching player skins for better performance. -
In policejob we are caching fine types for better database optimization.
https://github.com/esx-framework/esx_core/releases/tag/1.10.3
What's Changed
- update: Change manifest version in #1223
- sync dev branch by @TheFantomas in #1225
- 🚑 Fix server commands in server console by @Gellipapa in #1227
- ♻️ Synch main to dev by @Gellipapa in #1228
- remove callback by @Arctos2win in #1229
- add native to dependencies by @Arctos2win in #1231
- Updated fi.lua by @Bloope18 in #1234
- improve multiple functions and one event by @Arctos2win in #1232
- refactor(Player Class): Typing Code & Perf by @Walker974 in #1217
- quick fix by @Arctos2win in #1236
- Update de.lua by @ItzTrivial in #1237
- Create sv.lua by @Dannezzzan in #1239
- Create sv.lua by @Dannezzzan in #1238
- Create sv.js by @Dannezzzan in #1243
- Create sv.lua by @Dannezzzan in #1242
- Create sv.lua by @Dannezzzan in #1241
- Create sv.lua by @Dannezzzan in #1240
- 🔧 Added missing onCancel callback to progressbar by @Gellipapa in #1247
- Prevent Integer Underflow in Account Balance Update by @Kenshiin13 in #1253
- fix: (esx_multicharacter) FR translation by @Cartman117 in #1254
- improve setjob function by @Arctos2win in #1255
- Create id.lua by @IAmNotGod-core in #1258
- fix(es_extended/server/classes/player): trying to use non existent event by @Thekuca in #1263
- fix player metadata can get set to false. by @Arctos2win in #1266
- fix(es_extended/client/modules/actions): player health regeneration by @Thekuca in #1277
- refactor(es_extended/client/main): use esx keymapping function by @Thekuca in #1278
- chore(readme.md) by @Thekuca in #1283
- ESX.CreateJob - Fixed error for skin no default value by @t1ger-scripts in #1282
- Added ESX.DeleteJob for Runtime by @t1ger-scripts in #1281
- Revert "Added ESX.DeleteJob for Runtime" by @Arctos2win in #1284
- sl.lua by @C3-FrameWork in #1252
- Fix checkDOBFormat by @xtrsyz in #1279
- Dev Update Hebrew by @thefourcraft in #1250
- fix(SQL): fixed missing column by @zRxnx in #1289
- REwrite LoadESXPlayer by @Arctos2win in #1290
- 🎉 New release 1.10.3 by @Gellipapa in #1292
- Fix for ox inventory by @Arctos2win in #1293
New Contributors
- @Dannezzzan made their first contribution in #1239
- @IAmNotGod-core made their first contribution in #1258
- @t1ger-scripts made their first contribution in #1282
- @xtrsyz made their first contribution in #1279
- @zRxnx made their first contribution in #1289
Full Changelog: 1.10.2...1.10.3
1.10.2
Updates in version ESX 1.10.2
Thanks to the men behind the scenes who make this update possible, especially itsfantik, gellipapa, rav3n95, arctos, thekuca and all Translator <3
🔨 General Improvements:
- Resolved various lint errors, including unused values and extra whitespaces.
- Enhanced ESX.Context availability handling in
es_extended
. - Converted some
ipairs
loops to numeric loops for optimization. - Enabled console usage for commands and refined log outputs.
- Introduced a new command type for coordinates.
- Added new localizations
🆕 New Features:
- Automatically close all ESX menus upon stopping the
esx_menu_default
resource. - Health and Armor states are now saved through metadata.
- Introduced a
repair/fix
command that also cleans your vehicle. - Starting inventory items are now configurable (Not applicable to
ox_inventory
). - Added an option to disable ammo display in the config file.
- Added a new weapon:
WEAPON_HEAVYRIFLE
. - Introduced new
xPlayer.admin
functionalities. - Implemented measures to halt resources that are incompatible with ESX (for example essentialmode will be stopped by es extended)
⚙ New Utility Functions:
- Upgraded
xPlayer
Metadata Management with the addition of subValue arguments. - Improved ESX Core Cron Task Management.
- Added function
ESX.GetNumPlayers
for retrieving the number of players in a specific job.
⛔ Removed:
- Deleted
driftTyres
fromESX.VehProperties
as it was non-functional across all FiveM versions.
🌱 Bug Fixes:
- Resolved all mismatched vehicle types.
- Corrected vehicle event warning messages.
- Fixed
noclip
notification issue. - Addressed issues with the
getNearbyPlayers
function (ESX.OneSync.GetPlayersInArea
,ESX.OneSync.GetClosestPlayer
).
https://github.com/esx-framework/esx_core/releases/tag/1.10.2
New Contributors
- @Cookiieezz made their first contribution in #1116
- @wornysek made their first contribution in #1108
- @tekkenkkk made their first contribution in #1121
- @ItsKuf made their first contribution in #1130
- @CanysLypys made their first contribution in #1119
- @thefourcraft made their first contribution in #1117
- @DasistOnly made their first contribution in #1149
- @Kenshiin13 made their first contribution in #1154
- @YOMAN1792 made their first contribution in #1147
- @Xray51YT made their first contribution in #1167
- @WirzRexTon made their first contribution in #1178
- @KadDarem made their first contribution in #1173
- @steliosgaminggr made their first contribution in #1203
- @Walker974 made their first contribution in #1208
- @xavitoxdeb made their first contribution in #1218
Full Changelog: 1.10.1...1.10.2
1.10.1
Updates in version ESX 1.10.1
⛔ Removals:
- Removed esx:removeWeapon now you must use xPlayer.removeWeapon which automatically deletes weapons using RPC native and does not need to use client side and event esx:removeWeapon.
🌱 Fixes:
- Resolved the issue of wheel saving and custom wheel saving
- Fixed saving of drift wheels and typo in variable driftTyresEnabled
New Contributors
Full Changelog: 1.10...1.10.1
1.10
Updates in version ESX 1.10
🔨 General Updates:
- Entire code has been formatted with the Lua extension (settings in .editorconfig) and Prettier.
- Resolved a large portion of lint errors including unused variables, whitespaces, and function arguments.
- Updated locales (A big thanks to all our translators! ❤️ )
- Enhanced some JavaScript performance
- Removed jQuery from esx_identity.
🆕 New Additions :
- Introduced support for MultiSpawns in es_extended config.
- Added a new AdminGroups table in es_extended config.
- Added logging for admin commands to Discord (when an admin uses a command, a message on discord will be sent)
- Disabled custom
ESX.A111
vehicle plate in esx_config. - New weapons added from latest DLCs (
WEAPON_METALDETECTOR, WEAPON_PISTOLXM3, WEAPON_ACIDPACKAGE, WEAPON_CANDYCANE, WEAPON_RAILGUNXM3
). - Added support for drift tires, bulletproof wheels, roof livery, and custom wheels in VehicleProperties.
- Added
esx:spawnVehicle
event.
⚙️ New Functions:
- Added
ESX.GetAccount
function.
⛔ Removals:
- Removed
self.updateCoords
for optimized position saving.
🌱 Fixes:
- Fixed OneSync range error handling in
ESX.Game.SpawnVehicle.
- Resolved the issue of not being able to rotate while creating a character with esx_skin.
New Contributors
- @Blo0per made their first contribution in #974
- @pecedevelopment made their first contribution in #966
- @donxp made their first contribution in #957
- @ExTTaSy made their first contribution in #969
- @DyroS3 made their first contribution in #971
- @StomperG made their first contribution in #970
- @pelaoloko made their first contribution in #989
- @Kraleemil made their first contribution in #941
- @KiLaOriginal made their first contribution in #998
- @C3-FrameWork made their first contribution in #999
- @FacoSL made their first contribution in #1012
- @GurraG004 made their first contribution in #1004
- @NeMyOriginal made their first contribution in #1006
- @AzSumPesho made their first contribution in #1046
- @thesysadmindev made their first contribution in #1047
- @itsfaizy made their first contribution in #884
- @Cyzxin made their first contribution in #1049
- @fekydev made their first contribution in #1043
- @r3ps4J made their first contribution in #1057
- @falszywyyy made their first contribution in #1058
- @CENSOR1337 made their first contribution in #1037
- @FilipeCuco made their first contribution in #1061
- @Lenny822 made their first contribution in #1070
- @TheKetur55 made their first contribution in #1060
- @lxi1400 made their first contribution in #1074
- @epyidev made their first contribution in #1094
Full Changelog: 1.9.4...1.10
1.9.4
What's Changed
- feat: Metadata by @Rav3n95 in #912
- feat(es_extended): callback functions, vehicle type by @CsokiHUN in #886
- feat(es_extended/locales): Added IT Locale by @NikartikTheBear in #917
- Fix: Metadata update to client side by @Rav3n95 in #918
- refactor: more logical code by @MoskalykA in #920
- fix(es_extended/server/classes/player.lua): negative removeInventroyItem count by @3869542 in #928
- feat(es_extended/common/modules): TableContains by @baguscodestudio in #925
- Feat/Fix(es_extended & esx_multicharacter): Added Validations + bug fixes by @Mycroft-Studios in #922
- refactor(core): reformatting code with prettier by @MoskalykA in #879
- refactor(playerActive): longer refreshment time by @MoskalykA in #929
- feat(es_extended/client/modules/actions.lua): Added disable seat shuff (PART 2) by @Thekuca in #930
- feat(es_extended/config.lua): Adding disable seat shuff (PART 1) by @Thekuca in #931
- fix: could not find file
nui/img/*.png
by @MoskalykA in #935 - chore(esx_identity/locales/nl.lua): Update Dutch Locales by @Arctos2win in #937
- Feat: Disable config options by @Rav3n95 in #939
- chore(core): Update Dutch(nl) locales by @Arctos2win in #940
- chore(esx_multicharacter): Update Dutch(nl) locales by @Arctos2win in #943
- Update metadata by @Rav3n95 in #942
- Update de.lua - 変態#9999 by @ChrissisCodeXD in #944
- refactor(cron/server/main): Micro change by @Thekuca in #945
- Tweak(esx_multicharacter): update Readme by @Mycroft-Studios in #949
- fix(es_extended/server/functions.lua): Added model argument to callback by @TheFantomas in #955
- 1.9.4 by @jbdevic in #959
New Contributors
- @NikartikTheBear made their first contribution in #917
- @3869542 made their first contribution in #928
- @Thekuca made their first contribution in #930
- @Arctos2win made their first contribution in #937
- @ChrissisCodeXD made their first contribution in #944
Full Changelog: 1.9.3...1.9.4