Make sure your folder is still named 'es_extended' or it will not work

Using the ESX import

• Add shared_script '@es_extended/imports.lua' to your fxmanifests
• Remove the old method TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)
• The old method will still function if you don't want to use the import
• If using the old method, add this event to the client

AddEventHandler('esx:setPlayerData', function(key, val)
	if GetInvokingResource() == 'es_extended' then
		ESX.PlayerData[key] = val
		-- EXAMPLE: if key == 'job' then print('Job was changed to '..ESX.PlayerData.job.name..' '..ESX.PlayerData.job.grade_label)
	end
end)

• You no longer need events like esx:setJob and don't need to perform ESX.GetPlayerData()

Changes (linden branch)

Any changes that are striked out have been officially added to ESX Legacy

• Superadmin is re-enabled
• If firstname, lastname, or phone columns exist then add them to xPlayer
• Removed pickups, loadouts, and other redundant functions or events
• Removed looping functions for saving weapon ammo and drawing pickups (handled by inventory)
• Removed commands that are handled by the inventory instead
  Add a TriggerEvent to ESX.SetPlayerData so we can tell other resources to update
  Only set networked vehicles as persistent and able to migrate
  Return entityCoords from ESX.Game.GetVehicleInDirection
  Only run ServerSyncLoops while ESX.PlayerLoaded is true
  Create an imports file to set ESX object and EventHandler for esx:setPlayerData
  Add a function to retrieve a playerId's identifier with ESX.GetIdentifier(playerId)

es_extended LEGACY / BROKEN / WONTFIX

Things hapenning here now https://github.com/ESX-Org/es_extended/tree/develop (WIP)

es_extended is a roleplay framework for FiveM. The to-go framework for creating an economy based roleplay server on FiveM and most popular on the platform, too!

Featuring many extra resources to fit roleplaying servers, here's a taste of what's available:

• esx_ambulancejob: play as a medic to revive players who are bleeding out. Complete with garages and respawn & bleedout system
• esx_policejob: patrol the city and arrest players commiting crime, with armory, outfit room and garages
• esx_vehicleshop: roleplay working in an vehicle dealership where you sell cars to players

ESX was initially developed by Gizz back in 2017 for his friend as the were creating an FiveM server and there wasn't any economy roleplaying frameworks available. The original code was written within a week or two and later open sourced, it has ever since been improved and parts been rewritten to further improve on it.

Links & Read more

• ESX Forum
• ESX Documentation
• ESX Development Discord
• FiveM Native Reference

Features

• Weight based inventory system
• Weapons support, including support for attachments and tints
• Supports different money accounts (defaulted with cash, bank and black money)
• Many official resources available in our GitHub
• Job system, with grades and clothes support
• Supports multiple languages, most strings are localized
• Easy to use API for developers to easily integrate ESX to their projects
• Register your own commands easily, with argument validation, chat suggestion and using FXServer ACL

Requirements

• mysql-async
• async

Download & Installation

Using Git

cd resources
git clone https://github.com/esx-framework/es_extended.git --branch legacy
git clone https://github.com/ESX-Org/esx_menu_default [esx]/[ui]/esx_menu_default
git clone https://github.com/ESX-Org/esx_menu_dialog [esx]/[ui]/esx_menu_dialog
git clone https://github.com/ESX-Org/esx_menu_list [esx]/[ui]/esx_menu_list

Plume ESX:

PlumeESX is a full featured (13 jobs) and highly configurable yet lightweight ESX v1.2 base that can be easily extendable. Forum Thread: https://forum.cfx.re/t/recipe-plumeesx-full-base-2021/1964029 YouTube Tutorial: https://www.youtube.com/watch?v=iGfwUCO0RZQ

Manually

• Download https://github.com/esx-framework/es_extended/releases/tag/v1-final
• Put it in the resource/[esx] directory
• Download https://github.com/ESX-Org/esx_menu_default/releases/latest
• Put it in the resource/[esx]/[ui] directory
• Download https://github.com/ESX-Org/esx_menu_dialog/releases/latest
• Put it in the resource/[esx]/[ui] directory
• Download https://github.com/ESX-Org/esx_menu_list/releases/latest
• Put it in the resource/[esx]/[ui] directory

Installation

• Import es_extended.sql in your database
• Configure your server.cfg to look like this

add_principal group.admin group.user
add_ace resource.es_extended command.add_ace allow
add_ace resource.es_extended command.add_principal allow
add_ace resource.es_extended command.remove_principal allow
add_ace resource.es_extended command.stop allow

start mysql-async
start es_extended

start esx_menu_default
start esx_menu_list
start esx_menu_dialog

Legal

License

es_extended - ESX framework for FiveM

Copyright (C) 2015-2021 Jérémie N'gadi

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 http://www.gnu.org/licenses/.