入门与集成模式

Steam 创意工坊入门:选择集成模式并开放访问

Steam 创意工坊为游戏社区提供发现、分享和获取用户生成内容的渠道。本页面向游戏开发者和 Mod 工具开发者,说明两种工坊模式、上线准备和基本职责,帮助你在写代码之前确定内容如何进入游戏。

创作者提交内容,经 Steam 工坊分发给玩家,最后由游戏加载的流程

创意工坊负责什么

Steam 提供内容存储、展示、搜索、订阅和分发能力,但游戏仍需认识自己的内容格式,并实现资源校验、加载及兼容性处理。通常,创作者通过游戏内编辑器或独立工具提交项目;玩家在工坊浏览并订阅,Steam 下载内容后游戏再读取本地目录。不同游戏允许制作的内容可以是地图、外观、规则或其他资源。

开始接入前,先定义可修改的范围、文件格式、目录结构和制作工具;多人游戏还需要考虑主机与其他玩家是否都具备同一份内容。提供测试目录、制作指南和明确的内容规范,有助于创作者在提交前自行检查。

即用型与鉴选型

即用型(Ready-to-use)适合希望支持较多地图、Mod 或其他内容的游戏。内容上传后可供玩家订阅,创作者也能更新项目。游戏开发者需要在前期做好加载器、编辑器和校验机制。

鉴选型(Curated,也常称精选型)更适合由开发者挑选并控制最终进入游戏的内容。社区可以浏览和评价提交,开发者再决定接受哪些作品、如何集成以及是否赋予游戏属性。若涉及受限持有或销售,还需要库存、权限及交易方面的基础设施;具体实现应以 Steam 当前规则为准。

配置与测试可见性

在 Steamworks 的应用设置中打开 Workshop → General,按测试阶段选择 Developers Only、Developers & Testers、Customers & Developers 或 Everyone,并通过 Publish 流程发布配置。公开到 Everyone 前,官方要求完成工坊清单,包括品牌素材、标题、简介及至少一个公开项目。

可先用 Steam 测试分支交付测试构建,再用 Steam 社区组限制工坊访问。在编辑者测试过上传、协议确认、订阅、下载和游戏加载的完整流程后,再逐步扩大访问范围。制作指南应让创作者知道支持什么格式、如何验证内容以及如何联系项目维护者。

上传工具与账号限制

上传工具可以放在游戏中,也可以是单独的应用。它应提交游戏能够识别的内容及预览图,并将校验错误反馈给创作者。官方说明,仅通过家庭共享或免费周末等临时许可获得应用访问权的用户不能上传该应用的工坊内容;测试人员应使用符合条件的账号。

本页依据 Steam Workshop 概览 与 实现指南 整理。具体配置名称和能力可能随 Steamworks 更新,请在实际操作前复核官方页面。

按开发任务阅读

首次接入可先读上传、订阅与加载及SDK 初始化与 C++ 示例,再按自己的工具或加载器任务查阅接口。准备发布时,使用测试、上线与维护核对整条内容链路。

开发任务 章节
制作上传器、管理项目更新 上传工作流、发布 API
制作游戏内工坊浏览器 查询 API
订阅、下载和加载内容 下载状态与查询、订阅下载 API
兼容游戏不同分支 标签与版本兼容
查结果字段、枚举和错误 回调与类型参考
接入网站或发行商后台 工坊 Web API

本 Wiki 依据 2026 年 11 月 4 日读取的官方文档整理,采用中文说明、接口索引及原创示例。文档中存在个别重复或不一致的声明,相关章节已注明;实际编译时以项目所用 SDK 头文件为准。

完整实现与逐项参考

完整实现指南、92 个函数索引、回调字段参考。