🐶 Obi's Farm Adventure — 3D

A charming 3D farm game where you catch Obi the dachshund before he catches the chickens!

Built with Three.js — pure procedural 3D geometry, no external assets needed. Runs in any modern browser, desktop or mobile. Designed for ages 5+.

A fully procedural 3D farm built entirely from Three.js primitives — no image textures, no model files.

• Long brown body, floppy ears, red collar — bigger for visibility
• Floating red exclamation marker bobs above his head, visible from far away
• AI state machine: wander → chase (nearest chicken) → flee (from player) → tagged (stunned)
• Legs animate, tail wags, ears flap when running
• Gets stunned for 4 seconds when tagged (tail still wags!)
• Red ring on mini-map when chasing, yellow when fleeing, green check when tagged

• ❤️ Heart particles float above safe chickens (occasional + on tag)
• 😢 Sad face icons appear above caught chickens
• Caught chickens sit low with head down

• Black body with white stripe and bushy tail
• Appears at evening from a random edge of the farm
• Green stink cloud follows it — gets bigger and denser when ready to spray
• Raises tail straight up before spraying (warning!)
• 3-second stun + score penalty if sprayed
• 8-second cooldown between sprays
• Wanders peacefully when player is far away

• Farm kid with straw hat, red shirt, blue overalls, brown boots
• Third-person camera that smoothly follows with orbit-style positioning
• Camera auto-rotates toward Obi when he's chasing and far away
• Walking and running animations with arm/leg swing
• Sprint dust trail particles when running
• Yellow ring appears when close enough to tag Obi

All sounds are procedurally generated with Web Audio oscillators — no audio files needed.

A 2D radar canvas in the bottom-right corner showing:

When you win (tag Obi 3 times), the game doesn't just show a screen — it celebrates:

1. 🎵 Win fanfare plays (C-E-G-C)
2. 🎉 80 confetti particles burst from the player position
3. 🐔 All safe chickens hop up and down
4. 🐶 Obi rolls over (spinning animation)
5. ❤️ Heart particles float from chickens
6. 🏆 Win screen appears after 2.5 seconds with score, chickens saved, and time

npm install
npm run dev      # dev server at localhost:5173
npm run build    # production build to dist/
npm run preview  # preview production build

obi-farm-3d/
├── src/
│   ├── main.js       # Game loop, states, HUD, day/evening cycle, all integrations
│   ├── World.js      # Farm environment (terrain, trees, coop, fence, arch, decor)
│   ├── Player.js     # Farm kid character + third-person camera + controls
│   ├── Obi.js        # Dachshund AI (wander/chase/flee/tagged) + exclamation marker
│   ├── Chicken.js    # 6 chickens with wandering/fleeing behavior + names
│   ├── Skunk.js      # Skunk with evening appearance + spray mechanic
│   ├── Sound.js      # Procedural Web Audio sound effects (7 sounds)
│   ├── Effects.js    # 7 particle systems (feathers, hearts, sad faces, stink, dust, confetti, fireflies)
│   ├── MiniMap.js    # 2D radar canvas with entity tracking
│   └── Visual.js     # Visual polish: toon gradient, sky dome, blob shadows, outlines, pollen, wind
├── index.html        # Game UI, HUD, touch controls, overlays
├── package.json
└── vite.config.js

• Target audience: Ages 5+ — simple controls, bright colors, friendly characters
• Session length: ~2 minutes per round (20s morning + 25s afternoon + evening)
• Win condition: Tag Obi 3 times
• Lose condition: Obi catches 3 chickens
• Skunk adds evening tension — player must balance chasing Obi with avoiding the skunk
• No violence, no scary content — Obi gets stunned, chickens sit down sadly, skunk sprays with comedic effect
• Mobile-first touch controls — joystick, sprint button, tap-to-tag
• Everything is procedural — no downloads, no asset loading, instant play

Screenshots are in the screenshots/ directory, captured via Playwright headless Chromium with SwiftShader WebGL2.

Built 2026-06-19 — A 3D farm adventure for young players. v1.0.0: Core game · v2.0.0: 10 GUI improvements · v3.0.0: 10 visual polish upgrades