Bird Window
Screenshot saved!

🌿 Garden View Ecosystem

A living, breathing ecosystem designed for relaxation and observation. Birds perch for 6+ minutes, hop on ground for 2+ minutes, and display calm, natural behaviors. This is slow, contemplative birdwatching - perfect for unwinding.

⚡ Quick Start

  • Click/Tap: Drop food for birds (they investigate 80% of the time!)
  • Info button (ℹ️): See ecosystem stats, toggle clock display, and access settings
  • Window Sill (🪟): Enable window frame for cozy indoor POV. Birds land on the sill 3x larger and face you!
  • Click Sill Birds: Make them chirp melodies note-by-note! Each hour brings a new song
  • Curtains (🎀): Add interior curtains in random colors. Click curtains to adjust them
  • Quiet Mode (🤫): Reduce chirping by 80% for peaceful ambiance
  • Clock toggle: In info panel, enable real-time clock with weather forecast
  • Diary toggle: View your garden's story and bird families
  • Be patient: Birds spend most time perched or on ground. Watch them settle and relax!

Want to know more? Expand the sections below:

🐦 Bird Behavior Systems
  • States: Birds transition between Flying, Perched, Hopping, Pecking, Bathing, Sleeping, Feeding babies, Building nests, and Fleeing
  • Relaxing behavior: Birds perch for ~6 minutes, sleep for ~2.5 minutes, hop on ground for ~2 minutes, and only fly for brief 5-second bursts between locations. This creates a calm, contemplative atmosphere.
  • Perching: Birds can perch anywhere on trees including all throughout the green leafy canopy (25 positions per tree). They settle comfortably and stay for long periods.
  • Ground life: Birds land and stay on ground for hopping, pecking (~20 seconds), and feeding (~30 seconds). They forage naturally with visible, relaxing ground behaviors.
  • Sleeping: Birds fall asleep at night while perched, showing floating "ZzZz" above them. They wake at dawn or if danger approaches
  • Player food priority: Birds investigate player-added food 80% of the time, even when not hungry! This helps attract birds to specific areas.
  • Nesting: Non-wild birds collect twigs to build nests in trees. Special golden twigs speed up construction
  • Parenting: Adult birds feed hungry baby birds, prioritizing critically hungry ones
  • Flocking: Birds of similar types recognize each other and coordinate behaviors
🎵 Musical Chirping & Communication
  • Musical voices: Each bird has a unique voice (Melodic, Bright, Exotic, or Songbird)
  • Musical scales: Chirps use pentatonic, major, and minor scales for pleasant sounds
  • Ambient chirping: Birds chirp randomly while perched or idle
  • Visual notes: Musical notes appear above chirping birds
  • Chirp types:
    • 🎵 Social - General communication
    • 🌽 Food Call - "Found food here!"
    • 📞 Contact Call - "Where is everyone?"
    • ⚠️ Alert - Warning of danger
    • 🏆 Victory - Won a territorial dispute
    • 🛡️ Territorial - Defending territory
  • Synchronized chirping: Social chirps can trigger nearby birds to chirp back
  • Mute button: Available in info panel (🔊/🔇)
🌳 Trees & Environment
  • Tree lifecycle: Trees live for 6.5 in-game days (~26 min), age gracefully, produce flowers, and eventually fall. New trees regrow dynamically
  • Dynamic spawning: Trees spawn faster when sparse (every 3 min), slower when dense (every 8 min). Full ecosystem takes 1-2 hours
  • Spawn variety: Trees can spawn as singles (58%), pairs (25%), clusters (5%), or rare "Forest Bloom" events (2%) with 5-7 trees at once!
  • Special tree types: 15% chance for rare variants (Birch, Cherry, Willow, Oak, Pine, Maple, Aspen) with unique colors. Time of day affects which types spawn!
  • Rare tall trees: 2% spawn as majestic tall variants - 33% taller with thicker trunks and more branches for extra perching spots
  • Special Starting Scenarios (5% chance - rare!):
    • 🌳 Ancient Garden - One magnificent elder tree
    • 🌱 Baby Forest - 12-15 young saplings
    • 🌲 Twin Giants - Two ancient guardians
    • ✨ Sacred Grove - 6-8 trees in mystical circle
    • 🍎 Orchard - 7-9 trees in neat row
    • 🌲 Wild Wilderness - 15-19 dense trees
    • 🎋 Zen Garden - 3 perfect trees in balance
    • 🛤️ Enchanted Path - 8-11 trees forming avenue
    • 🌿 Cluster Chaos - 3 competing groves
    • 🏔️ Mountain Peaks - Trees rising like mountains
    • 🪞 Mirror Grove - Perfect symmetrical reflection
    • 🏜️ Desert Oasis - Precious life in vast emptiness
    • 💨 Storm Survivors - Windswept trees bent by gale
    • 🏛️ Ancient Ruins - Temple pillars with new growth
  • Perching positions: Each tree offers 25 perching spots throughout its canopy, including all through the leafy areas
  • Perching preferences: Birds prefer shelter during rain/night, healthy trees during day
  • Branch traversal: Squirrels can jump between nearby trees
  • Flowers: Appear on healthy trees during the day, attract butterflies
