README.md

---
title: 🧜‍♀️Streamlit🧠CV📚Scroller
emoji: 🧜‍♀️📚🧜‍♂️
colorFrom: gray
colorTo: pink
sdk: streamlit
sdk_version: 1.45.0
app_file: app.py
pinned: false
license: mit
short_description: 🧠CV Scroller🧜‍♀️🧜‍♂️🧜3D Graphs
---


# 🌟 Master Asset Component Library 🌟

## 🏙️ 1. Cyberpunk City Builder Kit

* ### 🧱 Modular Building Prefabs
    * 1.  🏢 **Cyberpunk Wall Panel:** Parameterized dimensions (WxH), base material slot (plasteel, concrete), trim material slot (neon glow, metal), connection points (top, bottom, sides). Boolean cutouts for windows/doors.
        `Gold Prompt: modular cyberpunk wall panel plasteel neon trim grid snap`
    * 2.  🌃 **Rooftop AC Unit:** Box primitive geometry, fan grille detail (alpha texture or geometry), rust/grime PBR material, attachment base.
        `Gold Prompt: rooftop AC unit cyberpunk boxy grime rust PBR`
    * 3.  🪟 **Holographic Window Display:** Plane primitive, animated emissive shader (parameterized content/color cycle), frame geometry slot.
        `Gold Prompt: holographic window display cyberpunk animated emissive shader glow`
    * 4.  🔩 **Greeble Set:** Collection of small primitives (pipes, vents, boxes, wires) designed for surface detailing, attachable via snapping, shared PBR material (worn metal).
        `Gold Prompt: cyberpunk greeble set small pipes vents boxes worn metal detail`

* ### 💡 Exterior Decorative Prefabs
    * 1.  🚦 **Neon Sign:** Spline-based tube geometry, emissive material (parameterized text/symbol, color, flicker), mounting bracket.
        `Gold Prompt: neon sign cyberpunk spline tube emissive text glow flicker`
    * 2.  🪜 **Fire Escape Stair:** Modular stair/platform sections (metal grid PBR), railing spline geometry, rust/wear parameters.
        `Gold Prompt: modular fire escape stairs metal grid platform rust wear cyberpunk`
    * 3.  💈 **Street Lamp Post:** Tall cylindrical or complex spline pole, light source geometry (parameterized color/intensity), weathered metal PBR.
        `Gold Prompt: cyberpunk street lamp post tall sleek weathered metal cyan light`
    * 4.  🚧 **Holographic Barrier:** Plane geometry with animated projected texture, emitter base primitive, parameterized color/pattern.
        `Gold Prompt: holographic barrier projector cyberpunk animated energy pattern`

* ### 🛋️ Interior Building Prefabs
    * 1.  🚪 **Sci-Fi Door:** Sliding panel geometry, frame geometry, emissive light strips (parameterized color), activation panel detail, metallic PBR.
        `Gold Prompt: sci-fi interior door sliding panel emissive strips metallic`
    * 2.  ✨ **Floating Data Kiosk:** Screen primitive (parameterized UI texture), base pedestal (geometric or anti-gravity effect), emissive highlights.
        `Gold Prompt: floating data kiosk cyberpunk screen UI pedestal emissive`

* ### 🏭 Premade Buildings (Conceptual Assembly)
    * 1.  🏢 **Modular Hab Block:** Assembled from Wall Panels, Windows, Rooftop AC units, Fire Escapes via blueprint data.
        `Gold Prompt: assembled cyberpunk hab block modular panels windows AC units gritty`
    * 2.  🗼 **MegaCorp Skyscraper:** Assembled from unique facade modules, spire components, large signage, glass PBR materials, defined by assembly data.
        `Gold Prompt: towering cyberpunk skyscraper glass facade mega corp logo neon lights`

* ### 🎨 Materials & Textures
    * 1.  💿 **PBR Material - Wet Asphalt:** Parameterized base color, high roughness, normal map for bumps/cracks, reflection map slot (for puddles).
        `Gold Prompt: PBR material wet asphalt texture puddles reflections cracks`
    * 2.  💡 **PBR Material - Neon Glow:** Base color (black), high emissive color parameter, bloom intensity parameter.
        `Gold Prompt: PBR material neon glow emissive bright bloom effect`
    * 3.  🧱 **Texture - Tiled Grime:** 2K tileable texture map (color, normal, roughness) depicting urban grime and leakage.
        `Gold Prompt: tileable grime texture urban leakage stains PBR 2K`

## 🏰 2. POLYGON - Fantasy Kingdom Pack

* ### 🧑‍🤝‍🧑 Characters (Low Poly Style)
    * 1.  👑 **King Figure:** Low-poly mesh, distinct silhouette, material IDs for clothing (velvet texture parameter), skin, hair, crown (metallic PBR parameter). Rigged.
        `Gold Prompt: low poly king figure regal pose velvet texture gold crown stylized`
    * 2.  🛡️ **Soldier Figure:** Low-poly mesh, armor material ID (parameterized metal/leather), helmet attachment point, weapon grip point. Rigged.
        `Gold Prompt: low poly fantasy soldier plate armor helmet spear stylized`
    * 3.  🧙 **Mage Figure:** Low-poly mesh, robe material ID (parameterized color/symbol), staff grip point, particle emitter attachment point (hands). Rigged.
        `Gold Prompt: low poly fantasy mage flowing robes pointy hat magic staff stylized`

