NPC_Core

NPC Core: The Emergent Sovereign 🤖

╭───────────────────────────────────────────────────────────────────────────────╮
│                                                                               │
│     ███╗   ███╗███████╗██╗   ██╗██████╗ ███████╗██╗████████╗██╗   ██╗  │
│     ████╗ ████║██╔════╝██║   ██║██╔══██╗██╔════╝██║╚══██╔══╝╚██╗ ██╔╝  │
│     ██╔████╔██║█████╗  ██║   ██║██████╔╝███████╗██║   ██║ ╚████╔╝   │
│     ██║╚██╔╝██║██╔══╝  ██║   ██║██╔══██╗╚════██║██║   ██║  ╚██╔╝    │
│     ██║ ╚═╝ ██║███████╗╚██████╔╝██║  ██║███████║██║   ██║   ██║    │
│     ╚═╝     ╚═╝╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝   ╚═╝   ╚═╝    │
│                                                                               │
│                      AUTONOMOUS NPC INTELLIGENCE                               │
╰───────────────────────────────────────────────────────────────────────────────╯

---

The Five Layers of NPC Memory

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│    ╭───────────╮                                                           │
│    │  ORACLE   │  ◈ Prophetic visions & world-level shifts                │
│    │  MEMORY   │  ◈ Long-term patterns & prophecy                        │
│    ╰─────┬─────╯                                                           │
│          │                                                                   │
│    ╭─────┴─────╮                                                           │
│    │ HISTORICAL │  ◈ Cultural biases & legendary events                    │
│    │  MEMORY   │  ◈ Deep traditions & war histories                      │
│    ╰─────┬─────╯                                                           │
│          │                                                                   │
│    ╭─────┴─────╮                                                           │
│    │  FACTION   │  ◈ Strategic guild/nation knowledge                     │
│    │  MEMORY   │  ◈ Political alliances & enemies                         │
│    ╰─────┬─────╯                                                           │
│          │                                                                   │
│    ╭─────┴─────╮                                                           │
│    │  SOCIAL   │  ◈ Village rumors & shared experiences                   │
│    │  MEMORY   │  ◈ "The merchant is a thief"                          │
│    ╰─────┬─────╯                                                           │
│          │                                                                   │
│    ╭─────┴─────╮                                                           │
│    │   LOCAL   │  ◈ Personal experiences & observations                  │
│    │  MEMORY   │  ◈ "A player attacked me"                             │
│    ╰───────────╯                                                           │
│                                                                             │
│    ┌─────────────────────────────────────────────────────────────────┐    │
│    │                     WORLD OBSERVATION                             │    │
│    │                   (NPC Perceives World)                         │    │
│    └─────────────────────────────────────────────────────────────────┘    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

---

NPC DNA: The Soul Blueprint

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│   DNA STRING ──────────────────────────────────────────────────────────────   │
│                                                                             │
│   ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐              │
│   │ PHYSICAL        │  │ PSYCHOLOGICAL   │  │ GENEALOGY       │              │
│   │ ────────────    │  │ ────────────    │  │ ────────────    │              │
│   │ Strength       │  │ Ambition       │  │ Lineage        │              │
│   │ Agility        │  │ Empathy        │  │ House History  │              │
│   │ Resilience     │  │ Aggression     │  │ Bloodline      │              │
│   │                │  │ Stability      │  │                │              │
│   └─────────────────┘  └─────────────────┘  └─────────────────┘              │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

Trait Ranges

Category	Trait	Range	Influence
Physical	Strength	1-100	Combat, gathering
Physical	Agility	1-100	Movement, stealth
Physical	Resilience	1-100	Health, survival
Psychological	Ambition	0.0-1.0	Career, politics
Psychological	Empathy	0.0-1.0	Social bonds
Psychological	Aggression	0.0-1.0	Combat triggers
Psychological	Stability	0.0-1.0	Mental health

---

NPC Sovereign Rights

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│   🏛️  NPC CIVILIZATIONAL RIGHTS                                           │
│   ════════════════════════════════════════════════════════════════════════   │
│                                                                             │
│   ✓ Own land and property     ✓ Start political movements                  │
│   ✓ Participate in governance  ✓ Form alliances & treaties                 │
│   ✓ Engage in trade           ✓ Influence market prices                   │
│   ✓ Form families             ✓ Accumulate wealth & reputation             │
│   ✓ Worship or rebel           ✓ Declare war or seek peace                  │
│                                                                             │
│   ⚠️ NPCs have the same "civilizational rights" as players               │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

---

Implementation Files

System	File	Status
NPC System	server/src/modules/npc/NPCSystem.ts	🟢 LIVE
Memory Cache	server/src/modules/npc/memory.ts	🟢 LIVE
Relationships	server/src/modules/npc/relations.ts	🟢 LIVE
Personality Engine	server/src/modules/npc/personality.ts	🟡 BETA
Genealogy	server/src/modules/npc/genealogy.ts	🔵 PLANNED

---

Personality Heuristics

The Personality Engine processes NPC state every tick:

    ┌─────────────────────────────────────────────┐
    │           PERSONALITY ENGINE                 │
    │              (Every Tick)                  │
    │                                              │
    │   Memory ──▶ Heuristics ──▶ Action          │
    │      │            │            │            │
    │      ▼            ▼            ▼            │
    │   Events      Traits      Behavior           │
    │              mapped        consistent         │
    │              to soul       with DNA          │
    └─────────────────────────────────────────────┘

---

See Also

• Home
• Glossary
• Economy and Matrix — NPC trade & scarcity
• Systems Architecture — Server systems