《Steam 游戏平台:开发与商业化》9.2 VAC 与封禁机制

VAC 的状态从哪来:EAuthSessionResponse 的 VACBanned 分支、ISteamApps::BIsVACBanned 客户端查询、GSPolicyResponse_t 的 secure 标记。本节讲封禁在接入工程中的可观测点与边界(按游戏隔离、与自研封禁分工),lab 用 C++ mock 验证封禁判定与 secure 标记。

9.2 VAC 与封禁机制

上一节认识了服务器安全模式,这一节处理接入工程最容易被误解的一个接口域:VAC 与封禁状态。开发者容易把「VAC」当成一个能主动查询的全局封禁位,实际上 SDK 里 VAC 的状态分散在三个可观测点:验证玩家时的 EAuthSessionResponse::VACBanned、客户端侧的 ISteamApps::BIsVACBanned()、以及服务器向玩家广播的 GSPolicyResponse_t。本节讲清楚这三个点的口径与边界。

本卷所有接口口径以 Steamworks SDK v1.65(2026-07-23) 为准。本节摘录的签名对照该版本 public/steam/steamclientpublic.h、isteamapps.h、isteamgameserver.h。

本章与站内既有内容的分工

  • Steam 发行专题 (操作手册)讲「后台申请 VAC、设置反作弊规则」;本节讲「封禁状态在 SDK 里怎么被读到、哪些分支必须处理」。
  • 卷一《平台机制与商店》讲账号与社区机制;本节把封禁机制落成接入工程的状态判定。
  • lab 用纯 C++ 复现封禁判定与 secure 标记,不依赖 Steam 客户端运行。

封禁从哪来:EAuthSessionResponse 分支

多人在线里,服务器验证玩家票据后收到的 ValidateAuthTicketResponse_t 回调携带 EAuthSessionResponse。v1.65 的枚举把失败原因分类得极细,其中与封禁直接相关的有三条:

// steamclientpublic.h:EAuthSessionResponse(SDK v1.65 头文件摘录,已删减)
enum EAuthSessionResponse
{
	k_EAuthSessionResponseOK = 0,							// Steam has verified the user is online, the ticket is valid and ticket has not been reused.
	k_EAuthSessionResponseUserNotConnectedToSteam = 1,		// The user in question is not connected to steam
	k_EAuthSessionResponseNoLicenseOrExpired = 2,			// The license has expired.
	k_EAuthSessionResponseVACBanned = 3,					// The user is VAC banned for this game.
	k_EAuthSessionResponseVACCheckTimedOut = 5,				// VAC has been unable to perform anti-cheat checks on this user
	k_EAuthSessionResponsePublisherIssuedBan = 9,			// The user is banned for this game. The ban came via the web api and not VAC
};

工程语义:

  1. VACBanned 是「该游戏」的 VAC 封禁,不是账号级全局封禁。枚举注释写的是 “VAC banned for this game”——同一个账号在别的游戏里可能完全干净。接入工程不能把它当全局身份标签用。
  2. VACCheckTimedOut 与 VACBanned 是两种不同的处理:前者是「没查出结果」,后者是「查出被封」。对买断制游戏,超时通常按「暂缓通过 + 重试」处理,而不是直接踢。
  3. PublisherIssuedBan 提醒你存在「非 VAC 的封禁」:它来自 Web API 的发行商封禁,和 VAC 是两条独立体系。接入工程若要支持自己封禁,应把它与 VAC 状态分开记录、分开展示。

客户端查询:ISteamApps::BIsVACBanned

玩家本机侧还有一个更简单的读取点——游戏启动时直接问「我是不是被 VAC 封了」:

// isteamapps.h:ISteamApps::BIsVACBanned(SDK v1.65 头文件摘录,已删减)
virtual bool BIsVACBanned() = 0;

工程语义:

  1. 它是「当前 App」的封禁布尔:语义上对应当前运行 AppID 的 VAC 状态,不是跨游戏查询。要在 UI 里展示「反作弊状态」用它即可。
  2. 它与服务器侧的 EAuthSessionResponse::VACBanned 是两个视角:客户端侧适合启动时展示/提示,服务器侧适合准入判定。工程上不要把两个口径混在一个状态机里。
  3. 布尔没有超时分支:若需要区分「未封」与「未知」,应以服务器侧票据验证结果为准。

服务器 secure 广播:GSPolicyResponse_t

服务器是否「安全」最终要广播给客户端。v1.65 的回调结构极简:

