novafarma/docs/TIME_AGING_MARRIAGE_FAMILY_SYSTEM.md

# 📅💍👶 **TIME, AGING, MARRIAGE & FAMILY SYSTEM - COMPLETE!**

## 📅 **CALENDAR SYSTEM (12 Months - Real Life!):**

### **IN-GAME TIME:**
```
1 DAY = 30 MINUTES real-time! (confirmed!)

TIME BREAKDOWN:
- Daytime (Dawn → Dusk): 15 minutes
- Nighttime (Dusk → Dawn): 15 minutes
- Week: 7 days = 3.5 hours real-time
- Month: ~30 days = 15 hours real-time
- Year: 12 months = ~180 hours (7.5 days real!)

FULL IN-GAME YEAR = ~1 WEEK REAL TIME! ✅
```

---

### **12 MONTHS (Like Real Life!):**

```
SPRING (3 months):
1. MAREC (March) - Start of spring, planting season!
2. APRIL (April) - Flowers bloom
3. MAJ (May) - Warm, perfect farming weather

SUMMER (3 months):
4. JUNIJ (June) - Hot, crops grow fast!
5. JULIJ (July) - Hottest month
6. AVGUST (August) - Late summer harvests

AUTUMN (3 months):
7. SEPTEMBER (September) - Harvest season!
8. OKTOBER (October) - Leaves fall
9. NOVEMBER (November) - Cold weather begins

WINTER (3 months):
10. DECEMBER (December) - Snow, Christmas vibes!
11. JANUAR (January) - Coldest month, NEW YEAR!
12. FEBRUAR (February) - Late winter

YEAR REPEATS! ♾️
```

---

### **SEASONAL EFFECTS:**

```
SPRING:
- Crops grow 10% faster!
- Rain more frequent
- Animals give birth season!
- Flowers everywhere!

SUMMER:
- Crops grow 20% faster! (best!)
- Need more watering
- Berries/fruits available
- Long daylight hours

AUTUMN:
- HARVEST SEASON! (best farming profits!)
- Mushrooms abundant
- Leaves change color
- Cooler weather

WINTER:
- Most crops DON'T grow! (greenhouse needed!)
- Snow covers ground
- Some animals hibernate
- Christmas/New Year events!
- Can ice fish!
```

---

## 🎂 **AGING SYSTEM (Kai & Ana ONLY!):**

### **THE RULE:**
```
✅ KAI & ANA AGE OVER TIME!
✅ Start: 14 years old (when arrive at farm)
✅ Age +1 every in-game year
✅ NPCs DON'T age! (stay same forever)
```

---

### **KAI & ANA AGING PROGRESSION:**

```
YEAR 1 (Game Start):
- Kai: 14 years old
- Ana: 14 years old (twin!)
- Status: Teenagers, learning farm life
- Memory: Lost, recovering via farming

YEAR 2:
- Age: 15 years
- Status: Young farmers
- Unlocks: Can start dating NPCs! (if 10 hearts!)

YEAR 3:
- Age: 16 years
- Status: Experienced farmers
- Unlocks: More complex relationships

YEAR 5:
- Age: 18 years (ADULTS!)
- Status: Full-grown
- Unlocks: Marriage proposals unlock!

YEAR 10:
- Age: 23 years
- Status: Seasoned farmers
- Appearance: Slight visual changes (optional)

YEAR 20:
- Age: 33 years
- Status: Master farmers
- Appearance: More mature look

YEAR 50:
- Age: 63 years
- Status: Elder farmers
- Appearance: Gray hair, wrinkles (cosmetic)
- Legacy: Can establish dynasty!

NO DEATH FROM OLD AGE!
Can play FOREVER! ♾️
```

---

### **VISUAL AGING (Optional Cosmetic):**

```
AGE 14-17: Teen sprite (current!)
AGE 18-30: Young adult sprite (slightly taller?)
AGE 31-50: Adult sprite (mature look)
AGE 51+: Elder sprite (gray hair, optional wrinkles)

SUBTLE CHANGES - not drastic!
Player can disable aging visuals in settings! ✅
```

