griefed/serverpackcreator

ServerPackCreator Docker镜像文档

镜像概述和主要用途

ServerPackCreator是一个命令行工具（CLI），旨在从给定的Minecraft模组包（支持Forge、NeoForge、Fabric、LegacyFabric或Quilt等模组加载器）创建服务器包，从而减少模组包开发中的重复工作。通过自定义配置，用户可快速生成包含服务器所需文件（如启动脚本、server.properties、服务器图标等）的服务器包，尤其适用于模组包版本更新时的服务器包快速构建。

核心功能和特性

1. 交互式配置生成：通过-cgen参数运行，可逐步生成自定义配置文件
2. 模组包下载与处理：支持直接下载CurseForge模组包（通过项目ID和文件ID）并从中创建服务器包
3. 服务器加载器安装：自动在服务器包中安装Forge、Fabric等模组加载器服务器
4. 客户端模组过滤：可配置客户端专属模组列表，自动从服务器包中删除匹配的客户端模组
5. 目录自定义复制：支持指定模组包中的目录（如存档世界）复制到服务器包，自动调整路径（如/saves/MyWorld复制为服务器包根目录下的/MyWorld）
6. 启动脚本包含：内置适用于Linux和Windows系统的Forge/Fabric启动脚本模板，可自定义后包含在服务器包中
7. 服务器图标支持：可包含自定义的server-icon.png文件到服务器包
8. 服务器配置文件：可包含自定义的server.properties文件到服务器包
9. ZIP归档生成：支持将生成的服务器包压缩为ZIP归档文件

使用场景和适用范围

• 模组包开发者：在更新模组包版本时，快速生成对应的服务器包，避免手动处理客户端模组删除、服务器文件配置等重复工作
• Minecraft服务器管理员：需要基于现有模组包构建服务器环境时，通过工具自动化处理客户端模组过滤和服务器配置
• CurseForge模组包用户：直接通过项目ID和文件ID下载指定版本的模组包并生成服务器包，无需手动准备模组包文件

使用方法和配置说明

Docker镜像信息

• 基础镜像：基于lsiobase/alpine（Alpine Linux + S6 overlay），支持与主机相同的用户/组ID，便于文件权限管理
• 支持架构：linux/amd64、linux/arm/v7、linux/arm64
• 镜像标签：
  • latest：最新稳定版
  • develop：开发版，可能包含未稳定功能，慎用

环境变量说明

Docker Compose配置示例

yaml
version: "2"
services:
  serverpackcreator:
    image: docker.xuanyuan.run/griefed/serverpackcreator:latest
    container_name: serverpackcreator
    restart: "no"
    environment:
      - TZ=Asia/Shanghai  # 时区设置
      - PUID=1000         # 主机用户ID
      - PGID=1000         # 主机组ID
      - MODPACKDIR=430517,3250155  # CurseForge项目ID,文件ID
      - MODLOADER=Forge   # 模组加载器类型
      - MODLOADERVERSION=43.2.0  # 模组加载器版本
      - MINECRAFTVERSION=1.19.2  # Minecraft版本
      - INCLUDEZIPCREATION=true  # 生成ZIP归档
      - INCLUDESTARTSCRIPTS=true  # 包含启动脚本
      - INCLUDESERVERPROPERTIES=true  # 包含server.properties
      - INCLUDESERVERINSTALLATION=true  # 安装服务器加载器
      - INCLUDESERVERICON=true  # 包含服务器图标
      - COPYDIRS=/saves/MyWorld,/config  # 复制的目录
      - CLIENTMODS=jei-,journeymap-  # 客户端模组列表
    volumes:
      - /host/path/to/data:/data  # 数据卷挂载（生成的服务器包存储于此）

Docker CLI命令示例

bash
docker create \
  --name=serverpackcreator \
  -e TZ=Asia/Shanghai \
  -e PUID=1000 \
  -e PGID=1000 \
  -e MODPACKDIR=430517,3250155 \
  -e MODLOADER=Forge \
  -e MODLOADERVERSION=43.2.0 \
  -e MINECRAFTVERSION=1.19.2 \
  -e INCLUDEZIPCREATION=true \
  -e INCLUDESTARTSCRIPTS=true \
  -e INCLUDESERVERPROPERTIES=true \
  -e INCLUDESERVERINSTALLATION=true \
  -e INCLUDESERVERICON=true \
  -e COPYDIRS=/saves/MyWorld,/config \
  -e CLIENTMODS=jei-,journeymap- \
  -v /host/path/to/data:/data \
  --restart "no" \
  griefed/serverpackcreator:latest

首次运行说明

首次运行后，工具会在server_files目录下生成模板文件（启动脚本、server.properties、server-icon.png等），用户可自定义这些文件以适配模组包需求。若需重新生成默认模板，删除对应文件后重新运行即可。