diff --git a/BuilderExecutionPlan_Draft.md b/BuilderExecutionPlan_Draft.md index bfa4868..642bcf1 100644 --- a/BuilderExecutionPlan_Draft.md +++ b/BuilderExecutionPlan_Draft.md @@ -6,6 +6,7 @@ Deliver a stable, content-driven dungeon builder pipeline that: 2. Produces deterministic results for a given seed/content snapshot. 3. Keeps admin tooling (`/admin/dungeonbuilder`) aligned with runtime output. 4. Scales to higher-tier larger dungeons with multi-boss support. +5. Uses palette-scoped tile selection only (no cross-palette wall/floor picks). ## Non-Goals (for this phase) 1. Final art polish for room shapes and micro-layout aesthetics. @@ -26,13 +27,20 @@ Deliver a stable, content-driven dungeon builder pipeline that: - Random walk connectivity overlay. - Corridor width enforcement (2-4). - Bucket-constrained floor placement. - - Wall placement via 8-neighbor mask lookup. + - Wall placement via ordered two-pass masking: + 1) cardinal-first wall bucket fill, + 2) diagonal/8-neighbor completion only for unfilled cells. 2. Tier scaling: - Increase map size/room budget for tier 6+. - Allow multi-boss placement tier 6+. 3. Hard constraints: - At least one boss per dungeon. - Dungeon clear requires all bosses defeated. +4. Wall placement rules: + - Every wall tile must resolve to exactly one wall bucket. + - Cardinal bucket matches are evaluated and applied first. + - Remaining unresolved wall slots are resolved from 8-direction buckets. + - Tile candidate selection is limited to buckets available in the active palette. ### Deliverables 1. Deterministic VNext map output for fixed seed + snapshot. @@ -45,7 +53,8 @@ Deliver a stable, content-driven dungeon builder pipeline that: - floor buckets, - wall buckets/masks, - adjacency matrix, - - template pools. + - template pools, + - palette bucket-to-tile indexes (for fast palette-only sampling). 2. Ensure no DB reads in inner generation loops. 3. Add snapshot key/versioning (palette id + updated timestamp). @@ -130,12 +139,14 @@ Deliver a stable, content-driven dungeon builder pipeline that: ## Acceptance Criteria 1. Corridor width always 2-4. 2. 0 invalid floor cardinal adjacency violations after repair pass. -3. Wall mask resolution >= 99.9% (remaining repaired/fallbacked). -4. Deterministic outputs for fixed seed + snapshot. -5. Every dungeon has >=1 boss; tier 6+ supports multi-boss. -6. Clear condition strictly `defeatedBosses == totalBosses`. -7. TestGen and runtime produce equivalent structural output for same inputs. -8. Rejoin/reload does not corrupt visual state or AI state. +3. 100% of placed wall tiles resolve to one wall bucket; unresolved placements are flagged and repaired/fallbacked. +4. Wall placement execution order is cardinal pass then unfilled-cell directional completion pass. +5. Tile picks are always from buckets present in the selected palette. +6. Deterministic outputs for fixed seed + snapshot. +7. Every dungeon has >=1 boss; tier 6+ supports multi-boss. +8. Clear condition strictly `defeatedBosses == totalBosses`. +9. TestGen and runtime produce equivalent structural output for same inputs. +10. Rejoin/reload does not corrupt visual state or AI state. ## Risks 1. Legacy content missing bucket/mask metadata.