j dZddlmZddlZddlZddlZddlmZddlm Z edZ ejdejZ ejdejZejd ejZd ejd ejfd ejd ejfdejdejfdejdejffZdejdejfdejdejfdejdejfdejdejfdejdejffZd)d*dZd)d+dZd)d*dZd)d*d Zd,d!Zd-d"Zd.d#Zd$d%d&Zd/d'Zde fd0d(Zy)1aThe Town: settlements for a custom 3D game (villages, hamlets, towns and cities of the medieval and Breton styles). A custom 3D game whose words name a settlement (a village, a hamlet, a castle town, a tavern, a smithy, a cathedral...) gets the town kit (JavaScript ES modules, built by `tools/pack/pack_townkit.sh`) and its style's models and textures as attachments, and the builder contract joins the brief. The builder places houses from the kit with `settle` + `buildSettlement` (SETTLEMENT.md) instead of drawing them from boxes. The Engine stages attachments at `.forge/attachments/att/original.` in order, like games_garage and games_library. A missing bundle = no town kit, the build goes on as before. ) annotationsN)Path)Anyz/srv/forge-assets/distzk\b(breton|bretons|brittany|britanny|bretagne|finistere|morbihan|fishing (?:village|town|port|harbou?r)s?)\ba1\b(medieval|mediaeval|middle ages?|fantasy (?:town|village|city|kingdom|realm)s?|castle towns?|kingdom(?! hearts)|kingdoms|knights?|knightly|taverns?|blacksmiths?|smithy|smithies|bakery|bakeries|market towns?|cathedrals?|abbeys?|monasteries|monastery|peasants?|feudal|hamlets?|villages?|serfs?|thatched)\baV\b(space|spaceships?|starships?|sci-?fi|galax\w*|asteroids?|aliens?|cyber\w*|modern city|downtown|skyscrapers?|metropolis|new york|hong kong|racing (?:circuit|track)|race ?tracks?|grand prix|formula (?:1|one)|football|soccer|basketball|baseball|tennis|golf\w*|skate\w*|supermarkets?|airports?|office blocks?|shopping (?:mall|centre|center))\bcityz9\b(cities|city|capitals?|cathedrals?|walled|metropolis)\btownz \b(towns?)\bvillagez\b(villages?)\bhamletz\b(hamlets?)\bcoastzD\b(coasts?|coastal|seaside|shore|shoreline|harbou?rs?|bay|cliffs?)\briverz7\b(rivers?|riverside|streams?|fords?|lakes?|springs?)\bhillz4\b(hills?|hilltops?|hillsides?|mountains?|perched)\bspurz!\b(spurs?|ridges?|promontor\w*)\b crossroadsz6\b(crossroads?|crossings?|junctions?|intersections?)\bc Pt|dd}t|ddt|ddt|ddt|ddt|dddjt|d dxsgt|d dxsdt|d dxsd|xsdg }djd |DS) Nworldtitlerpitchgenre core_loop first_version moodsettinglookc38K|]}|st|yw)N)str).0ps E/home/claude-agent/forge-build/forge-assets/omg/factory/games_town.py z_card_text..4s/qQCF/s)getattrjoin)cardpromptrpartss r _card_textr&/s D'4 (E T7B 'w)CWTSZ\^E_ahimoz|~a T?B /'$PT:U:[Y[1\ UIt , 2GE644P4VTVX^Xdbd fE 88/E/ //ct||}tj|rytj|rytj|ryy)zt'breton', 'medieval' or None, deterministic from the words. Modern, space and sport words win over settlement words.Nbretonmedieval)r& _NOT_TOWN_REsearch_KIND_BRETON_RE_KIND_MEDIEVAL_RE)r#r$texts r town_kindr07sD dF #D4 d#% r'cbt||}tD]\}}|j|s|cSy)zj'hamlet', 'village', 'town' or 'city'. The largest word wins; a settlement with no size word is a village.r)r& _TIER_WORDSr,)r#r$r/tierpatterns r town_tierr5Cs7 dF #D$ g >>$ K r'cbt||}tD]\}}|j|s|cSy)zj'coast', 'river', 'hill', 'spur', 'crossroads' or 'plain': water first, then high ground, then a crossing.plain)r& _SITE_WORDSr,)r#r$r/siter4s r town_siter:Ls7 dF #D$ g >>$ K r'ct|dd}t|dddk(xr't|dddk(xr|duxrt|dddvS)Nrlanecustomstagenoneview)firstthirdtop)r!)r#rs r town_fitsrDUse D'4 (E D&$ '8 3 Jgt8TX^8^ Jchptct Jvt,0IIKr'c |dz jjxsdS#t$rYnwxYw tj|dz j j S#t$rYywxYw)zfsha256 of the code tarball (the one `townkit.sha` names), for meta; None when the kit is not vendored.z townkit.shaNtownkit.tar.gz) read_textstripOSErrorhashlibsha256 read_bytes hexdigest) assets_dirs rtown_sharO[sy ]*557==?G4G    ~~z,<<HHJKUUWW s$' 333A++ A76A7cVd|dtj|jzS)Nzdata:z;base64,)base64 b64encodedecode)mimedatas r _data_urlrVgs* 4& !F$4$4T$:$A$A$C CCr'zpMedieval style: timber-framed and stone houses with tile roofs, Romanesque and Gothic churches, walls and gates.zmBreton style: granite and slate houses with blue-grey slate roofs and painted timber, a fishing-village look.)r*r)cd|zdz|zdz|zdz|zdz|zdzt|zdz|zdz|zd z|zd z|zd z|zd zS) zXThe builder contract for the town kit. code_id / models_id are attachment ids (att2...).z0 SETTLEMENTS COME FROM OUR TOWN KIT. Attachment zQ is the town kit (JavaScript ES modules, three.js, a gzipped tar) and attachment z holds its zm style models and textures (a gzipped tar). First run: `mkdir -p src/lib/town && tar -xzf .forge/attachments/z;/original.* -C src/lib/town && tar -xzf .forge/attachments/z[/original.* -C public`, then read `src/lib/town/TOWN.md` and `src/lib/town/SETTLEMENT.md`. z This world is a z on a zy: build the whole world with ONE call: `const town = await createTown(THREE, { renderer, GLTFLoader, KTX2Loader, style: 'z ', tier: 'z ', site: 'a', seed })` from `@/lib/town/index.mjs` (three.js loaders from three/addons; kits load from /town/kits/, the KTX2 decoder from /town/basis/), then `scene.add(town.group)`. Never draw houses, walls, roads or churches from boxes: the kit places them. Spawn the player at `town.spawn` (the main square). Collide with `town.colliders`. Walk on `town.heightAt(x, z)`. Do not edit src/lib/town or public/town.) _STYLE_NOTES)code_id models_idkindr3r9s r town_contractr\qs ;WDH' ')2 35B CEI JMR RT[ \_' '*3 36) ),8+=  >AT  TW[  [^f  fim  mpB  B EI  I L      (  ( +/  / 2[ [ r'ct|syt||}|y |dz j}|d|dz j}d|dzd|dz}}t d|dd d d t d|d|dd |d dd g} t ||t ||} } t|||| | } | | || | t|dfS#t$rYywxYw)a(attachments, contract, meta) or None. first_index = attachments already in the brief (the Engine numbers att1, att2... in list order). None when the game has no settlement or a bundle is missing: the town kit is a bonus, never a reason to fail a build.NrFztownkit-z.tar.gzattzapplication/gzipzTown kit (JavaScript, three.js)z/code to extract into src/lib/town and use as is)urlfilenamealtrolezTown kit models and textures (z style)z+models to extract into public (public/town))r[r3r9sha) rDr0rLrIrVr5r:r\rO) r# first_indexr$rNr[codemodelsrYrZattsr3r9contracts rtown_attachmentsrks" T? T6 "D |--99;$w77CCE{Q/0C a7H2IYG,d3AQZ{B D,f5XdVSZC[0g>Hu w D 4()D&*A$DWitTBH D$XV`Mab bb s*B;; CC)r)r#rr$rreturnr)r#rr$rrl str | None)r#rrlbool)rNrrlrm)rTrrUbytesrlr) rYrrZrr[rr3rr9rrlr) r#rrfintr$rrNrrlz-tuple[list[dict[str, Any]], str, dict] | None)__doc__ __future__rrQrJrepathlibrtypingrDISTcompileIr-r.r+r2r8r&r0r5r:rDrOrVrXr\rkr'rrzs#   $%"**rtvtxtxzBJJHIKOrzzrsuswswy  ZRZZTVXVZVZ [\ ZRZZ ./  -rtt45 zrzz+RTT23   jbjj`bdbfbfgh jbjjSUWUYUYZ[ ZRZZOQSQUQU VW ZRZZ