ServerPackCreator 配置文件终极指南：serverpackcreator.conf 与 properties 全字段解析

ServerPackCreator 配置文件终极指南serverpackcreator.conf 与 properties 全字段解析【免费下载链接】ServerPackCreatorCreate a server pack from a Minecraft Forge, NeoForge, Fabric, LegacyFabric or Quilt modpack!项目地址: https://gitcode.com/gh_mirrors/se/ServerPackCreatorServerPackCreator 是一款强大的 Minecraft 服务端模组包生成工具它能从 Forge、NeoForge、Fabric、LegacyFabric 或 Quilt 模组包一键生成完整的服务端包。要玩转它核心在于读懂两套配置文件控制单个服务包行为的serverpackcreator.conf以及掌控全局行为的serverpackcreator.properties。本文将逐一解析每个字段的作用、默认值与最佳实践帮助你彻底掌控这个工具。两套配置文件各司其职ServerPackCreator 的配置分为单包配置与全局配置两层配置文件格式作用范围存放位置serverpackcreator.confTOML单个服务端包模组包路径、版本、包含目录等你的配置目录每包一份serverpackcreator.propertiesProperties全局行为模组过滤、脚本模板、Web 服务等SPC 主目录homeoverrides.propertiesProperties全局行为的临时覆盖层SPC 主目录加载顺序为内置默认值 → 主目录serverpackcreator.properties→ 主目录overrides.properties。这一优先级机制由 application.properties 中的spring.config.import定义。内置默认值可参考 serverpackcreator.properties。serverpackcreator.conf 全字段解析单包配置serverpackcreator.conf是每次生成服务端包的任务书使用 TOML 格式。字段定义与注释可直接查看 PackConfig.kt配置校验逻辑在 ConfigurationHandler.kt。基础字段一览字段说明示例modpackDir模组包目录或 ZIP 路径相对/绝对路径均可./Some ModpackminecraftVersionMinecraft 版本需与模组包一致1.20.1modLoader加载器仅限Forge/NeoForge/Fabric/Quilt/LegacyFabricNeoForgemodLoaderVersion加载器具体版本20.1.0serverPackSuffix服务端包名称后缀可留空-betajavaArgs写入启动脚本的 JVM 参数留空则不加-Xms2G -Xmx4GserverIconPath自定义server-icon.png路径可留空serverPropertiesPath自定义server.properties路径可留空includeServerIcon是否包含默认/自定义图标booltrueincludeServerProperties是否包含server.propertiesbooltrueincludeZipCreation是否生成 CurseForge 兼容的 ZIP 归档booltrueconfigVersion内部版本标记勿手动编辑用于版本迁移判断—inclusions包含规则详解inclusions是 conf 中最强大的部分决定哪些文件/目录进入服务端包。每个条目包含四个字段[[inclusions]] source config destination inclusionFilter exclusionFilter config/bluemap/.*source来源。模组包内的目录无需前缀如mods、config包外文件必须写完整路径。destination在包内的目标位置留空表示保持原名。inclusionFilter正则白名单只保留匹配的文件。exclusionFilter正则黑名单。若条目不设置 source则视为全局排除规则作用于所有包含项如.*.png可排除所有图片。⚠️ 注意lazy_mode会把整个模组包含客户端内容全部复制进服务端包官方明确不建议在生产配置中使用。clientMods 与 whitelist模组过滤双保险clientMods [AmbientSounds_, PackMenu-, F3Toggle-] whitelist [Ping-Wheel-, appleskin-]clientMods纯客户端模组黑名单生成时从服务端包中删除。写模组文件名前缀不含版本号不是 CurseForge 项目名。whitelist白名单模组即使命中黑名单也强制保留如Ping-Wheel这类客户端显示但服务端也需要的模组。当列表为空时SPC 会自动回退到内置的fallbackmodslist兜底列表数百个常见客户端模组的文件名前缀该列表随版本更新。[scripts]启动脚本占位符[scripts]是键值对集合生成启动脚本时做占位符替换[scripts] SPC_JAVA_SPC java SPC_JAVA_ARGS_SPC -Xms2G -Xmx4G内置占位符包括SPC_MINECRAFT_VERSION_SPC、SPC_MODLOADER_SPC、SPC_RESTART_SPC崩溃自动重启、SPC_SKIP_JAVA_CHECK_SPC跳过 Java 兼容性检查、SPC_WAIT_FOR_USER_INPUT_SPC脚本结束时等待用户确认等。注意SPC_JAVA_SPC在压缩包内的脚本中恒为java只有解压后的本地脚本使用你的自定义值——这是为了保证下载用户环境的兼容性。[plugins]插件扩展配置安装了插件pf4j 格式放入plugins目录后插件的扩展配置会保存在[plugins]区块中随 conf 一起加载。示例插件见 serverpackcreator-plugin-example。serverpackcreator.properties 全字段解析全局配置全局配置分四大板块官方文档详见 HELP.md 的 Configuration 章节。核心生成控制属性说明de.griefed.serverpackcreator.serverpack.autodiscovery.enabled自动检测模组端侧性客户端/服务端并排除纯客户端模组默认truede.griefed.serverpackcreator.serverpack.autodiscovery.filter黑名单匹配方式START默认前缀/END/CONTAIN/REGEX/EITHER慎用de.griefed.serverpackcreator.serverpack.cleanup.enabled生成后是否清理临时文件默认truede.griefed.serverpackcreator.serverpack.overwrite.enabled是否覆盖已存在的同名服务端包默认truede.griefed.serverpackcreator.minecraft.snapshots是否向 GUI 开放快照/预发布版本默认falsede.griefed.serverpackcreator.serverpack.zip.excludeZIP 归档排除的文件支持MINECRAFT_VERSION、MODLOADER、MODLOADER_VERSION占位符默认排除服务器 jar遵守 Mojang EULAde.griefed.serverpackcreator.serverpack.zip.exclude.enabled是否启用上述 ZIP 排除de.griefed.serverpackcreator.configuration.directories.serverpacks服务端包输出目录留空则为默认模组列表与目录过滤属性说明de.griefed.serverpackcreator.configuration.fallbackmodslist客户端模组兜底黑名单勿手动编辑通过菜单Edit → Update Fallback Clientside Modslist更新de.griefed.serverpackcreator.configuration.fallback.updateurl兜底列表的远程更新源 URLde.griefed.serverpackcreator.configuration.modswhitelist全局模组白名单如Ping-Wheel-、appleskin-de.griefed.serverpackcreator.configuration.directories.mustinclude建议纳入服务端包的目录config、mods、kubejs、scripts 等de.griefed.serverpackcreator.configuration.directories.shouldexclude自动排除的客户端目录screenshots、resourcepacks、logs、shaderpacks 等de.griefed.serverpackcreator.configuration.aikarAikar 的 JVM 调优参数集合GUI 中点击按钮即可一键写入javaArgs脚本模板与 Java 路径属性说明de.griefed.serverpackcreator.serverpack.script.template.bat/ps1/sh三种启动脚本模板的路径留空使用内置默认每次启动会被重置为最新版de.griefed.serverpackcreator.serverpack.java.template.ps1/shJava 自动安装脚本模板路径6.0.0de.griefed.serverpackcreator.script.java.N为 Java N 指定本地路径如script.java17C:/.../java.exede.griefed.serverpackcreator.script.java.autoupdate是否按 Minecraft 版本自动切换脚本中的 Java 路径默认truede.griefed.serverpackcreator.serverpack.update是否允许更新旧版生成的服务端包需关闭覆盖Web 服务模式与 Spring/Tomcat 配置启用-web参数后服务监听http://localhost:8080以下属性生效。官方明确提示无特别说明的spring.*/server.*属性不要改动以免破坏服务。属性默认值说明server.port8080Web 服务端口spring.servlet.multipart.max-file-size5000MB单文件上传上限用于上传模组包 ZIPspring.servlet.multipart.max-request-size5000MB单次请求总大小上限server.tomcat.accesslog.*—Tomcat 访问日志开关、目录、前缀/后缀、格式commonserver.tomcat.keep-alive-timeout600000长连接超时毫秒spring.datasource.tomcat.max-active50数据库连接池上限spring.transaction.default-timeout600事务默认超时秒spring.output.ansi.enabledALWAYS控制台彩色输出de.griefed.serverpackcreator.spring.schedules.database.cleanup0 0 0 * * *数据库清理 CronWeb 模式de.griefed.serverpackcreator.spring.schedules.files.cleanup0 30 0 * * *文件清理 CronWeb 模式de.griefed.serverpackcreator.spring.schedules.versions.refresh0 0 0 * * *Minecraft/加载器版本列表刷新 CronWeb 模式其他实用属性属性说明de.griefed.serverpackcreator.language界面语言en_GB、de_DE、uk_UAde.griefed.serverpackcreator.versioncheck.prerelease更新检查是否包含预发布版默认falsede.griefed.serverpackcreator.configuration.hastebinserver日志/配置上传用的 HasteBin 服务地址de.griefed.serverpackcreator.homeSPC 主目录谨慎修改custom.property.*自定义前缀用于向脚本/模板注入你自己的键值对实战技巧overrides.properties 快速覆盖无需改动主配置文件即可临时覆盖任意属性在 SPC 主目录新建overrides.properties写入要覆盖的键值对即可。启动时加载的覆盖项会打印到日志方便确认。这是 Web 部署如 Docker见 docker/root/defaults/serverpackcreator.properties时最常见的做法。配置检查Config Check会在生成前自动验证 conf 的所有字段——模组包路径是否存在、版本组合是否合法、包含目录是否可用错误会汇总显示如图中所示常见问题速查GUI 中看不到快照版本设置de.griefed.serverpackcreator.minecraft.snapshotstrue。想换语言修改de.griefed.serverpackcreator.language后重启。黑名单误删了服务端需要的模组把它加入whitelist或改用autodiscovery.filterREGEX精确匹配。生成的 ZIP 上传被平台拒绝检查zip.exclude是否生效需zip.exclude.enabledtrue服务器 jar 必须被排除。启动脚本 Java 路径不生效确认SPC_SKIP_JAVA_CHECK_SPCfalse且压缩包内脚本恒用java属正常设计。命令行生成使用-config /path/to/serverpack.conf直接指定 conf 文件配合--destination指定输出位置。相关文件路径一览默认全局配置serverpackcreator.properties单包配置模型与字段注释PackConfig.kt配置校验逻辑ConfigurationHandler.kt全局属性读取ApiProperties.ktWeb 服务内置属性application.properties官方配置文档HELP.md总结serverpackcreator.conf管这一个包怎么做路径、版本、inclusions、模组过滤、脚本占位符。serverpackcreator.properties管工具整体怎么跑自动检测策略、模板、Web 服务与定时任务。需要临时覆盖时优先用overrides.properties不动主配置。所有字段改完后运行一次配置检查确保生成流程零报错。掌握这两套配置文件后无论是本地 GUI 使用、CLI 自动化还是 Web 服务部署你都能对 ServerPackCreator 的行为了如指掌。【免费下载链接】ServerPackCreatorCreate a server pack from a Minecraft Forge, NeoForge, Fabric, LegacyFabric or Quilt modpack!项目地址: https://gitcode.com/gh_mirrors/se/ServerPackCreator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考