💧 Water Systems & Ponds
  • Puddles: Form during rain, birds bathe in them, evaporate over time
  • Ponds: Permanent water sources (10% chance to spawn on load or after 5 rains)
  • Koi fish: Swim in ponds in 8 traditional colors (orange-red, gold, crimson, brown, slate grey), get excited when birds approach, and may jump out of water!
  • Frogs: Live near ponds, jump away from birds, croak warnings, catch ants
  • Bird interactions: Birds visit ponds to drink and bathe, can hop below ground to reach them
🐿️ Squirrels & Ground Creatures
  • Squirrels: Wander, forage for nuts, climb trees, jump between branches
  • Nest raiding: Squirrels may damage bird nests if they share a tree
  • Bird interactions: Birds may chase squirrels from trees
  • Ants: Form colonies at ant hills, forage for food, frogs hunt them
  • Worms: Emerge from ground, more active at night and after rain
🦉 Nocturnal & Predators
  • Owls: Hunt rats at night, may deliver gameboy after day 30
  • Rats: Scavenge on the ground, flee from owls and birds
  • Rat Kings: Rare, larger with crown, attract more rats and owls
  • Crows: Visit when worm population exceeds 30
☁️ Weather & Time
  • Day/Night cycle: ~4 minutes per full cycle (perfectly balanced!)
  • Rain: Spawns puddles and worms, birds seek shelter
  • Thunder: Can occur during heavy rain with lightning strikes
  • Rainbow: Rare, appears after rain with right conditions
  • Weather Forecast: 3-icon forecast in clock display with 95% accuracy
  • Sky gradient: Smooth 3-color gradients for atmospheric perspective
  • Night behaviors: Worms emerge, owls hunt, birds sleep and shelter in birdhouses
🏠 Birdhouses & Shelter
  • Construction: Birds build birdhouses similar to nests using twigs
  • Shelter: During rain or night, birds seek birdhouses for protection
  • Capacity: Multiple birds can shelter together
  • Behavior: Birds sleep inside, emerge at dawn
📖 Garden Diary
  • Auto-Generated Story: Click the 📖 button in info panel to view your garden's history
  • Event Chronicle: Major moments automatically recorded (births, nests, weather, visitors, special scenarios)
  • Special Scenario Tracking: If your garden starts with a special scenario, it's automatically recorded in the diary with full description
  • Bird Lineages: Birds receive names and track family generations (Ruby → Ruby Jr. → Ruby III)
  • Timeline View: See your garden's story unfold day by day
  • Family Trees: Watch bird families grow across generations
  • Milestone Tracking: First nest, pond formation, rare birds, and special events recorded
🪟 Window Sill & Curtains
  • Window Sill Frame: Toggle in info panel (🪟) to display a cozy window frame at screen edges. Creates a "looking out the window" perspective!
  • Sill Perching: Birds can land on the window sill (up to 3 birds at once). Sill birds are 3x larger and face forward toward you with adorable frontal view!
  • Interactive Musical Clicks: Click awake sill birds to make them chirp the next note in a melody sequence. Each hour features a different song from 24 classic melodies (same as hourly chimes). Shows music notes (♪♫🎵🎶) 70% of the time and cute emojis (💕✨😊) 30% of the time!
  • Head Turning: Sill birds naturally look around, turning their heads left and right. When turned far enough, you see their side profile with one eye visible!
  • Sleeping Sill Birds: Birds can naturally fall asleep on the sill, showing closed eyes and floating ZZZ emojis (💤😴). Click sleeping birds to startle them - they show "!" and fly away!
  • Smooth Transitions: Birds smoothly transition between flying (side view) and sill perching (frontal view) with rotation and scaling animations over 1 second
  • Anime-Style Eyes: Sill birds have very large pupils with minimal white showing for an adorable anime aesthetic
  • Curtains: Toggle in info panel (🎀) to add interior curtains. Curtains are randomized in color (12 schemes) and position each time. Click curtains to cycle through: random → even → closed → random
  • Layering: Birds appear under curtains (as if inside the house) for proper depth perspective
  • Quiet Mode: Toggle 🤫 in info panel to reduce ambient bird chirping by 80% for a more peaceful atmosphere
