Initial import of HEROLL source and design documents

This commit is contained in:
toshiocn
2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,14 @@
"key","value","execution_rule","source_status","source"
"buildingCarrier","exterior house layer","A house is attached to a small tile's exterior slot and never replaces its movement tile, event, or enemy content","MVP frozen","v0.2.8 building-module decision"
"exteriorSlotCapacity","1 per ordinary small tile","A slot is eligible only when it has no house and belongs to the configured upcoming board side","MVP frozen","v0.2.8 building-module decision"
"housingSupportTileId","129","Landing on Housing Support opens the construction event and performs one two-die construction roll","source-aligned","newtile.csv + CornerDiceBuilding reverse"
"baseConstructionAttempts","D6_A + D6_B","Roll two independent six-sided dice once; their sum is the number of base construction attempts","source-aligned","CornerDiceBuilding reverse"
"urbanPlanningBlessingId","152","If owned, add 2 construction attempts once per Housing Support event; the blessing is unique and does not stack","source structure + MVP consumer freeze","augment.csv EmptyTripleBuild"
"placementOrder","next clockwise board side","Starting after the Housing Support Corner, collect empty exterior slots on the following side and choose distinct slots without replacement using the run RNG seed","MVP executable edge","v0.2.8 geometry freeze"
"actualBuiltCount","min(totalAttempts, eligibleSlotCount)","Every selected eligible slot succeeds; unused attempts are discarded","source-aligned cap + MVP edge","CornerDiceBuilding reverse + v0.2.8"
"reward","actualBuiltCount * 1 spirit stone","Grant the reward after placement animation; the exact original reward conversion remains unknown","DEMO default","04-unknown-parameter-mvp-defaults.csv"
"zeroEligibleSlots","build 0 and reward 0","Show a no-space result, complete the event, and do not reroll or relocate to another side","MVP frozen","v0.2.8 building-module decision"
"persistence","until final Boss Floor","Houses survive loop/Floor progression and Good/Enemy/Empty mutations of the underlying tile because the exterior layer is independent","MVP frozen","v0.2.8 building-module decision"
"ongoingEffect","none","A built house has no passive income, combat bonus, or tile-trigger modification in MVP","MVP scope freeze","v0.2.8 building-module decision"
"finalBossCleanup","clear every exterior house","Clear houses in the same board-conversion transaction that replaces all 44 positions with Boss Tiles","MVP frozen","v0.2.8 final Boss rule"
"saveState","slot occupancy + construction RNG result","Persist occupied slot IDs, both dice values, selected slot IDs, reward, seed, and ruleset version at the event safety point","MVP frozen","v0.2.8 determinism requirement"
1 key value execution_rule source_status source
2 buildingCarrier exterior house layer A house is attached to a small tile's exterior slot and never replaces its movement tile, event, or enemy content MVP frozen v0.2.8 building-module decision
3 exteriorSlotCapacity 1 per ordinary small tile A slot is eligible only when it has no house and belongs to the configured upcoming board side MVP frozen v0.2.8 building-module decision
4 housingSupportTileId 129 Landing on Housing Support opens the construction event and performs one two-die construction roll source-aligned newtile.csv + CornerDiceBuilding reverse
5 baseConstructionAttempts D6_A + D6_B Roll two independent six-sided dice once; their sum is the number of base construction attempts source-aligned CornerDiceBuilding reverse
6 urbanPlanningBlessingId 152 If owned, add 2 construction attempts once per Housing Support event; the blessing is unique and does not stack source structure + MVP consumer freeze augment.csv EmptyTripleBuild
7 placementOrder next clockwise board side Starting after the Housing Support Corner, collect empty exterior slots on the following side and choose distinct slots without replacement using the run RNG seed MVP executable edge v0.2.8 geometry freeze
8 actualBuiltCount min(totalAttempts, eligibleSlotCount) Every selected eligible slot succeeds; unused attempts are discarded source-aligned cap + MVP edge CornerDiceBuilding reverse + v0.2.8
9 reward actualBuiltCount * 1 spirit stone Grant the reward after placement animation; the exact original reward conversion remains unknown DEMO default 04-unknown-parameter-mvp-defaults.csv
10 zeroEligibleSlots build 0 and reward 0 Show a no-space result, complete the event, and do not reroll or relocate to another side MVP frozen v0.2.8 building-module decision
11 persistence until final Boss Floor Houses survive loop/Floor progression and Good/Enemy/Empty mutations of the underlying tile because the exterior layer is independent MVP frozen v0.2.8 building-module decision
12 ongoingEffect none A built house has no passive income, combat bonus, or tile-trigger modification in MVP MVP scope freeze v0.2.8 building-module decision
13 finalBossCleanup clear every exterior house Clear houses in the same board-conversion transaction that replaces all 44 positions with Boss Tiles MVP frozen v0.2.8 final Boss rule
14 saveState slot occupancy + construction RNG result Persist occupied slot IDs, both dice values, selected slot IDs, reward, seed, and ruleset version at the event safety point MVP frozen v0.2.8 determinism requirement