Manual Setup - OpenDAoC
The easiest way to get started is to use the Docker container as described in the Docker Setup guide, but this guide will also cover how to compile and run the server on Linux.
Setting up the environment
This process assumes you do not already have a fully-configured environment with the specific tools or software installed previously.
If you’ve already completed a step previously, we recommend that you quickly review the steps again to ensure no special configurations are missed.
Installing git
To clone the OpenDAoC repository, you will need to have git installed on your system.
To install git, run the following command from the Terminal:
Installing .NET SDK
OpenDAoC is a .NET application and requires the .NET SDK to be installed on your system.
If you are running a Debian based Linux distribution such as Ubuntu or Debian, you can install the SDK by running the following commands from the Terminal:
Please see Microsoft’s documentation for instructions on how to install the .NET SDK on other platforms.
Installing MariaDB
MariaDB is an open-source relational database management system (RDBMS). OpenDAoC has been tested with MariaDB up to version 10.6.
Perform the following steps from the Terminal:
The RDBMS is installed, but needs a user and database for OpenDAoC to access and use.
Preparing the Database
The following steps walk you through the process of adding a user and database using MariaDB.
In this example, we will be using the following values:
- User:
opendaoc
- Password:
opendaoc
- Database:
opendaoc
To create the user and database, perform the following steps from the Terminal:
- Access your MySQL server using a privileged user
- Create the database and verify that it exists
- Verify that the database exists
- Create the user and verify that it exists
- Grant privileges to the user
- Refresh the privilege changes and verify that the user has the correct privileges
Cloning the Repository
The OpenDAoC repository can be cloned from GitHub.
In this example, we will be cloning OpenDAoC-Core
to the /home/opendaoc/OpenDAoC-Core
directory.
To clone the repository, run the following command from the Terminal:
Populating the Database
The database needs to be populated with the required tables and data before the server can be run.
We provide both a DummyDB.sql
file with just the tables and the full OpenDAoC DB dump.
Using the DummyDB.sql
file is only recommended if you plan using your own data or if you are familiar with the OpenDAoC database structure.
Using the DummyDB.sql file
The database needs to be populated with the required tables and data with the provided DummyDB.sql
file before the server can be run.
Run the following command from the Terminal:
You will be prompted for the password for the opendaoc
user, which is opendaoc
in this example.
Altering serverconfig.xml
The last step before running the server is to alter the serverconfig.xml
file to reflect your own configuration.
- Copy
/home/opendaoc/OpenDAoC-Core/DOLServer/config/serverconfig.example.xml
to/home/opendaoc/OpenDAoC-Core/DOLServer/config/serverconfig.xml
. - Open the
serverconfig.xml
file. - Within the
RegionIP
tags, change the value0.0.0.0
to one of these:- To test locally, enter
127.0.0.1
. - To test over LAN, enter your machine’s IP address (use the Terminal command
ip a
, and it should start with192
). - To test outside your network, enter your public IP address.
- To test locally, enter
- Configure the database access as per your own configuration.
Now you’re ready to build and run the server!
Building OpenDAoC
This section provides the commands necessary to build the server code.
- Navigate to the
/home/opendaoc/OpenDAoC-Core/
directory - Run
dotnet build DOLLinux.sln
Launching the Server
- Navigate to the
/home/opendaoc/OpenDAoC-Core/
directory - Run
dotnet run --project CoreServer
Congratulations!
You’re now running an instance of OpenDAoC.