KAZIK/docs/world-pool-v4.md

Native world and billiards update

All game code in this update is x86 MASM. Python only packs artwork and checks framebuffers. Existing C# launchers are packaging utilities, not the game engine.

Street

• The camera walks on the north pavement after crossing from the alley.
• Traffic waits for the crossing and continues from its stopped position.
• Only the two entrance guards remain. Road objects no longer use guard sprites.
• The avenue continues through an intersection into staggered city blocks. No distant building spans the entire road.
• Per-pixel depth of distant buildings survives foreground depth preparation.
• Seven storeys share one roof/texture projection and taller floor spacing.
• Walking pedestrians, benches, hydrant, mailbox, newspaper box, bollards, planter, parking meter and fence use separate depth-tested sprites.

Casino

• The bar can be activated from its entire serving edge, but not from staff space.
• Highball, red cocktail and water use separate preparation and drinking frames.
• Cabaret has physical stage sides, back curtain, wings, steps and a truss. Its former full-stage billboard is not drawn. Players cannot enter the stage.
• Native regression checks verify visitor anchors are not inside map walls.

Billiards

• Click or drag on the cloth to aim; left/right arrows refine the direction.
• Click or drag the force slider, or use up/down arrows, before shooting.
• Space or the Shot button uses the selected power without wrapping its value.
• The aim guide uses Q16.16 consistently with the cue and physics positions.
• Balls are captured only within visible 8-pixel pocket mouths. Corner jaws and cushion openings agree with these mouths; outer bounds prevent escaped balls.
• Potted balls visibly sink, then remain in a tray. A scratched cue is placed through the normal ball-in-hand mode instead of being silently discarded.
• A break eight is re-spotted with full ball-diameter clearance.

Offline validation

tools/tests/world_regression.inc exercises the complete camera/car route, front/staff bar access, stage collision, six pocket approaches, force input and 100 different-angle/different-force breaks through actual native functions. tools/tests/check_hall_frames.py checks new packs and sixteen native frames, including three distinct drinks. Screenshots are in build/actions.

Art

Built-in image_gen generated the versioned sources in assets/sprites/hall. Prompts: assets/sprites/hall/prompts-v4.json. Observed atlas gutters, true alpha, common scales and foot anchors are normalized by pack_world_v4.py.