lancommander-ref/LANCommander.Servers.UT2004
1
0
Fork 0
mirror of https://github.com/LANCommander/LANCommander.Servers.UT2004.git synced 2026-08-01 02:47:13 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
6 commits 1 branch 1 tag 43 KiB
Find a file
Exact
Pat Hartl adf707e32b Migrate to LANCommander base image with hook-based install 
Replace bash entrypoint with LANCommander PostInitialization hook
(20-InstallServer.ps1) that downloads server binaries, extracts them,
and patches the master server INI. Update Dockerfile to build from
lancommander/base:latest with SERVER_URL/START_EXE/START_ARGS env vars.
Update documentation to reflect new OverlayFS-based directory layout,
security requirements, and hook extension points.
2026-02-20 22:54:53 -06:00
.github/workflows Add basic documentation 2026-01-20 20:29:34 -06:00
Documentation Migrate to LANCommander base image with hook-based install 2026-02-20 22:54:53 -06:00
Hooks/PostInitialization Migrate to LANCommander base image with hook-based install 2026-02-20 22:54:53 -06:00
Dockerfile Migrate to LANCommander base image with hook-based install 2026-02-20 22:54:53 -06:00
LICENSE Initial commit 2026-01-19 13:44:41 -06:00
README.md Migrate to LANCommander base image with hook-based install 2026-02-20 22:54:53 -06:00

README.md

Unreal Tournament 2004 Dedicated Server (Docker)

This repository provides a Dockerized Unreal Tournament 2004 dedicated server built on the LANCommander base image. The container automatically downloads the dedicated server binaries on first run, supports file overlaying using OverlayFS, and integrates with the LANCommander hook system.

Features

  • Runs the Unreal Tournament 2004 dedicated server (ucc-bin)
  • Automatically downloads and extracts server binaries on first startup via the PostInitialization hook
  • Patches the master server list to use the OpenSpy community server
  • Supports custom file overlays via OverlayFS
  • Extensible via custom PowerShell hook scripts

Docker Compose Example

services:
  ut2004:
    image: lancommander/ut2004:latest
    container_name: ut2004

    ports:
      - "7777:7777/udp"  # Game port
      - "7778:7778/udp"  # Query port

    volumes:
      - ./config:/config

    environment:
      # Optional overrides
      # START_ARGS: "-ini=SystemSettings.ini -ini=UT2004.ini -ini=UT2004Server.ini"

    cap_add:
      - SYS_ADMIN

    security_opt:
      - apparmor:unconfined

    restart: unless-stopped

Directory Layout (Host)

config/
├── Server/              # UT2004 server files (auto-downloaded on first run)
│   └── System/
│       ├── ucc-bin      # Server binary
│       ├── UT2004.ini   # Main server configuration
│       └── ...
├── Overlay/             # Drop-in overrides (maps, configs, mutators)
├── Merged/              # OverlayFS merged view (auto-created)
└── Scripts/
    └── Hooks/           # Custom PowerShell hook scripts

The config directory must be writable by Docker. Server binaries are downloaded and extracted automatically on first run by the PostInitialization hook.

Environment Variables

Variable Description Default
SERVER_URL URL to download the UT2004 dedicated server archive https://s3.amazonaws.com/ut2004-files/dedicated-server-3339-bonuspack.tar.gz
START_EXE Server executable path relative to the server directory System/ucc-bin
START_ARGS Arguments passed to the server executable -ini=SystemSettings.ini -ini=UT2004.ini -ini=UT2004Server.ini

Configuration

Server configuration files live under /config/Server/System/ (or /config/Overlay/System/ for overrides that survive reinstalls):

  • UT2004.ini - Main server configuration
  • Default.ini - Default game settings
  • User.ini - User-specific settings

Example UT2004.ini snippet:

[Engine.GameInfo]
ServerName=My UT2004 Server
MaxPlayers=16
AdminPassword=changeme

Ports

  • UDP 7777 – Game port (clients connect here)
  • UDP 7778 – Query port (server browser)

License

Unreal Tournament 2004 is distributed under its own license. This repository contains only Docker build logic and helper scripts licensed under MIT.