// isteamgameserver.h:GSPolicyResponse_t(SDK v1.65 头文件摘录,已删减)
struct GSPolicyResponse_t
{
	enum { k_iCallback = k_iSteamUserCallbacks + 15 };
	uint8 m_bSecure;
};

工程语义:

  1. m_bSecure 即服务器是否以 secure(VAC 保护)身份运行:它对应上一节的 eServerModeAuthenticationAndSecure,是玩家侧判断「这服务器开没开反作弊」的依据。
  2. secure 标记只对连接后的玩家有意义:客户端把 BSecure() 作为 InitiateGameConnection 时代的 bSecure 传入(旧接口)或结合验证结果展示。
  3. 封禁与 secure 的耦合:只有 secure 服务器才跑 VAC,封禁判定才有意义;非 secure 服务器不应假装拥有反作弊背书——这是诚实性边界,也是合规边界。

接口签名对照

头文件条目语义
steamclientpublic.hEAuthSessionResponse验证玩家后的响应枚举(VACBanned/VACCheckTimedOut/PublisherIssuedBan)
isteamapps.hISteamApps::BIsVACBanned()客户端侧当前 App 的 VAC 封禁布尔
isteamgameserver.hGSPolicyResponse_t服务器 secure 标记广播(m_bSecure)
isteamgameserver.hISteamGameServer::BSecure()服务器运行态 secure 门控

数据口径与来源

  • EAuthSessionResponse 各分支值、BIsVACBanned、GSPolicyResponse_t 字段:SDK v1.65 public/steam/steamclientpublic.h、isteamapps.h、isteamgameserver.h 可实证(本机镜像已核对)。
  • 「封禁按游戏生效」「VAC 超时语义」:头文件注释明文。
  • VAC 封禁的具体时长、VAC 检查的触发时机:partner 文档登录后可见,以官方当前为准;本卷不给假设数值。

以上接口口径撰写时对照 Steamworks SDK v1.65 头文件与 partner.steamgames.com 官方文档核对;登录后可见数据以官方当前为准。

可运行产物:C++ 最小验证

下面的仿真复现「VAC 与封禁机制」的工程语义:EAuthSessionResponse 各分支判定、封禁按游戏隔离、非 secure 服务器不判封禁、GSPolicyResponse 的 secure 标记。它与 src/09-2-vac-bans.cpp 逐字节一致,mock 接口签名对照 SDK v1.65 头文件:

// file: src/09-2-vac-bans.cpp
// tier: L1
// verify: clang++ -std=c++20 -Wall -I. src/09-2-vac-bans.cpp -o bin/09-2-vac-bans && ./bin/09-2-vac-bans
//
// mock:复现 VAC 与封禁机制——EAuthSessionResponse 的各分支(VACBanned、
// VACCheckTimedOut、PublisherIssuedBan)、BSecure 服务器是否启用 VAC、
// 封禁按游戏隔离、以及 GSPolicyResponse 的 secure 标记。
// 签名对照 SDK v1.65 steamclientpublic.h / isteamgameserver.h,非 Valve 实现。
#include "verify.h"

#include <cstdint>
#include <unordered_map>

namespace steam_repro {

// EAuthSessionResponse 枚举值对照 steamclientpublic.h
enum MockAuthResponse {
  kOK = 0,
  kUserNotConnectedToSteam = 1,
  kNoLicenseOrExpired = 2,
  kVACBanned = 3,
  kLoggedInElseWhere = 4,
  kVACCheckTimedOut = 5,
  kAuthTicketCanceled = 6,
  kAuthTicketInvalidAlreadyUsed = 7,
  kAuthTicketInvalid = 8,
  kPublisherIssuedBan = 9,
  kAuthTicketNetworkIdentityFailure = 10,
};

// GSPolicyResponse_t 语义:游戏服务器向用户呈现的 secure 标记
struct MockGSPolicyResponse {
  enum { kCallback = 100 + 15 };  // k_iSteamUserCallbacks + 15
  uint8_t m_bSecure;
};

class MockVACEnforcer {
 public:
  struct UserRecord {
    bool connected = true;
    bool vacBannedGameA = false;
    bool vacBannedGameB = false;
    bool publisherBanned = false;
    bool checkTimedOut = false;
  };

  // 按游戏维护封禁:封禁是 per-game(VAC 按 appid 生效)
  std::unordered_map<uint64_t, UserRecord> users_;

