qs-core: The Free FiveM Framework That Runs ESX and QBCore
qs-core (Quasar Framework) is a free, open-source FiveM framework that runs ESX and QBCore scripts on one server. Full features and txAdmin install guide.
qs-core (Quasar Framework): The Free FiveM Framework That Runs ESX and QBCore Scripts on One Server#
For as long as FiveM roleplay has existed, every new server has started with the same question: ESX or QBCore? Pick one and you give up half of the scripts on the market. Pick the other and you pay for conversions, maintain forks and turn down resources you would love to run.
qs-core, also called Quasar Framework, ends that choice. It is a made by Quasar Store that runs , with one player, one wallet and one inventory behind all of them. It ships a complete, playable roleplay base and installs in .
[04]Newsletter
Never miss a release
One short email when something ships: what changed, what breaks, and how to roll it out on a live server. No spam, ever.
New scripts
Breaking changes
Server guides
1,000+server owners subscribed
Double opt-in · free
Get the next drop
We only use your email for this newsletter. One click to unsubscribe, any time.
91views
1comments
2reactions
free, open-source FiveM roleplay framework
ESX scripts, QBCore scripts and its own qs-core scripts on the same server
one click with txAdmin
This is the complete guide: what a FiveM framework is, how qs-core's multi-framework bridges work, every system it includes, a step-by-step txAdmin installation guide, commands, configuration, how to add your own items, cars and jobs, troubleshooting and a long FAQ. Bookmark it.
A FiveM server is a collection of resources: folders of Lua, JavaScript and web files that each add something to the game, from a phone to a police job. Most of them need the same basic things: who the player is, how much money they have, what job they do and what they carry. The framework is the resource that answers those questions for everyone else.
The player object: identity, character data, money accounts, job, gang and metadata.
The items: what exists, what can be used and who carries what.
The server logic: callbacks, commands and the events scripts listen to, such as a player loading in or dying.
The database: where all of that is saved between sessions.
Two frameworks dominate FiveM roleplay: ESX Legacy (its resource is called es_extended) and QBCore (qb-core). Each one exposes its own API, and every script connects to it with its own line of code:
lua
local ESX = exports['es_extended']:getSharedObject()
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addMoney(500)
lua
local QBCore = exports['qb-core']:GetCoreObject()
local Player = QBCore.Functions.GetPlayer(source)
Player.Functions.RemoveMoney('cash', 350)
A script written for ESX does not run on QBCore, and the other way round, unless someone converts it. So the framework you pick on day one decides which scripts you can ever install. Until now, crossing that line meant paying for conversions and maintaining forks: modified copies of scripts that break with every update.
"Choosing between ESX and QBCore used to mean giving up half of the scripts on the market."
qs-core is what Quasar Store calls "the first multi-framework for FiveM": one core that speaks ESX, QBCore and its own API at the same time, so every script you own runs on the same server, with the same players, the same money and the same inventory, without touching a single line of its code.
It is not a fork. The core is written from scratch and ships a complete, playable base (characters, inventory, every GTA weapon, jobs, police, EMS, banking, vehicles, HUD and chat) with a single shared UI theme, ready to deploy from txAdmin in one click.
Creators are already testing it. In this review, Velo Hub walks through Quasar Framework, its bridges and its custom core. More reactions, reviews and guides are collected on the Quasar Framework videos page.
How qs-core Runs ESX and QBCore Scripts: the Multi-Framework Explained#
Diagram: how qs-core runs ESX and QBCore scripts through the es_extended and qb-core bridges on one shared player
The trick is simple and clever. qs-core ships two bridge resources named exactly like the frameworks they replace: es_extended and qb-core. An ESX script that asks for exports['es_extended'] finds the first one. A QBCore script that asks for exports['qb-core'] finds the second. Neither knows it is actually talking to qs-core.
Behind those objects, every call is answered by the same qs-core player. A job set by an ESX script is the job a QBCore script sees, and money earned in one is spent in the other.
Picture a player with $1,000 in cash. An ESX job pays them $500. Then they buy something for $350 in a QBCore shop:
The ESX job calls xPlayer.addMoney(500). The es_extended bridge passes it to qs-core: $1,500.
The QBCore shop calls Player.Functions.RemoveMoney('cash', 350). The qb-core bridge passes it to the same qs-core player: $1,150.
Both scripts now read $1,150. There is only one balance.
You can see it in the published code. In the ESX bridge, a player's addMoney does one thing: call the core. In the QBCore bridge, AddMoney does the same:
lua
functionself.addMoney(amount, reason)return core:AddMoney(src, 'cash', math.floor(tonumber(amount) or0), reason)
end
lua
functionself.Functions.AddMoney(moneytype, amount, reason)local ok = core:AddAccountMoney(src, moneytype, amount, reason)
if ok then refresh() endreturn ok
end
As the Quasar Framework website puts it: "The money an ESX job pays is the money a QBCore shop charges."
No. The core is Quasar Store's own, written from scratch. To make the bridges answer exactly like the originals, the bridge resources contain code derived from ESX Legacy and QBCore, both GPL-3.0, and the NOTICE file credits their authors file by file. qs-core is not affiliated with or endorsed by the ESX or QBCore projects.
qs-core is far more than two bridges. It is a full roleplay server: 28 resources in three folders, 16 web interfaces and one visual theme. According to TopV Magazine's count of the repository, that adds up to 36,884 lines of source code.
Players arrive on a loading screen with your server name and the default keys. On their very first join, a short intro lets them choose the colours of every interface. It only plays once (/introreset plays it again).
A multicharacter screen with a cinematic camera gives every player up to 5 characters. Creating one asks for first and last name, date of birth, nationality and sex, then opens a full clothing editor. Clothing stores, barbers and tattoo parlours are spread across the map, and the downed state, EMS revive and hospital respawn are built in.
A weight and slot inventory (F1) with stashes, trunks and gloveboxes, quick slots on 1 to 5 and an item wheel on TAB that replaces the GTA weapon wheel. Right-click an item to split, use, give or drop it.
Every GTA V weapon is an item: 105 of them, from the knife and the bat to the Mk II rifles, the railgun and the minigun, with ammo by type (ammo_pistol, ammo_rifle…). Throwables are spent when thrown, and no native GTA loot drops on death.
Vehicles: Real Keys, Hotwiring, Garages and a Dealership#
Owned vehicles come with real keys: lock and unlock them with U, share them with /givekeys, and hotwire what is not yours with G through a lockpick minigame. Job and admin vehicles come with keys too. Garages with a 3D preview show fuel, engine and body condition, and a dealership sells cars by category from a showroom.
Full reference: Vehicles in the Quasar Framework documentation.
Cash, bank and black money. ATMs and bank branches handle deposits, withdrawals, transfers and transaction history; shops with peds and blips validate every purchase on the server; and paychecks are paid by job grade. Most importantly, ESX and QBCore scripts read and spend the same balances.
Full reference: Economy & Banking in the Quasar Framework documentation.
A job center offers activity jobs such as delivery driver, miner, lumberjack and fisherman, built on gather, process, sell and deliver loops, each with its own salary. Jobs and grades live in one Lua file, so adding your own takes a minute (see the guide below).
qs-core FiveM job center with delivery driver, miner, lumberjack and fisherman jobs
Police: Cuffs, Searches, Fines, Evidence and Armory#
The police can cuff, escort, search, fine and put suspects in vehicles, collect evidence such as bullet casings and blood samples and analyse it in a forensics lab, and gear up at the armory. Every action is on the job menu (F6), and officers keep moving while it is open.
When a player goes down, a downed screen shows a timer and a key to call the paramedics. EMS can diagnose injuries by body part (bleeding, bruises, burns), treat them with the right items and use a stretcher. Respawn happens at the hospital.
The HUD shows health, armour, hunger, thirst, money and job, with a speedometer, gear, seatbelt and fuel when driving; the minimap appears in vehicles and hides on foot. The chat suggests every command you can use while you type, and the classic roleplay commands are in: /me, /do, /ooc, /b, /try, /pm and /ame.
Every interface reads the same palette. Players pick theirs in the intro or later with /colors: Ocean, Cyan, Emerald, Violet, Rose, Crimson, Amber or Slate, or a custom primary and accent colour. The HUD, menus, inventory and notifications change at once, and the server sets its default palette in a single config file.
The eight qs-core colour palettes on the inventory: Ocean, Cyan, Emerald, Violet, Rose, Crimson, Amber and Slate
An ACE-protected admin menu opens with /admin: players (kick, ban with expiry, set job and group, give money, items and weapons), self tools (noclip, godmode, teleports, vehicle tools) and server tools such as announcements and freezing the time and weather for everyone. On top of the menu there are more than 25 admin commands, and it works with txAdmin: its Heal also revives downed players.
Full reference: Administration in the Quasar Framework documentation.
Resmon (FiveM's resource monitor) shows how many milliseconds each resource costs per frame, and a heavy framework slows down every player. qs-core is built to stay out of your frame budget:
Principle
What it means
Event-driven
Logic reacts to events instead of polling: nothing runs every frame while you are idle.
Per-frame only when needed
The few per-frame tasks, like holding the item wheel or getting into a vehicle, stop as soon as you are done.
One save path
qs-core is the single place that saves players, so the bridges never write to the database twice.
How to Install qs-core with txAdmin: Step-by-Step Guide#
The recommended way to install qs-core is txAdmin, the web panel that ships with every FiveM server. You do not need to know anything about servers: follow the steps in order and you will be playing in about fifteen minutes.
A recent Windows or Linux artifact with support for game build 3751. Use the latest Recommended build from the Windows artifacts or Linux artifacts page.
Database
MySQL 8.0+ or MariaDB 10.4+. You only need it running: txAdmin creates the database. Download MariaDB.
License key
A free Cfx.re server key from portal.cfx.re. It starts with cfxk_.
OneSync
Required. The recipe turns it on for you.
Everything else
oxmysql, ox_lib, pma-voice, the maps and the IPL loader are downloaded by the recipe.
A recipe is a YAML file that tells txAdmin how to build a server: what to download, what to import into the database and which server.cfg to write. qs-core's recipe lives on GitHub (recipe.yaml), and you only need its raw URL:
Sign in at portal.cfx.re with your Cfx.re account and create a server license key. Copy it somewhere safe: it starts with cfxk_.
Install a database
Download MariaDB and install it. During the setup, choose a password for the root user and keep the default port 3306. Write the password down: you need it in step 6.
Already running MySQL or XAMPP? You can use it instead. Do not create any database by hand.
Download the server
Open the FiveM server artifacts page and download the latest Recommended build (server.7z). Create a folder such as C:\FXServer\server and extract it there with 7-Zip.
Open txAdmin
Run FXServer.exe. A console window opens and so does your browser on http://localhost:40120 (type it yourself if it does not). Link your Cfx.re account with the PIN shown in the console, then create a backup password.
Choose the Quasar Framework recipe
Give your server a name and press Next. In Deployment Type choose Remote URL Template and paste this URL:
If you do not use txAdmin, or you want to add qs-core to an existing server folder:
Copy the resources
Download qs-core from GitHub and copy [core], [addons] and [bridge] into your resources folder.
Import the database
Import [core]/qs-core/sql/qscore.sql into an empty database.
Install the dependencies
oxmysql, ox_lib, pma-voice, bob74_ipl, the Pillbox hospital interior and, from cfx-server-data, mapmanager and spawnmanager. Do not add basic-gamemode: its autospawn fights the downed state.
Use the server.cfg template
Copy qs-recipes/server.cfg next to your server and replace the {{...}} placeholders. Keep its ensure list in the same order: resources start by name in boot order.
Full reference: Installation in the Quasar Framework documentation.
If a script lists es_extended or qb-core as a dependency, it is already there. Libraries such as ox_lib, qb-target, qb-menu, qb-input and PolyZone work as they are.
If a script still throws errors, check that it starts after ensure [bridge] and that it is not in the not-covered list, then open an issue on GitHub with the error.
Use setr qs:locale "es", not set: players only receive replicated values. Codes: en, es, fr, de, it, pt, pl, ru, tr, ar.
Default colours
[core]/qs-core/shared/config.lua
Config.Theme is the palette players see before choosing their own with /colors.
Intro
[core]/qs-intro/config.lua
Config.Enabled = false turns the intro off.
Optional systems
server.cfg
Remove the ensure line of any resource in [addons] to turn it off.
Recent versions also added Config.MinimapOnlyInVehicle (qs-corehud), Config.DisableVehicleFires, Config.DisableWeaponScroll and Config.RemoveAnimals (qs-core), Config.MarkerDistance (qs-garage), Config.MenuKey (qs-police and qs-ambulance) and Config.HiddenCommands (qs-corechat).
Full reference: Configuration in the Quasar Framework documentation.
How to Add Items, Weapons, Food, Shop Products, Cars and Jobs#
Everything here is plain Lua. Open the file with any text editor, add the line from the example, change the values and restart the server.
Add a line inside local base = { ... } in [core]/qs-core/shared/items.lua. The name on the left is the item id that commands and scripts use, weight is in grams and useable = true lets players use it from the inventory.
To give it an image, save a square PNG with a transparent background in [core]/qs-coreinventory/web/images/, named exactly like the item: goldbar.png.
Register the item with useable = true, then add it inside NeedsConfig.Consumables in [core]/qs-needs/shared/config.lua. hunger and thirst are how much it fills (0 to 100) and verb picks the eat or drink animation.
The 105 GTA weapons and their ammo are already items. For an add-on weapon, start its resource and add it inside WeaponsConfig.Weapons in [core]/qs-coreweapons/config.lua. cat sets the ammo it uses: pistol, smg, rifle, shotgun, sniper or mg.
Add this line at the end of [addons]/qs-vehicleshop/config.lua with one of its categories: compacts, sedans, suvs, sports, offroad or motorcycles. model is the spawn name; for add-on cars, start the car's resource first.
Add a new entry inside Jobs = { ... } in [core]/qs-core/shared/jobs.lua. Grades start at 0, salary is paid automatically and isBoss = true marks the boss grade.
qs-core comes from the team behind Quasar Store, the ecosystem of premium FiveM scripts for ESX and QBCore. That pays off: Quasar Store scripts that support ESX or QBCore run on qs-core through the bridges, with no conversion.
Quasar Smartphone: the most advanced and fastest FiveM phone ever created.
Housing Creator: realistic home ownership and rentals, built in game.
Police Creator: CAD, MDT, dispatch, reports and a criminal database.
Advanced Inventory: RPG progression, crafting, missions, advanced shops and a hotbar.
Crime Creator: gangs, territories, missions, graffiti and illegal activities.
Mechanic Creator: tuning areas and vehicle lifts with unique 3D models.
Restaurant Creator: in-game creation, cooking minigames and order management.
qs-core is licensed under the GNU General Public License v3.0 (GPL-3.0-only). In plain words: you can run it, read it, change it and build on it, and if you distribute a modified version you share its source code too.
Found a bug during the beta? Open an issue on GitHub with the error and how to reproduce it.
Want to help? Pull requests are welcome: keep changes focused, match the style of the surrounding code and test them on a running server first.
Credits: the bridges contain code derived from ESX Legacy and QBCore, listed file by file in the NOTICE.
On launch day, TopV Magazine opened the qs-core code and counted what is inside: 28 resources, 36,884 lines of source code, 16 web interfaces, 10 languages and 105 weapons as items. Its analysis explains the problem qs-core solves, how the two bridges send every call to one player, what the recipe installs and what to know before installing.
"Quasar Store releases a free framework that runs ESX and QBCore scripts on the same server."
qs-core (Quasar Framework) is a free, open-source FiveM roleplay framework by Quasar Store. It ships a complete roleplay base and two bridges, es_extended and qb-core, so ESX and QBCore scripts run on the same server with one shared player.
Is qs-core free?
Yes. It is open source under GPL-3.0. Run it, change it and build on it; if you distribute a modified version, share its source too.
Do my ESX and QBCore scripts work without changes?
Most do. The bridges answer as es_extended and qb-core, so scripts load them the usual way. Qbox-only scripts, scripts that call qb-inventory or ox_inventory exports directly, and scripts that edit money with raw SQL are not covered yet.
Can I run ESX and QBCore scripts at the same time?
Yes, that is the point. Both bridges run together and share the same player: a job set by an ESX script is the job a QBCore script sees.
Should I install the real es_extended or qb-core?
No. The bridges already use those names. Installing the real frameworks next to them breaks both.
Does qs-core support Qbox?
Qbox scripts that are compatible with QBCore run through the QBCore bridge. Scripts written only for Qbox (qbx_core) are not supported yet.
How do I install qs-core?
In txAdmin, choose Remote URL Template and paste https://raw.githubusercontent.com/imnotquasar/qs-core/main/qs-recipes/recipe.yaml. Fill in your license key and database and run the recipe. The full walkthrough is in the install guide.
What do I need to run it?
A recent FXServer artifact with game build 3751, MySQL 8+ or MariaDB 10.4+, OneSync and a Cfx.re license key. The txAdmin recipe installs everything else.
How do I change the language?
Set setr qs:locale "es" (or any of en, es, fr, de, it, pt, pl, ru, tr, ar) in server.cfg and restart.
How do I make someone an admin?
Ask them to join and run /setgroup <id> admin, or add add_principal identifier.fivem:<id> group.admin to server.cfg.
Does it work with Quasar Store scripts?
Yes. Quasar Store scripts that support ESX or QBCore run through the bridges, and qs-inventory can replace qs-coreinventory (run it instead of it, not next to it).
Is it ready for production?
qs-core is in its public testing phase. It boots clean and is fully playable, but test it on your server before you open it to players, and report what you find on GitHub.
Can I turn off systems I do not want?
Yes. Everything in [addons] is optional: remove its ensure line in server.cfg.
qs-core takes the oldest question in FiveM roleplay, ESX or QBCore, and answers it with both. Two bridges, one player, one wallet, one inventory, a complete roleplay base, a low resmon and a one-click txAdmin install, for free and in the open.
FiveM Enhanced: The Complete 2026 Guide for Servers
FiveM Enhanced explained: ray tracing, Cfx Server, 120 sync ticks, Alchemist, Asset Escrow and how to set up a server. Quasar scripts are ready on day one.
Quasar Direct October 2026: Every New FiveM Script
Full recap of Quasar Direct October 2026: Arcade Creator, Clothing, Tattoo and Weapon Skin Creators, Backrooms 2.0, Smartphone update, free FiveM tools and more.
Play and Win: Free 8-Bit Games and Prizes for Black Friday & Christmas
Play and Win is live at Quasar Store: four free 8-bit arcade games, one try per game a day and a mystery prize for every win this Black Friday and Christmas.
[01]Comments
The thread