From d258144df42b7f385d1d0dd89b7fc9c74b30517d Mon Sep 17 00:00:00 2001
From: Kelsi <kelsihates2fa@gmail.com>
Date: Wed, 6 May 2026 03:31:04 -0700
Subject: [PATCH] docs(format-spec): document WOB->WMO restoration details
 under WOB section

---
 tools/editor/FORMAT_SPEC.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tools/editor/FORMAT_SPEC.md b/tools/editor/FORMAT_SPEC.md
index 384b8e1a..f3d8ed03 100644
--- a/tools/editor/FORMAT_SPEC.md
+++ b/tools/editor/FORMAT_SPEC.md
@@ -41,6 +41,13 @@ Novel file formats for custom WoW zone content. No Blizzard IP.
 - Material: texturePath + flags(4) + shader(4) + blendMode(4)
 - Doodad: modelPath + position(12) + rotation(12) + scale(4)
 - Portal: groupA(4) + groupB(4) + vertexCount(4) + vertices
+- toWMOModel restoration:
+  - Materials are deduplicated across all groups by (texture, blend, flags)
+  - Texture paths .png → .blp (renderer's PNG override is keyed on .blp)
+  - Outdoor flag → WMO group flag bit 0x08
+  - Portal vertices reconstruct MOPR refs for groupA / groupB
+  - Doodad euler degrees → glm::quat using glm::eulerAngles convention
+  - Default `Set_$DefaultGlobal` doodadSet emitted when doodads present
 
 ## WCP — Wowee Content Pack (archive)
 - Extension: `.wcp`