* ### 🧢 Character Attachments
    * 1.  👑 **King's Crown:** Low-poly mesh, metallic PBR material (gold parameter), jewel geometry slots (parameterized color). Attaches to head bone.
        `Gold Prompt: low poly king crown gold metallic jewels fantasy stylized`
    * 2.  ⛑️ **Soldier Helmet:** Low-poly mesh, PBR material matching soldier armor, optional visor/plume boolean state. Attaches to head bone.
        `Gold Prompt: low poly soldier helmet steel plate simple design fantasy stylized`

* ### 🐎 Vehicles & Siege Weapons
    * 1.  🛒 **Wooden Cart:** Low-poly assembly of wood planks (texture parameter), wheels (spinning parameter), attachment point for horse/ox.
        `Gold Prompt: low poly wooden cart fantasy simple planks spinning wheels stylized`
    * 2.  🏹 **Ballista:** Low-poly wood frame, rope/winch detail, bolt projectile slot, aiming parameters (pitch/yaw).
        `Gold Prompt: low poly ballista siege weapon wood frame rope stylized fantasy`
    * 3.  🏰 **Siege Tower:** Low-poly modular wood sections (height parameter), ramp (boolean deployed state), wheels, attach points for soldiers.
        `Gold Prompt: low poly siege tower wooden modular ramp wheels stylized fantasy`

* ### 🧱 Modular Castle & Houses
    * 1.  🧱 **Stone Wall Section:** Low-poly block mesh, stone PBR material (parameterized color/moss amount), crenellation boolean option, snap connectors.
        `Gold Prompt: low poly castle wall stone block modular crenellated mossy stylized`
    * 2.  🚪 **Wooden Door:** Low-poly plank geometry, frame, metal hinge/handle primitives, PBR material (parameterized wood type/wear). Opens via rotation parameter.
        `Gold Prompt: low poly wooden door planks metal hinges fantasy stylized simple`
    * 3.  🏠 **House Roof Section:** Low-poly tile/thatch geometry, PBR material, modular edge connectors, chimney attachment point.
        `Gold Prompt: low poly house roof tile thatch modular simple stylized fantasy`

* ### 🌳 Environment
    * 1.  🌲 **Pine Tree:** Low-poly trunk cylinder, layered plane geometry for needles, simple bark/needle PBR materials.
        `Gold Prompt: low poly pine tree stylized simple layered needles bark texture`
    * 2.  🪨 **Boulder:** Low-poly smoothed rock primitive, stone PBR material (parameterized moss/lichen coverage), variable scale parameter.
        `Gold Prompt: low poly boulder smooth rock mossy stone stylized fantasy`

* ### 🏮 Props & Items
    * 1.  🚩 **Banner:** Cloth plane geometry (physics simulation parameters), pole primitive, material slot for faction symbol texture.
        `Gold Prompt: low poly fantasy banner cloth physics faction symbol pole stylized`
    * 2.  🏺 **Clay Pot:** Low-poly revolved spline geometry, terracotta PBR material, breakable state (boolean/mesh swap).
        `Gold Prompt: low poly clay pot terracotta simple breakable stylized fantasy`
    * 3.  ⚔️ **Sword:** Low-poly blade primitive, hilt primitive, crossguard primitive, PBR material (parameterized metal/leather).
        `Gold Prompt: low poly sword simple blade leather hilt stylized fantasy weapon`

* ### 💥 FX
    * 1.  🕯️ **Candle Flame:** Particle system emitter, simple flame texture sheet, light component (parameterized color/intensity).
        `Gold Prompt: low poly candle flame particle effect stylized simple glow`
    * 2.  💨 **Dust Cloud:** Particle system emitter, soft alpha texture, parameterized color/density/duration.
        `Gold Prompt: low poly dust cloud particle effect stylized soft brown puff`

## 👹 3. HEROIC FANTASY CREATURES FULL PACK VOL 1 (Conceptual Categories)

* 1.  😈 **Demonic Creature Base Mesh:** Parameterized base mesh (bipedal, quadrupedal), material slots for skin (scaled, leathery PBR), horns (bone PBR), claws (chitin PBR), eye glow (emissive). Rigged.
    `Gold Prompt: fantasy demonic creature base mesh scales horns claws glowing eyes PBR rigged`
* 2.  🐾 **Fantasy Animal Base Mesh:** Parameterized base mesh (quadrupedal common forms), material slots for fur/scales/hide PBR, eye material. Rigged.
    `Gold Prompt: fantasy animal base mesh wolf stag bear fur hide PBR rigged stylized`
* 3.  🦎 **Fantasy Lizard Base Mesh:** Parameterized base mesh (reptilian forms), scale PBR material slots (parameterized color/pattern), claw/teeth material. Rigged.
    `Gold Prompt: fantasy lizard base mesh reptilian scales pattern PBR rigged stylized`
