ServerPackCreator：自动化Minecraft服务器包创建工具

ServerPackCreator是一个专为Minecraft服务器管理员设计的自动化工具，能够从Forge、Fabric、Quilt、LegacyFabric和NeoForge模组包中快速生成服务器包。该项目通过简化服务器配置、模组管理和客户端资源整合流程，大大提升了Minecraft服务器的部署和维护效率。

核心功能特性

多模组加载器支持

ServerPackCreator全面支持主流Minecraft模组加载器：

• Forge - 传统模组加载器支持
• Fabric - 轻量级现代加载器
• LegacyFabric - 旧版本Fabric支持
• Quilt - Fabric分支改进版本
• NeoForge - Forge的现代替代方案

智能模组管理

工具提供双重模组排除机制：

• 自动排除 - 自动扫描模组包的sideness属性识别客户端专用模组
• 手动配置 - 支持自定义模组过滤列表，按需排除特定模组

文件与目录管理

• 支持从模组包中添加文件和目录
• 支持从本地计算机添加额外资源
• 灵活的包含和排除规则配置

服务器配置自动化

• 服务器图标 - 自动缩放至64x64标准尺寸，支持自定义或使用默认图标
• server.properties - 可配置默认服务器设置文件
• 启动脚本 - 自定义JVM参数和启动选项，支持Aikar标志等优化参数

技术架构

多模式运行支持

ServerPackCreator提供三种运行模式，适应不同使用场景：

命令行模式(CLI)

• 无需图形界面，适合服务器环境
• 支持配置文件逐步生成和现有配置加载
• 适合自动化脚本集成

图形界面模式(GUI)

• 可视化文件浏览和配置管理
• 支持拖放操作和实时预览
• 完整的配置编辑功能

Web服务模式(WEB)

• 基于浏览器访问，无需客户端安装
• 支持模组包和服务器包共享
• 配置复用和多版本管理

插件系统架构

项目采用模块化设计，支持功能扩展：

• 插件API提供多个扩展点
• 示例插件包含在项目中演示开发模式
• 支持自定义脚本模板和占位符替换

安装与部署

系统要求

• Java版本：运行JAR文件需要Java 21
• 内存需求：建议至少2GB可用内存
• 网络连接：需要互联网连接以下载模组加载器版本

安装方式

使用安装包 各平台提供原生安装包，包含内置Java运行时：

• Windows：EXE安装程序
• macOS：DMG镜像文件
• Linux：DEB/RPM包或AppImage

使用JAR文件 直接下载JAR文件运行：

java -jar serverpackcreator.jar

Docker部署（推荐）

使用Docker Compose快速部署Web服务：

version: '3'
services:
    serverpackcreatordb:
        image: mongodb/mongodb-community-server:8.0.5-ubuntu2204
        environment:
            MONGO_INITDB_ROOT_USERNAME: <用户名>
            MONGO_INITDB_ROOT_PASSWORD: <密码>
        volumes:
            - spcdb-data:/data/db

    serverpackcreator:
        image: griefed/serverpackcreator:latest
        ports:
            - "8080:8080"
        environment:
            - SPC_DATABASE_USERNAME=<用户名>
            - SPC_DATABASE_PASSWORD=<密码>
        volumes:
            - ./modpacks:/app/serverpackcreator/modpacks
            - ./server-packs:/app/serverpackcreator/server-packs

使用指南

基本工作流程

1. 选择模组包 - 指定要处理的模组包ZIP文件或目录
2. 配置设置 - 调整模组过滤、文件包含等参数
3. 生成服务器包 - 自动处理模组排除和资源配置
4. 测试验证 - 强烈建议测试生成的服务器包
5. 分发部署 - 打包为ZIP文件或直接使用

配置示例

典型的服务器包配置包括：

• 模组加载器版本选择
• JVM内存参数配置（-Xms4G -Xmx4G）
• 服务器图标和属性文件设置
• 自定义脚本模板和变量

注意事项

安全提示

• Web服务模式不建议公开访问，因涉及ZIP文件上传安全风险
• 如必须公开访问，应实施身份验证和授权机制
• 定期更新以获取安全补丁和功能改进

版本兼容性

• 使用Alpha/Beta版本时建议备份配置目录
• 生产环境避免使用预发布版本
• 不同Java版本可能存在兼容性问题

责任声明

• 工具不保证生成的服务器包100%正常工作
• 用户仍需对生成的服务器包进行充分测试
• 使用预发布版本产生的问