5/j:SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r \ "SS5r \ "SS5r S r \RRS 5=(d$ \RRS 5=(d S r\R"R%\S 5rSrSSjrSSjrSSjrSSjrSSjrSSjrSSjrS S!SjjrS"Sjr\S:Xa\R>"\"55 gg)#u Phase D.1.a — stage the 13x13 ring's ACE landblock_instance spawn records. Mirrors the Phase C.1 scenery-bake staging pattern (one JSONL per LB, hex-named, plus a bake-source sha256 sidecar). Output layout: /mnt/wbterminal1/holtburger-dist-v2/spawns/ source.sha256 # sha256 of input JSONL 0xA9B4.spawns.jsonl # 106 records for Holtburg 0xA9B0.spawns.jsonl # 13 records for South Outpost ... # one per LB in the 13x13 ring README.md # schema notes Empty JSONL files are emitted for LBs with zero ring matches — this gives the runtime an unambiguous "this LB has been queried, zero spawns" signal (vs 404 "this LB hasn't been baked yet"). Filter range (matches the Phase C ring driver): landblockId in {(x<<8)|y for x in 163..=175, y in 174..=186} Run: python3 stage-ring-spawns.py python3 stage-ring-spawns.py --source /path/to/ace_spawn_records.jsonl python3 stage-ring-spawns.py --out /path/to/spawns Determinism contract: byte-identical output across runs given the same input. We sort records within each LB by (cell, x, y, z, wcid) so the JSONL output doesn't drift on the JSONL line order in the source file. ) annotationsN)Pathz=/home/wbterminal/projects/RetailSmoke/ace_spawn_records.jsonlHOLTBURGER_DISTHOLTBURGER_DIST_V2z /mnt/wbterminal2/holtburger-distspawnsz8/home/wbterminal/projects/RetailSmoke/weenie_index.jsonlcSUS3$)z5Render `landblockId` (e.g. 43444 = 0xA9B4) as 0xXXXX.0x04X) landblock_ids n/home/wbterminal/WorldBuilder-ACME-Edition/external/holtburger/scripts/world-completeness/stage-ring-spawns.pylb_hexr=s  S! ""c|[5n[H'n[HnURUS-U-5 M M) U$)zBuild the 169-element ring set.)set RING_X_RANGE RING_Y_RANGEadd)outxys r ring_lb_setrBs8EC A GGQ!VqL ! Jrc^[R"5nURS5m[U4SjS5HnUR U5 M SSS5 UR 5$!,(df  UR 5$=f)z;SHA-256 of a file's bytes (used for source.sha256 sidecar).rbc&>TRS5$)Ni)read)fsrsha256_file..Os !&&/rrN)hashlibsha256openiterupdate hexdigest)pathhchunkr"s @r sha256_filer.KsbA 4A137E HHUO8  ;;=  ;;=s )A)) BcvUSURSS5URSS5URSS5USURSS5US US US [URS S 55[URS05RSS55S. nURS5nUbURSS5nURSS5nURSS5n[US- 5S:a-[U5S:a[U5S:a[U5S:dX!S'X1S'XAS'XQS'U$)uProject a source JSONL record to the wire-shape we stage. Pulls only fields the renderer's synthetic-spawn injector reads. Coordinates are LB-local metres (same convention as LandblockInfo.objects + scenery bake). Orientation: when the source carries explicit per-axis quaternion components (`qw/qx/qy/qz` — added by the angle-merge from ACE `landblock_instance.angles_*`), we emit them so the wasm `EntitySpawnJsonRaw` parser (optional qw/qx/qy/qz, `#[serde(default)]`) and `scene3d/spawns.js::buildUpd` render the REAL rotation. Identity placements (and pre-merge sources that only ship `{isIdentity}`) omit the quat — the parser defaults to qw=1 — keeping files lean and backward-compatible. wcidnamecategory weenieTyper landblockIdcellrrzisServerManagedT orientation isIdentityF) r0r1r3r4r5r6rrr7r8orientationIsIdentityqwqxgqyqzg?gư>)getboolabs)recrr<r=r>r?s rnormalise_recordrDTs2"F #GGJ+gglA.=)" X X X(94 @A!%cggmR&@&D&D\SX&Y!Z C B ~ WWT3  WWT3  WWT3 BH $R4GdNs2w~IIII Jrc URSS9 U[U5S3- nURS5nUH8nUR[R "USS95 URS5 M: SSS5 [ U5nURURS 3- RUS-5 g!,(df  NH=f) zWrite one LB's JSONL, sorted deterministically. Sort key: (cell, x, y, z, wcid). Stable across re-runs given the same source JSONL. The empty-file invariant: every LB in the ring gets a file, even when records is []. c.USUSUSUSUS4$)Nr6rrr7r0r)rs rr# write_lb_jsonl..s#& 1S61S61S61V9Mr)keyz .spawns.jsonlwT) sort_keys Nz.sha256) sortrr'writejsondumpsr.parentr1 write_text)out_dirlbrecordsr+r"rGshas rwrite_lb_jsonlrWs LLMLN r |=1 1D 31A GGDJJqD1 2 GGDM  d C [[dii[((44S4Z@ s ?B44 Cc0SnUS- RU5 g)uCSchema doc — explains what the JSONL means and how to consume it.u5# Phase D.1 — staged ACE spawn records for the 13x13 Holtburg ring Each `0xXXXX.spawns.jsonl` file contains the ACE `landblock_instance` spawn records for one landblock, filtered from the world-wide dump at `/home/wbterminal/projects/RetailSmoke/ace_spawn_records.jsonl`. ## Ring 13 x 13 landblocks centred on Holtburg (LB 0xA9B4 = cell_x 0xA9, cell_y 0xB4). Mirrors the Phase C.1 scenery bake's ring. ## Schema (per JSONL line) ```jsonc { "wcid": 7978, // ACE weenie classification ID "name": "Scrawed Grievver", "category": "Creature", // Creature, Object, NPC, ... "weenieType": 10, // ACE WeenieType enum "landblockId": 43444, // (cell_x << 8) | cell_y "cell": 0, // intra-LB cell index (0 = outdoor) "x": 130.239, // LB-local metres "y": 104.9, "z": 46.005, "isServerManaged": true, // ACE manages lifecycle (vs DAT static) "orientationIsIdentity": false // true => use identity quat } ``` ## Notes - **Orientation is dropped.** The source JSONL has only `orientation: {isIdentity: bool}` — no per-axis quaternion components. The injector emits identity quat (qw=1). A future re-run of the dumper can include full quaternion fields without schema breakage. - **Empty files are intentional.** 125 of 169 LBs in the ring have zero spawns. The runtime treats "empty body" as "queried, zero spawns" (not 404 "not yet baked"). - **wcid alone doesn't render an entity.** The renderer needs a `setupDid` (`csetup_id`) — we resolve it via the weenie_index at injection time, not in this stage. - **The wire-position injector mirrors handleEntitySpawn(upd).** See `scene3d/spawns.js::ensureSpawnsForLandblock`. ## Reproducibility ```sh python3 stage-ring-spawns.py ``` Deterministic given the same input JSONL (records sorted by `(cell, x, y, z, wcid)` within each LB). The output `source.sha256` covers the input JSONL so a manifest consumer can verify it has the same spawn snapshot. z README.mdN)rR)rScontents r write_readmerZs7Gp {&&w/rcUR5(dSS[U5S.$0nUR5nUHcnUR5R S5nU(dM+[ R "U5nURS5nU(dM\XsUS'Me SSS5 0n/n [U5H;n URU 5nU(aXx[U 5'M*U RU 5 M= US- R[ R"USS S 95 [U5U S S .$![ Ra GM f=f!,(df  N=f) uvStage a `wcid_to_setup.json` mapping for the ring's wcids. The renderer's synthetic injector reads this to resolve a SetupModel DID (0x02xxxxxx) for each spawn record — the JSONL itself doesn't carry the setup_id. Filtered to ring wcids only so the file stays tiny (~4 KB for the 13x13 ring vs ~1 MB for all 43k weenies). Returns a stats dict (entry counts, miss list). Tr) missing_inputentries missing_wcidssetupDidr0Nzwcid_to_setup.json)rKindentF)r]r^r\)existslistr'striplstriprOloadsJSONDecodeErrorr@sortedstrappendrRrPlen) rS ring_wcidsweenie_index_path wcid_to_setupr"linerCsetupout_mapmissingrJs rwrite_wcid_to_setuprts>  # # % %!%!d:FVWW$&M    !QD::<&&u-D jj&GGJ'Eu-2c&k* "!GG J !!!$ #CFO NN1    ##// 7d15 w<  '''   " !s5.E &D.<E  E .EE EE  Ec0UR5(d[SU35eURSSS9 U(aSO [5nU(a[5Vs0sHoU/_M snOUVs0sHoU/_M snn[ 5nSnSn UR 5n U Hn U R 5RS5n U (dM+US- n[R"U 5n U RS 5nUbXT;aMbO)[U[ 5(dMzUR#U/5 U S- n XeR%['U 55 UR)U S 5 M SSS5 SnSn[+UR-55H&nXen[/XU5 U(aUS- nM!US- nM( [1U5n[3XU5nUcS OSnUc [5U5O [5U5nUcSOLS[6R8S[6R:S- S[<R8S[<R:S- S3 nUS- R?UR@SUSUS3U-SUSUSUSU S5SUSS[5US5S3-5 [CU5 UU U[5U5UUUUSUSS . $s snfs snf![Ra*n [SUS U 3[RS 9 Sn A GMaSn A ff=f!,(df  GN=f)!aRead source JSONL, partition by LB into per-LB files, write sha256. Ring mode (default): keep only the 13x13 Holtburg ring, pre-seeding an empty file for every ring LB. World mode (`all_world=True`): keep EVERY landblock present in the source, emitting a file only for LBs that have spawns (unpopulated LBs 404 -> the loader fail-softs to "no spawns", which is correct). Returns a stats dict for logging. zFAIL: source missing: T)parentsexist_okNrr_zWARN: bad json on line z: )filer5r0worldringr2z ring-x-range z..=z ring-y-range rLz source.sha256 z4 bake-tool-version stage-ring-spawns.py/0.2.0 scope z lb-count z populated-lbs z empty-lbs z total-records z unique-wcids z wcid-to-setup-entries r]z wcid-to-setup-missing r^) total_seen total_kept ring_sizerm populatedempty source_sha256wcid_to_setup_entrieswcid_to_setup_missing)"rc SystemExitmkdirrrr'rerfrOrgrhprintsysstderrr@ isinstanceint setdefaultrkrDrrikeysrWr.rtrlrstartstoprrRr1rZ) source_pathrSrn all_worldr{rTper_lbrmr}r~r"rprCerrrecssrc_sha wcid_statsscopelb_count range_liness r stage_spawnsrs_     1+?@@ MM$M.4+-D -6+-(-BR-(T;RTrFT;R 5JJJ    qD::<&&u-D !OJ jj&'B>"""c**!!"b) !OJ J  .s3 4 NN3v; ') 0I EV[[]#zwD)  NI QJE $+&G$W:KLJ|GE"ls6{D H < \//0L4E4E4I3JK)//0L4E4E4I3J" N  **    Bwi(    xj!#%W$&Z)*"",Y"7!89""%j&A"B!C2  G G ! *o !+I!6!+O!<  Q );R'' / |2aSA S   sC J;- K3LK$A>LLK>7L>LL Lc J[R"[S9nURS[S[S3S9 URS[ S[ S3S9 URS[ S [ S3S9 URS S S S 9 UR5n[UR5n[UR5n[UR5n[X#XARS9n[S5 [S5 [SU35 [SU35 [SUS35 [SUSSUSS35 [SUS35 [SUS35 [SUS35 [SUS S![US"5S35 [S#US$35 g%)&N) descriptionz--sourcezInput JSONL path (default: ))defaulthelpz--outzOutput dir (default: z--weenie-indexzWeenie index JSONL (default: z --all-world store_truezStage EVERY landblock present in the source (whole world), not just the 13x13 Holtburg ring. Emits a file only for LBs that have spawns.)actionr)ru$Phase D.1.a — staged spawn recordsz!=================================zsource : zout : zrecords scanned : r}zrecords kept : r~z (ring=rz populated LBs : rz empty LBs : rzring unique wcids : rmzwcid_to_setup ents: rz (missing=rzsource.sha256 : rr)argparseArgumentParser__doc__ add_argumentDEFAULT_SOURCE DEFAULT_OUTDEFAULT_WEENIE_INDEX parse_argsrsourcer weenie_indexrrrrl)apargssrcrrstatss rmainrps  W 5BOOJ6~6FaHJOOG[0 Q?AOO$.B89M8NaPROOM,?@ ==?D t{{ C txx.C))*L <>> JE 02 -/  &'  &' |!4 5 67 |!4 5XeK>P=QQR ST {!3 4 56 w 0 12 |!4 5 67 '>!? @A% 789:! => !7 8 9: r__main__)rrreturnrj)rset[int])r+rrrj)rCdictrr)rSrrTrrUz list[dict]rNone)rSrrr)rSrrmrrnrrr)F) rrrSrrnrrrArr)rr) r __future__rrr%rOosrpathlibrrangerrrenvironr@r r+joinrrrrr.rDrWrZrtrr__name__exitrrrrs<#  S# S# P JJNN$%* zz~~*+*) ggll?H5 Q# *ZA2:0z-,0-59-b>Cf%)f6:fGKfR D zHHTVr