* 4.  💀 **Living Dead Base Mesh:** Parameterized base mesh (humanoid skeleton/zombie), material slots for bone (PBR), decayed flesh (PBR), tattered cloth. Rigged.
    `Gold Prompt: fantasy undead skeleton zombie base mesh bone decayed flesh PBR rigged stylized`
* 5.  🦹 **Fantasy Villain Base Mesh:** Parameterized base mesh (humanoid archetypes - warrior, mage), material slots for menacing armor/robes PBR, unique feature attachments (horns, scars). Rigged.
    `Gold Prompt: fantasy villain base mesh humanoid dark armor robes menacing PBR rigged stylized`
* 6.  🦄 **Mythological Creature Base Mesh:** Parameterized base mesh (unique forms - griffin, centaur), multiple material slots for fur, feathers, scales, etc. Rigged.
    `Gold Prompt: mythological creature base mesh griffin centaur feathers fur PBR rigged stylized`

## ☢️ 4. POLYGON - Apocalypse Pack (Low Poly Style)

* ### 🚶 Characters (Low Poly Style)
    * 1.  🧟 **Zombie Figure:** Low-poly humanoid mesh, material IDs for decayed skin (PBR), tattered clothes (PBR), optional gore decals. Rigged, unique animation set parameter.
        `Gold Prompt: low poly zombie figure decayed skin tattered clothes gore stylized apocalypse`
    * 2.  🧑‍🔧 **Survivor Figure:** Low-poly humanoid mesh, material IDs for rugged clothing (leather, denim PBR), skin, hair. Attachment points for gear. Rigged.
        `Gold Prompt: low poly survivor figure rugged clothes leather jacket denim stylized apocalypse`

* ### 🎒 Character Attachments
    * 1.  🎒 **Backpack:** Low-poly container shape, canvas/nylon PBR material, strap geometry. Attaches to back bone slot.
        `Gold Prompt: low poly backpack canvas rugged straps stylized apocalypse gear`
    * 2.  🛡️ **Makeshift Armor:** Low-poly plates (tire, metal sign geometry), strap primitives, PBR materials (rubber, rusted metal). Attaches to torso/limbs.
        `Gold Prompt: low poly makeshift armor tire metal sign straps stylized apocalypse`

* ### 🚗 Vehicles & Attachments
    * 1.  🚙 **Buggy Frame:** Low-poly vehicle chassis base, wheel attachment points, driver seat position, basic metal PBR.
        `Gold Prompt: low poly dune buggy frame chassis simple metal stylized apocalypse`
    * 2.  <0xF0><0x9F><0x9B><0x82>️ **Motorbike:** Low-poly core bike geometry, wheel primitives, handlebar control points, metal/rubber PBR.
        `Gold Prompt: low poly motorbike simple rugged metal rubber stylized apocalypse`
    * 3.  🔩 **Vehicle Spike Armor:** Sharp cone/pyramid primitives, weld bead details, rusted metal PBR. Attaches to vehicle armor slots.
        `Gold Prompt: low poly vehicle spike armor cone rusted metal weld stylized apocalypse`

* ### 🏠 Buildings & Modular Systems
    * 1.  🧱 **Concrete Bunker Wall:** Low-poly thick wall section, concrete PBR material (parameterized damage/grime), modular snap connectors.
        `Gold Prompt: low poly concrete bunker wall thick damaged grime modular stylized apocalypse`
    * 2.  🏘️ **Damaged House Facade:** Low-poly building front, broken window booleans, burnt wood/brick PBR materials, rubble pile attachment points.
        `Gold Prompt: low poly damaged house facade broken windows burnt wood brick stylized apocalypse`
    * 3.  🚧 **Quarantine Wall Section:** Low-poly large panel (metal/concrete), barbed wire spline geometry on top, warning symbol decal slot. Modular connectors.
        `Gold Prompt: low poly quarantine wall concrete metal panel barbed wire modular stylized apocalypse`

* ### 🌲 Environment
    * 1.  🛣️ **Cracked Road Segment:** Low-poly plane geometry, asphalt PBR material, crack decal/geometry boolean, modular connectors.
        `Gold Prompt: low poly cracked road asphalt modular segment stylized apocalypse`
    * 2.  <0xF0><0x9F><0xAA><0xB1> **Rubble Pile:** Low-poly collection of broken concrete/brick primitives, dust/debris PBR material. Parameterized size.
        `Gold Prompt: low poly rubble pile broken concrete bricks dust stylized apocalypse`

* ### 📦 Props & Items
    * 1.  🚧 **Jersey Barrier:** Low-poly concrete barrier shape, weathered concrete PBR, optional graffiti decal slot.
        `Gold Prompt: low poly jersey barrier concrete weathered graffiti stylized apocalypse`
    * 2.  <0xF0><0x9F><0x️ **Oil Drum:** Low-poly cylinder primitive, rusted metal PBR, optional bullet hole decals/boolean.
        `Gold Prompt: low poly oil drum cylinder rusted metal bullet holes stylized apocalypse`
    * 3.  🥫 **Canned Food:** Low-poly cylinder primitive, label texture slot (parameterized brand/condition), dent deformer parameter.
        `Gold Prompt: low poly canned food cylinder label dented rusty stylized apocalypse item`

