pvillaverde/openttd-jgr

OpenTTD Server with JGR Patch Pack 镜像文档

镜像概述

该镜像基于OpenTTD（开源运输模拟游戏）与JGR Patch Pack（第三方扩展补丁）构建，提供功能增强的OpenTTD服务器环境。JGR Patch Pack为原版OpenTTD添加了大量扩展功能、性能优化及自定义选项，使服务器支持更丰富的游戏规则与多人联机体验，适用于搭建私人或社区性质的OpenTTD多人游戏服务器。

核心功能与特性

• 增强的游戏功能：集成JGR Patch Pack提供的扩展特性，包括更多车辆类型、路线规划工具、信号系统优化等
• 灵活的配置选项：支持自定义游戏规则、经济参数、地图生成设置及服务器参数
• 性能优化：针对多人游戏场景进行性能优化，提升服务器在高玩家数量下的稳定性
• 兼容性保障：兼容标准OpenTTD客户端，支持使用原版客户端或JGR Patch Pack客户端连接
• 数据持久化：支持游戏存档、配置文件及日志的持久化存储，确保服务器重启后数据不丢失

使用场景

• 私人游戏服务器：搭建供朋友或小团体使用的多人联机服务器，自定义游戏规则与地图
• 社区游戏平台：为OpenTTD玩家社区提供长期稳定的游戏服务，支持多人协作或竞争
• 游戏测试环境：验证自定义游戏模组、地图设置或新游戏规则的效果
• 教育/演示用途：用于展示运输网络规划、物流管理等模拟场景

使用方法与配置说明

基本部署（Docker Run）

使用以下命令快速启动服务器：

bash
docker run -d \
  --name docker.xuanyuan.run/openttd-jgr-server \
  -p 3979:3979/tcp \
  -p 3979:3979/udp \
  -v ./openttd-data:/root/.openttd \
  -e SERVER_NAME="My JGR OpenTTD Server" \
  -e MAX_PLAYERS=10 \
  -e PASSWORD="your-server-password" \
  docker.xuanyuan.run/openttd-jgr-server

参数说明：

• -p 3979:3979/tcp：映射TCP端口（游戏数据传输）
• -p 3979:3979/udp：映射UDP端口（玩家发现服务器）
• -v ./openttd-data:/root/.openttd：挂载数据卷，持久化存储游戏存档、配置及日志
• 环境变量（可选）：
  • SERVER_NAME：服务器名称（默认："JGR OpenTTD Server"）
  • MAX_PLAYERS：最大玩家数（默认：8）
  • PASSWORD：服务器密码（默认：无密码）
  • MAP_SIZE：地图尺寸（默认："1024x1024"，可选："512x512"、"2048x2048"等）

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  openttd-jgr:
    image: docker.xuanyuan.run/openttd-jgr-server
    container_name: openttd-jgr-server
    ports:
      - "3979:3979/tcp"
      - "3979:3979/udp"
    volumes:
      - ./openttd-data:/root/.openttd
    environment:
      - SERVER_NAME="Community OpenTTD Server"
      - MAX_PLAYERS=15
      - PASSWORD="secure-password"
      - GAME_SPEED=1
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

数据持久化

服务器数据（存档、配置、日志）存储在容器内/root/.openttd目录，通过挂载宿主机目录（如示例中的./openttd-data）实现持久化。常用子目录说明：

• save/：游戏存档文件（.sav）
• config/：服务器配置文件（openttd.cfg）
• logs/：服务器运行日志

高级配置

如需自定义高级参数，可通过以下方式修改配置：

1. 修改配置文件：编辑挂载目录中的openttd.cfg文件，调整服务器参数（如游戏规则、经济设置等）
2. 启动命令参数：在docker run或docker-compose中添加命令参数，例如：

   bash
   docker run ... openttd-jgr-server -g "my-custom-map.sav" -r 2  # 加载指定存档并设置游戏速度为2x
   

常用环境变量

连接服务器

客户端连接方法：

1. 确保客户端版本与JGR Patch Pack兼容（推荐使用相同版本的JGR客户端）
2. 在OpenTTD客户端中选择"多人游戏" → "加入游戏"
3. 输入服务器IP及端口（默认3979），如需密码则输入设置的PASSWORD值

注意事项

• 端口映射：需确保宿主机防火墙开放3979端口（TCP/UDP）
• 数据备份：定期备份挂载的数据卷目录，防止存档丢失
• 版本兼容性：JGR Patch Pack版本需与客户端匹配，建议使用镜像标签指定版本（如:latest或特定版本号）
• 性能需求：根据玩家数量调整服务器资源（CPU/内存），建议至少1GB内存以支持10人以上联机