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
};
工程语义:
VACBanned是「该游戏」的 VAC 封禁,不是账号级全局封禁。枚举注释写的是 “VAC banned for this game”——同一个账号在别的游戏里可能完全干净。接入工程不能把它当全局身份标签用。VACCheckTimedOut与VACBanned是两种不同的处理:前者是「没查出结果」,后者是「查出被封」。对买断制游戏,超时通常按「暂缓通过 + 重试」处理,而不是直接踢。PublisherIssuedBan提醒你存在「非 VAC 的封禁」:它来自 Web API 的发行商封禁,和 VAC 是两条独立体系。接入工程若要支持自己封禁,应把它与 VAC 状态分开记录、分开展示。
客户端查询:ISteamApps::BIsVACBanned
玩家本机侧还有一个更简单的读取点——游戏启动时直接问「我是不是被 VAC 封了」:
// isteamapps.h:ISteamApps::BIsVACBanned(SDK v1.65 头文件摘录,已删减)
virtual bool BIsVACBanned() = 0;
工程语义:
- 它是「当前 App」的封禁布尔:语义上对应当前运行 AppID 的 VAC 状态,不是跨游戏查询。要在 UI 里展示「反作弊状态」用它即可。
- 它与服务器侧的
EAuthSessionResponse::VACBanned是两个视角:客户端侧适合启动时展示/提示,服务器侧适合准入判定。工程上不要把两个口径混在一个状态机里。 - 布尔没有超时分支:若需要区分「未封」与「未知」,应以服务器侧票据验证结果为准。
服务器 secure 广播:GSPolicyResponse_t
服务器是否「安全」最终要广播给客户端。v1.65 的回调结构极简:
// isteamgameserver.h:GSPolicyResponse_t(SDK v1.65 头文件摘录,已删减)
struct GSPolicyResponse_t
{
enum { k_iCallback = k_iSteamUserCallbacks + 15 };
uint8 m_bSecure;
};
工程语义:
m_bSecure即服务器是否以 secure(VAC 保护)身份运行:它对应上一节的eServerModeAuthenticationAndSecure,是玩家侧判断「这服务器开没开反作弊」的依据。- secure 标记只对连接后的玩家有意义:客户端把
BSecure()作为InitiateGameConnection时代的 bSecure 传入(旧接口)或结合验证结果展示。 - 封禁与 secure 的耦合:只有 secure 服务器才跑 VAC,封禁判定才有意义;非 secure 服务器不应假装拥有反作弊背书——这是诚实性边界,也是合规边界。
接口签名对照
| 头文件 | 条目 | 语义 |
|---|---|---|
steamclientpublic.h | EAuthSessionResponse | 验证玩家后的响应枚举(VACBanned/VACCheckTimedOut/PublisherIssuedBan) |
isteamapps.h | ISteamApps::BIsVACBanned() | 客户端侧当前 App 的 VAC 封禁布尔 |
isteamgameserver.h | GSPolicyResponse_t | 服务器 secure 标记广播(m_bSecure) |
isteamgameserver.h | ISteamGameServer::BSecure() | 服务器运行态 secure 门控 |
数据口径与来源
EAuthSessionResponse各分支值、BIsVACBanned、GSPolicyResponse_t字段:SDK v1.65public/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 服务器架构与商业化 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。