全站通知：

模组:在Android上安装SMAPI

来自站务
跳到导航 跳到搜索
← 模组:目录
模组使用指南 SMAPI mascot.png

本页介绍如何在Android上安装并使用SMAPI（该工具可让您使用Mod）。

其他平台的安装指南：Linux • macOS • Steam Deck • Windows。

安装 SMAPI

最低要求

  • 星露谷物语 1.6.15 或更高版本，可以从 Play Store 或 Galaxy Store 下载。
  • 64位手机

安装 SMAPI

Android 版 SMAPI 仍在测试中。某些模组尚不能正常工作；这可能会在 Android 版 SMAPI 的后续更新中被解决。务必备份存档。有时 SMAPI 启动器会崩溃并删除所有存档和模组。

  1. 下载并安装 SMAPI 启动器（形如 SMAPI.Launcher.vx.x.x.apk 的文件）。
  2. 下载 SMAPI 数据包（形如 SMAPI.4.x.x-xxxx.zip 的文件）。
  3. 打开 SMAPI Launcher。
  4. 点击 "Install SMAPI From Zip" 按钮。
  5. 选择之前下载好的 SMAPI 数据包。
  6. 当启动器显示 "Successfully installed SMAPI" 即为导入成功。
  7. 点击 "Start Game" 游玩带有模组的游戏。

如果您需要帮助，请参见 Android 版 SMAPI 教程（其中包含一个 Discord 链接以供您寻求帮助）。

启动器按钮简介

启动器介绍

我打不开启动器，它总是闪退

  • 你很可能使用了盗版/破解版游戏，请从Play Store 或 Galaxy Store 购买正版。
  • 如果你已经合法购买了游戏，但仍然被踢出游戏

请尝试重新安装启动器。

我必须更新 SMAPI 数据包吗

  • 不需要，但是最新版的 SMAPI 数据包能让你使用更多的模组。同时修复了之前版本中的一些常见错误和问题。

游戏加载的很慢

  • 如果你正在玩扩展包，可能是 SMAPI 或你的设备（两者皆有可能）加载困难。加载时也请避免触摸屏幕，以免崩溃。

Disable SaveBackup by SMAPI Android是什么？

  • 手机版星露谷物语自带快速存档，以下模组会导致该功能失效：
    • Custom Farm Loader
    • Farm Type Manager
    • SpaceCore
    • Unlockable Bundles
  • SMAPI4.3新增了对Quick Save模组的支持，你可以使用该模组平替。

SMAPI日志

如何分享我的游戏日志

  • 游戏日志是运行游戏产生的，它可以检查模组是否正确安装。请点击启动器页面的" share log "并将所有内容粘贴，发送给其他玩家。请勿删除显示游戏、启动器和 SMAPI 版本的附加信息。

"...it needs SMAPI 4.x.x or later"

  • 请确认你使用了最新版的 SMAPI 。

"...because it's no longer compatible"

  • 请更新你的模组。如果已经是最新版本但仍然出现此错误，则说明该模组在安卓系统上无法正常运行。您可以尝试使用旧版本（如果有的话）。

"...mod couldn't be added because it requires mods..."

  • 请阅读并安装所需的模组。同时查看 Nexus 模组页面，获取 Requirements 下的所有模组。

"...because it contains files, but none of them are manifest.json"

  • 检查模组文件夹内的文件，文件名必须为 manifest.json ，而不是 Manifest.json （首字母大写）。如果 manifest 文件不存在，请从 Nexus 重新下载模组并再次尝试安装。
  • 确认模组文件没有散开。每个模组需要一个单独的文件夹。
  • 有些模组，例如 Portraiture 和翻译文件，会说明需要将文件移动到某些模组文件夹内。请阅读模组说明了解具体步骤。

日志中有橙色警告

  • 如果它们对你的游戏没有任何影响，可以忽略它们。你只需要修复那些红色报错即可。

模组相关

如何更新模组？

  • 删除/data/abc.smapi.gameloader/files/Mods 中的模组文件夹，之后重新导入模组即可。

如何安装.rar的模组压缩包？

  • 将文件解压到 Mods 文件夹中。
  • 或者将模组文件解压然后再次压缩为 .zip 文件，并使用启动器自带的" Mod Manner "进行安装。

