在饥荒的各个玩家群里,几乎每天都有人问同一类问题:为什么我订阅了一百多个Mod,游戏反而进不去?为什么同一个Mod在朋友那里好好的,在我这儿一开就红字?为什么有的Mod必须装服务器端,有的装客户端就行?还有不少人想自己动手写个饥荒Mod,但对着网上那些零散的教程,连modinfo.lua和modmain.lua是干什么的都搞不明白。
这篇文章我打算一次把这些事讲透。内容分成两大块:一是玩家视角,怎么把Mod装对、装稳、出问题怎么排查;二是作者视角,从零手写一个能用的饥荒Mod,把加载机制、常用API、测试方法都过一遍。无论你是只想好好用Mod的玩家,还是想动手改游戏的新手作者,都能从里面找到能直接抄作业的东西。
1. 饥荒Mod到底能改变什么?先分清“装修”和“拆承重墙”
很多人对Mod的理解是“往游戏里塞东西”,这个说法对,但太笼统。想用好Mod,甚至想写Mod,第一步得知道饥荒这个游戏的逻辑层到底是怎么组织的。
1.1 Mod是游戏留给玩家的改装接口
饥荒的核心逻辑——合成、季节、饥饿值、San值、战斗、世界生成——这些绝大部分是用Lua脚本写出来的,而不是编译死在引擎里的。这意味着游戏本身就留了一个很深的改装接口:玩家写的Lua脚本可以在游戏启动时被加载进去,把原本的数值、逻辑、物品、生物,甚至整个玩法都替换掉。
举一个最直观的例子。游戏里“石篝火的燃烧时间”是一个数值,存放在TUNING表里。一个Mod只需要几行代码,就能把这个数值改大改小,或者把它改成无限。这种改动不需要碰游戏本体,只是在你启动游戏的时候,脚本被额外执行了一遍,把原来的数值覆盖掉了。
所以Mod能做的事,远不止“加几个物品”。它能改UI布局,能在地图上画格子(几何布局Mod就是这么干的),能改变怪物AI,能重新定义四季长度,能加一整套新角色和新科技树。大型Mod比如神话书说、棱镜,本质上是往饥荒里塞了一个全新的游戏内容包,靠的依然是这套Lua接口。
1.2 三类常见的饥荒Mod
按玩家实际使用场景,我习惯把Mod分成三类。这个分类对后面理解“为什么会崩”“该装哪一端”特别重要。
第一类是显示辅助类。典型代表是几何布局(Geometric Placement)、显示食物属性(Smart Minisign)、小地图(Minimap HUD)。这类Mod只改变你屏幕上的信息呈现方式,不改变游戏世界的数据,存档里也不会写入任何Mod相关的东西。它们通常做成“客户端Mod”,只对你一个人生效,别人装不装都无所谓。
第二类是功能扩展类。典型代表是快速拾取、自动堆叠、智能锅、灭火器范围扩大这类。它们会改变游戏机制本身,比如把捡东西的判定范围变大,或者让锅自动停止烹饪。这类Mod有的只需要客户端就能实现,有的必须服务器端执行,具体看它改的是“你的操作体验”还是“世界逻辑”。
第三类是内容重构类。新增角色、新增生物、新增BOSS、修改整个季节机制,这类Mod是写进存档里的。你玩一个带新物品的Mod,存档里就会记录这个物品的实例数据。一旦关闭Mod再进旧档,游戏读不到对应的Prefab,轻则物品消失,重则直接崩溃。
1.3 边界在哪:Mod改不了什么
说了这么多“能改”,也得说说“不能改”。理解这个边界,能帮你避免很多不切实际的期待,也能解释为什么有些Mod做不出来。
饥荒的游戏引擎底层(图形渲染、物理碰撞、网络同步框架)是C++写的,编译在可执行文件里。Lua脚本能访问的是引擎开放出来的一层API,够用,但不是万能的。比如你想给游戏加一个全新的渲染管线,或者修改水面反射特效,这类需求Lua基本做不了,只能靠Shader Mod这种走引擎着色器接口的Mod,而且限制也很多。
另外一个限制是网络同步。联机版里,客户端看到的画面和服务器计算的逻辑是两套东西。一个Mod如果想在服务器上生成一个全服玩家都能见到的物品,它必须作为服务器Mod运行,服务器端生成实体后,再通过网络把状态同步给所有客户端。这也就是为什么有的Mod在单人模式好好的,一进联机房间就失灵。
提示:判断一个Mod能不能做,先问自己三个问题——它改的是显示信息,还是世界数据?它需不需要所有玩家都看到同样的结果?它的运行范围在客户端还是服务器?想清楚这三点,就明白一个大半了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从加载机制说起:为什么Mod会冲突、会崩溃
装Mod久了你会发现一个规律:大部分崩溃不是Mod作者写得太烂,而是Mod之间互相踩了,或者Mod跟当前游戏版本不匹配。想搞明白这些,得先知道饥荒是怎么加载一个Mod的。
2.1 一个Mod文件夹里都有什么
打开任意一个饥荒Mod的文件夹,里面通常有这么几个东西:
- modinfo.lua:给游戏看的“Mod说明书”,包括名字、作者、版本、兼容性标记。
- modmain.lua:Mod的主逻辑文件,游戏启动时会执行这里面的代码。
- prefab文件夹:如果你这个Mod加了新物品或新生物,通常会在这里放对应的Prefab定义文件。
- images、anim、sound等文件夹:资源文件,放图标、贴图、动画、音效。
- modicon.tex / modicon.xml:Mod在游戏列表里显示的图标。
对玩家来说,看到一个Mod文件夹,至少要能确认modinfo.lua是不是在这个根目录下。经常有人手动下载Mod后,把整个文件夹又套了一层,导致游戏找不到modinfo,最后这个Mod在列表里根本不显示。
2.2 modinfo.lua:模组的身份证
modinfo.lua是每个Mod必须有的文件。它不是一个“配置说明”,而是游戏启动时第一个被读取并执行的Lua脚本。它的返回值是一个大表,里面所有字段直接决定游戏怎么对待这个Mod。
下面是一个典型的modinfo.lua,我给每一行都加了注释:
lua复制name = "Warm Amulet - 温暖护符" -- Mod在列表里显示的名字
description = "一个可以制作的保暖护符,冬天不再怕冷" -- 鼠标悬停时的说明
author = "YourName" -- 作者名
version = "1.0.0" -- 版本号,更新时一定要改
api_version = 10 -- 依赖的游戏API版本
-- 兼容性标记:这两项在联机版特别重要
dont_starve_compatible = false -- 是否兼容单机版
dst_compatible = true -- 是否兼容联机版(DST)
client_only_mod = false -- 是否仅客户端Mod
all_clients_require_mod = true -- 是否所有客户端都必须装同一个Mod
-- 图标
icon_atlas = "modicon.xml"
icon = "modicon.tex"
这里最容易踩的坑就是client_only_mod和all_clients_require_mod这两个字段。很多新手作者不清楚它们的作用,随便写了个false,结果做出来的Mod在联机房间里要么不生效,要么别人进来就掉线。具体机制我在第5章详细讲。
