Source SDK 2013 三步跑通：从零搭好你的第一个 Source 引擎 Mod
【免费下载链接】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: Deathmatch 和 Team Fortress 2 的完整源码，想写 Mod、改游戏内容或者做独立游戏，都能从这里起步。
它附带两个开箱即用的 Mod 模板，一个 HL2 死亡竞赛，一个 TF2。把代码克隆下来，跑一条构建命令，就能启动自己的 Mod。下面按顺序讲清楚环境怎么备、目录怎么看、第一处改动落在哪里。
适合谁：写 C++ 的人，或者想用具体项目进 Source 引擎生态的新手。你不需要背下整个引擎，模板已经把骨架搭好了。
🛠️ 一次到位的环境搭建
动手前先核对三件事：
- Steam 里装好 Source SDK 2013 Multiplayer，Windows 和 Linux 都要，Mod 加载的游戏内容来自它。
- Windows：Visual Studio 2022（C++ 桌面工作负载）、Windows SDK 10.0.19041.1 及以上、Python 3.13 及以上。
- Linux：只需要 podman。
核对完，三步走：
1. 拉取代码
git clone https://gitcode.com/GitHub_Trending/so/source-sdk-20132. 生成工程并构建
进入src目录。Windows 下执行createallprojects.bat，它会生成everything.sln解决方案，再到 Visual Studio 里执行 Build > Build Solution；Linux 直接执行./buildallprojects，脚本会在容器里针对 Steam Runtime 完成全部构建。
3. 启动你的 Mod
Windows 上在 VS 里把Client (Mod Name)项目设为启动项目，按 F5 即可，Release 的启动参数是出厂预填的。Linux 上进入game目录，执行./mod_tf。
📁 目录解剖：每个文件夹是干什么的
整个仓库可以压成一棵树，记住一句话：game 是你的，src 是引擎的。
source-sdk-2013/ ├── game/ # 你的 Mod 住在这里 │ ├── mod_hl2mp/ # HL2: Deathmatch 模板 │ └── mod_tf/ # Team Fortress 2 模板 └── src/ ├── game/ # 游戏逻辑 C++（client / server / shared） ├── public/ # 引擎公共接口 ├── utils/ # vbsp、vrad、vvis 等地图工具 ├── tier0/ tier1/ # 基础库 └── materialsystem/ # 着色器与材质系统逐行用白话说一遍：
- game/ — 你的 Mod 的家，两个模板现成放着，所有改动从这里开始。
- src/game/ — 游戏逻辑的 C++ 代码，
client管渲染和 HUD，server管游戏状态和 AI，shared是两端共用的部分。 - src/public/ — 引擎的公共接口头文件，相当于你的 Mod 和引擎之间的"契约"。
- src/utils/ — 地图工具集：
vbsp编译地图，vrad烘焙光照，vvis算可见性。 - src/tier0/ 和 src/tier1/ — 基础库，内存、字符串、KeyValues 这类底层能力，其他一切代码踩在它上面。
- src/materialsystem/ — 着色器与材质系统，画面效果从这来。
- src/vpc_scripts/ — 构建脚本，
createallprojects.bat就是靠它们生成工程的。
✏️ 第一次动手改：一行配置看到效果
第一个任务很小：把 Mod 的名字改掉。
- 打开 game/mod_hl2mp/gameinfo.txt。
- 找到
game这一行，把 "My First HL2MP Mod" 换成你自己起的名字。 - 重新构建，启动 Mod。启动器里显示出新名字，就算通过了。
这个文件的其他部分先别碰，尤其SearchPaths段：它决定引擎按什么顺序找纹理和声音，顺序乱了资源就加载不出来。
🩹 踩坑速查
| 症状 | 先查哪里 |
|---|---|
| 生成工程或编译报错 | VS2022 的 C++ 工作负载、Windows SDK 组件是否装全，Python 是否 ≥ 3.13；再逐条读构建日志 |
| 启动后游戏内容缺失 | Steam 里没装 Source SDK 2013 Multiplayer |
| Windows 下 Mod 起不来 | 启动项目是否选对了Client (Mod Name)，配置是否为 Release |
| 想让 Mod 上架 Steam | 按 Steam Runtime 构建是硬性要求，Linux 构建脚本已自动处理 |
| 进游戏卡顿 | 看地图的光照与可见性设置；游戏里开net_graph观察帧率和网络数据 |
🧭 进阶路线
第一个 Mod 跑起来之后，分两档走：
入门档
- 把两个模板都跑一遍，各自启动一次
- 改 skill.cfg 里的几个数值，比如爆头伤害倍率、充电器回血量，感受配置系统
- 精读 gameinfo.txt 的
SearchPaths，弄懂资源加载顺序
进阶档
- 写服务端实体，放到 src/game/server/ 下
- 改 HUD 和客户端特效，翻 src/game/client/
- 用 src/utils/ 里的
vbsp、vrad、vvis编译自己的地图
资料就找两处：Valve 开发者维基里的 Source SDK 2013 页面，以及网上别人的 Mod 源码。挑一个完整读懂，比看十篇教程视频管用。
等你的第一个 Mod 跑起来，后面就只剩下换一行代码再跑一遍的事。
【免费下载链接】source-sdk-2013The 2013 edition of the Source SDK项目地址: https://gitcode.com/GitHub_Trending/so/source-sdk-2013
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