---

## 💕 **HEART SYSTEM (NPC Relationships):**

### **HEART LEVELS (0-20 Hearts!):**

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
HEARTS | STATUS        | UNLOCKS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
0-2    | Stranger      | Basic shop, expensive prices
3-4    | Acquaintance  | Normal prices, small talk
5-6    | Friend        | 10% discount, shares gossip
7-8    | Good Friend   | 15% discount, small gifts
9      | Close Friend  | Special dialogues, help events
10 ❤️   | **ROMANCE!**  | **CAN INVITE TO FARM!** ✅
11-12  | Dating        | Special dates, cutscenes
13-14  | Serious       | Talks about future
15     | In Love       | Marriage proposal possible!
16-17  | Engaged       | Planning wedding!
18-19  | Married       | Living together!
20 ❤️❤️ | **SOULMATES** | **CAN HAVE CHILDREN!** 👶
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

### **HOW TO INCREASE HEARTS:**

```
TALK DAILY: +0.25 hearts (slow but steady!)
GIVE GIFTS: +0.5 to +2 hearts (depends on gift!)
  - Loved gift: +2 hearts! 💕
  - Liked gift: +1 heart
  - Neutral: +0.25 heart
  - Disliked: -0.5 hearts!
  - Hated: -2 hearts! 💔

COMPLETE QUESTS: +3 hearts! (big boost!)
SPECIAL EVENTS: +2 hearts
BIRTHDAYS: +5 hearts!!! (give gift on birthday!)

DECREASE HEARTS:
- Ignore for week: -1 heart
- Give hated gift: -2 hearts
- Refuse quest: -1 heart
- Divorce: -20 hearts! (back to 0!)
```

---

## 💍 **MARRIAGE SYSTEM:**

### **REQUIREMENTS TO MARRY:**

```
✅ NPC must have 15+ hearts! ❤️❤️❤️
✅ Must complete NPC's personal questline
✅ Must have upgraded farmhouse (at least medium!)
✅ Must buy Blue Feather (marriage item, 5,000g!)
✅ Kai/Ana can be ANY AGE! (no minimum!) ✅

EXAMPLE:
Year 1, Age 14, 15 hearts with NPC = CAN MARRY! ✅
(No age restrictions! Player choice!)
```

---

### **MARRIAGE PROCESS:**

**STEP 1: REACH 15 HEARTS**
```
[Talk to NPC at 15 hearts]

NPC: "I've been thinking... we're so close now.
Do you ever think about... the future? Together?"

OPTIONS:
A) "I do! I want to be with you!" ✅
   → NPC blushes, relationship deepens!
   
B) "Let's take it slow..."
   → NPC understands, can try again later

[Choose A]
[Quest appears: "A Special Purchase"]
```

**STEP 2: BUY BLUE FEATHER**
```
[Go to town]
[Visit Jewelry Shop]
[Purchase Blue Feather: 5,000 gold]

BLUE FEATHER: Traditional marriage proposal item!
(Like real Slovenian/European tradition!)
```

**STEP 3: PROPOSE!**
```
[Hold Blue Feather in hand]
[Talk to NPC]

PLAYER: "I have something important to ask you..."
[Shows Blue Feather]

PLAYER: "Will you marry me?"

NPC: "YES! YES! A thousand times yes!" 💍

[Engaged status! ✅]
[Hearts remain at 15+]
```

**STEP 4: PLAN WEDDING**
```
[Wait 7 days for wedding preparation]

During week:
- NPCs gossip about upcoming wedding!
- Decorations appear in town
- Choose wedding location:
  • Church (traditional!)
  • Beach (romantic!)
  • Farm (intimate!)
  • Castle (fancy!)
```

