mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-05-06 17:13:51 +00:00
47eff19cb6
- WOB save/load now serializes Material struct fields (flags, shader, blendMode, texturePath) per group — was saving only texture paths - FORMAT_SPEC.md v1.1: documents WOT doodad/WMO placements, WOB material fields, doodad rotation, terrain stamps, WCP file list - Test coverage: 5 new assertions verify material round-trip (flags, shader, blendMode all preserved through save→load cycle) - 260 total assertions across 75 test cases, all passing
76 lines
3.4 KiB
Markdown
76 lines
3.4 KiB
Markdown
# Wowee Open Format Specification v1.1
|
||
|
||
Novel file formats for custom WoW zone content. No Blizzard IP.
|
||
|
||
## WOT — Wowee Open Terrain (JSON metadata)
|
||
- Extension: `.wot`
|
||
- Contains: tile coords, texture list, per-chunk layers/holes, water data,
|
||
doodad placements (M2 objects), WMO placements (buildings)
|
||
- Key: `"format": "wot-1.0"`
|
||
- Placement fields: `doodadNames[]`, `doodads[]` (nameId, uniqueId, pos, rot, scale, flags)
|
||
- WMO fields: `wmoNames[]`, `wmos[]` (nameId, uniqueId, pos, rot, flags, doodadSet)
|
||
|
||
## WHM — Wowee HeightMap (binary)
|
||
- Extension: `.whm`
|
||
- Magic: `WHM1` (0x314D4857)
|
||
- Layout: magic(4) + chunks(4) + vertsPerChunk(4) + per-chunk data × 256
|
||
- Per-chunk: baseHeight(4) + heights[145](580) + alphaSize(4) + alphaData(alphaSize)
|
||
- Alpha data: raw alpha blend maps for texture layers (same format as ADT MCAL)
|
||
- Backward compatible: older WHM files without alpha data still load (alphaSize=0)
|
||
|
||
## WOM — Wowee Open Model (binary)
|
||
- Extension: `.wom`
|
||
- Magic: `WOM1` (0x314D4F57)
|
||
- Layout: magic(4) + vertCount(4) + indexCount(4) + texCount(4) + bounds(28) + name + vertices + indices + texPaths
|
||
- Vertex: position(vec3) + normal(vec3) + texCoord(vec2) = 32 bytes
|
||
- Note: geometry-only (no skeletal animation — WOM2 planned for bone data)
|
||
|
||
## WOB — Wowee Open Building (binary)
|
||
- Extension: `.wob`
|
||
- Magic: `WOB1` (0x31424F57)
|
||
- Layout: magic(4) + groupCount(4) + portalCount(4) + doodadCount(4) + bounds(4) + name + groups + portals + doodads
|
||
- Group: name + vertexCount(4) + indexCount(4) + texCount(4) + outdoor(1) + bounds(24)
|
||
+ vertices(pos+normal+uv+color) + indices + texPaths + materialCount(4) + materials
|
||
- Material: texturePath + flags(4) + shader(4) + blendMode(4)
|
||
- Doodad: modelPath + position(12) + rotation(12) + scale(4)
|
||
- Portal: groupA(4) + groupB(4) + vertexCount(4) + vertices
|
||
|
||
## WCP — Wowee Content Pack (archive)
|
||
- Extension: `.wcp`
|
||
- Magic: `WCP1` (0x31504357)
|
||
- Layout: magic(4) + fileCount(4) + infoJsonSize(4) + infoJSON + [pathLen(2) + path + dataSize(4) + data] × N
|
||
- Info JSON includes categorized file list (terrain/model/building/texture/data)
|
||
|
||
## zone.json — Map Definition
|
||
- Replaces WDT
|
||
- Fields: `mapName`, `displayName`, `mapId`, `biome`, `baseHeight`
|
||
- `hasCreatures`, `description`, `tiles` array, `files` map
|
||
- `doodadNames[]`, `doodads[]`, `wmoNames[]`, `wmos[]` for placed objects
|
||
- `editorVersion` for compatibility tracking
|
||
|
||
## JSON DBC — Data Table Replacement
|
||
- Replaces binary DBC files
|
||
- Format: `{"format": "wowee-dbc-json-1.0", "records": [...], "fieldCount": N}`
|
||
- Records are arrays of mixed types: integers, floats, strings
|
||
- Client loads via DBCFile::loadJSON() when found in custom_zones/ or output/
|
||
|
||
## PNG Textures — Texture Replacement
|
||
- Replaces BLP texture files
|
||
- Standard PNG format, loaded by client's texture override system
|
||
- Editor auto-converts BLP→PNG on export via stb_image_write
|
||
|
||
## Terrain Stamps (.json)
|
||
- Portable terrain feature snapshots (mountains, craters, etc.)
|
||
- Format: `{"format": "wowee-stamp-1.0", "vertices": [[dx, dy, height], ...]}`
|
||
- Can be saved/loaded across zones and sessions
|
||
|
||
## Open Format Scoring (0-6)
|
||
1. WOT terrain metadata present
|
||
2. WHM heightmap with valid magic
|
||
3. zone.json map definition
|
||
4. PNG textures present
|
||
5. WOM models with valid magic
|
||
6. WOB buildings with valid magic
|
||
|
||
## All formats are novel, portable, and open for redistribution.
|
||
## No Blizzard intellectual property is used in any format definition.
|