How to Install QBCore on a Fresh FiveM Server

Installing QBCore on your FiveM server can be a daunting task if you're new to the scene. However, with the right steps and configurations, you'll find that it's a straightforward process. This guide will walk you through how to install QBCore on a fresh FiveM server, enabling you to create immersive roleplay experiences.

What is QBCore?

QBCore is a popular framework for FiveM that provides a solid core structure for developers to build upon. It offers various features and functionalities that allow server owners to create a rich roleplay environment. Its modular design makes it easier for you to manage resources and scripts compared to other frameworks, such as ESX. If you're considering switching from ESX to QBCore, this guide will help you with the transition.

Prerequisites

Before diving into the installation process, ensure that you have the following requirements met:

• A working FiveM server: You should have a clean installation of the FiveM server ready. If you haven't set one up yet, follow the official FiveM documentation on installing a server.
• Basic knowledge of server management: Familiarity with file management and basic coding will be beneficial.
• Access to a code editor: This can be Notepad++, Visual Studio Code, or any other editor you prefer for coding.

Step-by-Step Guide to Install QBCore

1. Download QBCore

First, you will need to download the QBCore framework package.

• Visit the official QBCore repository on GitHub to download the latest version.
• Extract the downloaded ZIP file to a folder on your system.

2. Setup the Server Files

Once you have the QBCore files extracted:

• Navigate to your FiveM server directory.
• Inside the resources folder, create a new folder named qb-core.
• Move all the contents from the extracted QBCore folder into your new qb-core folder.

3. Configure server.cfg

Next, you need to configure your server's configuration file:

• Locate the server.cfg file in your server directory.
• Open it with your code editor and add the following line to ensure QBCore loads:

  start qb-core
  

• Make sure to place it under the existing resources. This loads the QBCore framework when the server starts.

4. Create the fxmanifest.lua

Navigate back to the qb-core folder and create a new file named fxmanifest.lua. This file will define the resource manifest. Populate it with the following configuration:

fx_version 'cerulean'
game 'gta5'

author 'Your Name'
description 'QBCore Framework'
version '1.0.0'

client_scripts {
    'client/*.lua'
}

server_scripts {
    'server/*.lua'
}

shared_script 'config.lua'

• This ensures that the correct scripts for both client and server are loaded.

5. Set Up Database

QBCore often utilizes a MySQL database for data storage. You will need to set this up:

• Install MySQL server if you haven't already.
• Create a new database named qbcore.
• Update the database configuration in qb-core/config.lua:

database = { host = 'localhost', user = 'your_db_user', password = 'your_db_password', database = 'qbcore' }

- Save the changes.

### 6. Install Optional Dependencies
QBCore comes with a few dependencies that enhance its functionality:
- **MySQL-Async**: You can find it on [MySQL-Async GitHub](https://github.com/brouznouf/fivem-mysql-async). Download and place it in the `resources` folder. Modify your `server.cfg` to ensure it's loaded:

start mysql-async

- **Additional Resources**: If you want more features (like police job systems or vehicle spawns), explore additional scripts available in the [Fivemania scripts category](/category/scripts).

### 7. Testing Your Setup
Now that you have everything set up, it’s time to test:
- Start your FiveM server.
- Connect to it and ensure that QBCore is running properly.
- Use the console to check for any errors. If it fails to start, double-check the configurations made in `server.cfg` and `fxmanifest.lua`.

## Troubleshooting Common Issues
Even with a thorough installation, you may encounter issues. Here are some common problems and how to tackle them:

- **QBCore not starting**: Check if you've correctly added `start qb-core` in your `server.cfg`. Ensure the `fxmanifest.lua` is properly configured.
- **Database connection errors**: Verify your database credentials in `config.lua`. Ensure the MySQL server is running.
- **Script errors**: Check the console output for any specific script issues. Review the code or consult the QBCore community for fixes.

## Frequently Asked Questions

**Q: Can I use QBCore with ESX scripts?**  
A: Not directly. They are different frameworks. You may need to adapt ESX scripts to work with QBCore.

**Q: Is QBCore customizable?**  
A: Yes, QBCore is highly modular and allows for extensive customization. You can easily add or modify features.

**Q: Where can I find resources and support?**  
A: Check the [Fivemania asset listings](/assets) or join QBCore community forums for support and additional scripts.

Following these steps will help you seamlessly integrate QBCore into your FiveM server. Give it a go, and enjoy crafting your unique roleplay experience!