**STEP 5: WEDDING DAY!**
```
[Day 7 arrives]
[WEDDING CUTSCENE! ✨]

CEREMONY:
- All town NPCs attend!
- Priest officiates
- Vows exchanged
- Kiss! 💋
- Celebration party!

[MARRIED! ✅]
[Spouse moves to your farm!]
[Shares bedroom with player!]
```

---

### **MARRIED LIFE:**

```
SPOUSE BENEFITS:
✅ Lives on your farm!
✅ Helps with chores! (watering, feeding animals!)
✅ Gives daily gifts! (random items!)
✅ Morning kiss (+stamina boost!)
✅ Cooks meals! (free food!)
✅ Special dialogues!
✅ Can have CHILDREN at 20 hearts! 👶

SPOUSE SCHEDULE:
- Morning: Helps on farm 2 hours
- Midday: Free time (walks around)
- Evening: Returns home for dinner
- Night: Goes to bed with player

Can still give gifts to spouse!
Must maintain hearts or relationship decays!
```

---

## 👶 **CHILDREN SYSTEM:**

### **REQUIREMENTS:**

```
✅ Must be MARRIED!
✅ Must have 20 HEARTS! ❤️❤️❤️❤️ (SOULMATES!)
✅ Must have LARGE FARMHOUSE (with nursery!)
✅ Must wait at least 1 in-game year married!
```

---

### **HAVING CHILDREN:**

**STEP 1: REACH 20 HEARTS**
```
[Married couple, hearts at 20]

SPOUSE (at night): "I've been thinking...
Our farm is doing well, we're so happy together...
Maybe it's time to... start a family?"

OPTIONS:
A) "Yes! Let's have a child!" ✅
   → Spouse is overjoyed!
   
B) "Let's wait a bit longer..."
   → Can ask again later

[Choose A]
[Quest: "Preparing the Nursery"]
```

**STEP 2: PREPARE NURSERY**
```
[Upgrade farmhouse if needed]
[Build/upgrade nursery room]

Materials:
- 200 Wood
- 100 Cloth (soft!)
- 50 Iron (crib!)
- 20 Glass (windows!)
- 1,000 gold

[Build crib, baby furniture]
[Nursery ready! ✅]
```

**STEP 3: PREGNANCY/ADOPTION**
```
BIOLOGICAL CHILDREN (if spouse is female NPC or Ana!):
- Spouse becomes pregnant!
- 2 seasons (6 months in-game) pregnancy
- Morning sickness dialogues
- Baby bump appears (sprite change!)

ADOPTION (if both male OR player choice!):
- Visit Adoption Center in Ljubljana
- Choose child (boy/girl, appearance!)
- 1 month waiting period
- Adoption finalized!

BOTH OPTIONS VALID! ✅
```

**STEP 4: BABY ARRIVES!**
```
[Cutscene: Baby birth/adoption!]

PLAYER & SPOUSE: "Welcome to our family!" 👶

[Baby appears in crib!]
[Name your baby!]

Baby stats:
- Gender: Boy/Girl (player choice OR random!)
- Appearance: Mix of parents (genetic!)
- Personality: Developed over time!
```

---

### **CHILD GROWTH STAGES:**

```
STAGE 1: BABY (0-1 year)
- Stays in crib
- Cries sometimes (feed bottle!)
- Spouse cares for baby mostly
- Cute dialogues!

STAGE 2: TODDLER (1-3 years)
- Crawls around farmhouse!
- Says first words! 😊
- Can play with toys
- Follows parents around (cute!)

STAGE 3: CHILD (3-8 years)
- Walks/runs around farm!
- Talks to NPCs
- Can help with TINY chores (watering 1 crop!)
- Goes to school (if built!)
- Makes friends with other kids!

STAGE 4: TEENAGER (8-14 years)
- Helps significantly on farm!
- Can use tools (low level!)
- Has own personality/interests!
- Can date other NPCs' kids! (aww!)

STAGE 5: ADULT (14+ years)
- FULLY GROWN! ✅
- Can take over farm! (succession!)
- Can marry & move out!
- OR stay and help forever!

Children age WITH Kai/Ana! ✅
```