* ### 🔫 Weapons & Modular Guns
    * 1.  🔪 **Makeshift Machete:** Low-poly blade shape, wrapped handle primitive, PBR materials (sharpened metal, dirty tape).
        `Gold Prompt: low poly makeshift machete sharpened metal taped handle stylized apocalypse weapon`
    * 2.  🔫 **Pistol Body (Modular):** Low-poly core gun receiver geometry, attachment points for barrel, grip, magazine, sight. Basic metal/polymer PBR.
        `Gold Prompt: low poly modular pistol body receiver attachment points polymer stylized apocalypse`
    * 3.  <0xF0><0x9F><0x9E><0xAB> **Scope Attachment (Modular):** Low-poly cylinder/box geometry for scope body/lens, PBR material. Attaches to weapon sight rail.
        `Gold Prompt: low poly scope attachment sight modular weapon stylized apocalypse`

* ### ✨ FX
    * 1.  🩸 **Blood Splat Decal:** Projected decal texture, parameterized size/color/opacity.
        `Gold Prompt: blood splat decal projected texture red transparent gore effect`
    * 2.  🔥 **Burning Barrel Fire:** Particle system emitter placed inside barrel prop, flame/smoke texture sheets, heat distortion parameter.
        `Gold Prompt: low poly fire effect burning barrel flames smoke particles stylized apocalypse`

## 🗺️ 5. Fantastic City Generator (Conceptual Components)

* 1.  🏢 **Procedural Building Volume:** Bounding box primitive defining space. Populated by facade/roof/detail modules based on parameters (style, height, wealth).
    `Gold Prompt: procedural city building volume wireframe bounding box generator`
* 2.  <0xF0><0x9F><0x9A><0x9D>️ **Road Network Spline:** 3D spline defining road path, width parameter, intersection generation logic. Material slot for asphalt PBR.
    `Gold Prompt: procedural road network spline 3D path asphalt generator`
* 3.  🌉 **Bridge Module:** Parameterized geometry for bridge spans (arch, beam), support pillars, road surface connector. Snaps to road splines over gaps (like rivers).
    `Gold Prompt: procedural bridge module arch beam supports road generator`
* 4.  🏞️ **River Volume/Spline:** Spline defining river path, boolean geometry for carving terrain, water shader material slot.
    `Gold Prompt: procedural river spline water volume terrain carve generator`
* 5.  🚗 **Basic Traffic Vehicle:** Simplified car mesh primitive, parameterized color, basic wheel rotation, path-following agent behavior.
    `Gold Prompt: simple traffic vehicle low poly car path following agent generator`
* 6.  🌳 **Prop Placement Area:** Defined volume (e.g., park polygon) where prop assets (trees, benches) are scattered based on density/type parameters.
    `Gold Prompt: procedural prop placement area park scatter trees benches generator`

## 🚀 6. POLYGON - Sci-Fi Worlds Pack (Low Poly Style)

* ### 👽 Characters (Low Poly Style)
    * 1.  🤖 **Soldier Figure (Sci-Fi):** Low-poly humanoid mesh, material IDs for futuristic armor (clean PBR, faction color parameter), helmet/visor geometry. Rigged.
        `Gold Prompt: low poly sci-fi soldier futuristic armor faction colors helmet stylized`
    * 2.  👾 **Alien Figure (Rock Type):** Low-poly non-humanoid mesh, crystalline/rock PBR material, emissive eye slots. Rigged.
        `Gold Prompt: low poly sci-fi alien rock creature crystalline PBR stylized rigged`
    * 3.  👨‍🚀 **Space Suit Figure:** Low-poly bulky humanoid mesh, material IDs for suit fabric/panels, helmet with reflection parameter. Rigged.
        `Gold Prompt: low poly space suit figure bulky helmet reflection stylized sci-fi`

* ### 🎒 Character Attachments
    * 1.  🎒 **Jetpack:** Low-poly geometry, engine nozzle primitives, metallic/panel PBR, particle emitter points for thrust FX. Attaches to back slot.
        `Gold Prompt: low poly jetpack sci-fi engine nozzles metallic PBR stylized attachment`
    * 2.  🎭 **VR Visor:** Low-poly headset geometry, emissive lens material (parameterized color/pattern). Attaches to head slot.
        `Gold Prompt: low poly VR visor headset emissive lens pattern stylized sci-fi attachment`

