
矿鱼框架(内容补丁器)
一个用于自定义矿井钓鱼的内容修补框架。可独立编辑第20、60和100层,添加原版或模组鱼类,调整捕获概率并控制条件
查看大图[color=#ff7700][size=4][b][u]为每一层矿井钓鱼水域提供独立的渔获表[/u][/b][/size][/color]
Mine Fish Framework 允许 Content Patcher 内容包自定义矿井钓鱼,包括第 100 层的岩浆池。
矿井使用特殊的渔获选择逻辑,普通的钓鱼数据编辑无法完全覆盖这些逻辑。本框架提供了独立、可编辑的池,因此内容包作者可以修改某一层,而不会把相同的改动应用到所有矿井钓鱼层。
[b]这是一个框架。[/b]请安装兼容的内容包来添加渔获或调整平衡。它自身提供基于原版矿井钓鱼的默认值,不会添加新的鱼类物品。
[color=#ff7700][size=4][b]功能[/b][/size][/color]
[list]
[*]为第 [b]20、60 和 100[/b] 层提供独立的钓鱼池。[/*]
[*]通过 Content Patcher 添加、移除或替换渔获。[/*]
[*]支持原版鱼类和其他模组定义的自定义鱼类。[/*]
[*]可调整渔获概率、钓鱼等级与距离加成、鱼饵加成以及好奇诱饵加成。[/*]
[*]可控制洞穴水母和垃圾保底项。[/*]
[*]支持基于时间、季节、进度和其他游戏状态的检查条件。[/*]
[*]训练用鱼竿规则、渔获上限和位置限制。[/*]
[*]支持在有可钓水域的其他矿井层或层数范围添加规则。[/*]
[*]支持 Content Patcher 重新加载,无需重启游戏。[/*]
[/list]
默认值保留原版的特殊鱼类和第 100 层水母概率公式。随机抽取的顺序不同,因此即使使用默认设置,单次渔获也可能有所差异。
[color=#ff7700][size=4][b]前置要求[/b][/size][/color]
[list]
[*][b]星露谷物语 1.6[/b]。[/*]
[*][b][url=https://smapi.io/]SMAPI[/url][/b] 版本 [b]4.3.2 或更高[/b]。[/*]
[*][b][url=https://www.nexusmods.com/stardewvalley/mods/1915]Content Patcher[/url][/b] 用于加载 Content Patcher 内容包。[/*]
[*]你所选内容包所需的任何额外模组,包括定义其自定义鱼类的模组。[/*]
[/list]
内容包工作流需要 Content Patcher。框架本身可以在没有它的情况下加载,并使用其默认池。
[color=#ff7700][size=4][b]安装[/b][/size][/color]
[list=1]
[*]安装 SMAPI 和 Content Patcher。[/*]
[*]下载 Mine Fish Framework 主发布版本。[/*]
[*]将 ZIP 解压到你的星露谷物语 Mods 文件夹中。应创建 Mods/MineFishFramework。[/*]
[*]安装你想使用的兼容内容包。[/*]
[*]通过 SMAPI 启动游戏。[/*]
[/list]
更新时,替换现有的框架文件。只保留一个已安装副本。
[color=#ff7700][size=4][b]适用范围[/b][/size][/color]
内置规则覆盖第 20、60 和 100 层的钓鱼池,包括危险矿井中的这些层数。内容包可以定义额外的层数规则。
普通钓鱼地点、火山口、蟹笼和骷髅洞穴默认保留其现有行为。自定义地牢地点需要使用游戏的 MineShaft 类才能被这些规则覆盖。
[color=#ff7700][size=4][b]兼容性[/b][/size][/color]
[b]Content Patcher 内容包:[/b]多个内容包可以编辑本框架的数据。替换同一条目或更改同一字段的内容包可能相互覆盖。内容包加载顺序和池优先级决定哪些改动生效。
[b]现有的矿井钓鱼编辑:[/b]第 20 和 60 层在显式特殊鱼类条目失败后,仍会继续读取正常的全局和地下矿井钓鱼表。第 100 层默认不继承这些表;框架内容包可以启用该行为。
[b]自定义鱼类:[/b]当渔获条目引用鱼类的限定物品 ID 时受支持。定义该鱼类的模组也必须安装。仅添加鱼类模组不会自动将其鱼类添加到矿井中。
[b]钓鱼难度和小游戏模组:[/b]在不干预渔获选择的情况下预计可以共存。替换所选渔获的模组需要单独进行兼容性测试。
[b]其他矿井池框架:[/b]将 [b][url=https://www.nexusmods.com/stardewvalley/mods/44654]IamMineFish[/url][/b] 视为替代框架。没有专门的集成时不要组合两者;两者都控制矿井渔获选择,因此结果可能取决于补丁顺序。
本框架在 MineShaft.getFish 上使用一个 Harmony 前缀来暴露硬编码的矿井渔获。其他修补该方法的模组可能需要兼容补丁。
[color=#ff7700][size=4][b]多人游戏[/b][/size][/color]
渔获选择在钓鱼玩家的客户端上运行。所有使用这些池的玩家都应安装匹配版本的框架、内容包、自定义鱼类模组和配置。
[b]多人游戏和分屏尚未测试[/b]
[color=#ff7700][size=4][b]致内容包作者[/b][/size][/color]
[b][u][color=#ff0000][url=https://github.com/darkrobon-ops/MineFishFramework/wiki/Author-Guide]完整作者指南见此处[/url][/color][/u][/b]
使用 Content Patcher 的 EditData 操作修补此数据资产:
[code]
Mods/DarkRobon.MineFishFramework/Pools[/code]
默认池 ID 为 20、60 和 100。每个池都有一个 Fish 列表,其中包含可单独寻址的渔获条目。
例如,以下 content.json 更改第 100 层岩浆鳗鱼的[b]基础概率[/b]:
[code]
{
"Format": "2.0.0",
"Changes": [
{
"Action": "EditData",
"Target": "Mods/DarkRobon.MineFishFramework/Pools",
"TargetField": ["100", "Fish"],
"Fields": {
"LavaEel": { "Chance": 0.1 }
}
}
]
}[/code]
现有的钓鱼等级、距离和装备加成仍然适用。这更改的是基础值,而不是每次抛竿的最终概率。
将你的内容包声明为 Content Patcher 内容包,并添加对 [b]DarkRobon.MineFishFramework[/b] 的必需依赖。同时声明对你所用鱼类定义模组的依赖。为你添加的渔获条目使用唯一 ID,以帮助内容包共存。
渔获概率是顺序概率,而不是相对权重。Precedence 较低者先检查,相同优先级的条目会被打乱。每次抛竿只选择一个匹配的池规则。
[color=#ff7700][size=4][b]故障排除[/b][/size][/color]
在 SMAPI 控制台中运行以下命令:
[list]
[*][b]mff_pools[/b]:列出已加载的池,并显示当前矿井层所选的规则。[/*]
[*][b]mff_reload[/b]:使池资产失效,以便在下次抛竿时重新加载。[/*]
[*][b]mff_patches[/b]:列出共享矿井钓鱼方法上的 Harmony 补丁,用于兼容性故障排除。[/*]
[/list]
编辑 Content Patcher 内容包的文件后,使用 patch reload YourPack.UniqueID,以便 Content Patcher 重新读取它们。仅使用 mff_reload 不会重新读取 content.json。
报告漏洞时,请包含你的 SMAPI 日志、受影响的层、已安装的钓鱼内容包、鱼竿和鱼饵、预期渔获以及实际发生的情况。对于疑似冲突,还请包含 mff_pools 和 mff_patches 的输出。
[color=#ff7700][size=4][b]测试[/b][/size][/color]
四个开发测试包场景已通过测试:独立层池、时间条件、训练用鱼竿和零概率行为,以及由 Content Patcher 内容包定义的自定义鱼类。
这并不一定意味着与所有钓鱼模组兼容。声明的最低版本为 SMAPI 4.3.2,因此这应该适用于最新的 Android SMAPI。
[color=#ff7700][size=4][b]卸载[/b][/size][/color]
移除框架文件夹以及任何需要它的内容包。
如果单独的模组定义了自定义鱼类,请在卸载该模组之前遵循其移除说明。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。