Ananta-ps/pkg/protocol/models/world_entry_state.go

package models

import (
	"context"
	"encoding/json"
	"sync"
)

var _ = json.RawMessage{}
var _ = sync.Mutex{}
var _ = context.Background

type WorldEntryState struct {
	SyncRoot any `json:"syncRoot"`
// 
// 静态 NPC 生成的串行门。逐字对齐捐赠端 WorldEntryState.cs:13
// （internal SemaphoreSlim StaticNpcSpawnGate { get; } = new(1, 1);）。
// ⛑ 2026-10-02 补：主线移植 GameRouter.Npc.cs → GameRouter.DonorNpc.cs 时
// 漏了这道门。一个 NPC 的诞生是**一串有序包**（`SyncAetherAIStaticNpcAddData` →
// `SyncManagedLogicAgent` → `SyncBattleAiS=false` → POI → 归属物 → 警察登记），
// 两批并发会把这串包交错发出，客户端拿到的实体就是半初始化的 ——
// 表现是「NPC 看得到，但原生盘查菜单弹不出来」，且服务端日志一切正常。
// 
	StaticNpcSpawnGate *sync.Mutex `json:"staticNpcSpawnGate"`
// 
// Static-NPC entity id -> pending plot event id (0 = nothing pending). The donor build seeds
// every spawned citizen here; GameRouter.Plot uses it to match a server-driven plot step to
// the pedestrian that should perform it.
// 
	StaticNpcPreparedPlotEvents map[uint64]uint32 `json:"staticNpcPreparedPlotEvents"`
// 
// Static-NPC entity id -> last position/facing the server believes it is at.
// The citizen channel normally hands movement to the client's Aether crowd, so nothing on the
// server ever needed a position. Server-driven walking does: it has to interpolate from where
// the citizen stands, and after one walk that place is no longer the spawn point. Seeded at
// spawn, updated after every walk.
// 
	StaticNpcPoses map[uint64]StaticNpcPose `json:"staticNpcPoses"`
// 
// Dropped-weapon destructible id -> what was dropped.
// Dropping a weapon makes the client call AskSkillDestructibleCreate and wait for the new
// destructible's id; every later step (the long-press-Q psychokinesis absorb, the pick-up
// prompt) is addressed by that id. It used to be answered with a hard 0, so the client spent
// the whole drop/absord cycle talking to an entity that does not exist — hence the slide loop,
// the sticky Q prompt and the weapon falling straight back out of the hand.
// See GameRouter.WeaponDrop.cs.
// 
	WeaponDrops map[uint64]WeaponDropRecord `json:"weaponDrops"`
// 
// Next destructible id handed out for a dropped weapon. Deliberately far away from the player
// unit id (1e11) and weapon instance ids (~2e5) so nothing collides.
// 
	NextWeaponDropId uint64 `json:"nextWeaponDropId"`
// 
// Interactive props (Gadget) the admin panel spawned with SyncGadgetAdd, keyed by the instance
// id the client was told to use. Kept so the panel can remove them again and so a re-publish
// after a scene change reuses the same ids instead of leaving orphans behind.
// 
	SpawnedGadgets map[uint64]SpawnedGadgetRecord `json:"spawnedGadgets"`
// 
// Next Gadget instance id. Separate band from the weapon drop ids so the two never collide.
// 
	NextSpawnedGadgetId uint64 `json:"nextSpawnedGadgetId"`
// 
// Activation state of scene-authored DynamicGo props, as reported by the client through
// AskActiveDynamicGo. Their ids only exist inside the client's scene resources, so this map is
// built purely from what the client tells us — it can never be enumerated up front.
// 
	DynamicGoActive map[int32]bool `json:"dynamicGoActive"`
	InitialStateSent bool `json:"initialStateSent"`
	EnterSceneSent bool `json:"enterSceneSent"`
	SceneLoadAckSeen bool `json:"sceneLoadAckSeen"`
	GameResourcesReadySeen bool `json:"gameResourcesReadySeen"`
	ControlPublished bool `json:"controlPublished"`
	SceneCompletionSent bool `json:"sceneCompletionSent"`
	CurrentSpiritStateSent bool `json:"currentSpiritStateSent"`
	Ready bool `json:"ready"`
	LivePlayerProfilePublished bool `json:"livePlayerProfilePublished"`
	SameSceneAckSeen bool `json:"sameSceneAckSeen"`
	MovementCapabilityPublished bool `json:"movementCapabilityPublished"`
	FreeRoamReleased bool `json:"freeRoamReleased"`
	FirstMovementSeen bool `json:"firstMovementSeen"`
	InitialCapabilityBuffsPublished bool `json:"initialCapabilityBuffsPublished"`
	AllBuildBuffsPublished bool `json:"allBuildBuffsPublished"`
	InitialActorPresentationPublished bool `json:"initialActorPresentationPublished"`
	CombatProfilePublished bool `json:"combatProfilePublished"`
	AccountArmoryPublished bool `json:"accountArmoryPublished"`
// One-shot guard for the unlockAll full-catalog SyncArmoryAddWeapon replay
// (reset per scene load so the freshly-built client store receives the whole armory again).
	AccountArmoryAllWeaponsSent bool `json:"accountArmoryAllWeaponsSent"`
// One-shot guard for the SyncSceneFogMapAllUnlock replay. Reset on every scene load
// (see AllBuildBuffsPublished) because the client rebuilds MapFogDataMgr per scene.
	MapFogUnlockPublished bool `json:"mapFogUnlockPublished"`
// One-shot guard for the SyncPlayerAllTask replay (reset per scene load, same as fog).
	PlayerTasksPublished bool `json:"playerTasksPublished"`
// 
// 客户端 SyncChangeIndoor 上报的 indoorConfigId —— 室内判定的权威值。
// 0 = 客户端认为自己不在任何室内。见 GameRouter.IndoorSector.cs 的
// PreferClientReport：几何最近邻在 MiniMapPos 矩形重叠的场馆（ACD 76/129）会抖。
// 
	ClientIndoorConfigId uint32 `json:"clientIndoorConfigId"`
// 
// 上一次收到 SyncChangeIndoor 的 Environment.TickCount64。
// 0 = 从没收到过。用于判断上报值是否还新鲜（ClientReportGraceMs）。
// 
	ClientIndoorReportMs int64 `json:"clientIndoorReportMs"`
// Current public-world destination. Initial values come from private-server.json; airport
// travel updates these per scene generation without mutating global configuration.
	ActiveRaidId uint32 `json:"activeRaidId"`
	ActiveInstanceId uint64 `json:"activeInstanceId"`
	ActiveUniverseId uint32 `json:"activeUniverseId"`
	ActiveContentScene string `json:"activeContentScene"`
	WorldEntryIsAirportTravel bool `json:"worldEntryIsAirportTravel"`
// Native LoadingManager common-teleport transaction. Airport travel reuses the retail
// AskTeleport -> SyncPreTeleportOption -> ReportPreTeleportFinish -> domain RPC ->
// SyncTeleport -> ReportPostTeleportFinish sequence so SwitchTeleportManager cannot retain
// a stale AcrossRaid flow after landing.
	PendingTeleportId uint64 `json:"pendingTeleportId"`
	PendingAirportRouteKey string `json:"pendingAirportRouteKey"`
	PendingTeleportPreFinished bool `json:"pendingTeleportPreFinished"`
	PendingTeleportSyncSent bool `json:"pendingTeleportSyncSent"`
// 改装店（ApplyCar）离场时间戳：客户端自己的触发区会在离场落地后 0.3s 再补一发
// config=8 的 AskTeleport（ garage_in02 ），照着 echo 会把人/车重新拽回店里无限循环。
// 4s 内压掉 enter 侧的 echo（真要再进一次，开车压触发区的时间远不止 4s）。见硬规则 166。
	LastShopExitTicks int64 `json:"lastShopExitTicks"`
// Build 4229938: one generation-bound initial-player handoff.
// 0 = edge not claimed; -generation = claimed/in-flight; +generation = published.
	WorldEntryControlPending bool `json:"worldEntryControlPending"`
	WorldEntryControlFinalized bool `json:"worldEntryControlFinalized"`
	WorldEntryControlUnit uint64 `json:"worldEntryControlUnit"`
	WorldEntryControlTemplate uint32 `json:"worldEntryControlTemplate"`
	WorldEntryControlGeneration int32 `json:"worldEntryControlGeneration"`
	WorldEntryLoadingCompletedGeneration int32 `json:"worldEntryLoadingCompletedGeneration"`
	WorldEntryOpeningEndedGeneration int32 `json:"worldEntryOpeningEndedGeneration"`
	WorldEntryControlFinalizingGeneration int32 `json:"worldEntryControlFinalizingGeneration"`
	WorldEntryLogicProjectionPublishedGeneration int32 `json:"worldEntryLogicProjectionPublishedGeneration"`
	WorldEntryCurrentMetadataPublishedGeneration int32 `json:"worldEntryCurrentMetadataPublishedGeneration"`
	WorldEntrySceneId4229938 uint64 `json:"worldEntrySceneId4229938"`
	WorldEntrySessionId4229938 uint64 `json:"worldEntrySessionId4229938"`
// 
// 本次 world-entry 事务「应该等的 scene id」= SwitchSceneAsync 收到的 instanceId。
// ★ R101（自 donor v2.1 移植，2026-09-27 定案）—— 这是「所有摊位/摆件一起消失」的根因：
// admin 面板（或任何客户端侧）在**新场景还没加载完**时就发起切换时，时序是
// 1. SwitchSceneAsync 把 WorldEntrySceneId4229938 清 0；
// 2. **上一张图**的 AskLoadSceneCompleted 迟到抵达 ⇒ 命中「== 0」分支
// ⇒ 把权威位占成**旧 scene**；
// 3. 新图的 AskLoadSceneCompleted 随后抵达 ⇒ correlation-mismatch ⇒ 永久拒绝；
// AskLoadingFinished 同样被拒 ⇒ WorldEntryControlFinalized 永远 false
// ⇒ world-ready 钩子 EnsureGadgetGrid 从不执行 ⇒
// GADGET-GRID / SCENE-ITEM-GRID 循环不启动
// ⇒ 摊位 / 健身房器材 / 补货 / 派对家具 **全部不摆**。
// 有它之后，OnLoadSceneCompleted 能把「迟到的旧 ack」识别出来直接丢弃：
// 不占权威位、不报 mismatch。正常路径（ack 与 expected 一致）完全不变。
// 0 = 不校验（首次进世界 / 旧调用方未设置）。
// 
	WorldEntryExpectedSceneId uint64 `json:"worldEntryExpectedSceneId"`
	WorldEntryCreateHeroPosition Vec3 `json:"worldEntryCreateHeroPosition"`
	WorldEntryCreateHeroFacing float32 `json:"worldEntryCreateHeroFacing"`
	LastReportedPlayerPosition Vec3 `json:"lastReportedPlayerPosition"`
	LastReportedPlayerRotation Vec3 `json:"lastReportedPlayerRotation"`
	HasLastReportedPlayerTransform bool `json:"hasLastReportedPlayerTransform"`
// AetherCity 人群流式：上次下发 SyncCrowdSpecifiedDensityRefresh 时的中心点。
// 玩家走远后要按这个点算位移并重发，否则走出盒子就没人了（见 GameRouter.Crowd.cs）。
	LastCrowdCenter Vec3 `json:"lastCrowdCenter"`
	HasCrowdCenter bool `json:"hasCrowdCenter"`
// Throttle for the walking save. No session-end hook exists, so the movement handler writes the
// snapshot periodically; these two fields decide when it has moved/waited long enough.
	LastPositionSaveTicks int64 `json:"lastPositionSaveTicks"`
	LastSavedPlayerPosition Vec3 `json:"lastSavedPlayerPosition"`
	HasSavedPlayerPosition bool `json:"hasSavedPlayerPosition"`
	ActiveSkillId uint32 `json:"activeSkillId"`
	RestoreResourcesAfterActiveSkill bool `json:"restoreResourcesAfterActiveSkill"`
	ActiveClientSkillInstanceId int32 `json:"activeClientSkillInstanceId"`
	ActiveSkillStartedTicks int64 `json:"activeSkillStartedTicks"`
	ActiveWeaponInstanceId uint64 `json:"activeWeaponInstanceId"`
	ActiveFightStyleId uint32 `json:"activeFightStyleId"`
	LastWeaponBySpirit map[uint32]uint64 `json:"lastWeaponBySpirit"`
	WeaponSlotsBySpirit map[uint32][]uint64 `json:"weaponSlotsBySpirit"`
// 
// 搜打撤武器轮盘：最后一次下发给客户端的「实体化武器」表（CurrWeaponSlots 下标 → InstanceId）。
// 轮盘 bag 每变动一次就要让 gWeaponManager 跟上（否则 Tab 在轮盘武器之间根本切不动），
// 增量下发必须知道「客户端现在认为每一格是什么」，所以这里留一份服务端镜像。
// 下标口径：0 = 拳头、1 = 私有武器、轮盘 CellX c → c + 2。
// ⛑ 只记轮盘那几格（下标 2 起）：0/1 是拳头和私有武器，混进来会被当成
// 「轮盘里被删掉的格」而发 Remove，把拳头和角色自带武器摘掉。
// 
	ExtractionWheelPublished map[int32]uint64 `json:"extractionWheelPublished"`
	WeaponStyleOverrides map[uint64]uint32 `json:"weaponStyleOverrides"`
// Persistent weapon-instance ammunition. These dictionaries intentionally survive public-scene
// generations and character switches; a weapon switch must never refill its magazine.
	WeaponMagazineAmmo map[uint64]int32 `json:"weaponMagazineAmmo"`
// For firearms without separate backpack bullets, Durability is the remaining total ammo
// (loaded magazine + reserve). Keep it instance-persistent for the same reason as the magazine.
	WeaponDurabilityAmmo map[uint64]int32 `json:"weaponDurabilityAmmo"`
	WeaponBulletByInstance map[uint64]uint32 `json:"weaponBulletByInstance"`
	BackpackItemCounts map[uint32]uint32 `json:"backpackItemCounts"`
// Economy: wallet balances and granted backpack stacks. Fed by the GM console (ALT+F1),
// mall purchases and gacha draws. PlayerProgress mirrors them to disk so a re-login
// restores the character instead of starting from the auth-time values again.
	WalletMoney float64 `json:"walletMoney"`
	WalletGold float64 `json:"walletGold"`
	WalletBindingGold float64 `json:"walletBindingGold"`
	Progress PlayerProgress `json:"progress"`
	ProgressRestored bool `json:"progressRestored"`
// 
// 钓鱼：玩家钓鱼档案（渔具 / 已钓鱼类 / 钓点鱼池）。是 session 级的真相源，登录时灌进
// PlayerClientInfo.InfoMinor.FishingInfo。不落盘（重登从空重建 + 登录 seed 整套渔具）。
// 2026-09-29 自捐赠端 DRMK-PS_09_HyNB-v1.9-钓鱼 移植（GameRouter.Fishing.cs 依赖它）。
// 
	Fishing PlayerFishingInfo `json:"fishing"`
// Granted backpack stacks keyed by item template id, so repeated grants accumulate into
// one stack instead of spraying one entry per grant.
	GmBackpackItems map[uint32]PlayerPackItem `json:"gmBackpackItems"`
// Phone menu skin parts (手机壁纸) actually worn, keyed by FightSpiritConfig template id —
// SpiritInfo.MobileSkinInfo is a PER-CHARACTER struct, and SpiritManager keys its view store
// by TemplateId, so the S2C packet has to name the character too.
// Fed by AskSetMobileSkinPart and mirrored to disk through PlayerProgress so a re-login seeds
// the login payload with the player's own choice instead of the default suit.
	PhoneSkinBySpirit map[uint32]SpiritMobileSkinInfo `json:"phoneSkinBySpirit"`
// Outfit actually worn, keyed by FightSpiritConfig template id. The wardrobe panel only sends
// AskSetSpiritFashionsWithSource; the authoritative value lives in SyncSetSpiritFashions, so
// without this the model snaps back to the authored default on every re-login.
	FashionBySpirit map[uint32]FashionRecord4229938 `json:"fashionBySpirit"`
// 
// Dye (染色) per fashion id, restored from the player progress snapshot. Only fashions the
// player actually dyed appear here; everything else reads the configured default slot count.
// 
	Colorings map[uint32]FashionColoringRecord4229938 `json:"colorings"`
// 
// Livehouse 音游成绩 per 曲目 id（2026-10-04）。 everything here is restored from / written to
// config/player-progress.json through PlayerProgressStore. See
// LivehouseProgressStore; absent entry means "never cleared once".
// 
	LivehouseRecords map[uint32]LivehouseRecord4229938 `json:"livehouseRecords"`
// 
// True once AskQueryLiveHouseInfo has answered FirstPlay = true, which is what
// makes the client play the intro timeline exactly once per account.
// 
	LivehouseFirstPlayDone bool `json:"livehouseFirstPlayDone"`
// 
// Equipped weapon skins per character (spiritId -> weapon sceneItemId -> skinId), restored from
// the player progress snapshot. Written by AskSetWeaponSkins / AskSyncWeaponSkinToSpirits.
// 
	WeaponSkins map[uint32]WeaponSkinRecord4229938 `json:"weaponSkins"`
	SpiritStyleOverrides map[any]uint32 `json:"spiritStyleOverrides"`
	CombatUseCount int32 `json:"combatUseCount"`
// 
// Gameplay talent trees (天赋, T1-6), keyed by TalentTreeGamePlayConfig id (1..5 in stock
// 4229938). Holds the point balance the server owns plus every node the player activated.
// Why the server has to keep this at all: AskActiveGameplayTalentLayer carries no cost and no
// resulting layer, only (gameplayId, talentId, addLayer), and the eight talent S2Cs
// (SyncGameplayTalentPoint 64859579 & friends) have no contract and no client reader we can
// verify. PlayerClientInfo.GameplayTalentInfos is the one talent wire we know is correct — it
// rides the login frame — so this dictionary is published there and re-pushed through
// SyncPlayerInfo after each accepted activation.
// 
	GameplayTalents map[uint32]GameplayTalentState4229938 `json:"gameplayTalents"`
	CombatEndCount int32 `json:"combatEndCount"`
	CombatHitCount int32 `json:"combatHitCount"`
	NextBuffInstanceId uint32 `json:"nextBuffInstanceId"`
	ActiveFeiSuoBuffInstanceId uint32 `json:"activeFeiSuoBuffInstanceId"`
	ActiveFeiSuoBuffUnitId uint64 `json:"activeFeiSuoBuffUnitId"`
// 
// 玩家是否处在飞索蹲伏态（由 AskEnterFeiSuoCrouch / AskLeaveFeiSuoCrouch 维护）。
// ⛑⛑ 用途只有一个：蹲伏期间不要再把飞索 buff 加回去。
// 客户端进蹲伏态的同一帧会发 AskRemoveClientBuff(52853760) 主动摘掉飞索 buff
// （实测 19:41:32.258 进 / .262 摘）。旧逻辑在 120ms 后无条件 reassert 回去，
// 客户端随即 AskLeaveFeiSuoCrouch ⇒ 蹲伏态撑不过 0.4s ⇒
// StealthManager.CrouchAssassinationUpdate 永远跑不满一轮 ⇒
// ReportCanAssassinateEnemies 命中恒 0 ⇒ 暗杀 HUD 死在源头。
// 
	FeiSuoCrouchActive bool `json:"feiSuoCrouchActive"`
// 
// 已下发 SyncEnemyCanAssassinate = true 的 agent 集合。
// 客户端 StealthManager 每 0.4s 上报一次候选名单（ReportCanAssassinateEnemies），
// 蹲着不动时名单完全一样 ⇒ 用它做差分，只有集合真的变化才发包。
// 不做差分的话一个蹲伏姿态每秒会多推 2~3 个包 * N 个敌人。
// 
	AssassinationGrantedAgents []uint64 `json:"assassinationGrantedAgents"`
// 
// ★ 本次蹲伏里已经播种过 canAssassinate = true 的 agent（硬规则 192）。
// 与 AssassinationGrantedAgents 的区别：后者是「当前还授权着」的集合，会被
// 上报路径的撤销逻辑摘掉；前者只记「我播种过谁」。
// 为什么需要两个：打破死锁的那次播种是盲发（客户端还没算过候选），播完之后
// 客户端下一轮 0.4s 检测若判定它不合格，就会上报一个不含它的名单 ⇒ 上报路径撤销它。
// 若只看 AssassinationGrantedAgents，播种逻辑会以为「没授权过」而再播一次，
// 撤销→播种→撤销来回甩（500ms 一轮不停发包）。有了这个集合，每个敌人每次蹲伏
// 只播种一次；离开播种半径后重新靠近才会再播。
// ⛑ 进出蹲伏态时清空（见 OnEnter/OnLeaveFeiSuoCrouch）。
// 
	AssassinationSeededAgents []uint64 `json:"assassinationSeededAgents"`
// 播种扫描上次跑的时间戳（Environment.TickCount64）。
// 挂在敌人 AI worker 的 100ms tick 上，用它节流到 AssassinationSeedIntervalMs。
	AssassinationSeedAtTicks int64 `json:"assassinationSeedAtTicks"`
// Exact instance ids for client-owned 4229938 traversal states (SwingBuff/WallRushBuff).
// They are created/removed on demand and are intentionally not resident login buffs.
	ActiveClientWebBuffInstances map[any]uint32 `json:"activeClientWebBuffInstances"`
	SceneId uint64 `json:"sceneId"`
	ActiveSpiritUnitId uint64 `json:"activeSpiritUnitId"`
	ActiveSpiritTemplateId uint32 `json:"activeSpiritTemplateId"`
// 
// ★★ gameplay.webTraversal.parkourStateGates 的记账：当前已下发且仍挂在客户端上的
// ParkourState id 集合（严格跟状态：进了才发、离开立即撤）。
// 为什么需要它：客户端 OnParkourStateChange(67897801) 上报是高频的（实测约 1.2 次/秒，
// 一份 7 分钟的日志 516 次）。没有记账就会每次上报都发一遍 SyncPaokuLimitChange，
// 大跳门会被反复 add/remove 抖动。有了它只在 0→1 / 1→0 的边沿各发一次。
// ⛑ 硬规则 240 的哨兵要求在这里天然满足：集合初值是空（≠「无目标」的任何 state id），
// 所以「从没下发过」和「下发过」可区分，第一次进入稳定触发一次 add。
// ⛑ 会话内状态、不落盘 —— 重连后为空，重新按上报累积。
// 
	ActiveParkourGateStates []uint32 `json:"activeParkourGateStates"`
// 
// ActiveParkourGateStates 记账对应的单位 id。**0 = 还没记过**（哨兵，合法 unitId 不为 0）。
// 用途：切角色后单位换了，旧单位上那几张门随之消失 —— 记账必须整个重置，
// 否则新单位会以为「已经下发过」而永远不发。⛑ 重置时不补发
// isAdd=false：旧单位已经不在场了，撤它的门没有意义（与切角色不撤销常驻门同理）。
// 
	ActiveParkourGateUnitId uint64 `json:"activeParkourGateUnitId"`
// 
// Server-authoritative player HP. Only enemy hits move it, and only while
// PlayerLifeLocked is off. Reset to full by RestorePlayerHealthAsync.
// 
	PlayerHp float32 `json:"playerHp"`
// 
// GM vitals lock. ON by default: the player still gets hit, stiffened and cast-locked, but HP
// never moves, so a session is never ended by an enemy we cannot balance. Turn it off from the
// admin panel to make the player mortal.
// 
	PlayerLifeLocked bool `json:"playerLifeLocked"`
// True while the knocked-out sequence is running; blocks further damage.
	PlayerDowned bool `json:"playerDowned"`
	WorldEntrySwitchShowId uint32 `json:"worldEntrySwitchShowId"`
	LastSwitchShowId uint32 `json:"lastSwitchShowId"`
	SwitchCount int32 `json:"switchCount"`
// 
// 本次切人**发起**时的 Environment.TickCount64。
// 唯一用途：客户端回报 AskSwitchSpiritComplete(67272187) 时算
// 「整条演出真实播了多久」—— 这是我们唯一能实测演出时长的点
// （09-26 00:4x 加；CBT3 用它标定 apexDelayMs，我们暂时只记日志）。
// 
	SwitchStartedTicks int64 `json:"switchStartedTicks"`
// 
// ★★ 本次会话里**玩家亲手操控过**的角色（templateId）。
// 用途：切走一个角色时决定要不要让他「去过日子」（LeftBehindDailyLife，
// 即按「现在几点」把他刷到日程活动的坐标上）。用户 09-26 03:3x 定：
// **一旦玩家控制过某个角色，他就该停在玩家最后离开他的地方**，别再被瞬移到日程点。
// ⇒ 被操控过 ⇒ 跳过过日子（留在原地）；没操控过 ⇒ 照旧按日程去过日子。
// ⛑ 写入点只有两个：进世界时（GameRouter.World.cs 的初始角色）和
// 切人完成移交时（GameRouter.Switching.cs）。别在别处加，否则语义会漂。
// ⛑ 会话内状态、不落盘 —— 重连后重新累积。
// ⛑ 别拿 LeftBehindCharacters 当这个判据：那是「切走后留在世界里的身体」，
// 切走的那一刻它刚被写进去，恒为真，区分不出「有没有被操控过」。
// 
	ControlledSpirits []uint32 `json:"controlledSpirits"`
// Native 4229938 SwitchTeleport is a three-phase transaction. Only the current character
// exists as the controlled actor. Every target is materialized by the same generic AOI path
// after the client reports that the source close-up has finished.
	PendingSwitchTemplateId uint32 `json:"pendingSwitchTemplateId"`
	PendingSwitchUnitId uint64 `json:"pendingSwitchUnitId"`
	PendingSwitchOldUnitId uint64 `json:"pendingSwitchOldUnitId"`
	PendingSwitchShowId uint32 `json:"pendingSwitchShowId"`
	PendingSwitchPosition Vec3 `json:"pendingSwitchPosition"`
	PendingSwitchFacing float32 `json:"pendingSwitchFacing"`
	PendingSwitchControlTransferred bool `json:"pendingSwitchControlTransferred"`
	PendingSwitchLandingStarted bool `json:"pendingSwitchLandingStarted"`
// 切人演出（SwitchSpiritConfig 行驱动的两阶段切人）的挂起态。
// ⛑ PendingSwitchPosition/Facing 存的是「演出落点」（行的 Position/TimeLineAngleY），
// 不是玩家发起切人时站的位置 —— 捐赠端就是因为把两者混为一谈，才出现「镜头飞到远处却没人、
// 播完又拉回原角色原地切人」。
	PendingPreSwitchSent bool `json:"pendingPreSwitchSent"`
	PendingSwitchRequestedTicks int64 `json:"pendingSwitchRequestedTicks"`
	PendingSwitchConfigId uint32 `json:"pendingSwitchConfigId"`
	PendingSwitchConfigPublished bool `json:"pendingSwitchConfigPublished"`
	PendingSwitchLandingPosition Vec3 `json:"pendingSwitchLandingPosition"`
	PendingSwitchLandingFacing float32 `json:"pendingSwitchLandingFacing"`
// 目标角色是否已经在演出开始前预生成到落点了（决定 phase 2 能否被 6s 超时兜底接管）。
	PendingSwitchAgentPreSpawned bool `json:"pendingSwitchAgentPreSpawned"`
// 
// 目标角色此刻已经留在大世界里（上次被切换掉时没移除，见 LeftBehindCharacters）。
// true ⇒ phase 1 不再预生成（重复投放同一个 unitId），但 phase 2 仍要走 Leave+重建
// 才能把它从「服务端驱动」变回玩家可操控 —— 语义与预生成相同。
// 
	PendingSwitchTargetInWorld bool `json:"pendingSwitchTargetInWorld"`
// 
// 目标角色已经在演出开始之前以主角身份重建好了（RecreateHeroBeforeShow）。
// true ⇒ phase 2 不再重复建一遍，也不再发 SyncLogicAgentLeave。
// ⛑⛑⛑ 为什么必须提前：客户端的 LiftOffOneShot 时间线是 SyncPreSwitchSpirit 起的，
// 实测（2026-09-25 01:31:50 → 01:32:04）整整跑 14 秒。我们把 Leave+重建放在
// ReportPreSwitchSpiritFinish 之后 = 时间线跑到 3.5 秒时把主角单位拆了
// ⇒ 时间线在 12.5 秒处连抛 3 条 SwitchChar_common_04 2 System.NullReferenceException
// ⇒ 客户端再也建不出主角 ⇒ InitModules … IsMe False ⇒ 原地跑步、坐标不动。
// 
	PendingSwitchHeroPrebuilt bool `json:"pendingSwitchHeroPrebuilt"`
// 
// ⛑⛑⛑ 2026-10-04：演出演员的 uid —— 服务端为这出切人演出 spawn 的、站在落点上
// 演戏的那些身体（主演 + 陪衬）。
// 官方语义见 ClientConfigRepository.cs:862 引的注释：
// "Those rows carry AgentId entries that stock SwitchTeleport expects the server to spawn
// before landing."
// ⇒ 官方 SwitchTeleport 期望服务端在落地前把这些 agent spawn 好；
// 主线此前一个都没 spawn（只把主角单位换皮顶上）⇒ 演出里道具/环境在动、人没有。
// 主演取演出行的 FightSpiritIds[0]，经 GameAdminBridge.AgentIdForSpirit
// 映射成 AgentId（嘉姆 15020989→40140032、塔菲 15020992→40140035）；
// 陪衬直接用行的 AgentIds。
// 演完（ReportPreSwitchSpiritFinish）后由服务端 Leave 掉。
// 
	PendingSwitchShowActors []uint64 `json:"pendingSwitchShowActors"`
// 
// 被切换掉但留在大世界里的角色：templateId → 它的 unitId 与留下时的位姿。
// 移交控制权时旧单位不再发 SyncLogicAgentLeave（配置 KeepLeftBehindCharacters），
// 下次切回这个角色时落点直接取这里记的位置，而不是 SwitchSpiritConfig 行的演出锚点。
// 单位本身不移动（服务端驱动，没人喂位置包），所以这份位置就是它的实时位置。
// ⛑⛑ 2026-09-24 18:1x 实测：**不喂位置包它会自由落体掉出世界**（客户端停掉自己的 AI
// 后只做物理模拟，这类 actor 没有地面吸附 ⇒ Y 一路掉到 -3000）。所以服务端必须按
// FeedLeftBehindPositions 周期性把它钉回 Position（见 WorldCodec.LogicAgentSyncData）。
// 
	LeftBehindCharacters map[uint32]LeftBehindCharacter `json:"leftBehindCharacters"`
// 
// 旧角色（被切换掉的那个）留下时的位姿，在 OnSwitchSpirit 冻结玩家位置的那一刻
// 一并记下。不能在 phase 2 现读 LastReportedPlayerPosition：演出期间客户端的
// SwitchChar Timeline 会把角色移动到落点并照常上报位置，到那时该值已被覆盖成
// 新角色的落点 —— 16:5x 实测「老角色 T-pose 出现在新角色身边」就是这么来的。
// 
	SwitchOldUnitPosition Vec3 `json:"switchOldUnitPosition"`
	SwitchOldUnitFacing float32 `json:"switchOldUnitFacing"`
	HasSwitchOldUnitPose bool `json:"hasSwitchOldUnitPose"`
// 
// 「留在大世界里」的角色续发路点任务的后台循环句柄。
// 由 SyncRoot 保护；session 断开后循环自己会因写 socket 抛异常而退出。
// 
	LeftBehindCts *context.CancelFunc `json:"leftBehindCts"`
	LeftBehindLoop *any `json:"leftBehindLoop"`
// ── 改装店改装件（2026-09-26 自 repair-shop.zip 移植）─────────────────────────────────
// 「买过的件」是服务端唯一的真相源：客户端 ApplyCar 面板自己按 VehiclePartConfig 应用，
// 但**刷车时**的外观（SyncLogicVehicleEnter / SyncSpawnVehicle / SyncAllUnlockedVehicles
// 的 Parts + SuitId）只能由服务端给出。全部由 SyncRoot 保护。
// 
// vehicleConfigId → 买过的改装件（PartTag, PartConfigId）。
// 一个槽位只留一条（新买的按 PartTag 顶掉旧的）；type=18 的套件不进这里（见下）。
// 
	VehiclePartsByConfig map[uint32][]any `json:"vehiclePartsByConfig"`
// vehicleConfigId → 买过的套件 id（VehiclePartSuitConfig 的行 id）。
	VehicleSuitByConfig map[uint32]uint32 `json:"vehicleSuitByConfig"`
// 本次会话里因为购买而解锁过的车辆 config（用于 SyncAllUnlockedVehicles 重推）。
	SessionUnlockedVehicleConfigs []uint32 `json:"sessionUnlockedVehicleConfigs"`
// Admin / vehicle Phase-1 tracking. Guarded by SyncRoot like the rest of the state.
	LastAdminVehicleId uint32 `json:"lastAdminVehicleId"`
	LastSpawnedVehicleUid uint64 `json:"lastSpawnedVehicleUid"`
	LastVehicleDriveState byte `json:"lastVehicleDriveState"`
	HasVehicleDriveState bool `json:"hasVehicleDriveState"`
// Admin "spawn NPC": spirit-entity units materialized beside the player. Kept as a list
// because SyncLogicAgentLeave does not retire these units (the roster unitIds are also the
// switch-flow identities, so a summoned copy has to carry its own id), which means several
// can legitimately be standing at once.
	LastSummonedNpcEntityId uint64 `json:"lastSummonedNpcEntityId"`
	SummonedNpcEntityIds []uint64 `json:"summonedNpcEntityIds"`
// Scene switches can land on any owned character; the strict initial-identity
// commit check is relaxed only when a switch rearmed the transaction.
	WorldEntryAllowNonInitialControl bool `json:"worldEntryAllowNonInitialControl"`
// 
// Landing pose to re-apply once the client finishes loading a scene switch into the
// raid/instance it was already running.
// Re-pushing SyncEnterScene for the same raid+instance makes the client reload the level but
// leave the avatar standing where it was — verified 2026-09-19: two re-logins restored the
// pre-switch position even though the destination was ~1900m away. The load is still worth
// doing (it refreshes props and re-arms the world-entry transaction), so the landing is
// stored here and sent as a real move once the entry flow reaches ready.
// 
	SceneLandingPosition *Vec3 `json:"sceneLandingPosition"`
// Facing (Unity Euler Y, degrees) paired with SceneLandingPosition.
	SceneLandingFacing *float32 `json:"sceneLandingFacing"`
// Time/weather state (persist across scene switches; pushed on load when set).
	TimeHour uint32 `json:"timeHour"`
	TimeMinute uint32 `json:"timeMinute"`
	TimeFixed bool `json:"timeFixed"`
// 
// ★★ 玩家**主动改时间**的次数（AskPassingTime / GmSetTime / GmPassingTime /
// GmFixRaidTime / 面板设时间 / 面板「解除固定」都 +1）。
// 为什么不用 CurrentDaySecond 直接比：实时流逝也是每秒 +1，
// 而「被玩家操控过的角色赖在他最后的位置」这条需求恰恰要忽略实时流逝
// —— 玩家在城里逛 10 分钟，里希不该自己跑掉。
// 只有玩家主动把时间推走（游戏里的「度过时间」、GM/面板改时间）才算数。
// 由 SyncRoot 保护；调用方一律 `lock (state.SyncRoot) state.TimeEpoch++;`。
// 
	TimeEpoch uint32 `json:"timeEpoch"`
	TimeTransitionSeconds uint32 `json:"timeTransitionSeconds"`
	HasExplicitTime bool `json:"hasExplicitTime"`
	WeatherId uint32 `json:"weatherId"`
	WeatherTransitionSeconds uint32 `json:"weatherTransitionSeconds"`
	HasExplicitWeather bool `json:"hasExplicitWeather"`
	IsHangup bool `json:"isHangup"`
// ── 通缉系统 (Wanted) ────────────────────────────────────────────────────────────────
// 2026-09-23 自捐赠端 miyuki_fix 移植的「警车版」：服务端自己记犯罪值、自己派警车，
// 完全不接官方 SyncAgentCrimeAdd(68831313) / ReportPoliceCrimeEvent(67146776) /
// GmAddCrimeValue(69946581)。全部由 SyncRoot 保护。
	WantedCrimeValue uint32 `json:"wantedCrimeValue"`
	WantedLevel uint32 `json:"wantedLevel"`
	WantedChaseActive bool `json:"wantedChaseActive"`
	WantedPoliceVehicleIds []uint64 `json:"wantedPoliceVehicleIds"`
	WantedKilledNpcIds []uint64 `json:"wantedKilledNpcIds"`
	WantedDestroyedVehicleIds []uint64 `json:"wantedDestroyedVehicleIds"`
	WantedLastIncidentTarget uint64 `json:"wantedLastIncidentTarget"`
	WantedLastVehicleHitTicks int64 `json:"wantedLastVehicleHitTicks"`
	WantedStartedTicks int64 `json:"wantedStartedTicks"`
	WantedEscapeActive bool `json:"wantedEscapeActive"`
	WantedEscapeGeneration int32 `json:"wantedEscapeGeneration"`
	WantedEscapeDeadlineTicks int64 `json:"wantedEscapeDeadlineTicks"`
	WantedEscapeDurationSeconds int32 `json:"wantedEscapeDurationSeconds"`
	WantedPendingReward float64 `json:"wantedPendingReward"`
	WantedRewardTotal float64 `json:"wantedRewardTotal"`
	WantedPenaltyTotal float64 `json:"wantedPenaltyTotal"`
	WantedEscapeCount int32 `json:"wantedEscapeCount"`
	WantedArrestCount int32 `json:"wantedArrestCount"`
	WantedNpcHitCount uint32 `json:"wantedNpcHitCount"`
	WantedNpcKillCount uint32 `json:"wantedNpcKillCount"`
	WantedVehicleHitCount uint32 `json:"wantedVehicleHitCount"`
	WantedVehicleDestroyCount uint32 `json:"wantedVehicleDestroyCount"`
	WantedLastIncident string `json:"wantedLastIncident"`
	WantedLastOutcome string `json:"wantedLastOutcome"`
	WantedLastSync string `json:"wantedLastSync"`
// ── 迷雾 / 探索 POI（2026-09-24 自捐赠端 DremkaPS 移植）──────────────────────────────
// 数据驱动选出来的：66 个「捐赠端有、本服没有」的 handler 里，只有 6 个在 16.5 万行
// unknown-methods.log 里出现过，而 SyncEnterFogMapPoiId 一个人就占了 49 次（活跃到 09-23）。
// 其余 60 个客户端从没主动发过 —— 注册它们只是增加维护面。
// 由 SyncRoot 保护。
// 玩家踏入过的迷雾 POI（SyncEnterFogMapPoiId 上报）。
	FogMapPoiIds []uint32 `json:"fogMapPoiIds"`
// 控制台 GmUnlockAllFogMap 请求过的「全解锁」标记。
	FogMapAllUnlocked bool `json:"fogMapAllUnlocked"`
// Aether 氛围层开关（GmSetAmbianceEnabled / GmGetAmbianceEnabled 一对）。
	AmbianceEnabled bool `json:"ambianceEnabled"`
// AmbianceEnabled 的 type 参数。
	AmbianceType int32 `json:"ambianceType"`
// ── GM 控制台职业命令（GmJob*）────────────────────────────────────────────────────────
// 2026-09-24 自捐赠端 DremkaPS 移植，只取职业部分。由 GmJobs.SyncRoot 保护（独立锁：
// HTTP 面板线程在会话拆掉之后仍可能摸到它）。HasGmOverride=false 时职业完全由配置驱动，
// GM 命令一条都没到过，推送照旧。
	GmJobs GmJobState4229938 `json:"gmJobs"`
}