  // ISteamUser::BeginAuthSession 前置校验通过后,异步结果走
  // ValidateAuthTicketResponse_t 的 EAuthSessionResponse。这里直接返回该枚举。
  int validate(uint64_t steamId, uint32_t gameAppId, bool serverSecure) {
    auto it = users_.find(steamId);
    if (it == users_.end()) return kAuthTicketInvalid;
    UserRecord& u = it->second;
    if (!u.connected) return kUserNotConnectedToSteam;
    if (!serverSecure) return kOK;  // 非 secure 服务器不跑 VAC,不判封禁
    if (u.publisherBanned) return kPublisherIssuedBan;
    if (gameAppId == 1 && u.vacBannedGameA) return kVACBanned;
    if (gameAppId == 2 && u.vacBannedGameB) return kVACBanned;
    if (u.checkTimedOut) return kVACCheckTimedOut;
    return kOK;
  }

  // ISteamApps::BIsVACBanned:客户端侧查询当前用户是否 VAC 封禁
  bool isVACBanned(uint64_t steamId, uint32_t gameAppId) const {
    auto it = users_.find(steamId);
    if (it == users_.end()) return false;
    const UserRecord& u = it->second;
    if (gameAppId == 1) return u.vacBannedGameA;
    if (gameAppId == 2) return u.vacBannedGameB;
    return false;
  }

  // GSPolicyResponse:secure 服务器置位
  MockGSPolicyResponse policyResponse(bool secure) {
    return MockGSPolicyResponse{secure ? uint8_t(1) : uint8_t(0)};
  }
};

}  // namespace steam_repro

int main() {
  using namespace steam_repro;

  MockVACEnforcer vac;
  const uint64_t bannedUser = 76561197960287931ull;
  const uint64_t cleanUser = 76561197960287932ull;
  const uint32_t gameA = 1;
  const uint32_t gameB = 2;

  // 1. 初始:无记录 → 无效票
  CHECK(vac.validate(cleanUser, gameA, true) == kAuthTicketInvalid);

  // 2. 干净用户在 secure 服务器验证通过
  vac.users_[cleanUser] = MockVACEnforcer::UserRecord{};
  CHECK(vac.validate(cleanUser, gameA, true) == kOK);

  // 3. 用户在 gameA 有 VAC 封禁 → VACBanned
  vac.users_[bannedUser] = MockVACEnforcer::UserRecord{};
  vac.users_[bannedUser].vacBannedGameA = true;
  CHECK(vac.validate(bannedUser, gameA, true) == kVACBanned);

  // 4. 封禁按游戏隔离:gameA 封禁不影响 gameB
  CHECK(vac.validate(bannedUser, gameB, true) == kOK);
  CHECK(vac.isVACBanned(bannedUser, gameA));
  CHECK(!vac.isVACBanned(bannedUser, gameB));

  // 5. 非 secure 服务器不跑 VAC → 即使封禁也判 OK(是否连本由其他机制决定)
  CHECK(vac.validate(bannedUser, gameA, false) == kOK);

  // 6. VAC 检查超时
  vac.users_[bannedUser].checkTimedOut = true;
  CHECK(vac.validate(bannedUser, gameB, true) == kVACCheckTimedOut);
  vac.users_[bannedUser].checkTimedOut = false;

  // 7. PublisherIssuedBan 来自 Web API,非 VAC
  vac.users_[bannedUser].publisherBanned = true;
  CHECK(vac.validate(bannedUser, gameB, true) == kPublisherIssuedBan);

  // 8. 离线用户 → UserNotConnectedToSteam
  vac.users_[cleanUser].connected = false;
  CHECK(vac.validate(cleanUser, gameA, true) == kUserNotConnectedToSteam);

  // 9. GSPolicyResponse:secure 服务器 m_bSecure=1
  CHECK(vac.policyResponse(true).m_bSecure == 1);

  // 10. GSPolicyResponse:非 secure 服务器 m_bSecure=0
  CHECK(vac.policyResponse(false).m_bSecure == 0);

  return lab::report("09-2 VAC 与封禁机制");
}

本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译通过(零警告),断言 12/12 通过。

小结

  • VAC 状态有三个可观测点:验证回调的 EAuthSessionResponse、客户端 BIsVACBanned、服务器 GSPolicyResponse_t 的 secure 标记。
  • 封禁按游戏生效:VACBanned 是「该游戏」的封禁,接入工程不要把账号级与游戏级混为一谈。
  • VACCheckTimedOut 与 PublisherIssuedBan 是两条独立分支,需分开处理。
  • secure 服务器才跑 VAC,封禁判定才有意义;非 secure 服务器不应宣称反作弊背书。

阅读导航:上一节:9.1 游戏服务器机制 · 下一节:9.3 服务器架构与商业化 。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图