修复双重物品

修复双重物品

修复模组之间的物品名称冲突,使两个物品都能保留在游戏中并继续正常工作。

[center][img]https://i.imgur.com/3qxSqCb.png[/img] [/center]


是否曾经安装了两个鱼类模组,然后打开星露谷水族馆的捐赠列表,却发现它坏了、闪烁或空空如也?很可能你的两个模组添加了完全同名的鱼——例如 Stardew Valley Expanded 的「Tadpole」和 Unique Fish Additions 的「Tadpole」。这些物品不同,ID 也不同,但少数模组(例如 Stardew Aquarium)会按名称查找鱼,得到两个结果,然后放弃。有时这会在你的 SMAPI 日志中产生错误,有时这意味着两条鱼都无法使用。

此模组会找出这些名称冲突,并悄悄给其中一个物品一个新的内部名称。两条鱼都会留在你的游戏中,都能继续工作,而且看起来没有任何不同——你在游戏中看到的名称不会改变。

[b]工作原理[/b]

每个物品都有一个 ID(游戏用于配方、存档、商店等)和一个内部名称(少数模组将其用作查找键)。ID 是唯一的。名称有时不是。

当游戏加载其物品列表时,此模组会:
1. 查找来自不同模组但共享内部名称的物品(空格和大写字母会被忽略,因为 Stardew Aquarium 就是这样比较它们的)。
2. 检查该冲突是否真的会造成问题。大多数名称重叠是无害的,所以默认情况下只有两种情况会被处理:安装了 Stardew Aquarium 时的两条鱼,或者游戏数据(鱼塘、机器、礼物喜好、商店、收集包……)通过其 item_name 标签引用的名称。
3. 保留一个物品的名称,并给另一个添加一个小后缀,例如 Tadpole 和 Tadpole_otohime.uniquefish。两者显示的名称仍然是「Tadpole」。

它有意不处理的情况:来自同一模组、故意共享名称的物品(变体、编号笔记等),以及与原版物品冲突的任何内容。

物品 ID 绝不会被改动,因此配方、机器、商店、收集包和你现有的存档都会像以前一样继续工作。


[center]img[/img] [/center]


1. 安装最新版本的 SMAPI。
2. 安装 Generic Mod Config Menu(可选,但推荐用于轻松配置)。
3. 下载此模组并将其解压到你的 Stardew Valley/Mods 文件夹中。
4. 使用 SMAPI 运行游戏。

无需其他操作——它会自行工作。每次重命名都会写入 SMAPI 日志,并附上原因。


[center]img[/img] [/center]


你可以使用 Generic Mod Config Menu 在游戏内配置此模组,或编辑 Mods/DoubleItemFixer/config.json:

[list]
[][i]Enabled[/i] - 打开或关闭所有重命名。保存菜单后立即生效。[/]
[][i]Only real problem cases[/i] - 默认开启。只处理真正可能破坏某些功能的名称冲突(见上文)。关闭它以处理所有名称重叠,这会找出许多无害的重叠。[/]
[][i]Manual mode[/i] - 默认关闭。允许你覆盖每一对物品的自动选择(见下文)。[/]
[][i]Review key[/i] - 打开冲突列表。默认为 F10。[/]
[][i]Log every rename[/i] - 在 SMAPI 控制台中显示每次重命名,而不仅仅是在日志文件中。[/]
[][i]IgnoredNames[/i](仅 config.json) - 永远不应被重命名的内部名称。[/]
[/list]
[b]手动模式[/b]

对哪个物品被重命名不满意?开启手动模式并按审查键(或在模组菜单中勾选「保存后打开审查列表」)。你会得到一个列表,其中每个冲突都会并排显示两个物品,每个都带有图标、名称和来源模组。将鼠标悬停在物品上可查看其 ID 以及该冲突为何重要。然后选择以下之一:

[list]
[][i]重命名左侧的[/i] 或 [i]重命名右侧的[/i] - 该物品会获得新名称。[/]
[][i]保留两者[/i] - 不更改两个名称(冲突保留)。[/]
[][i]还原[/i] - 忘记你对该对的选择。还原所有选择 会对每一对执行此操作。[/]
[/list]
你尚未决定的配对会被自动重命名,因此在你查看时不会有任何损坏。你的选择会被保存,并在下次加载存档时应用(Stardew Aquarium 在加载时只读取一次名称)。

[b]卸载[/b]

一旦移除该模组,冲突就会回来。Stardew Aquarium 还会按名称保存你捐赠了哪些鱼,因此被重命名的鱼的捐赠会以其新名称存储。要清理这个问题,请在加载存档的情况下打开该模组的 Generic Mod Config Menu 页面,勾选 Prepare uninstall 和 Yes, I am sure,然后按 Save & Close。该模组随后会自行关闭,并只移除那些捐赠标记,同时写入备份。Undo preparation 会将它们恢复。然后关闭游戏并删除模组文件夹。

请记住:没有此模组时,使用相同名称的模组可能会再次冲突,因此你可能需要为这些模组制作一个小型兼容补丁。


[center]img[/img] [/center]


该模组不会更改任何文件——它只会在游戏加载时更改内存中物品的内部名称。

[list]
[]适用于任何添加物品的模组,无论它使用哪个框架。[/]
[]替代那些只重命名冲突鱼的小型兼容补丁(例如 Fresh Fish 与 Return to Mineral Town 的修复,或 Unique Fish Additions 与 Stardew Valley Expanded 的修复)。一旦此模组运行,你就可以移除那些补丁。[/]
[]重命名物品会更改其自动的 item_<name> 上下文标签。按该确切标签过滤的规则将不再匹配被重命名的物品,这与那些小型补丁所做的取舍相同。[/]
[]按名称查找物品的模组(例如使用带有名称的 ItemId 令牌的内容包)只会找到保留名称的物品。[/]
[/list]
[i]不兼容的模组:[/i]
目前未知。如果某个模组在名称冲突时仍然报错,请将 SMAPI 日志行和涉及的两个物品发给我。

欢迎在 [url=https://www.patreon.com/cw/legolukas/membership]Patreon[/url] 上支持我,如果你喜欢我的作品,别忘了在 Nexus 上点击 Endorse!

也来看看我的其他模组:
[][url=https://www.nexusmods.com/stardewvalley/mods/47267]Achievement Excluder[/url] - 让你可以为某些成就禁用模组或原版物品。[/]
[][url=https://www.nexusmods.com/stardewvalley/mods/52734]Fix Error Items[/url] - 将损坏和有问题的物品替换为可用的物品[/]
[][url=https://www.nexusmods.com/stardewvalley/mods/52612]Quest Vision[/url] - 在箱子和菜单中标记用于任务、收集包等的物品

[/
]