goobaroo/pixelmon

The Pixelmon Modpack 9.1.13 Docker容器

概述

本容器专为运行The Pixelmon Modpack 9.1.13设计，主要用于搭建Minecraft模组服务器。容器首次运行时会下载并安装指定版本的模组包（此过程可能耗时较长，可通过日志查看进度），后续运行则直接启动服务器。容器内不预装任何Minecraft模组文件，所有文件均在运行时下载。该容器最初为Unraid服务器设计，在其他系统中使用可能需要额外配置。

核心功能与特性

• 自动安装：首次运行自动下载并安装"The Pixelmon Modpack 9.1.13"完整模组包
• 配置灵活：支持通过环境变量自定义JVM参数、服务器描述、世界名称等
• 权限管理：可通过环境变量设置Minecraft管理员账号
• 持久化存储：需将/data目录挂载至持久化磁盘以保存服务器数据
• 合规运行：要求显式接受Mojang EULA方可启动服务器

使用要求

基础配置

• 存储：必须将/data目录挂载至持久化磁盘，用于保存服务器文件及世界数据
• 端口映射：需映射25565/tcp端口（Minecraft默认服务器端口）
• EULA接受：必须设置环境变量EULA="true"，表示接受Mojang EULA（默认值为false，未接受则无法启动）

配置说明

环境变量

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

添加Minecraft管理员

通过设置OPS环境变量指定管理员账号，格式为逗号分隔的玩家名称列表。示例：

bash
OPS="OpPlayer1,OpPlayer2"

部署示例

Docker Run命令

bash
docker run -d \
  --name pixelmon-server \
  -p 25565:25565/tcp \
  -v /path/to/persistent/data:/data \
  -e EULA="true" \
  -e JVM_OPTS="-Xms3072m -Xmx6144m" \
  -e MOTD="My Pixelmon Server" \
  -e OPS="AdminPlayer" \
  goobaroo/pixelmon:latest

参数说明

• -v /path/to/persistent/data:/data：替换/path/to/persistent/data为本地持久化目录路径
• -e EULA="true"：必须设置为"true"以接受EULA
• 其他环境变量可根据需求添加或省略（使用默认值）

故障排除

EULA未接受

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

文件权限错误

问题：在非Unraid系统中，/data目录出现权限错误
原因：容器内运行用户的UID为99、GID为100（适配Unraid环境），可能与其他系统的文件权限冲突
解决：调整宿主机/data目录权限，确保UID 99和GID 100有读写权限

安装失败/重置

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

源码与镜像地址

• GitHub：https://github.com/Goobaroo/docker-pixelmon
• Docker Hub：https://hub.docker.com/repository/docker/goobaroo/pixelmon