type LeftBehindCharacter struct {
	UnitId uint64 `json:"unitId"`
	Position Vec3 `json:"position"`
	Facing float32 `json:"facing"`
// 上一次给它回正位姿的时间戳（Environment.TickCount64），用于节流。
	LastFeedTicks int64 `json:"lastFeedTicks"`
// 上一次给它发「原地路点任务」的时间戳（Environment.TickCount64）。
	LastWaypointTicks int64 `json:"lastWaypointTicks"`
// 
// ★★ 这个角色被切走时，**时段表（NpcDailySchedule）当下那一段**指的活动 id（0 = 查不到）。
// 用途：后台（LeftBehindFollowSchedule）每 1.5 秒拿「现在时段的活动 id」跟它比，
// 不一样 ⇒ 游戏时间跨进了新的日程时段 ⇒ 该角色不再赖在原地，交还常驻化去演新活动。
// ⛑⛑⛑ 必须是 NpcActivityChoice.Timed（时段表真正指的那条），
// 不能是 Entry（落地用的那条）。原因（2026-09-26 06:0x 实机翻车）：
// 官方 284 条活动里有 131 条是「临时点位」没编坐标（睡觉 / 休息 / 对策局吃薯片……），
// 傍晚和夜里的时段大量命中这些条目 ⇒ Resolve 一律回落到
// FirstPositioned —— 而它是**与时间无关**的（同 tag 在本 raid 里 Id 最小的
// 有坐标那条），所以白天和夜里算出来的 Entry.Id **完全一样**。
// 实测：05:45 真实时间切走 Mechanika 记 11400031，18:00 再算还是 11400031
// ⇒ 判据恒等 ⇒ 时间跳了 13 小时也一次都不触发。
// 换成 Timed 就对了：11400031(跳大绳) → 11400034(睡觉)，里希 11400011 → 11400014。
// ⛑⛑ 必须记**真实活动 id**（不是出场包里那个 activityCfgId —— 那个可能被
// poiOverrides.sendActivityCfgId=false 抹成 0）。记 0 会导致每个 tick 都判定
// 「时段变了」⇒ 1.5 秒 retire+place 一次，客户端又没真撤掉 ⇒ 原地堆出一排人
// （09-25 跑步机堆里希就是这么来的，常驻化那边同一条坑，见 RosterNpc.cs 账本注释）。
// ⛑ 两个主角（AgentTag 2/3）压根没有时刻表 ⇒ 恒为 0 ⇒ 永远不触发，他们就该一直
// 待在玩家最后离开的地方 —— 这是对的，不要当成 bug 去"修"。
// 
	TimedActivityId uint32 `json:"timedActivityId"`
// 
// 切走他时 TimeEpoch 的值。玩家后来主动改过时间 ⇒ 两者不同 ⇒
// 该角色不再赖在原地，交还常驻化去过日子（开关 LeftBehindFollowOnTimeJump）。
// ⛑ 与 TimedActivityId 是两个独立触发条件，任一满足即放行：
// ① 时刻表的时段真的翻篇了（实时流逝也能触发，见 TimedActivityId）
// ② 玩家主动推了时间（哪怕还在同一个时段里 —— 06:13 跳到 06:00 就是这种）
// 
	TimeEpoch uint32 `json:"timeEpoch"`
// ── 闲逛（2026-09-26 18:5x；开关 SwitchAnimations.LeftBehindWander）────────────────
// 
// 当前这一段行程的折线（PedLaneGraph.TryPlanJourney 规划出来的人行道路径）。
// null = 现在没有行程，下次循环会重新挑一个终点并规划。
// ⛑ 只在这里记、只在 Movement.cs 里用；由 SyncRoot 保护。
// 
	WanderRoute []any `json:"wanderRoute"`
// 行程折线里已经派过的下标（下次从 WanderRouteIdx 开始往下发）。
	WanderRouteIdx int32 `json:"wanderRouteIdx"`
// 
// 下一次该派新行程的时间戳（Environment.TickCount64）。
// ⛑ 按「本段路程 ÷ 速度 + 余量」算（硬规则 109：不能固定步长，否则一步一停）。
// 
	WanderNextTicks int64 `json:"wanderNextTicks"`
// ── POI 轮换（2026-09-26 23:4x；开关 SwitchAnimations.LeftBehindPoiRotation）──────
// 
// 出场包里实际带出去的 AgentDataSetsActivityCfgId。
// ⛑⛑ 轮换的门禁：非 0 ⇒ 不轮换 —— 客户端那时在走生活日程，
// ambient 会盖掉我们推的 POI（硬规则 163）。与 TimedActivityId 是两回事
// （那个记的是真实活动 id，这个记的是"有没有进生活日程状态"）。
// 
	ActivityCfgId uint32 `json:"activityCfgId"`
// 
// 洗牌袋：本轮要播的 POI 顺序（组的副本打乱后的结果）。
// null = 还没建/这个角色不轮换。
// 
	PoiBag []uint32 `json:"poiBag"`
// 洗牌袋里下一条的下标；走到末尾 ⇒ 重新洗牌、归零。
	PoiBagIdx int32 `json:"poiBagIdx"`
// 下一次该换 POI 的时间戳（Environment.TickCount64）。0 = 立刻换。
	PoiNextTicks int64 `json:"poiNextTicks"`
}

