👑 Character Bio Generator

Basic Character Generation

using Omnivael.MedievalBio;

// Create a basic character context
var context = new NpcContext
{
    Id = "merchant_001",
    HomeTier = SettlementTier.Town,
    TownLevelScore = 65,
    Faction = FactionType.Civilian
};

// Generate the character
var character = CharacterBioGenerator.Generate(context);

// Access character data
Debug.Log($"Name: {character.Profile.DisplayName}");
Debug.Log($"Occupation: {character.Profile.Occupation}");
Debug.Log($"Social Class: {character.Profile.SocialClass}");

Occupation Distribution by Settlement

• Wilderness/Camp: Hunters, Poachers, Bandits, Rangers
• Hamlet: Farmers, Fishermen, Shepherds, Basic laborers
• Village: Blacksmiths, Carpenters, Bakers, Innkeepers
• Town: Merchants, Traders, Guards, Scholars, Artisans
• City: Nobles, Knights, Clerks, Healers, Specialists
• Keep: Soldiers, Veterans, Military specialists

Faction-Specific Features

• Civilian: Standard medieval society with normal occupation distribution
• Noble: Higher social class, house names, noble titles, privileged occupations
• Bandit: Criminal backgrounds, nicknames instead of surnames, outlaw occupations
• Mercenary: Military backgrounds, veteran status, combat-oriented occupations
• Monster: Non-human naming conventions, bestial occupations, special attributes

Social Hierarchy

• Peasant: Basic laborers, farmers, simple occupations
• Commoner: Skilled workers, apprentices, service providers
• Artisan: Craftsmen with specialized skills
• Merchant: Traders, shopkeepers, business owners
• Noble: Landowners, knights, high-ranking officials
• Outlaw: Criminals, bandits, those outside normal society

Generated Character Properties

• Basic Info: First name, surname, nickname, display name, age, gender
• Social Status: Social class, occupation, noble title (if applicable)
• Physical Traits: Build type, hair color, eye color, height modifiers
• Personality: 20 different personality traits (Brave, Honest, Ambitious, etc.)
• Background: Criminal history, family traditions, birthplace
• Skills: Talent tags weighted by occupation

Bandit Generation

var banditContext = new NpcContext
{
    Id = "bandit_chief_001",
    HomeTier = SettlementTier.Wilderness,
    TownLevelScore = 10,
    Faction = FactionType.Bandit,
    AgeOverride = 35,
    GenderOverride = Gender.Male
};

var bandit = CharacterBioGenerator.Generate(banditContext);
// Results in: "Black Jack" the Cutthroat, with criminal background

Noble Generation

var nobleContext = new NpcContext
{
    Id = "lord_001",
    HomeTier = SettlementTier.City,
    TownLevelScore = 85,
    Faction = FactionType.Noble,
    SocialClassHint = SocialClass.Noble
};

var noble = CharacterBioGenerator.Generate(nobleContext);
// Results in: "Lord Aldric of House Thornbury" with appropriate titles

Custom Occupation

var merchantContext = new NpcContext
{
    Id = "merchant_001",
    HomeTier = SettlementTier.Town,
    TownLevelScore = 70,
    Faction = FactionType.Civilian,
    OccupationHint = Occupation.Merchant,
    SocialClassHint = SocialClass.Merchant
};

var merchant = CharacterBioGenerator.Generate(merchantContext);
// Forces merchant occupation with appropriate social class

NPC Spawn Integration

public class NpcSpawner : MonoBehaviour
{
    public void SpawnNpc(Vector3 position, SettlementTier tier)
    {
        var context = new NpcContext
        {
            Id = System.Guid.NewGuid().ToString(),
            Position = position,
            HomeTier = tier,
            TownLevelScore = GetTownScore(position),
            Faction = DetermineFaction(position)
        };

        var character = CharacterBioGenerator.Generate(context);
        
        // Apply character data to your NPC
        var npc = Instantiate(npcPrefab, position, Quaternion.identity);
        npc.GetComponent<NpcData>().Initialize(character);
    }
}

Optimization Guidelines

• Use stable IDs for reproducible character generation
• Set appropriate TownLevelScore for realistic occupation distribution
• Override age/gender only when necessary for story purposes
• Let the system determine social class based on settlement context
• Use faction types to create appropriate naming conventions
• Generate family trees for important NPCs to create interconnected stories

Common Use Cases

• Quest Givers: Generate merchants, nobles, or officials with appropriate backgrounds
• Villagers: Create diverse populations with realistic occupation mixes
• Enemies: Generate bandits, raiders, or hostile mercenaries
• Allies: Create friendly NPCs with compelling backstories
• Background Characters: Populate towns with believable citizens