* ### 🏢 Buildings (Faction Specific)
    * 1.  🏭 **Industrial Faction Wall:** Low-poly modular panel, heavy metal PBR (parameterized rust/wear), pipe/conduit details, snap connectors.
        `Gold Prompt: low poly sci-fi industrial wall heavy metal pipes rust modular stylized`
    * 2.  <0xF0><0x9F><0xAA><0xB2> **Sleek Faction Platform:** Low-poly smooth curved platform section, clean white/grey PBR, edge emissive strip (parameterized color), snap connectors.
        `Gold Prompt: low poly sci-fi sleek platform smooth white emissive edge modular stylized`
    * 3.  👽 **Alien Faction Structure:** Low-poly organic/crystalline shapes, bio-luminescent PBR material (parameterized pulse/color), non-standard connection logic.
        `Gold Prompt: low poly sci-fi alien structure organic crystalline bioluminescent modular stylized`

* ### ⚙️ Props
    * 1.  📦 **Sci-Fi Crate:** Low-poly box primitive, panel line details, metallic PBR with faction decal slot.
        `Gold Prompt: low poly sci-fi crate metallic panel lines faction logo stylized prop`
    * 2.  🖥️ **Holographic Display Table:** Low-poly table geometry, projected volumetric display effect (parameterized content), emissive base.
        `Gold Prompt: low poly sci-fi holographic display table volumetric projection emissive stylized prop`
    * 3.  💎 **Energy Crystal:** Low-poly sharp geometric crystal mesh, emissive PBR material (parameterized color/intensity), floating animation parameter.
        `Gold Prompt: low poly energy crystal sharp geometric emissive glow floating stylized sci-fi prop`

* ### 🌳 Environment
    * 1.  <0xF0><0x9F><0xAA><0xA8> **Alien Plant:** Low-poly strange organic shape, unusual PBR material (parameterized color/texture), optional animation (pulse/sway).
        `Gold Prompt: low poly alien plant strange organic pulsating texture stylized sci-fi environment`
    * 2.  <0xF0><0x9F><0xAA><0xB0> **Floating Rock Platform:** Low-poly rock mesh, standard rock PBR, anti-gravity particle effect emitter at base. Parameterized size/shape variation.
        `Gold Prompt: low poly floating rock platform anti-gravity effect particles stylized sci-fi environment`

* ### 🛸 Vehicles & Attachments
    * 1.  🛵 **Hover Bike:** Low-poly sleek chassis, handlebar controls, engine/repulsor primitives, PBR material (faction colors), particle emitter for trail FX.
        `Gold Prompt: low poly hover bike sleek sci-fi repulsors faction colors trail FX stylized vehicle`
    * 2.  <0xF0><0x9F><0x9A><0x9F>️ **APC (Armored Personnel Carrier):** Low-poly blocky vehicle, wheel/track primitives (or hover pads), armor panel details, turret attachment point.
        `Gold Prompt: low poly APC armored vehicle blocky turret sci-fi stylized vehicle`
    * 3.  💥 **Vehicle Turret Attachment:** Low-poly gun geometry (laser/projectile), rotating base primitive, attaches to vehicle turret slot.
        `Gold Prompt: low poly vehicle turret laser projectile rotating base sci-fi stylized attachment`

* ### 🔫 Weapons
    * 1.  🔫 **Laser Pistol:** Low-poly pistol shape, energy cell geometry slot, nozzle primitive for beam FX emitter, emissive PBR details.
        `Gold Prompt: low poly laser pistol energy cell emissive sci-fi stylized weapon`
    * 2.  <0xF0><0x9F><0xA7><0xA1> **Energy Sword:** Low-poly hilt primitive, beam blade geometry (emissive shader, parameterized length/color).
        `Gold Prompt: low poly energy sword hilt beam blade emissive lightsaber stylized sci-fi weapon`

* ### ✨ FX
    * 1.  💫 **Warp Tunnel Effect:** Animated mesh tunnel/particle system, space distortion shader, parameterized color/speed.
        `Gold Prompt: warp tunnel effect animated mesh particles distortion shader sci-fi FX`
    * 2.  ⚡ **Laser Beam:** Particle system or line renderer effect, bright core, glow parameter, impact particle system parameter.
        `Gold Prompt: laser beam effect bright core glow impact particles sci-fi FX`

## 🌍 7. POLYGON - Dungeons Pack (Low Poly Style)

* ### 😈 Characters (Low Poly Style)
    * 1.  <0xF0><0x9F><0xA7><0xB2> **Dwarf Miner Figure:** Low-poly stout humanoid, material IDs for beard (parameterized color), simple clothes, helmet (metal PBR). Pickaxe grip point. Rigged.
        `Gold Prompt: low poly dwarf miner figure beard helmet pickaxe stylized fantasy rigged`
    * 2.  💀 **Undead Knight Figure:** Low-poly skeletal mesh, material IDs for bone, rusted armor PBR. Glowing eye sockets (emissive parameter). Rigged.
        `Gold Prompt: low poly undead knight skeleton rusted armor glowing eyes stylized fantasy rigged`
    * 3.  🦸 **Hero Figure:** Low-poly adventurer archetype, material IDs for leather/cloth armor, hair. Weapon grip points. Rigged.
        `Gold Prompt: low poly hero figure adventurer leather armor sword stylized fantasy rigged`