// Where the server last put a static NPC, and which way it faces (radians).
type StaticNpcPose struct {
	X float32 `json:"x"`
	Y float32 `json:"y"`
	Z float32 `json:"z"`
	Facing float32 `json:"facing"`
}

// 
// One weapon lying in the world.
// The drop is authoritative now: the slot the weapon came from is emptied while it is on the
// ground and restored on pick-up, so SlotIndex is what makes the round trip exact.
// A drop that was not a weapon (or one whose weapon was not in a slot) carries SlotIndex = -1 and
// only the destructible is tracked.
// 
type WeaponDropRecord struct {
	DestructibleId uint64 `json:"destructibleId"`
	WeaponInstanceId uint64 `json:"weaponInstanceId"`
	SpiritTemplateId uint32 `json:"spiritTemplateId"`
// Index into WorldEntryState.WeaponSlotsBySpirit, or -1 when the weapon had no slot.
	SlotIndex int32 `json:"slotIndex"`
}

// One interactive prop (Gadget) placed into the world from the admin panel.
type SpawnedGadgetRecord struct {
	InstanceId uint64 `json:"instanceId"`
// Resource path id from GadgetCatalog.json — which prefab the client loaded.
	PathId int32 `json:"pathId"`
	Name string `json:"name"`
	X float32 `json:"x"`
	Y float32 `json:"y"`
	Z float32 `json:"z"`
// Yaw in degrees, kept so a re-push reproduces the original facing.
	Yaw float32 `json:"yaw"`
// 家具机关标记：网格 AOI 撤掉后要补发（见 GameRouter.HouseFurnitureGadget.cs）。
	IsHouseFurniture bool `json:"isHouseFurniture"`
}