Download Oxide MUD

Current Stable Version: v0.13.0

[Note] All-in-One Package:

The package includes all three core binaries:

  • oxide-server: The main asynchronous concurrent game engine server.
  • oxide-mcp: The Model Context Protocol service for AI agent creation.
  • spade: The visual terminal world builder and layout tool.

Download for Linux

[oxide_linux.tar.gz]

> Linux Release

Statically compiled using `musl` for compatibility across distributions. Contains all server binaries, Docker runtime files, and visual world building packages.

Quick Start Installation

> Quick Start with Docker (Recommended)

The release archive bundles a preconfigured Dockerfile and docker-compose.yml. Docker provides the fastest and most portable way to run Oxide MUD on Linux, macOS, or Windows.

  1. Download and extract the release archive above:
    tar -xzf oxide-0.13.0-*.tar.gz
cd oxide-0.13.0-*
  2. Launch the server with Docker Compose:
    docker compose up -d --build

    Builds and runs the server container with persistent mounts for server.toml, content/, data/, and logs/. Exposes ports 4000 (Telnet) and 8080 (REST & WebSockets).

  3. Connect to your running server:
    • Browser / WebSocket: ws://localhost:8080/ws/play
    • Spade TUI Client: ./bin/spade connect ws://localhost:8080/ws/spade
    • Telnet: telnet localhost 4000
Alternative: Native Host Installation (Linux / systemd)

For bare-metal Linux servers or systemd management, run the bundled interactive installer:

./install.sh

The script installs binaries to ~/.oxidemud (or /opt/oxide as root), configures paths, and sets up optional background systemd services.

Next Steps

Once your server is running, explore our documentation to configure game mechanics, build world zones, and manage your realm.

$ explore docs/README

Latest Release Notes

What's new in v0.13.0

[release_notes_v0.13.0.md]

Release notes could not be loaded directly (rate limit or offline). View the latest release on GitHub.