* ### 🧢 Character Attachments
    * 1.  <0xF0><0x9F><0xAB><0x85> **Dwarven Beard:** Low-poly braided beard geometry, hair texture parameter. Attaches to face slot.
        `Gold Prompt: low poly dwarven beard braided long stylized fantasy attachment`
    * 2.  🤘 **Demon Horns:** Low-poly curved horn geometry, bone/chitin PBR material. Attaches to head slot.
        `Gold Prompt: low poly demon horns curved bone texture stylized fantasy attachment`

* ### 🧱 Environment & Modular Dungeon
    * 1.  🧱 **Dungeon Wall Section:** Low-poly stone block mesh, damp PBR material (parameterized moss/slime), optional torch holder attachment point, modular snap connectors.
        `Gold Prompt: low poly dungeon wall stone block damp mossy modular stylized fantasy`
    * 2.  <0xF0><0x9F><0xAA><0xA6> **Floor Grate:** Low-poly plane with cutout pattern geometry, rusted metal PBR, optional particle emitter below (steam/mist). Modular tile.
        `Gold Prompt: low poly floor grate metal rusted pattern modular steam stylized fantasy`
    * 3.  <0xF0><0x9F><0xAA><0xA8> **Spider Web:** Low-poly plane geometry with alpha texture for web strands, optional dewdrop particle effect. Corner/wall placement type.
        `Gold Prompt: low poly spider web alpha texture strands dew drops stylized fantasy environment`
    * 4.  🔥 **Lava Floor Tile:** Low-poly plane, PBR material with emissive cracks (parameterized color/intensity), heat distortion shader effect. Modular tile.
        `Gold Prompt: low poly lava floor tile emissive cracks glowing heat distortion modular stylized fantasy`

* ### 🏛️ Buildings (Exterior/Tents)
    * 1.  ⛺ **Nomad Tent:** Low-poly cloth geometry draped over pole primitives, weathered fabric PBR material (parameterized pattern/color).
        `Gold Prompt: low poly nomad tent cloth fabric weathered poles stylized fantasy building`
    * 2.  <0xF0><0x9F><0x97><0xBC>️ **Stone Archway:** Low-poly modular arch geometry, stone block PBR, optional keystone detail slot, snap connectors.
        `Gold Prompt: low poly stone archway modular blocks keystone stylized fantasy building`

* ### 🏺 Props
    * 1.  <0xF0><0x9F><0xAA><0x84> **Treasure Chest:** Low-poly box with lid primitive, wood/metal PBR materials (parameterized richness/wear), hinged lid parameter (open/closed state), optional glow FX inside.
        `Gold Prompt: low poly treasure chest wood metal bands locked glow stylized fantasy prop`
    * 2.  <0xF0><0x9F><0xAB><0xAD> **Wall Torch:** Low-poly holder geometry (rusted metal PBR), flame FX attachment point. Attaches to wall points.
        `Gold Prompt: low poly wall torch metal holder flame FX stylized fantasy prop`
    * 3.  🦴 **Bone Pile:** Low-poly collection of simple bone primitives, aged bone PBR material. Parameterized size.
        `Gold Prompt: low poly bone pile skulls various aged texture stylized fantasy prop`

* ### ⚔️ Weapons
    * 1.  <0xF0><0x9F><0xAA><0x93> **Dwarven Axe:** Low-poly axe head geometry (heavy, ornate), handle primitive, PBR materials (steel, wood, gold inlay parameter).
        `Gold Prompt: low poly dwarven axe heavy ornate steel wood gold inlay stylized fantasy weapon`
    * 2.  <0xF0><0x9B><0x84>️ **Magic Staff:** Low-poly wooden staff primitive, crystal geometry slot at top (emissive PBR, parameterized color), optional particle FX emitter.
        `Gold Prompt: low poly magic staff wood crystal orb glowing particle FX stylized fantasy weapon`

* ### ⛵ Vehicles
    * 1.  ⛵ **Sand Boat:** Low-poly boat hull geometry, sail plane geometry (cloth PBR), steering rudder primitive. Designed for sand/dune environment.
        `Gold Prompt: low poly sand boat hull sail rudder desert stylized fantasy vehicle`

* ### ✨ FX
    * 1.  ✨ **Gold Sparkle:** Particle system emitter, small bright yellow/gold particle texture, short lifespan, often used with treasure props.
        `Gold Prompt: gold sparkle particle effect bright shiny treasure stylized fantasy FX`
    * 2.  💨 **Steam Vent:** Particle system emitter, white/grey soft cloud texture, upward velocity parameter, often used with grates or lava.
        `Gold Prompt: steam vent particle effect white soft cloud upward stylized fantasy FX`

## 🏞️ 8. Polyquest Worlds Full Pack Vol.1 (Terrain Focus)

* 1.  ⛰️ **Cliff Mesh (Layered):** Polygonal mesh geometry representing cliff face. UV mapped for layered shader (base rock texture, secondary overlay texture like snow/moss, mask texture control). Vertex colors for blending.
    `Gold Prompt: polygonal cliff mesh layered shader rock snow moss blend PBR terrain`
