StardewSaveLauncher for MacOS

StardewSaveLauncher for MacOS

StardewSaveLauncher 是一个启动器,它将星露谷物语存档文件与特定的模组集关联起来,让你能够直接使用对应存档启动游戏。

[size=4][b]描述[/b][/size]
Stardew Save Launcher 是一款专注于存档的《星露谷物语》模组启动器。
它让你可以在一个统一的模组库中管理《星露谷物语》模组,并为每个存档分配不同的模组组合。无需在切换农场时手动启用和禁用模组,只需选择你想游玩的存档,启动器就会按照该存档配置的模组环境启动游戏。
每个存档都可以拥有自己的模组组合,而像 Content Patcher 或 Generic Mod Config Menu 这类常用模组可以标记为通用模组,并自动包含在所有存档中。
当你启动某个存档时,Stardew Save Launcher 会合并该存档分配的模组、通用模组以及必需的依赖项,创建临时的运行时模组环境,启动 SMAPI,并加载所选存档。
目标很简单:
[b]选择你的农场,点击 Play,剩下的交给启动器为该存档准备好正确的模组配置。[/b]

[size=4][b]安装说明[/b][/size]
[list=1]
[][color=#d4d4d8]确保已安装《星露谷物语》和 SMAPI。[/color][/]
[][color=#d4d4d8]下载适用于你操作系统的最新 Stardew Save Launcher 版本。[/color][/]
[][color=#d4d4d8]解压下载的压缩包。[/color][/]
[][color=#d4d4d8]在 macOS 上,将 [b]Stardew Save Launcher.app[/b] 移动到你的“应用程序”文件夹或你选择的其他位置。[/color][/]
[][color=#d4d4d8]打开 Stardew Save Launcher。[/color][/]
[][color=#d4d4d8]如果未能自动检测到所需路径,请手动配置:[/color]

[list]
[
][color=#d4d4d8]Stardew Valley[/color][/]
[
][color=#d4d4d8]SMAPI[/color][/]
[
][color=#d4d4d8]Stardew Valley 存档目录[/color][/]
[
][color=#d4d4d8]模组库[/color][/]
[/list][/
]
[][color=#d4d4d8]将你的模组添加到模组库。启动器会扫描每个模组的 [/color]

[code]manifest.json[/code][color=#d4d4d8],并使用其中的 [/color]

[code]UniqueID[/code][color=#d4d4d8] 来识别和管理模组。[/color][/
]
[][color=#d4d4d8]选择一个存档文件,并选择要关联到该存档的模组。[/color][/]
[][color=#d4d4d8]可选:将常用的模组标记为 [b]通用模组[/b],以便自动将其包含在每个存档中。[/color][/]
[][color=#d4d4d8]点击 [b]Play[/b],构建运行时模组环境,并通过 SMAPI 启动所选存档。[/color][/]
[/list][color=#d4d4d8]你原来的模组仍保留在模组库中。启动器会创建一个独立的运行时环境,仅包含所选存档所需的模组。[/color]


[size=4][b]主要功能[/b][/size]
[b]基于存档的模组管理[/b]
为每个《星露谷物语》存档分配不同的模组配置。你的模组环境会跟随你选择游玩的农场。

[b]中央模组库[/b]
将已安装的模组集中保存在一个库中,而无需为每个存档维护单独的副本。模组通过其
[code]manifest.json[/code] 中的
[code]UniqueID[/code] 进行识别。

[b]通用模组[/b]
将模组标记为通用模组,可自动为每个存档启用它们。这对于你希望始终可用的框架、实用工具和 UI 模组非常有用。

[b]自动依赖解析[/b]
启动器会读取模组依赖项,并自动将必需的依赖项包含到运行时环境中。缺失或不兼容的必需依赖项会在启动前报告。

[b]运行时模组环境[/b]
只有所选存档所需的模组会被添加到运行时 Mods 目录中。在支持的情况下会使用符号链接,避免不必要地复制你的模组文件。

[b]存档检测[/b]
启动器会扫描你的《星露谷物语》存档目录,并让你围绕各个农场管理模组配置。

[b]通过 SMAPI 启动[/b]
准备好所需模组后,Stardew Save Launcher 会通过 SMAPI 启动游戏。

[b]直接启动存档[/b]
一个轻量级的配套 SMAPI 模组允许启动器在开始游戏时请求特定存档,将常规操作流程简化为:
[b]打开启动器 → 选择农场 → Play[/b]

[size=4][b]要求[/b][/size]
[b]必需[/b]
[list]
[]Stardew Valley[/]
[]SMAPI[/]
[]运行于 Apple Silicon(M1 或更新)的 macOS[/]
[/list][b]用于模组管理[/b]
模组必须包含有效的 SMAPI
[code]manifest.json[/code],才能被启动器识别。
各个模组可能有自己的依赖项和要求。Stardew Save Launcher 可以从它们的清单中检测所需的依赖项,但不会自动下载缺失的模组。
[b]平台支持[/b]
当前版本的 Stardew Save Launcher 仅支持 [b]Apple Silicon 上的 macOS[/b]。
支持的处理器包括:
[list]
[]Apple M1[/]
[]Apple M2[/]
[]Apple M3[/]
[]Apple M4[/]
[]更新的 Apple Silicon 处理器[/]
[/list][b]当前版本不支持基于 Intel 的 Mac。[/b]
Windows 支持计划在后续版本中提供。

[b]重要[/b]
Stardew Save Launcher 不会取代 SMAPI。它管理每个存档使用哪些模组,并通过 SMAPI 启动生成的模组环境。
启动器在切换存档配置时也不会修改或复制你原来的模组库。运行时模组环境是为启动游戏而单独生成的。

[size=3][b]默认路径
[/b][/size]Stardew Save Launcher 会在可能的情况下自动检测所需目录。在 macOS 上,默认常用以下位置:

[b]模组库[/b]
[code]/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/Mods[/code]《星露谷物语》的主 Mods 目录。已安装的模组会从此位置检测,并可分配到各个存档配置。

[b]存档目录[/b]
[code]/.config/StardewValley/Saves[/code]macOS 上《星露谷物语》的默认存档目录。启动器使用此目录检测你的农场并创建存档专属模组配置。

[b]SMAPI 目录[/b]
[code]/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/StardewModdingAPI[/code]包含 SMAPI 启动器的《星露谷物语》安装目录。

[b]运行时目录[/b]
[code]/StardewSaveLauncher/Runtime[/code]由 Stardew Save Launcher 生成的临时运行时目录。启动存档时,启动器会在此处使用所选存档配置、通用模组和必需依赖项构建活动模组集合。

如果你的《星露谷物语》或 SMAPI 安装使用不同位置,可以在启动器设置中更改这些路径。


[size=4][b]测试须知
[/b][/size]macOS 应用已使用 Developer ID 证书签名。但是,我目前还无法在其他 Mac 上测试当前版本。
如果你有 Apple Silicon Mac 并且愿意进行测试,如果你能尝试启动该应用并留言告诉我是否正常运行,我将非常感激。
如果你遇到任何问题,请附上你的 Mac 型号、macOS 版本以及你看到的任何错误信息。这将帮助我改善与其他 Mac 环境的兼容性。
感谢你帮助测试此版本!