Behavior-preserving; full solution builds, 1013 tests green. ClassId is the one genuinely-closed set of the three flagged stringly fields, so it becomes a CardClass enum (1..8). Wire stays "1".."8": producer casts (CardClass)run.ClassId, ServerBattleFrames renders via CardClassWire.ToWireValue(). RankBattleController's AI-start path drops a fragile int.TryParse(...)?:-1 for (int)cast. CharaId (free-form leader/skin id, e.g. "5000123") and CountryCode (open-ended account data) stay string with proper XML docs; CountryCodes.Korea/Japan name the captured values. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
46 lines
2.1 KiB
C#
46 lines
2.1 KiB
C#
namespace SVSim.BattleNode.Bridge;
|
|
|
|
/// <summary>
|
|
/// Per-battle player snapshot captured at do_matching time and replayed into the
|
|
/// server-authored frame lifecycle on WS connect. SVSim.BattleNode does not know how to build this — the HTTP-side
|
|
/// per-mode controller is the source. Snapshot semantics: cosmetic changes between matching
|
|
/// and WS connect have no effect on the in-battle render.
|
|
/// </summary>
|
|
public sealed record MatchContext(
|
|
// Player's drafted deck — exactly 30 entries, idx 1..30 paired with the chosen cardIds
|
|
// in the order this list provides them. Producer is responsible for the count.
|
|
IReadOnlyList<long> SelfDeckCardIds,
|
|
|
|
// Player class + leader (BattleStartSelfInfo)
|
|
|
|
/// <summary>The player's class. Rendered onto the wire <c>classId</c> as <c>"1".."8"</c> via
|
|
/// <see cref="CardClassWire.ToWireValue"/>; a closed set, so it's typed, not stringly.</summary>
|
|
CardClass ClassId,
|
|
|
|
/// <summary>Leader/skin id on the wire <c>charaId</c>. FREE-FORM, not a class enum: it's the
|
|
/// equipped leader-skin id (e.g. <c>"5000123"</c>) when one is chosen, else the class ordinal
|
|
/// (<c>"1".."8"</c>). Passed through verbatim — the node never interprets it.</summary>
|
|
string CharaId,
|
|
|
|
string CardMasterName, // current card-master, e.g. "card_master_node_10015"
|
|
|
|
// Player cosmetics (MatchedSelfInfo)
|
|
|
|
/// <summary>Account region code, wire <c>country_code</c>. OPEN-ENDED account data (any value,
|
|
/// possibly empty); the node never branches on it. <see cref="CountryCodes"/> names the values
|
|
/// seen in captures.</summary>
|
|
string CountryCode,
|
|
|
|
string UserName,
|
|
string SleeveId,
|
|
string EmblemId,
|
|
string DegreeId,
|
|
int FieldId,
|
|
int IsOfficial, // 0 or 1
|
|
|
|
// Battle-mode hint (the prod do_matching mode id). Named BattleModeId, NOT BattleType, to
|
|
// avoid colliding with the <see cref="Sessions.BattleType"/> enum (Pvp/Bot) — a different axis.
|
|
// Known values live in <see cref="BattleModes"/> (currently just TK2 == 11). Future modes add
|
|
// their own constant.
|
|
int BattleModeId);
|