Content Patcher：不写一行代码，用 JSON 改造你的星露谷世界

Content Patcher：不写一行代码，用 JSON 改造你的星露谷世界

【免费下载链接】StardewModsMods for Stardew Valley using SMAPI.项目地址: https://gitcode.com/gh_mirrors/st/StardewMods

你大概也遇到过这种时刻：想在星露谷里换张立绘、改句对话、让农场随季节变色，结果一搜教程，满屏都是 C# 类和游戏 API，看完第一段就想放弃。Content Patcher 就是为这个痛点而生的：一个运行在 SMAPI 之上的内容包框架，你只需要维护 JSON 配置文件，就能替换贴图、编辑对话、修改游戏数据，全程不用写一行程序代码。它适合所有想给星露谷做点"自己的东西"、又没有编程基础的玩家。

先别急着学编程，你的需求可能只是个"配置问题"

把需求拆开看，大部分美化需求本质上是"把游戏的某个资源换成另一个资源"。这确实需要某种机制告诉游戏"用我的图片替换默认图片"——但这不等于你得掌握游戏引擎。难点在于，传统做法把"改内容"和"改代码"绑在了一起：你要学会面向对象、弄懂游戏加载流程、处理编译报错，最后还得在游戏更新后把失效的代码重写一遍。一个五分钟能搞定的换装需求，硬生生拖成一周的编程课。

Content Patcher 把这件事拆成了两部分：框架负责"怎么替换"这种脏活累活，你只负责提供"换成什么"。而"换成什么"就是几行 JSON——一种用冒号和花括号写出来的纯文本格式，记事本就能编辑。你只管声明"要什么"，剩下的交给框架。

三分钟做出第一个内容包：先换一张立绘

动手之前先确认环境：SMAPI 和 Content Patcher 要按各自的说明先装进游戏，这步不用我重复。之后你要做的，就是建一个文件夹，放两个文本文件进去。

第一个是manifest.json，相当于内容包的"身份证"，声明名字、作者和依赖；第二个是content.json，写明你想改什么。想给阿比盖尔换张头像，核心配置就这么几行：

{ "Format": "2.9.0", "Changes": [ { "Action": "Load", "Target": "Portraits/Abigail", "FromFile": "assets/abigail.png" } ] }

这段在做什么？它告诉 Content Patcher：把游戏里Portraits/Abigail这个资源，替换成你自己准备的assets/abigail.png。Format是内容包格式版本号，照着写即可。把图片放进assets文件夹，启动游戏，阿比盖尔就"变脸"了。

这一步为你解锁的能力是：看懂内容包的最小结构。后面所有复杂玩法，都是在这个结构上叠加。

让贴图随季节自动换装：靠的是令牌系统

只做静态替换还不够，很多人第二步想要的是"动态"。比如秋天让农场铺满落叶，春天再恢复原样。按传统思路这得写季节判断代码；而在 Content Patcher 里，你只需要在配置里引用一个令牌——可以把它理解为游戏状态的实时变量，{{Season}}会自动变成当前的季节名。

{ "Action": "EditImage", "Target": "Buildings/houses", "FromFile": "assets/{{Season}}_house.png", "When": { "Season": "spring, summer, fall, winter" } }

于是春天它去找spring_house.png，冬天找winter_house.png；When则像一道门，条件不满足时整个修改不生效。除了季节，还有{{Day}}、{{Weather}}、{{Hearts:Abigail}}等几十个令牌可用，判断逻辑再也不用你手写。这也是很多星露谷美化包体积小、切换顺滑的原因——一个包就能覆盖四季，不必为每个季节做独立版本。

价格、对话、商店库存：用 EditData 改数据

改完贴图，很多人发现真正想要的是"改数值"：让某种作物更值钱，给 NPC 加一句应景对话，或者让商店多上架一件商品。这类需求用EditData操作完成，以调整物品价格为例：

{ "Action": "EditData", "Target": "Data/Objects", "Fields": { "MossSoup": { "Price": 80 } } }

意思很直白：找到Data/Objects这张数据表，只把MossSoup这一行的Price改成 80，其余一概不动。同样的手法也能改对话、改配方要求、改作物生长天数。数据驱动的好处是：游戏更新后只要数据格式没变，你的配置一般还能继续用，不用推倒重写。

多个 MOD 抢同一个资源时，用优先级排队

内容包装多了，你会碰到新问题：两个 MOD 都想改同一张贴图，到底听谁的？Content Patcher 提供了Priority字段控制加载顺序，数字大的后加载、优先生效；再配合HasMod这类条件令牌，还能实现"只有当另一个 MOD 存在时才启用我的修改"。这让不同作者的内容可以按规则协作，而不是互相覆盖。你的内容包还可以附带可视化配置界面，玩家不用碰 JSON 也能在游戏内调参数：

读完这篇，你现在能解决的三件事

第一，你搞清了"这是什么"：星露谷物语内容包制作靠 JSON 配置而非编程，一个内容包就是manifest.json加content.json加一个assets文件夹。第二，你知道"为什么用它"：替换贴图、动态换装、改数据、多 MOD 协作，每类需求对应一种操作，改动即时可见、坏了大不了删掉重来。第三，你有一条可执行的上手路径：装好 SMAPI 和 Content Patcher，按上面的最小示例做一个能跑的换装内容包，再试着加上When条件，让它只在某个季节生效。

下一步，去读仓库里这份完整的创作指南 ContentPatcher/docs/author-guide.md，令牌的完整清单在 ContentPatcher/docs/author-tokens-guide.md，其中也包含中文版本。挑一个你最想改的游戏资源，从最小示例开始动手——这才是内容包最友好的地方。

【免费下载链接】StardewModsMods for Stardew Valley using SMAPI.项目地址: https://gitcode.com/gh_mirrors/st/StardewMods