🎮 Special Features & Easter Eggs
  • Special Starting Scenarios: 5% chance (rare!) to start with a unique garden setup! A roguelite-style popup announces your scenario - 14 unique setups including Mountain Peaks, Mirror Grove, Desert Oasis, Ancient Ruins, and more! Auto-fades after 10 seconds or click to dismiss. Recorded in diary!
  • Real-Time Clock & Forecast: Toggle in info panel for a large transparent 24-hour clock with weather forecast. Birds perch on numbers! Clock chimes hourly with different melodies.
  • Gameboy: After day 30, an owl may deliver a magical gameboy. Click it to visit a 1-bit window game!
  • Mushroom Mode: Psychedelic visual mode with rainbow colors and bird trails. Find the magic mushroom to unlock!
  • Wind Chimes: 10% chance to spawn hanging from trees. Make soothing sounds when birds perch nearby. Owl delivers replacement if tree falls (after 15 days).
  • Scarecrow: Birds avoid scarecrows. Stays for 1 day/night cycle
  • Butterflies: Flutter peacefully through the garden near flowers
  • Screenshots: Capture special moments with the 📷 button
💡 Tips & Strategies
  • Patience is key: Birds now spend 6+ minutes perched and 2+ minutes hopping. This is a slow, contemplative experience - perfect for relaxing!
  • Attracting birds: Click to drop food anywhere. Birds investigate player food 80% of the time, even when not hungry, so you can guide them to favorite spots
  • Watch the canopies: Birds can perch anywhere in the leafy green areas - look for them throughout the entire tree, not just on branches
  • Ground activity: Birds land and stay on ground for extended periods. Watch for hopping, pecking, and feeding behaviors that last 20-120 seconds
  • Rare discoveries: Keep an eye out for rare colored birds (1.5% chance) and tall trees (2% spawn). They're automatically noted in your diary
  • Nest success: Keep trees healthy, scatter twigs, minimize squirrel interference
  • Baby bird survival: Adult birds will feed babies automatically if food is available
  • Ecosystem balance: Too many rats? Wait for owls. Too many worms? Crows will visit
  • Debug controls: Triple-click top of screen to access spawning, weather, and testing tools
🛠️ Crash Debugging & Recovery
  • Automatic Recovery: The simulation now has built-in crash recovery. If an error occurs, it will attempt to recover automatically.
  • Crash Log: Press Shift+L at any time to view the crash log in the console. This shows all errors with timestamps and context.
  • Persistent Logging: Crash logs are saved to localStorage and survive page refreshes, perfect for debugging overnight runs.
  • Health Monitoring: The simulation monitors its own health (FPS, heartbeat) and logs warnings if performance degrades.
  • Memory Protection: Automatic cleanup of debug logs and other data structures prevents memory leaks during long runs.
  • Console Tips: Open browser DevTools (F12) before overnight runs to see real-time health status and catch any issues.
  • Recovery Limit: After 10 consecutive crashes, the simulation will stop to prevent browser freezing. Check the crash log for patterns.
✨ Special Events & Phenomena
  • Meteor Showers: Rare nighttime celestial events with streaking meteors. Birds become alarmed and may take shelter!
  • Solar Eclipse: Extremely rare daytime event where the sky darkens gradually. Birds become confused during totality!
  • Migration Waves: Flocks of 10-15 birds pass through in V-formation or straight lines, flying across the sky
  • UFO Encounters: Very rare nighttime visitors! UFOs may beam up birdhouses, scarecrows, or ants:
    • Birdhouses & Scarecrows: Returned after 10-20 seconds with green glow effect
    • Ants: Transformed into giant glowing ants! Remain giant for 3 days, then revert to normal size but keep the glow
  • Double Rainbows: 1% chance after rain for a spectacular double rainbow with reversed color order!
  • Mushroom Mode Events: All special events have psychedelic rainbow versions when mushroom mode is active!
