Refine builder plan with strict wall bucket placement flow

- Document cardinal-first then unfilled-cell directional wall placement

- Require each wall tile to map to exactly one wall bucket

- Restrict tile selection to buckets available in active palette
This commit is contained in:
dingo
2026-02-09 15:33:48 -05:00
parent e0e3ccc63c
commit 1f5c56ec4f
+19 -8
View File
@@ -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.