哪些模组能在手机上运行?

  • 由于代码编写方式的差异，并非所有在 PC 端运行的 mod 都能在安卓端运行，尤其是那些修改用户界面的 mod。其次，请在 Android SMAPI Discord上寻找是否有安卓移植版。一些安卓版本的 mod 也已上传至 Nexus Mods，例如 UI Info Suite 2 Redux。

如何更改我的模组配置？

  • 使用 Generic Mod Config Menu。
    • 使用 GMCM 时

在移动端上无法滚动菜单。你可以按住向下滚动，但无法向上滚动。

  • 手动编辑模组文件的 config.json （这是搭载模组运行游戏产生的）。
  • 请仔细阅读模组页面作者的简介。

我无法退出模组的菜单

  • 您需要使用手机的返回键退出。
  • 如果您安装了 So Many Toolbars 插件，可以选择将 Esc 键设置为快速操作工具栏上的虚拟按键。启用此功能后，Esc 键将始终显示在菜单顶部，您可以将其用作返回键。

我下载了一个着色美化，但是游戏地方仍是原版

  • 请检查重新着色和图块集是否已更新至 1.6 版本。
  • 如果您有新的地图/地点，可以检查它是否与该重新着色兼容。

如何安装包含.xnb 文件的 mod？

  • 这类模组原本是用来替换游戏文件的，但现在已不再推荐使用。直接替换游戏文件很容易导致游戏崩溃。建议您寻找带有内容补丁程序（CP）的模组版本。
  • 如果没有 CP 版本， XNB Retex Helper 是一个可以添加 .xnb 资源文件的 CP 模组。请按照模组说明中的步骤操作。
  • 肖像文件请按照Portraiture说明中的步骤进行操作。
  • 对于非肖像文件，您也可以尝试使用模板将其转换为 CP 格式。此外，还有一个在线 XNB 转换器可以将图像转换为.png 格式，如果您想亲自查看游戏素材，也可以使用这个转换器。

特定模组

有替代方案

无替代方案

  • 任何增加背包空间的模组（例如 Bigger Backpack、Custom Backpack Framework）
  • 任何需要你按住某个键的模组
  • Better Crafting
  • Custom skill mods
  • Birb Core
  • DaLionheart
  • Desert Bloom Farm

No direct alternative. Try other farm maps

  • Extra Animal Configs
  • Farmer Portraits
  • Livestock Bazaar
  • Mobile Phone
  • PoohCore
  • Secret Note Framework
  • Solid Foundations
  • Sword and Sorcery
  • Vanilla Plus Professions

特定模组的配置说明

炼金术（Alchemistry）

  • 安卓版补丁请参考Discord帖子
  • 安装说明详见此处
  • 无需安装“Better Crafting（该模组与Android不兼容）请安装“Extra Machine Configs”模组代替
  • 目前，该模组中仅“坩埚”无法正常使用。

替代纹理（Alternative Textures）

  • 在 Android SMAPI 4.2 版本中，AT 地板和壁纸存在 bug。重新加载存档会破坏它们并使它们变得不可见，导致出现虚空房屋。这发生在原版和模组化的农舍上。
  • 使用按钮控制模式（摇杆和按钮，或任意）来应用更改
  • 搜索纹理名称无效
  • 使用箭头键来滚动
  • 要退出纹理菜单，请使用您手机的返回按钮，否则您将不得不选择一个纹理，以便窗口自行关闭。

饰品栏

  • 安卓版补丁请参考此论坛帖子
  • 安装说明详见此处
  • 无需安装“Better Crafting（该模组与Android不兼容）请安装“Extra Machine Configs”模组代替

蜜蜂寻路优化（Bee Paths）

  • 与快速存档不兼容，因为快速存档会导致你的机器消失。这个问题已经向两个模组页面报告为错误。

可建造的姜岛农场

  • 如果你曾经尝试在一个额外的农场上建设，比如 SVE 的格兰普顿田野、东峭壁的牧场农场、PIF 农场或其他什么农场，并且发现罗宾的菜单中没有显示额外位置，这确实是个问题。不知为何，这个模组修复了它，并允许你在额外的农场建设。只需安装它，你便可以在姜岛建造。

CJB 物品生成器

  • 使用 Android 版本

自定义菜单背景（Custom Menu Background）

  • 使用Optional Files 下的 Android 版本

东斯卡普

  • 理发店在 Android 上不兼容，所以你可以删除ESBarberShop 文件夹
  • 大部分NPC都能正常工作