---

### **MULTIPLE CHILDREN:**

```
CAN HAVE UP TO 3 CHILDREN! 👶👶👶

Requirements per child:
- 1st child: 20 hearts (soulmates!)
- 2nd child: Wait 2 in-game years, 20 hearts still!
- 3rd child: Wait 2 more years, 20 hearts maintained!

Large family! 👨‍👩‍👧‍👦
```

---

## 💔 **DIVORCE SYSTEM (HAHA!):**

### **WHY DIVORCE?:**

```
Reasons player might divorce:
- Found someone better! (brutal!)
- Relationship went bad (hearts dropped!)
- Want to marry someone else!
- Roleplay/story reasons!
- FOR THE MEMES! 😂

GAME ALLOWS IT! ✅
```

---

### **DIVORCE PROCESS:**

**STEP 1: DECIDE TO DIVORCE**
```
[Talk to spouse when hearts <10]
OR
[Visit Mayor's office]
[Request "Divorce Papers"]

MAYOR: "Are you sure? This is a big decision..."

OPTIONS:
A) "Yes, I want a divorce." 💔
B) "No, let me think about it."

[Choose A]
[Receive Divorce Papers]
Cost: 50,000 gold! (expensive! meant to discourage!)
```

**STEP 2: SERVE PAPERS**
```
[Give Divorce Papers to spouse]

SPOUSE: "What?! You want to... divorce me?!"
[Emotional cutscene! 😢]

SPOUSE: "Fine! I'll leave!"
[Spouse packs belongings]
[Moves out of farm next day]

[Divorced status! 💔]
```

**STEP 3: AFTERMATH**
```
POST-DIVORCE:
- Ex-spouse moves back to original home
- Relationship drops to 0 hearts! 💔
- Ex-spouse won't talk to you for 1 season! (angry!)
- Other NPCs gossip about divorce!
- Some NPCs lose hearts with you! (disapprove!)

CHILDREN (if any):
- Stay with YOU (player keeps custody!)
- OR can choose joint custody (kid visits ex!)
- Ex-spouse CAN visit farm to see kids!
- Awkward dialogues! 😬

Can REMARRY after 1 in-game year! ✅
Can even remarry SAME PERSON if rebuild hearts! (hard but possible!)
```

---

### **DIVORCE CONSEQUENCES:**

```
FINANCIAL:
- Divorce cost: 50,000 gold!
- Spouse takes 25% of your money! (ouch!)
- Splits shared items!

SOCIAL:
- Town approval: -20%
- Some NPCs angry at you!
- Harder to date new people! (reputation!)

EMOTIONAL (in-game):
- Sad music plays
- Rain more frequent
- Crops grow 5% slower (depression debuff!)
- Lasts 1 season

REALISTIC CONSEQUENCES! 💔
```

---

## 🌳 **FAMILY TREE SYSTEM:**

### **FAMILY TREE MENU:**

```
[Press F key → Family Tree]

╔════════════════════════════════════════════╗
║           MARKOVIĆ FAMILY TREE             ║
╠════════════════════════════════════════════╣
║                                            ║
║  GENERATION 1 (Deceased):                  ║
║  👴 Marko Marković ✝                       ║
║  👵 Elena Marković ✝                       ║
║       |                                    ║
║       └──┬─────────┐                       ║
║          |         |                       ║
║  GENERATION 2 (YOU!):                      ║
║  👦 Kai (Age: 16) ← YOU!                   ║
║  👧 Ana (Age: 16) - Twin                   ║
║       |                                    ║
║       └── 💍 Married to: [NPC Name]        ║
║            Hearts: ❤️❤️❤️❤️ (20/20)        ║
║            Years married: 2                ║
║            |                               ║
║            └──┬────────┐                   ║
║               |        |                   ║
║  GENERATION 3 (Children):                  ║
║  👶 [Child 1 Name] (Age: 3) - Toddler      ║
║  👶 [Child 2 Name] (Age: 1) - Baby         ║
║                                            ║
║  TOTAL FAMILY MEMBERS: 5                   ║
║  (2 living ancestors + YOU + spouse + kids)║
║                                            ║
║  [CLOSE] [EXPORT TREE]                     ║
╚════════════════════════════════════════════╝
```

