🌲 Family Tree Generator

Basic Family Generation

using Omnivael.MedievalBio;

// Generate a character with family
var context = new NpcContext
{
    Id = "merchant_001",
    HomeTier = SettlementTier.Town,
    TownLevelScore = 65,
    Faction = FactionType.Civilian,
    GenerateExtendedFamily = true
};

var character = CharacterBioGenerator.Generate(context);

// Access family members
var parents = character.Family.Parents;
var spouse = character.Family.Spouse;
var children = character.Family.Children;

Debug.Log($"Character: {character.Profile.DisplayName}");
Debug.Log($"Parents: {parents.Count}");
Debug.Log($"Spouse: {(spouse != null ? spouse.DisplayName : "None")}");
Debug.Log($"Children: {children.Count}");

Age-Based Generation

• Parents: 20-30 years older than the main character
• Spouse: Similar age (±5 years) to the main character
• Children: Ages 0 to (Character Age - 16), ensuring biological plausibility
• Minimum Age: Characters must be at least 16 to have children

Occupation Inheritance System

• High Probability (70%): Children inherit parent's exact occupation
• Medium Probability (20%): Children take related occupation in same field
• Low Probability (10%): Children pursue different career path
• Settlement Influence: Available occupations limited by settlement tier

Family Size by Settlement Tier

• Wilderness/Camp: Small families (1-2 children), survival-focused
• Hamlet/Village: Medium families (2-4 children), agricultural society
• Town/City: Variable families (1-5 children), diverse occupations
• Keep: Military families (1-3 children), soldier/specialist focus

Social Class Considerations

• Peasant Families: Large families for farm labor, simple occupations
• Artisan Families: Medium families, craft specialization inheritance
• Merchant Families: Small to medium families, business continuation focus
• Noble Families: Strategic marriages, alliance-building, title inheritance

Spouse Selection Logic

• Age Matching: Spouses are typically within 5 years of each other's age
• Social Class: Usually same or adjacent social class (nobles marry nobles, etc.)
• Occupation Compatibility: Related or complementary occupations
• Name Generation: Women typically keep maiden names in medieval setting

Marriage Probability by Age

// Marriage likelihood based on character age
Age 16-25: 20% chance of being unmarried
Age 26-35: 70% chance of being married
Age 36-45: 85% chance of being married
Age 46+: 60% chance of being married (higher widow rate)

Child Count Probability

• No Children: 15% chance (infertility, choice, or early death)
• 1 Child: 25% chance (common in merchant/noble families)
• 2-3 Children: 40% chance (most common family size)
• 4-5 Children: 15% chance (larger peasant/artisan families)
• 6+ Children: 5% chance (rare, usually peasant families)

Advanced Family Generation Example

// Generate a noble family with specific parameters
var nobleContext = new NpcContext
{
    Id = "lord_thornbury",
    HomeTier = SettlementTier.City,
    TownLevelScore = 85,
    Faction = FactionType.Noble,
    AgeOverride = 45,
    GenderOverride = Gender.Male
};

var noble = CharacterBioGenerator.Generate(nobleContext);

// Access detailed family information
Debug.Log($"Lord: {noble.Profile.DisplayName}");
Debug.Log($"Age: {noble.Profile.Age}");

foreach (var parent in noble.Family.Parents)
{
    Debug.Log($"Parent: {parent.DisplayName} (Age: {parent.Age})");
    Debug.Log($"Parent Occupation: {parent.Occupation}");
}

if (noble.Family.Spouse != null)
{
    Debug.Log($"Spouse: {noble.Family.Spouse.DisplayName} (Age: {noble.Family.Spouse.Age})");
}

foreach (var child in noble.Family.Children)
{
    Debug.Log($"Child: {child.DisplayName} (Age: {child.Age})");
    Debug.Log($"Child Occupation: {child.Occupation}");
}

Multi-Generational Occupations

• Family Trade: Blacksmithing, farming, scholarship passed down generations
• Noble Houses: Hereditary titles and responsibilities
• Merchant Dynasties: Business empires built over generations
• Military Families: Soldiering traditions in keep-based families

Using FamilyTreeGenerator Directly

// Manual family tree generation
var familyGenerator = new EnhancedFamilyTreeGenerator();
var mainCharacter = new PersonProfile { /* your character data */ };

// Generate specific family members
var parents = familyGenerator.GenerateParents(mainCharacter);
var spouse = familyGenerator.GenerateSpouse(mainCharacter);
var children = familyGenerator.GenerateChildren(mainCharacter, spouse);

// Create custom family tree
var familyTree = new FamilyTree
{
    MainCharacter = mainCharacter,
    Parents = parents,
    Spouse = spouse,
    Children = children
};

Historical Accuracy Guidelines

• Maternal Age: Medieval women typically had children between 16-40 years old
• Family Size: Peasant families were larger due to high child mortality
• Social Mobility: Rare but possible through marriage or exceptional circumstances
• Extended Family: Consider aunts, uncles, and cousins for noble houses
• Seasonal Considerations: Birth timing affects available resources

Storytelling Opportunities

• Family Feuds: Conflicting occupations or social classes
• Black Sheep: Children who reject family traditions
• Marriage Alliances: Strategic unions between families
• Orphan Stories: Characters without parents or family
• Legacy Quests: Continuing family trades or reclaiming lost honor

Dynamic NPC Generation

public class DynamicNpcSpawner : MonoBehaviour
{
    public void SpawnFamilyGroup(SettlementTier tier, Vector3 location)
    {
        // Generate family patriarch/matriarch
        var elderContext = new NpcContext
        {
            Id = $"elder_{location.GetHashCode()}",
            HomeTier = tier,
            TownLevelScore = GetSettlementScore(location),
            Faction = FactionType.Civilian,
            AgeOverride = Random.Range(40, 65)
        };

        var elder = CharacterBioGenerator.Generate(elderContext);
        SpawnNpc(elder, location);

        // Spawn family members
        foreach (var child in elder.Family.Children)
        {
            if (child.Age >= 16) // Only spawn adult children
            {
                SpawnNpc(child, location + Random.insideUnitSphere * 5f);
            }
        }

        if (elder.Family.Spouse != null)
        {
            SpawnNpc(elder.Family.Spouse, location + Vector3.right * 2f);
        }
    }
}