goobaroo/vaulthunters3

Vault Hunters Official Pack (3rd Ed.)-3.19.6.4 Docker镜像

概述

该Docker镜像用于运行CurseForge上的Vault Hunters Official Pack (3rd Ed.)-3.19.6.4 Minecraft模组包服务器。主要设计目标为Unraid服务器，在其他系统上兼容性可能不同。首次运行时，容器会自动下载指定版本的模组包及依赖文件并完成安装（过程可能耗时，可通过日志监控进度）；后续启动则直接运行服务器。注意：镜像不包含预打包的Minecraft模组文件，所有必要文件均在运行时动态下载。

核心功能与特性

• 自动部署：首次启动自动下载并安装Vault Hunters 3rd Ed. 3.19.6.4版本服务器文件
• 快速启动：完成初始安装后，后续启动无需重复下载，直接启动服务器
• 灵活配置：支持通过环境变量自定义JVM参数、服务器描述（MOTD）、世界名称等核心参数
• 管理员管理：可通过环境变量便捷添加Minecraft服务器管理员（OP）

使用场景与适用范围

适用于需要搭建Vault Hunters Official Pack (3rd Ed.)-3.19.6.4版本Minecraft模组服务器的用户，尤其推荐Unraid服务器用户使用。其他Linux系统用户需注意文件权限配置。

使用方法与配置说明

基本要求

• 数据持久化：必须将/data目录挂载至持久化存储卷（用于保存服务器配置、世界数据等）
• 端口映射：需映射TCP端口25565（Minecraft默认服务器端口）
• EULA接受：必须设置环境变量EULA="true"（用户需自行承担接受Mojang EULA的责任，容器默认EULA为false，不接受将导致服务器无法启动）

环境变量配置

以下环境变量可在运行时设置，以覆盖默认值：

添加服务器管理员（OP）

通过设置OPS环境变量添加管理员，值为逗号分隔的玩家名称列表。示例：
OPS="Player1,Player2"（将Player1和Player2设为管理员）

部署示例

Docker Run命令

bash
docker run -d \
  --name vaulthunters-server \
  -p 25565:25565/tcp \
  -v /path/to/your/data:/data \
  -e EULA="true" \
  -e JVM_OPTS="-Xms6144m -Xmx8192m" \
  -e MOTD="我的Vault Hunters 3rd Ed服务器" \
  -e LEVEL="vault_world" \
  -e OPS="AdminPlayer,ModeratorPlayer" \
  docker.xuanyuan.run/goobaroo/vaulthunters3

故障排除

EULA未接受

问题：服务器无法启动。
排查：检查是否已设置环境变量EULA="true"，未接受Mojang EULA会导致服务器拒绝启动。

文件权限错误

问题：/data目录出现权限拒绝错误。
原因：容器内运行用户的UID为99、GID为100（适配Unraid），其他系统挂载的/data目录可能因权限不匹配导致访问失败。
解决：调整宿主机/data挂载目录权限，确保UID 99和GID 100有读写权限。

安装/升级失败

问题：初始安装不完整或升级失败。
解决：删除/data目录中已下载的服务器文件，重启容器即可触发重新下载和安装流程。

源码与镜像地址

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