---

### **FAMILY TREE FEATURES:**

```
✅ Shows all generations!
✅ Tracks marriages!
✅ Tracks children!
✅ Shows ages!
✅ Shows deceased (✝)
✅ Shows heart levels with spouse!
✅ Can EXPORT tree (save as image!)
✅ Updates automatically!

SPECIAL:
- If Ana is NPC (player chose Kai), her family tree shows separately!
- If player marries Ana (twin incest? game allows but awkward dialogues! 😅)
- Can track up to 5 generations! (YOU → kids → grandkids → great-grandkids → great-great!)
- Family reunions event! (all family meets!)
```

---

## 🎂 **BIRTHDAY SYSTEM:**

### **CHARACTER BIRTHDAYS:**

```
KAI: April 15 (Spring!)
ANA: April 15 (same, twins!)

EVERY NPC HAS BIRTHDAY!
On birthday:
- NPC celebrates!
- Party in their home!
- Give gift = +5 hearts (HUGE!) 🎉
- Special dialogues!

YOUR BIRTHDAY (Kai/Ana):
- NPCs give YOU gifts!
- Big party on farm!
- Spouse cooks favorite meal!
- +50% friendship with everyone who attends!
- Aging happens! (+1 year!) 🎂
```

---

## 📊 **COMPLETE SYSTEM SUMMARY:**

```
╔════════════════════════════════════════════╗
║    TIME, AGING & FAMILY - COMPLETE!        ║
╠════════════════════════════════════════════╣
║                                            ║
║  📅 CALENDAR: 12 months (real life!)       ║
║  ⏱️  TIME: 1 day = 30 min                  ║
║  🎂 AGING: Kai & Ana age each year!        ║
║  💕 HEARTS: 0-20 heart system!             ║
║  💍 MARRIAGE: At 15 hearts, any age!       ║
║  👶 CHILDREN: At 20 hearts, up to 3!       ║
║  💔 DIVORCE: Allowed (expensive!)          ║
║  🌳 FAMILY TREE: Track all generations!    ║
║  🎉 BIRTHDAYS: Special events!             ║
║                                            ║
║  NO AGE RESTRICTIONS! ✅                   ║
║  NO TIME LIMITS! ♾️                        ║
║  FULL LIFE SIM! 💯                         ║
║                                            ║
╚════════════════════════════════════════════╝
```

---

## 🎮 **GAMEPLAY EXAMPLES:**

### **EXAMPLE 1: Early Marriage**
```
YEAR 1, Age 14:
- Meet NPC, give gifts daily
- Reach 15 hearts by Year 2
- Age 15: Get married! 💍
- Spouse moves to farm
- Help farming together!
- Age 16: Hearts reach 20
- Decide to have child! 👶
- Age 17: Baby born!
- Raise child while farming!
- Age 30: Child is 13, helps significantly!

WHOLESOME FAMILY FARM! 👨‍👩‍👧‍👦
```

### **EXAMPLE 2: Divorce Drama (HAHA!)**
```
YEAR 3, Age 17:
- Married to NPC_A for 2 years
- Hearts drop to 8 (ignored them!)
- Meet NPC_B, fall in love! 💕
- Divorce NPC_A (50,000g + drama!)
- Town gossips! 😱
- Wait 1 year (depression phase!)
- Age 18: Date NPC_B
- Age 19: Hearts reach 15, marry NPC_B!
- MUCH HAPPIER! ✅

SCANDALOUS BUT ALLOWED! 😂
```

---

**✅ COMPLETE RELATIONSHIP & LIFE SIM SYSTEMS!**  
**Ready to add to FINAL doc + move to demo!** 💍👶🎂