Source SDK 2013 完整指南：从编译环境到跑通第一个游戏模组-开发者社区

Source SDK 2013 完整指南：从编译环境到跑通第一个游戏模组

【免费下载链接】source-sdk-2013The 2013 edition of the Source SDK项目地址: https://gitcode.com/GitHub_Trending/so/source-sdk-2013

Source SDK 2013 是 Valve 官方放出的 Source 引擎开发工具包，仓库里带有 Half-Life 2、HL2:DM 和 Team Fortress 2 三份游戏逻辑源码，外加一整套引擎接口、构建脚本和地图编译工具。所谓"游戏模组"（mod），就是用这套代码编译出可替换引擎 DLL 的独立项目，让你改玩法、加武器、调数值。本文带你走完一条最小路径：准备环境、编译整个工程、看懂目录分工，然后启动你的第一个模组。

Source SDK 2013 是什么

你可以把它理解为"能编译出你自己的 Source 引擎游戏"的完整代码库。编译产物按游戏分成 Client（客户端）和 Server（服务端）两类项目，再配合game/目录下现成的资源模板，就构成一个可运行的模组工程。

它和你从 Steam 装到本地的 Source SDK 2013 Multiplayer 是配套关系：Steam 侧提供引擎运行时和公共游戏内容，这个仓库提供全部可修改的源码。

在本地编译 SDK 前需要准备什么

先把依赖核对一遍，两个平台的差异只在工具链：

Windows：Visual Studio 2022（装 C++ 桌面开发工作负载，含 MSVC v143 与 Windows 10/11 SDK）、Python 3.13 及以上、Steam 已安装 Source SDK 2013 Multiplayer。
Linux：podman 容器运行时、Steam 已安装 Source SDK 2013 Multiplayer、常规 gcc/make 工具链。

确认无误后，打开终端克隆仓库：

git clone https://gitcode.com/GitHub_Trending/so/source-sdk-2013

后续所有命令都在仓库的src/目录下执行。

src 目录布局与 game 模板分工

源码全部在src/下，几个关键位置的分工如下：

src/game/：游戏逻辑主目录，按client/、server/、shared/三层划分。客户端负责渲染、HUD 和输入；服务端负责游戏状态、物理和 AI；shared 放两边都要执行的数据结构与网络协议，改它时注意两端同步。
src/public/：引擎对外接口的头文件集合，你的模组通过这层接口与 Source 引擎交互，绝大多数模组开发不需要碰引擎内部实现。
src/utils/：地图编译工具链源码，vbsp 编译地图几何、vrad 烘焙光照、vvis 计算可见性。
src/vpc_scripts/：vpc 构建系统脚本，createallprojects.bat和buildallprojects最终都是调用它们。

src/外面还有 game/ 目录，放了mod_hl2mp（HL2:DM 风格）和mod_tf（TF2 风格）两个现成模板。新模组不需要从零写资源，直接复用其中一个即可。

gameinfo.txt：一个模组的身份与资源路径

每个模板的核心身份文件是 game/mod_hl2mp/gameinfo.txt。它声明三件事：模组在游戏菜单里的显示名称与标题、游戏类型（如多人专用），以及引擎启动时的资源搜索路径列表。

几个实用要点：

想让模组换名字，只改 gameinfo.txt 里game字段的值，其余不动。
搜索路径按挂载顺序生效，VPK 包排在松散文件夹之前以减少文件查找开销；你的自定义文件放在 mod 的custom子目录里，引擎启动时会按字母序挂载。
素材按目录分类存放：脚本与配置在scripts/，编译后的地图在maps/，材质在materials/，音效在sound/。新增一把武器时，在scripts/放对应的武器定义，模型与贴图放进相应资源目录。
正式分发时建议把资源打成 VPK 包，这是模板注释里推荐的打包方式。

Windows 和 Linux 下完成编译

Windows：在src/目录运行createallprojects.bat。它调用 vpc 生成everything.sln解决方案，之后在 Visual Studio 里"生成 → 生成解决方案"。编译完成后，把Client (Mod Name)项目设为启动项目再运行，Release 配置的启动参数已经预置好。

Linux：运行 buildallprojects。脚本会把编译放进 podman 容器，基于 Steam Runtime 构建全部工程，并顺带导出compile_commands.json方便代码索引。注意：凡是要走 Steam 分发的模组，必须基于 Steam Runtime 构建，该脚本已自动处理。编译完成后，在仓库根目录执行对应模组的构建启动器（例如./mod_tf）即可启动游戏。

编译失败和运行异常怎么排查

Windows 编译失败：先确认 Visual Studio 的 C++ 桌面开发组件装全（MSVC v143、对应版本 Windows SDK），再用python --version核对版本是否达到 3.13，错误细节看构建日志末尾。
Linux 编译失败：确认 podman 可用、容器镜像拉取成功，再复跑./buildallprojects，日志会停在第一个错误处。
启动后资源缺失或行为异常：对照 gameinfo.txt 的搜索路径检查 VPK 与文件夹是否正确挂载，进入游戏后在控制台执行path命令，能看到引擎实际解析到的路径列表。