🚜 Blossom Valley – A 3D Farming Simulator

Experience the joy of cultivating your own patch of paradise: clear obstacles, sow seeds, raise animals, build relationships, and watch your world flourish through seasons, weather, and time.

---

🌾 Land & Cropping

Obstacle Clearing

• Woody Stumps: Remove with an Axe
• Rocks: Break with a Pickaxe
• Weeds: Dig up with a Shovel

Clearing returns usable space and may yield resources (wood, stone, fibers).

Soil Preparation

Use a Hoe to till cleared land into Farmable Soil. Tilled tiles register in the Land System, track watering status, and accept seeds.

Planting & Growth Lifecycle

• Seed Placement: Plant seeds into hoed soil.
• Watering Mechanics:
  • Watering Can: Apply water to trigger seedling growth timer.
  • Ongoing watering advances growth stages.
  • Neglect leads to wilted crops.
• Growth States: Seed → Seedling → Harvestable → Regrowth (if applicable)
• Regrowable crops (e.g., Tomato) yield again after watering/time.

Land System Integration

Manages tile states (Untilled, Tilled–Dry/Wet, Planted, Wilted), reacts to rain, triggers visual/UI events, and supports save/load.

---

🐄 Animal Husbandry

Egg Incubation & Hatching

• Place Eggs in incubators to hatch Chicks after a set time.
• Stages: Empty → Incubating → Ready → Chick appears.

Chick → Chicken Growth

• Feed Chicks daily to grow into Chickens.
• Chickens lay Eggs periodically.

Relationship & Mood

• Daily interaction and feeding improve Mood and Fondness.
• Neglect leads to Grumpy animals and slower productivity.

---

🏘️ Town & NPC Relationships

Social Hub

Explore the town, meet NPCs, and observe their daily schedules.

Dialogue & Gift System

• Typewriter-style dialogues, gift preferences (Like/Dislike/Neutral).
• Birthday gifts yield bonus friendship points.

Character Unlocks & Events

Build friendships to unlock festivals, cutscenes, and NPC behavior changes.

---

🛒 Commerce & Economy

Shop System

• Buy seeds, tools, feed, and decor from town shops.
• Stock varies by season and NPC friendship.

Shipping Bin (Selling)

• Drop off items during the day.
• Items are shipped and money added next morning.

---

📅 Calendar & Time System

Time Flow

• Minutes → Hours → Days → Weeks → Months → Seasons → Years
• Seasons affect crops, NPC schedules, and weather chances.

Calendar UI

• Displays birthdays, festivals, and season changes.
• Supports interactive navigation and time skipping.

---

🌦️ Weather System

Rain Events

• Rain may occur randomly or on special days.
• Waters crops automatically and affects NPC behavior.
• Includes VFX and ambient SFX.

---

💾 Save & Load System

• Fully captures farm state, inventory, animals, weather, NPC relations, and time.
• Supports JSON/binary serialization via DTOs.
• Manual and auto-save options available.

---

🎮 Player & Interaction Systems

• 3D movement with camera follow and smooth controls.
• Tools include Axe, Pickaxe, Shovel, Hoe, Watering Can, and more.
• Quick-select wheel for rapid tool/item switching.
• Prompt-based interactions for NPCs, animals, crops, and objects.

---

🖥️ UI & Dialogue

Core UI Panels

• Inventory, Calendar, Stats, Shop, Shipping Bin, Animal Info, and Dialogue Panels.
• Typewriter dialogue with portraits and options.

HUD Elements

• Tool icons, watering gauge, day/night indicator, weather icons, interaction prompts.

UI Architecture

• MVC pattern with Observer/Event-driven updates.

---

🔊 Audio & Sound

• Centralized SoundManager (singleton pattern).
• Categories: UI, tools, rain, animals, etc.
• BGM loops and ambiance with smooth transitions.
• Volume controls available in settings.

---

🔧 Architecture & Code Concepts

• MVC (Model-View-Controller): Data separation and UI logic (e.g., Inventory).
• Observer/Event Pattern: Time-based systems like crops and animals.
• Singleton Pattern: Used for sound, time, weather systems.
• State Pattern: Crop and animal lifecycle transitions.
• Factory & Object Pooling: Efficient spawning (e.g., crops, chicks).
• ScriptableObjects & Enums: Config-driven logic and data typing.
• Dependency Injection & Interfaces: Decoupled time listeners, modular logic.
• Encapsulation & Namespacing: Organized, safe code access.
• Coroutines: Used for timers (e.g., growth, rain, hatching).
• Collections & DTOs: Lists, dictionaries, and serialized save data.

---

📝 A Note on the Journey

Building Blossom Valley has been a labor of love—combining relaxing farming loops with robust, data-driven architecture that balances performance and extensibility. Every system is designed for:

• Maintainability: Clean MVC, Observer/Event patterns.
• Extensibility: ScriptableObject-based configs.
• Performance: Object pooling and efficient coroutines.
• Immersion: Visual feedback, ambient sounds, dynamic relationships.

There’s always room to evolve—fishing, cooking, advanced livestock, or co-op multiplayer. Feedback is welcome. Let’s cultivate Blossom Valley together and watch our communities flourish! 🌸