Skip to content

Latest commit

 

History

History
80 lines (64 loc) · 2.74 KB

README.md

File metadata and controls

80 lines (64 loc) · 2.74 KB

GitHub Actions Docker Image CI HitCount banner

Xash3D FWGS Dedicated Server Docker

Probably, the fastest and easiest way to set up an old-school Xash3D FWGS dedicated server. You don't need to know anything about Linux or XashDS to start a server. You just need PC or VDS with installed Linux and installed Docker on it.

Supported mods

We have plans to support more mods in the future. But currently, only Half-Life Deathmatch is supported.

Quick Start

Clone this repository. Just two commands.

git clone https://github.com/FWGS/xashds-docker.git
cd xashds-docker

At the moment, we do not yet publishing pre-built images on Docker Hub. Therefore, you need to build it yourself with this command.

In future, when we will publish pre-built images on Docker Hub, this step can be skipped.

sudo docker build --no-cache -t snmetamorph/xashds-hldm:latest .

Next, you can use this Docker Compose file below as a base for your custom configuration. If you don't need custom configuration - just use this preset and continue to next step.

services:
  xashds:
    image: snmetamorph/xashds-hldm:latest
    build: .
    container_name: xashds-hldm
    restart: always
    tty: true
    stdin_open: true
    command: +map crossfire
    ports:
      - '27015:27015/udp'

Note: any server config command can be passed to command section in Docker Compose file.

By default, server will start on 27015 UDP port. When you're finished with configuration and ready to start a server just run:

sudo docker compose up -d

After that, Docker container with XashDS will be created and server will automatically start on system startup and auto-restarting in case of crash.

If you want to stop a server and completely remove all XashDS containers, run:

sudo docker compose down

What is included

  • Game assets from HLDS, build number 8308
  • Xash3D FWGS dedicated server, latest version
  • Metamod-p for Xash3D by mittorn, version 1.21p37
  • AMX Mod X, version 1.9.0.5294
  • jk_botti, version 1.43
  • Minimal config preset, such as mp_timelimit, public 1 and mapcycle

Default mapcycle

  • crossfire
  • bounce
  • datacore
  • frenzy
  • gasworks
  • lambda_bunker
  • rapidcore
  • snark_pit
  • stalkyard
  • subtransit
  • undertow
  • boot_camp