How to Set Up a Cabal Online Private Server Using Freya Emulator

Step 1: Install Prerequisites

Before you start, ensure that the following dependencies are installed:

• MySQL Server for the database.
• Visual C++ Build Tools to compile the source.
• Git for Windows to clone the Freya source.

Step 2: Clone the Freya Repository

Open Git Bash and clone the Freya emulator repository:

git clone https://github.com/ubis/Freya.git

This will download the Freya emulator files to your machine. Navigate into the folder:

cd Freya

Step 3: Set Up the MySQL Database

Open MySQL and create a new database and user for the Freya emulator:

CREATE DATABASE cabal;
CREATE USER 'cabal_user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON cabal.* TO 'cabal_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Replace password with a secure password. You will use these credentials later in the configuration files.

Step 4: Compile the Freya Emulator

Use Visual Studio to open the Freya solution file (Freya.sln) located in the root of the repository.

1. Open Visual Studio and load the solution file.

2. Set the build configuration to Release.

3. Build the solution by selecting Build > Build Solution. The compiled files will be placed in the Release folder.

Step 5: Configure the Server Files

Within the compiled Release folder, locate the configuration files and set them up as follows:

• server.properties: Set database connection details (username, password, and database name).
• config.ini: Configure general server settings like server IP and ports.

Make sure these settings match your environment. Save any changes you make.

Step 6: Import Database Structure

Freya provides SQL scripts to set up the initial database structure. In MySQL, run the provided SQL scripts (often located in a sql folder in the repository) to create tables and insert default data:

mysql -u cabal_user -p cabal < path/to/your_script.sql

Replace path/to/your_script.sql with the actual path to the SQL scripts.

Step 7: Start the Server

In the compiled Release folder, run the main server executable to start the server. This may be named FreyaServer.exe or similar:

./FreyaServer.exe

Monitor the console output to ensure the server starts successfully without errors.

Step 8: Configure the Client

Download a compatible Cabal Online client and modify the configuration file to point to your server’s IP address. You can usually find this in a config.ini or ServerInfo.ini file within the client folder.

Step 9: Test the Connection

Launch the client and attempt to connect to your server. If successful, you should be able to log in and play on your private Cabal Online server.

If there are any issues, review the server console output and logs for troubleshooting tips.