Documentation
Download & Installation
On this page we'll be guiding you through the installation of the Mercy Framework. On the previous page we guided you through installing a MySQL server for the framework. Make sure you have done all necessary steps for that before you continue!
Download & Installation
Since you have setup the database already we hope you already downloaded the framework and put it somewhere on your system! If not please look at the following steps.
Clone using Git (Fastest)
In the following steps we'll be guiding you on how to clone the Mercy Framework so it'll end up on your system in no time!
- Download Git if you have not already.
- Setup Git using your Github Account.
- Type following command in the folder where you would like the framework to be downloaded in:
git clone https://github.com/Mercy-Collective/mercy-framework.git
- Make sure to have the following folder structure:
mercy-framework/
├─ artifacts/ (FiveM Artifacts)
├─ server-data/ (Github Repository Files)
│ ├─ Mercy-CasinoWheelUI/
│ ├─ Mercy-VoiceServer/
│ ├─ cfg/
│ ├─ resources/
│ ├─ .gitignore
│ ├─ LICENSE
│ ├─ README.md
│ ├─ [Starter].bat
│ ├─ frameworkdb.sql
│ ├─ logo.png
- Make sure to go into the cfg folder and setup every .cfg file correctly!
- If you are ready to start the server, make sure to change the file path in the "[Starter].bat". For example:
Path with spacing (Add ")
"C:\Users\Firstname Lastname\Desktop\mercy-framework\artifacts\FXServer.exe"
Path without spacing
C:\Users\Administrator\Desktop\mercy-framework\artifacts\FXServer.exe
ZIP (Time Consuming)
In the following steps we'll be guiding you on how to download the Mercy Framework using the Download ZIP button on the Github repository page.
- Click on the green "Code" button on the top right of the repository page.
- Click on "Download ZIP"
- Once the download is complete extract the framework into a folder.
- Make sure to have the following folder structure:
mercy-framework/
├─ artifacts/ (FiveM Artifacts)
├─ server-data/ (Github Repository Files)
│ ├─ Mercy-CasinoWheelUI/
│ ├─ Mercy-VoiceServer/
│ ├─ cfg/
│ ├─ resources/
│ ├─ .gitignore
│ ├─ LICENSE
│ ├─ README.md
│ ├─ [Starter].bat
│ ├─ frameworkdb.sql
│ ├─ logo.png
- Make sure to go into the cfg folder and setup every .cfg file correctly!
- If you are ready to start the server, make sure to change the file path in the "[Starter].bat". For example:
Path with spacing (Add ")
"C:\Users\Firstname Lastname\Desktop\mercy-framework\artifacts\FXServer.exe"
Path without spacing
C:\Users\Administrator\Desktop\mercy-framework\artifacts\FXServer.exe
Download Time & Updates
Please know that downloading the framework straight from the repository will take time depending on your Ethernet speed and does not give the ability to "Update" your downloaded server using Github's "Pull" system.
txAdmin Recipe (Easiest)
In the following steps we'll be guiding you on how to download the Mercy Framework using recipe provided on our Github.
- Start the setup process of txAdmin by opening the FXServer.exe file in your artifacts.
- Create a txAdmin login.
- Input a server name, choose Remote URL Template as the Deployment Type and input following link.
https://raw.githubusercontent.com/Mercy-Collective/mercy-framework-recipe/main/mercy.yaml
Select the default or a new folder path where the framework should install.
Click on "Go to Recipe Deployer" and click "Next".
Fill in your License Key and change the Database Options if required.
Click on "Run Recipe".
The Mercy Framework will now start installing.
When the installation has finished you'll see the server.cfg**, be sure to add a Steam Web API Key and change other settings to your likings.
Make sure to set following txAdmin Settings before joining the server:
FXServer Settings (Parameters):
+set sv_enforceGameBuild 3095
FXServer Settings (OneSync):
Legacy or Infinity
Assets
The assets used in the Mercy Framework are not recommended to be used in Production. We highly recommend to use verified assets by verified creators.
If you did above steps the server should be up and running! If not, we are more than happy to help you in our Discord Server.