Skip to main content

PRD - Runic Engine Minecraft Server (Docker)

Overview

A Dockerized Minecraft Forge server running the Runic Engine modpack, designed for 2 players on a local network (192.168.1.x). The server will use the itzg/minecraft-server Docker image with Forge, and the mods directory will be a bind mount to shared NFS storage so that players can copy their CurseForge client mods directly to the server.

Goals

  1. Run a Forge-based Minecraft server in Docker that is compatible with the Runic Engine modpack
  2. Use a bind-mounted mods directory at /nfs_storage/minecraft_mods/runic so players can sync their client mods to the server
  3. Automatically exclude known client-only mods that would crash the server
  4. Provide clear documentation for players on how to find their CurseForge version info and copy mods

Users

  • 2 players on the local network using the CurseForge client
  • Server admin (you) managing the Docker container

Requirements

Server

  • Docker Compose service using itzg/minecraft-server image
  • Forge modloader matching the Runic Engine modpack's required Forge version
  • Minecraft version matching the modpack (currently 1.20.1)
  • Mods directory bind-mounted from /nfs_storage/minecraft_mods/runic
  • Resource limits appropriate for a 2-player modded server (~6-10G RAM)
  • REMOVE_OLD_MODS=true to clean stale mods on restart
  • Mechanism to exclude client-only mods from the server's active mods

Client Sync Workflow

  • Players install Runic Engine via CurseForge client
  • Players copy their entire mods/ folder contents to the NFS share
  • A server-side exclusion list removes known client-only mods before the server loads them
  • Documentation explains how to find the CurseForge mods folder and version info

Networking

  • Server exposed on port 25565 (or configurable)
  • Players connect via the server's LAN IP (e.g., 192.168.1.x:25565)

Out of Scope

  • Automatic mod syncing (manual copy is fine for 2 players)
  • External/internet-facing access
  • Backup automation (can be added later)
  • Whitelist/authentication beyond Mojang's online-mode

Known Constraints

  • Client-only mods in the copied mods folder will crash the server if not excluded
  • Forge version must exactly match between client and server
  • The Runic Engine modpack version must be identical on all clients and the server
Back to top