Installation

The WukongMP server is currently distributed in the following formats:

• Binary package
• Docker image

Binary package

Downloads

Platform	Architecture	Download
Linux	x64	Download for Linux
Windows	x64	Download for Windows

Installation

Extract the binary package to a location of your choice.

After extraction, the directory structure should look like this:

Windows

server/
├── server.exe                 # Main server binary
├── config.json                # Configuration file
├── mods/                      # Directory for mods
|   ├── WukongMp.Sdk/          # SDK mod
|   └── WukongMp.PvP/          # PvP mod
├── optional_mods/             # Move any of these mods to the "mods" folder to enable them
|   └── WukongMp.Coop/         # Co-op mod
├── saves/                     # Directory for game saves (empty by default)
├── wwwroot/                   # Admin panel assets
├── e_sqlite3.dll              # Dependency
└── aspnetcorev2_inprocess.dll # Dependency

Linux

server/
├── server                     # Main server binary
├── config.json                # Configuration file
├── mods/                      # Directory for mods
|   ├── WukongMp.Sdk/          # SDK mod
|   └── WukongMp.PvP/          # PvP mod
├── optional_mods/             # Move any of these mods to the "mods" folder to enable them
|   └── WukongMp.Coop/         # Co-op mod
├── saves/                     # Directory for game saves (empty by default)
├── wwwroot/                   # Admin panel assets
└── libe_sqlite3.so            # Dependency

Configuration

You can adjust server settings by editing the config.json file. In the following table, the : notation is used to represent nested settings.

Setting	Type	Purpose
Server:Port	number	The port on which the server listens for incoming connections

First launch

Start the server by running the server.exe binary.

On first launch, the server creates a data/ directory inside the server folder. This directory contains the web.db database file, where persistent data is stored.

Unless changed in config.json, the server listens on the following ports:

Port	Protocol	Purpose
9050	UDP	Game traffic (player connections, game state synchronization, etc.)
9050	HTTP	Admin panel

Docker

A Linux-based x64 Docker image is also available for those who prefer containerized deployments.

Pull the image from the registry:

docker pull ghcr.io/readycodeio/wukongmp-server:0.2.2

Run:

docker run \
    -p 9050:9050/udp -p 9050:9050/tcp \
    -v ./data:/app/data \
    -v ./mods:/app/mods \
    -v ./saves:/app/saves \
    --name wukongmp-server \
    ghcr.io/readycodeio/wukongmp-server:0.2.2

Or with Docker Compose:

docker-compose.yml

services:
  server:
    image: ghcr.io/readycodeio/wukongmp-server:0.2.2
    container_name: wukongmp-server
    restart: unless-stopped
    ports:
      - "9050:9050/tcp"
      - "9050:9050/udp"
    volumes:
      - ./data:/app/data
      - ./mods:/app/mods
      - ./saves:/app/saves

important

The image ships without mods. Copy WukongMp.Sdk and the mode you want (WukongMp.PvP, WukongMp.Coop) from the binary ZIP into your mods/ volume before starting the container.

Configuration

Configuring the port is done by remapping the container ports in the docker run command or Docker Compose file. For example, to use port 9060 instead of 9050, change the ports section to:

docker-compose.yml

ports:
  - "9060:9060/tcp"
  - "9060:9060/udp"