剑与魔法

  • 尽管不推荐使用，但该模组仍可运行——其角色构成的核心内容（基础数据、日程安排、事件流程）均基于 Content Patcher 制作。运行过程中会出现红色报错提示，且角色扮演机制可能无法正常生效，请自行承担使用风险。

简单的箱子（Easy Chest）

  • 与易谷一起使用
  • 打开 Easy Valley 菜单（默认 Q 键）然后点击Display Chests
  • 如果你不和易谷一起使用，将DefaultOpenList改为true并添加EasyChest的快捷键到你的虚拟键盘。
  • 关掉Show Chest Info以及工作台选项。

艾斯卡模组插件（Esca's Modding Plugins）

  • 如果最新版本无效，请使用1.6.1版本。

事件查找

  • 使用Android版本

额外机器配置（Extra Machine Configs）

  • 使用 Android 版本

时尚感（Fashion Sense）

  • Nexus 版本在 SMAPI 4.2 上运行良好，但具体效果因设备而异
  • 如果皮埃尔那里没有出现手镜，可以尝试按照 这个修复 的说明进行操作
  • ，或者你可以将 Require Hand Mirror 设置为 false，然后使用快捷键
  • 使用按钮控制模式（摇杆与按钮，或任意）来控制镜子
  • 在两个版本中，保存和搜索服装都不起作用

家具框架（Furniture Framework）

  • 使用版本 3.0.5

通用模组配置菜单

  • 在此无法更改按键绑定和文本输入。您需要手动配置模组

快乐家居设计师

  • 从 2.4.2 版本开始，正式添加了对 Android 的支持。

日志垃圾过滤器（Log Spam Filter）

  • 如果你对错误有很高的容忍度（例如对于 UI Info Suite 2），这会很有用，但设备本身不支持并且会很快变慢。如果你不确定如何配置它，请尝试以下方法：

```C# { 

  "EnableMod": true,
  "IsDebug": false,
  "AllowList": "Log Spam Filter", 
  "MSSpawnThrottle": 2500,  
  "MSBetweenMessages": 600,  
  "MSBetweenIdenticalMessages": 3000,  
  "MSBetweenSimilarMessages": 2000,  
  "PercentSimilarity": 80

}```

查找一切（Lookup Anything）

- 从 SMAPI 4.3 和 Lookup Anything 1.53 开始，搜索功能现在可以在移动设备上使用（尽管有点不稳定）。你需要将 ToggleSearch 的按键绑定改为单个键，而不是默认的 Leftshift + F1，因为 虚拟键盘 不支持多键组合

NPC地图显示

  • Nexus上和Android版本的唯一区别是菜单中的地图大小。根据屏幕大小进行选择。

Portraiture

  • 在使用 NRT 的虚拟键盘时，对话期间不会显示，因此需要在 Portraiture 中更改配置，将快捷键P和I其改为 VolumeDown 或 VolumeUp ，然后在对话显示时按音量键来切换/锁定肖像。
  • DoubleZ 的 Nexus 版本虚拟键盘会更好，请将"AboveMenu"后的数字改为1。

快速存档

  • 如果使用最新的SMAPI版本，则无需添加按键绑定。
  • 不过，请记住不要使用其他模组的默认按键绑定，或者将此模组的按键绑定更改为您确定不会使用的按键，以免误触。
  • 与蜜蜂寻路优化不兼容，因为快速加载会导致您的机器消失。此问题已向两个模组的页面报告。

多工具栏（So Many Toolbars）

  • 该模组除了能自定义屏幕显示内容外，“快捷工具栏”功能也是虚拟键盘的替代或补充方案——你无需修改config.json就能在游戏内直接定义虚拟按键。该工具栏可设置为悬浮于菜单，现在还新增了将指令添加为按键的功能。

太空核心（Space Core）

  • 使用 Android 版本 与最新的SMAPI版本⁠

特殊能力工具（Special Power Utilities）

  • 可以正常工作，但特殊功能选项卡有透明背景。这是由于移动界面与电脑界面不同

Stardew Valley Expanded

  • 存在一个错误，允许你在不先修复的情况下进入公交车并传送至卡利科沙漠

杨梅村

  • 使用 Android 版本 。请注意，从 SMAPI 4.2 开始，它存在一些问题，用户的使用结果各不相同

