QBCore has cemented itself as the definitive roleplay framework for FiveM in 2026. It's performant, actively maintained, and incredibly modular. If you are starting a new roleplay server today, QBCore is the way to go.
This guide will walk you through setting up QBCore completely from scratch.
Prerequisites
Before installing QBCore, you must ensure your server environment is ready.
- A FiveM Server Artifact: Make sure you have downloaded the latest recommended artifact and have txAdmin running.
- A Database Server: You must install MariaDB (recommended over MySQL or XAMPP for Windows servers).
- Database Management Software: Download HeidiSQL to easily manage your database tables.
The Installation Process (txAdmin Recipe)
In the past, you had to manually download dozens of repositories from GitHub and piece them together. Today, the process is automated.
1. Launch the Recipe
Open your txAdmin web interface.
If this is a fresh server, it will immediately open the setup wizard.
Select Popular Recipes.
Choose the QBCore Framework recipe.
Provide a path for the server data (the default is usually fine).
txAdmin will display a list of all the scripts it is about to download. Click Next.
2. Database Configuration
This is the step where most beginners fail. txAdmin needs to connect to your database to create the necessary tables.
Ensure MariaDB is actually running in your Windows Services.
When txAdmin asks for the connection string, it usually defaults to something like:
mysql://root@localhost/QBCoreFramework_xxxxx?charset=utf8mb4If you set a password for your
rootuser during MariaDB installation, you must include it in the string like this:mysql://root:YOURPASSWORD@localhost/QBCoreFramework_xxxxx?charset=utf8mb4Click Run Recipe. txAdmin will download everything and run the SQL file automatically.
Post-Installation Setup
Your server is now installed, but you need to configure your admin permissions to actually use the framework.
Giving Yourself Admin Rights
You must add your Discord, Steam, or FiveM license to the admin list.
- Join your server in-game.
- Open your txAdmin web panel on your browser.
- Go to the Live Console.
- Find your player ID (usually
1if you are the only one on). - Type the following command into the console:
setgroup 1 admin - You are now an admin in QBCore! In-game, type
/adminto open the QBCore admin menu where you can spawn vehicles, give money, and manage players.
Essential Configurations
Now that you have admin rights, you should customize the core settings.
1. Server Logo and Banner
Open your server.cfg file.
Find the load_server_icon line. You need a 96x96 PNG file named myLogo.png in the root folder.
Find the banner variables and insert direct links (Imgur works well) to your custom banners.
2. QBCore Config
Navigate to resources/[qb]/qb-core/shared/main.lua. This file contains the most critical settings for your entire server:
QBConfig.Money.Starting: Change how much cash and bank balance new players receive.QBConfig.Player.Bloodtypes: You can modify or translate these.
Conclusion
You have successfully built a QBCore foundation. From here, you can start exploring the [qb] folder to tweak jobs, edit the economy, and install new scripts from the Cfx.re forums!
