goobaroo/vaulthunters

Vault Hunters - Official Modpack-1.13.9H Docker镜像

镜像概述

本容器用于运行Curseforge上的https://www.curseforge.com/minecraft/modpacks/vault-hunters-official-modpack Minecraft模组包服务器。容器设计初衷为在Unraid服务器上运行，其他环境下使用效果可能不同。

首次运行时，容器会下载指定版本的模组包并完成安装（此过程可能耗时较长，可通过日志查看进度）。后续运行则直接启动服务器。注意：容器本身不包含任何Minecraft模组文件，所有文件均在运行时下载。

核心功能

• 自动下载并安装Vault Hunters 1.13.9H模组包
• 支持持久化存储服务器数据
• 可通过环境变量自定义服务器配置
• 首次安装完成后自动切换为直接启动模式

使用要求

基础依赖

• 必须将/data目录挂载到持久化存储磁盘
• 必须映射TCP端口25565（Minecraft默认端口）
• 必须设置环境变量EULA="true"（表示接受Mojang EULA协议）

重要：用户需自行承担接受Mojang EULA协议的责任，容器默认EULA值为false。

配置选项

可通过设置以下环境变量自定义服务器行为，未设置则使用默认值：

核心配置

添加管理员（Operators）

通过设置OPS环境变量添加服务器管理员，值为逗号分隔的玩家名称列表。示例：

bash
OPS="OpPlayer1,OpPlayer2"

使用方法

Docker Run示例

bash
docker run -d \
  --name vaulthunters-server \
  -p 25565:25565/tcp \
  -v /path/to/persistent/data:/data \
  -e EULA="true" \
  -e JVM_OPTS="-Xms6144m -Xmx8192m" \
  -e MOTD="Vault Hunters Server Powered by Docker" \
  -e OPS="AdminPlayer,ModeratorPlayer" \
  docker.xuanyuan.run/goobaroo/vaulthunters

参数说明

• -v /path/to/persistent/data:/data：挂载持久化存储目录，用于保存服务器数据、世界存档等
• -p 25565:25565/tcp：映射Minecraft服务器端口
• -e EULA="true"：接受Mojang EULA协议（必须设置）
• -e JVM_OPTS：自定义JVM内存分配（如"-Xms8G -Xmx10G"）
• -e MOTD：自定义服务器在列表中的显示消息
• -e OPS：设置管理员玩家列表（逗号分隔）

故障排除

EULA未接受

症状：服务器无法启动，日志提示EULA未接受。
解决：确保设置环境变量EULA="true"。

文件权限问题

症状：/data目录下文件权限错误，导致无法读写数据。
原因：容器设计用于Unraid环境，内部运行用户为uid 99和gid 100，其他系统可能存在权限冲突。

安装过程异常

症状：服务器安装中断或不完整。
解决：删除/data目录下的下载文件，重启容器将重新触发安装流程。

相关链接

• GitHub源码：https://github.com/Goobaroo/docker-vaulthunters
• Docker Hub镜像：https://hub.docker.com/repository/docker/goobaroo/vaulthunters