acdream/docs/research/vtank-kb
Erik 55010f92c7 docs(vt): round 3 item 11 — record the MyMonsters persistence gap
CombatSettings.Rules lives only in MossTank's JSON side-car;
VtankSettingsProfileSerializer preserves the real .usd MyMonsters table
byte-for-byte but never parses it into MonsterRules or regenerates it from
them (VtankSettingsProfileSerializer.cs:24-30). MonsterRules.cs/
MonsterExpression.cs (the rule-grammar evaluator itself) is a faithful,
well-cited port with no material gap — only the real-file round trip is
missing.

Filed TS-86 (temporary stopgap; slice 3 ports the table) and added it as
gap item 6 in docs/research/vtank-kb/03-combat.md section 8 (previously
absent — the existing five gaps are about rule-grammar/priority fidelity,
not about whether the real table round-trips at all). Corrected the TS
section header's stale active-row count (was undercounting by one before
this row) to the actual count. Documentation-only; the parse is
deliberately NOT implemented this round, per the task's explicit scope.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 02:00:19 +02:00
..
01-settings-and-profiles.md docs(vt): VT1 catalog 01 — VTank settings, defaults and the .usd profile format 2026-09-06 19:33:06 +02:00
02-scheduler-and-actions.md docs(vt): VT1 catalog 02 scheduler/actions and 03 combat from the VTank decompile 2026-09-06 19:29:22 +02:00
03-combat.md docs(vt): round 3 item 11 — record the MyMonsters persistence gap 2026-09-07 02:00:19 +02:00
04-buffs-and-vitals.md docs(vt): VT1 catalog 04 — VTank buffs, item enchantments, helpers and vitals 2026-09-06 19:44:02 +02:00
05-looting-and-utl.md docs(vt): VT1 catalog 05 — VTank loot flow and the Classic Looter .utl format 2026-09-06 19:48:33 +02:00
06-navigation-and-nav.md fix(vt): A ptl/tlk carry two coordinate triples, jmp direction loss recorded 2026-09-06 22:13:48 +02:00
07-meta-and-expressions.md fix(vt): H test-restoration + disabled-rule refusal + double-side gate 2026-09-06 23:20:20 +02:00
08-ui-views.md docs(vt): VT1 catalog 08 — VTank UI views from its own view XML and VVS semantics 2026-09-06 19:23:04 +02:00
09-commands-and-interop.md docs(vt): VT1 catalog 09 — /vt commands, chat sinks, and VTank's plugin interop surface 2026-09-06 19:42:51 +02:00
README.md docs(vt): land KB doc 07, VT2 gap audit draft, slice-1 contract; metas/navs move to metaf .af 2026-09-06 19:56:45 +02:00

VTank knowledge base (Campaign VT, VT1)

Written 2026-09-06 from the decompiled oracle under refs/ (gitignored; see docs/plans/2026-09-06-campaign-vt-vtank-oracle.md for what is there and how to regenerate it). Every behavioral claim cites file:line into refs/vtank/decompiled/ (VTank), refs/vtank-classiclooter/decompiled/ (Classic Looter) or refs/vvs/decompiled/ (VirindiViewService). Decompiled code is never pasted; behavior is re-implemented from these docs. When the older wiki-derived research (docs/research/2026-07-29-vtank-plugin-automation-requirements.md, docs/research/2026-08-26-mosstank-vtank-utilitybelt-research.md) disagrees with a doc here, the doc here wins.

Each doc ends with a MossTank gap section (ranked by player impact) and a Could not determine list. VT2 consolidates the gap sections into the implementation order.

# Doc What it pins Oracle files most cited
01 settings and profiles All 137 settings (type, default, tab control, consumer), the self-describing .usd table grammar, profile naming/selection, /vt opt f3.cs (typed accessors), gy/cw/bd/y.cs (table reader), defaultsettings.usd
02 scheduler and actions The single-winner priority list (24 rule classes, 45 instantiations, sentinels), 293 ms heartbeat + event poke, force-combat-mode ga.a and stuck-state recovery, IdlePeace in full uTank2/cLogic.cs, ga.cs, f9.cs, cm.cs, fz.cs
03 combat Target acquisition/selection (3 methods, ghost/blacklist), monster rules, weapon/damage/ammo choice, attack execution, the hardcoded 12-debuff order, pets dz.cs, hi.cs, b4.cs
04 buffs and vitals Buff plan and per-tick re-evaluation, item enchantments (-1 "no buffs"), helper buffs, the nine recharge thresholds, kits/potions/food, dispel, worn-item mana eq.cs, fz.cs, ba.cs, ai.cs, dy.cs, a5.cs, MySpell.cs
05 looting and .utl The .utl format and all requirement types, EarlyMatch identify-avoidance, ComputedItemInfo, VTank's corpse selection/approach/open/loot rules, ownership-denial regexes VTClassic cLootRules, UTLBlock_*; VTank fo.cs, d0.cs, el.cs, hv.cs
06 navigation and .nav uTank2 NAV 1.2 byte-for-byte (10 waypoint types), route types, steering/creep band, jump, door/lockpick, recall, priority interactions, 240 m/unit x.cs, ca.cs, fd.cs, bi.cs, b7.cs, g8.cs
07 meta and expressions .met format, FSM semantics, the expression language and built-in table, views created by metas ExpressionEvaluator.cs, ch.cs, a7.cs, cLogic.cs:191-196
08 UI views Every control of the nine tabs and three secondary views (type, geometry, binding), VVS control semantics our markup must offer, the markup extension needed (multi-column lists) uTank2.ViewXML.*.xml, VVS HudList/HudCombo/HudTabView, Decal3XMLParser.cs
09 commands and interop The /vt verb table (~48 documented + 15 parser-only), chat sinks and dedup, the three-tier export API, Classic Looter SPI, MosswartMassacre's real usage uTank2/PluginCore.cs, d5.cs, ah.cs, eExternalsPermissionLevel.cs

Owner amendment 2026-09-06 — metas and navs use metaf .af. Docs 06 §1 and 07 §1 document VTank's binary .nav/.met layouts; MossTank does not implement them. It reads and writes the human-readable metaf format (the reference converter is C:\Users\erikn\source\repos\metas\metaf_monolithic.py, see claude-memory/reference_metaf_af_format.md). The semantics sections of 06/07 (execution, FSM, expressions, views) remain the behavior oracle.

Local companion note (not committed): refs/vtank/notes/2026-09-06-idlepeace-fcm-trace.md — the line-level trace of the combat-mode choke point, the eight drop-to-peace sites and the wield sequencing.

Corrections folded in by the lead during spot-checks are marked in place ("lead verification 2026-09-06"). Files written by agents into the main checkout by mistake were moved here; check git status in the main checkout after any catalog session.