* 2.  ⛰️ **Cliff Mesh (MultiMat):** Polygonal mesh geometry representing cliff face. Mesh faces assigned different Material IDs (e.g., rock, crevices, topsoil) for applying separate standard materials. Optimized for draw calls in some engines.
    `Gold Prompt: polygonal cliff mesh multi-material rock crevice topsoil optimized PBR terrain`
* 3.  <0xF0><0x9F><0xAA><0xB0> **Gravel Scatter Preset:** Prefab containing multiple small gravel stone meshes, randomized rotation/position within a boundary, optimized for scattering on terrain. PBR gravel material.
    `Gold Prompt: gravel scatter preset small stones randomized PBR terrain detail`
* 4.  🌳 **Ground Mesh (Layered):** Polygonal terrain plane mesh. UV mapped for layered shader (dirt, grass, path textures + mask). Vertex colors for blending.
    `Gold Prompt: polygonal ground mesh layered shader dirt grass path blend PBR terrain`
* 5.  <0xF0><0x9F><0xAA><0xA8> **Rock Mesh (Standard):** Standalone polygonal rock model. Standard UV layout for single PBR rock material (parameterized color, moss amount).
    `Gold Prompt: polygonal rock standalone PBR material mossy standard terrain asset`
* 6.  <0xF0><0x9F><0xAA><0xB1> **Stones Mesh (MultiMat):** Polygonal mesh representing smaller stones/pebbles. Faces assigned Material IDs (stone types, wetness) for multiple standard PBR materials.
    `Gold Prompt: polygonal stones pebbles multi-material different types wetness PBR terrain asset`
* 7.  🌊 **Ocean Plane:** Large plane geometry, complex water shader material (parameterized waves, foam, depth color, reflections, refraction).
    `Gold Prompt: ocean plane large water shader waves foam depth reflections PBR environment`
* 8.  <0xF0><0x9F><0xAA><0xA8> **Skybox Texture:** Set of 6 textures (cubemap) for environment background. Parameterized time of day (e.g., Day, Sunset, Night variants).
    `Gold Prompt: skybox cubemap texture clear day sunset night atmospheric environment`

## 🛋️ 9. Hazelwood Loft (Photo-real Optimized)

* 1.  <0xF0><0x9F><0xAA><0x91> **Modern Sofa:** Optimized low-poly mesh, clean lines. High-res PBR fabric texture (color parameter), normal map for subtle folds/details, baked Ambient Occlusion map.
    `Gold Prompt: modern sofa low-poly PBR fabric normal map baked AO photoreal optimized`
* 2.  <0xF0><0x9F><0xAA><0x91> **Coffee Table:** Optimized low-poly mesh (wood/glass primitives). PBR materials (parameterized wood grain, glass reflection/refraction).
    `Gold Prompt: modern coffee table low-poly PBR wood grain glass reflection photoreal optimized`
* 3.  💡 **Floor Lamp:** Optimized low-poly stand/shade geometry. PBR metal/fabric materials. Light component source (parameterized intensity/color/temperature).
    `Gold Prompt: modern floor lamp low-poly PBR metal fabric light source photoreal optimized`
* 4.  🧱 **Interior Wall Section:** Optimized plane primitive. High-res PBR material (paint/wallpaper - parameterized), normal map for subtle texture, UVs tiled appropriately. Sockets for light switches/outlets (detail meshes).
    `Gold Prompt: interior wall plane low-poly PBR paint wallpaper normal map photoreal optimized`
* 5.  🖼️ **Picture Frame:** Optimized low-poly frame geometry, glass plane primitive. Material slot for artwork texture (parameterized). PBR frame material (wood/metal).
    `Gold Prompt: picture frame low-poly PBR wood metal glass artwork slot photoreal optimized`
* 6.  <0xF0><0x9F><0xAA><0x9F> **Window Frame:** Optimized low-poly geometry. PBR material (wood/vinyl). Glass pane primitive with PBR glass material (parameterized dirt/smudges).
    `Gold Prompt: window frame low-poly PBR wood vinyl glass pane dirt photoreal optimized`
* 7.  🏙️ **Surrounding City Backdrop:** Highly optimized, low-poly distant building meshes. Facade textures baked into atlas. Emissive map for night windows (parameterized on/off state or pattern). Designed for exterior views through windows.
    `Gold Prompt: distant city backdrop highly optimized low-poly facade atlas emissive night windows background`
* 8.  <0xF0><0x9F><0xAA><0xA8> **4K Skybox (Day/Night):** High-resolution cubemap textures for day and night scenes, matched perspective for window reflections. Parameterized transition/blending capability.
    `Gold Prompt: 4K skybox cubemap day night matched reflections photoreal environment`



## 📂 File Cast & Roles

- **`app.py`** — 🧑‍✈️ **The Conductor**  
  Orchestrates Streamlit:  
  - Loads per‑plot CSVs (your saved “tiles”)  
  - Fetches the **GameState vault**  
  - Injects everything into the browser  
  - Listens for your “💾 Save” click and hands new objects off to both the plot‑file writer **and** the GameState vault