🌟 Nighttime Wonders
  • Fireflies: Glowing insects appear on 10% of nights. Birds can hunt and catch them for food!
  • Pulsing Glow: Fireflies have a gentle pulsing light effect as they flutter through the air
  • Dawn Departure: All fireflies disappear when the sun rises
  • Owl Activity: Owls hunt during firefly nights, creating a living nighttime ecosystem
🍄 Advanced Ecosystem Mechanics
  • Food Caching: Squirrels and crows cache food for later (3-day lifespan). Rats can dig up these caches!
  • Nest Degradation: Abandoned nests decay 2-4x faster based on how long they've been empty
  • Mushroom Clusters: Non-magic mushrooms spawn near trees after rain (40% chance), age out after 5 minutes
  • Fallen Branches: Squirrels occasionally knock branches from trees while foraging. These become available twigs!
  • Pond Drinking: Birds visit ponds to drink water, not just to bathe
  • Rare Color Variants: 1.5% of birds spawn with special colors: Albino, Melanistic, Golden, Azure, Rose, or Emerald! Extremely rare combo birds (~0.3%) combine two colors! Each rare bird is automatically noted in your garden diary.
🔔 Wind Chimes
  • Spawn Chance: 10% chance for wind chimes to appear at game start (hanging from trees)
  • Owl Delivery: After day 15, owls may deliver wind chimes at night
  • Visual Design: Metallic chimes with 4-6 tubes that sway gently in the breeze
  • Musical Sounds: Chimes play pleasant notes every 15-45 seconds (realistic timing, mute button compatible)
  • Creature Interactions: Birds, squirrels, rats, and owls trigger chimes when passing through
  • Tree Dependency: Falls gracefully if tree disappears, owl may deliver replacement after 15 days
  • Aesthetic: Adds calm, meditative atmosphere to your garden
📋 Recent Major Updates
  • V40.1 - Crash Prevention & Recovery (LATEST): Major stability improvements for overnight runs! Added comprehensive crash logging system with persistent localStorage storage (Shift+L to view). Automatic error recovery in main game loop prevents crashes from stopping simulation. Memory leak fixes for debug log throttling. Simulation health monitoring with heartbeat detection. All errors are now caught, logged with full context, and recovered from automatically. Perfect for leaving the simulation running overnight!
  • V40 - Ultimate Chill Overhaul: Birds now truly relaxed! Perch throughout entire tree canopies (25 spots per tree), land and stay on ground with proper thresholds (30px), enforced ground positioning prevents drift. Extended behavior durations: 6min perched, 2.5min sleeping, 2min hopping, 30s feeding, 20s pecking, 5s flying. Player food gets 80% investigation priority even when not hungry. Rare birds (1.5%) auto-noted in diary. Rare tall trees (2% spawn, 33% taller). Fixed screenshot function and wind chime timing. This is the calm, contemplative bird experience!
  • V39 - Behavior & Duration Fixes: Fixed critical bug where MIN_STATE_DURATION overrode flying time. Extended all behavior durations for visibility. Birds now display natural, observable behaviors instead of rapid state-switching.
  • Sleep System & Visual Polish: Birds sleep at night with floating "ZzZz", 8 colorful koi varieties, 95% accurate weather forecasts, smooth sky gradients, baby bird hover info, perfected camera centering
  • Special Events & UFO System: Meteor showers, eclipses, migration waves, and UFO encounters! All with mushroom mode support.
  • Fireflies & Night Life: Glowing fireflies appear on some nights, creating a magical nighttime ecosystem.
  • Advanced Mechanics: Food caching, nest degradation, mushroom clusters, fallen branches, and rare bird color variants!
  • Hourly Musical Chimes: When clock is enabled, birds sing a different melody every hour from a rotating playlist of 24 songs. No repeats until all 24 are played!
  • Garden Diary System: Complete narrative tracking with auto-generated story entries, bird naming system with 80 names (nature + people), family lineage tracking across generations, and timeline view of major events.
  • 24-Hour Clock Display: Clock now shows 24-hour format without AM/PM, double-sized for better visibility. Birds can perch on the massive numbers, which become more opaque when occupied.
  • Real-Time Clock & Weather Forecast: Large transparent clock in the sky with 3-icon weather forecast. Birds perch on clock numbers! Includes max history tracking for ponds, frogs, koi, and birdhouses.

Relax. Watch. Enjoy. 🌿