Dragons Dogma Online - Server

Server Emulator for the Game Dragons Dogma Online.

---

Table of Contents

• Disclaimer
• Developer Setup
• Deployment
• Server
• Client
• Progress
• Guidelines
• Attribution

---

Disclaimer

The project is intended for educational purpose only.

Developer Setup

1. Clone the repository

   1. git clone https://github.com/sebastian-heinz/Arrowgene.DragonsDogmaOnline.git

2. Install .NET 6.0 SDK or later https://dotnet.microsoft.com/download

3. Use your IDE of choice

   1. Visual Studio

      1. Open the DragonsDogmaOnline.sln-file

      2. Note: Minimum version of "Visual Studio 2022" or later.

   2. VS Code

      1. Download IDE: https://code.visualstudio.com/download

      2. C# Plugin: https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp

      3. Open the Project Folder: \Arrowgene.DragonsDogmaOnline

   3. IntelliJ Rider

      1. https://www.jetbrains.com/rider/

      2. Note: Minimum version of "IntelliJ Rider 2021.3" or later.

      3. Open the DragonsDogmaOnline.sln-file

4. Debug the Project

   1. Run the Ddon.Cli-Project with arguments server start

Deployment

The application (server) requires the (ASP).NET runtime 6 to function. Alternatively the SDK also works and is required when building from source.

On a high level, a total of four components are required to successfully connect a client:

1. Web server

2. Login server

3. Game server

4. Database

All of these components are provided & automatically started up in the default developer setup outlined above.

As the developer setup relies on an embedded SQLite database, this might not suite all production needs (e.g. the embedded SQLite setup currently lacks ARM binaries). Thus, two more relational databases are supported:

1. MariaDB

2. PostgreSQL

Container setup

It is also possible to run a containerized setup. A Dockerfile is provided which encapsulates everything required to build & publish the server from source. Three separate docker-compose files are provided depending on the desired database. None of these actually reference any image and instead rely on ad-hoc source code builds as the image is currently not publicly available.

1. SQLite-enabled docker-compose

   1. docker-compose up

2. MariaDB-enabled docker-compose

   1. docker-compose -f docker-compose.mariadb.yml up

3. PostgreSQL-enabled docker-compose

   1. docker-compose -f docker-compose.psql.yml up

Useful run commands

• Force rebuild docker-compose up --build

• Clean up & delete persistent volumes (data) as well docker-compose down -v

• Only build the image docker-compose build

• Build for other runtimes, e.g. arm64 RUNTIME=linux-arm64 docker-compose build

• All-in-one clean & rebuild docker-compose down -v && docker-compose up --build

• All-in-one clean & rebuild & arm64 RUNTIME=linux-arm64 docker-compose down -v && docker-compose up --build

Server

With default configuration the server will listen on following ports:

52099 - http/download
52000 - tcp/gameserver
52100 - tcp/loginserver

ensure that no other local services listen on these ports.

Client

Launch the client with the following args:

"DDO.exe" "addr=localhost port=52100 token=00000000000000000000 DL=http://127.0.0.1:52099/win/ LVer=03.04.003.20181115.0 RVer=3040008"

Progress

Login Server

• ✓ Account

• ✓ Character Creation

Game Server

Party Management (Party List)

• ❏ Party Members

  • ✓ View Arisen Profile

  • ❏ Send Tell

  • ❏ Send Friend Request

  • ❏ View Status and Equipment

  • ✓ Promote to Party Leader

  • ✓ Kick from Party

  • ❏ Invite to Group Chat

  • ✓ Disband Party

  • ❏ Invite to Entryboard

  • ❏ Follow with Autorun

  • ❏ Cancel Party Invite

  • ❏ Decline Party Invite

  • ❏ View Party List

  • ✓ Leave

  • ❏ Invite Directly to Clan

• ❏ Main Pawns

  • ❏ View Pawn Profile

  • ✓ Invite to Party

  • ✓ Kick from Party

  • ❏ View Status and Equipment

• ❏ Support Pawns

• ❏ Party Search

  • ❏ Search

  • ❏ Simple Request

• ❏ Player Search

  • ❏ View Arisen Profile

  • ✓ Invite to Party

  • ❏ Send Tell

  • ❏ Send Friend Request

  • ❏ Invite to Group Chat

  • ❏ Invite to Entryboard

  • ✓ Search

Guidelines

Git

Workflow

The work on this project should happen via feature-branches

Feature branches (or sometimes called topic branches) are used to develop new features for the upcoming or a distant future release. When starting development of a feature, the target release in which this feature will be incorporated may well be unknown at that point. The essence of a feature branch is that it exists as long as the feature is in development, but will eventually be merged back into develop (to definitely add the new feature to the upcoming release) or discarded (in case of a disappointing experiment).

1. Create a new feature/feature-name or fix/bug-fix-name branch from master

2. Push all your changes to that branch

3. Create a Pull Request to merge that branch into master

Best Practise

• Do not use Console.WriteLine etc., use the specially designed logger.

• Own the Code: extract solutions, discard libraries.

• Annotate functions with documentation comments (https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/language-specification/documentation-comments).

C# Coding Standards and Naming Conventions

Object Name	Notation	Char Mask	Underscores
Class name	PascalCase	[A-z][0-9]	No
Constructor name	PascalCase	[A-z][0-9]	No
Method name	PascalCase	[A-z][0-9]	No
Method arguments	camelCase	[A-z][0-9]	No
Local variables	camelCase	[A-z][0-9]	No
Constants name	PascalCase	[A-z][0-9]	No
Field name	_camelCase	[A-z][0-9]	Yes
Properties name	PascalCase	[A-z][0-9]	No
Delegate name	PascalCase	[A-z]	No
Enum type name	PascalCase	[A-z]	No

Attribution

Contributors / Making It Happening

Let me preface with that this work could not exist without the excellent work of various individuals - Ando - Reverse Engineering & Tooling (Session Splitter, Camellia Key Cracker) - David - Reverse Engineering (unpacking PC Executable, defeating Anti Debug and CRC checks) - The White Dragon Temple - Nothilvien [@sebastian-heinz](https://github.com/sebastian-heinz) - Reverse Engineering & Server Code

(if you have been forgotten please reach out)

3rd Parties and Libraries

• System.Data.SQLite (https://system.data.sqlite.org/)

• KaitaiStruct.Runtime.Csharp (https://kaitai.io/)

• Arrowgene.Networking (https://github.com/sebastian-heinz/Arrowgene.Networking)

• .NET Standard (https://github.com/dotnet/standard)