- **`gamestate.py`** — 💼 **The Vault**  
  A thread‑safe singleton that:  
  - On startup, reads `world_state.csv` → `world_state[]`  
  - On update, merges in new objects by `obj_id` and writes back to `world_state.csv`  
  - Serves as the **shared truth** for everyone who joins

- **`index.html`** — 🎭 **The Stage**  
  Three.js world where:  
  - Injected arrays (`ALL_INITIAL_OBJECTS`, `PLOTS_METADATA`, `GAME_STATE`) arrive as `window…` variables  
  - Ground tiles and objects are rendered from those arrays  
  - Local clicks spawn new objects into a **sessionStorage** “back‑pocket” until you hit Save  
  - A tiny 5 s timer peeks at `window.GAME_STATE` so you can see others’ updates in near‑real time

- **`requirements.txt`** — 🛠️ **The Toolbox**  
  Lists exactly the small helper you need (`streamlit_js_eval`) to bridge JS ↔️ Python

---

## 🔄 How State Sticks

1. **Persistent CSVs**  
   - **Per‑plot files** (`plot_X3_Z2.csv`) hold each tile’s snapshot  
   - **Global file** (`world_state.csv`) holds the universal list of all objects

2. **In‑Memory Caching**  
   - `@st.cache_data` for plot metadata (avoids re‑reading disk for 1 h)  
   - `@st.cache_resource` for the GameState singleton (one vault, never re‑instantiated)

3. **Browser Session Storage**  
   - Unsaved objects live in `sessionStorage` so you don’t lose placements on refresh  
   - Cleared only when you “Reset” or after a successful Save

4. **JS ↔️ Python Bridge**  
   - JS `getSaveDataAndPosition()` → returns your new objects + player coords as JSON  
   - Streamlit parses that, writes CSV, merges vault, clears caches, and **reruns** to inject the fresh state back into the Stage

---

## 🌊 Flow of Play (Intuition)

1. **Boot Up**  
   - Conductor (`app.py`) reads all the saved chunks → tells the Stage (`index.html`) “Here’s what’s out there!”

2. **Explore & Build**  
   - You walk around (WASD) and click to place “House🌳Rock🏠Tree”  
   - New pieces go into your **back pocket** (`sessionStorage`)—invisible until saved

3. **Save the Day**  
   - Hit “💾 Save” → Conductor grabs your pocket’s contents  
   - Vault (`GameState`) merges them into the master record  
   - Plot files get updated so new visitors see your work

4. **Collaborate in Near‑Real Time**  
   - Every 5 s the Stage peeks at `window.GAME_STATE`  
   - You see newcomers’ additions pop in without a full reload

✨  a tiny toolbox keep a **persistent**, **shared**, **interactive** 3D world humming! 🎉```




- 🐍 **Python Startup**  
  - 📂 `load_plot_metadata()` → scan `saved_worlds/` for `plot_X…_Z…csv` (cached)  
  - 📑 `load_plot_objects()` → read CSV → build `ALL_INITIAL_OBJECTS`  
  - 🔒 `get_game_state()` → singleton `GameState` → load/hold `world_state.csv`  
  - 🚀 Inject → `ALL_INITIAL_OBJECTS`, `PLOTS_METADATA`, `GAME_STATE` into `index.html`

- 💾 **Save Flow**  
  - 🖱️ User clicks “💾 Save” → JS `getSaveDataAndPosition()` → returns JSON payload  
  - 🔄 Py parses → computes `plot_X…_Z….csv` → `save_plot_data()` writes per‑plot file  
  - ➕ `game_state.update_state()` merges into `world_state.csv`  
  - 🔁 `load_plot_metadata.clear()` + `st.rerun()` → refreshed state

- 🌐 **Three.js Init**  
  - 🌟 `init()` → scene, camera, lights  
  - 🛤️ `setupInitialGround()` → one plane per saved plot (or at 0,0)  
  - 👤 `setupPlayer()` → capsule mesh at center  
  - 📦 `loadInitialObjects()` → instantiate all persisted objects

- 🎮 **Interaction & Local State**  
  - 🖱️ `onDocumentClick()` → raycast → spawn `House/Tree/Rock…` → add to `newlyPlacedObjects`  
  - 💾 `saveUnsavedState()` → persist `newlyPlacedObjects` to `sessionStorage`  
  - 🔄 `restoreUnsavedState()` on reload → rehydrate unsaved objects  
  - 🗑️ `resetNewlyPlacedObjects()` → clear sessionStorage

- ⏩ **Game Loop**  
  - 🔑 `onKeyDown`/`onKeyUp` → track WASD/Arrows  
  - 🚶 `updatePlayerMovement()` → camera‑relative walk + `checkAndExpandGround()`  
  - 🌱 `checkAndExpandGround()` → add placeholder planes around player  
  - 📽️ `animate()` → movement, camera lerp, `renderer.render()`

- 🔄 **Collab Sync**  
  - ⏲️ `setInterval(pollGameState, 5000)` → logs or applies updated `window.GAME_STATE`  

✨ **All set!** end‑to‑end state protocol.