UI2

  • 无论使用哪个版本，你都需要至少睡一觉并保存游戏，以生成对应存档的配置文件。
    • Redux
      • 这是最新的移动版，修复了其他安卓版本存在的错误信息刷屏问题，还新增了信息图标与经验条移动设置等功能。
    • 官方 Nexus 版本
      • 无法在游戏中更改设置，您需要进入模组文件夹，然后到 /data/[保存名称].json 并手动配置
      • 地图上的内置 NPC 位置未对齐。使用 NPC 地图位置

UI 美化

  • 如果您不确定某个 UI 美化在 Android 上是否有效，可以点击 Preview file contents（预览文件内容）并在 LooseSprites 文件夹下查找名为 mobileatlas_manually_made 或 MobileAtlas_manually_made 的 png 文件
  • Minsun 制作了一个关于如何在 Android 上制作 UI 模组的教程，如果你想自己动手的话。不过它是泰语版的，但你可以通过截图文字然后放到 Google Lens 上进行翻译。

可解锁捆绑包（Unlockable Bundles）

  • 使用 Optional Files 下的 Android 版本，但由于该版本较旧，可能存在一些错误。如果软件包未出现在指定位置，请使用官方版本。此版本中不显示库存，因此提交物品需要一些尝试。

原版界面微调——界面优化

  • 不完全有效。背包和收集品菜单标签不会更改，但其他图标都正常工作
  • 如果你知道方法，在使用任何支持的自定义 UI 重色（假设它们支持移动端）的情况下，你可以自己编辑移动地图上的那些标签图标，而如果你只是使用原版 UI，则可以通过一个简单的 Content Patcher 模组来实现

虚拟键盘

我如何向我的虚拟键盘添加更多按钮？
  • 通过至少一次安装模组后运行游戏来生成配置文件。在启动器中应该有' Mod Manager '，然后点击' Open Folder Mods '。寻找虚拟键盘文件夹，然后编辑config.json 文件。或者使用文件管理器访问smapi启动器的模组储存路径Android/data/abc.smapi.gameloader/files/Mods找到并编辑该文件以根据需要添加和删除按键
      • Above Menu 改为1即可让其出现在对话框至上
  • ，两者之间的区别仅在于 NRTnarathip 的版本可以使用控制台命令 ，而第二个 DoubleZ 的版本即使有对话也会显示（对于 Portraiture 这类模组非常实用）。DoubleZ 版本还可以在按键上使用别名（例如，P 键用于打开CJB作弊菜单，所以我将 P 键别名为"作弊"，这样我就不用记住按键了）
虚拟键盘可以使用哪些按键绑定？
  • 只要它们不属于原版控制 ，你可以将其设置为任何你想要的按键。
  • 如果你在将这些原版控制键用作 mod 快捷键时遇到问题，只需换成其他键即可，一个键盘上有许多键，不可能每一个键都被占用
  • ，你可以在这里查看按钮代码。这些是你放入配置中的快捷键的"名称"
  • 建议使用模组的默认快捷键，但如果多个模组使用相同的快捷键，你可以改变它。SMAPI 不会防止模组使用冲突的热键。
  • 多键组合在虚拟键盘上无效，所以如果模组需要，只需将其编辑为单个按键。
  • 你也可以为模组设置备用按键绑定


更新 SMAPI

只需要重新按照安装步骤进行安装即可，“SMAPI启动器”会自动清理旧版本的文件残留。

为什么要有专门针对 Android 的 SMAPI？

由于Android上的《星露谷物语》与其他平台上的游戏版本架构差异较大，因此官方版本的 SMAPI 不兼容 Android 版的游戏。有人将 SMAPI 移植到了 Android 平台，此移植版兼容大部分基于 SMAPI 的模组和内容包（包括Content Patcher，Farm Type Manager，Json Assets 和 PyTK 等基础框架），但也有一些Mod可能不兼容。

Android版SMAPI的移植者是谁

Android 版 SMAPI 最开始是被 MartyrPher 移植的，以用于星露谷物语 1.4.x 版本。随后，ZaneYork 针对星露谷物语 1.5.x 版本做了更新和优化，NRTnarathip 针对星露谷物语 1.6.x 版本做了更新和优化。每次升级都是建立在前人的基础上的（例如，NRTnarathip 的版本接续了 MartyrPher 和 ZaneYork 的工作）。

← 入门

取自“https://wiki.biligame.com/stardewvalley/index.php?title=模组:在Android上安装SMAPI&oldid=136095”