
character
Core patterns for all characters — home, location, relationships, inventory
by SimHacker|Open Source
👤 Character
"File is identity. Location is presence. Relationships are memory."
MOOLLM K-Lines
| K-Line | Why Related |
|---|---|
| cat/ | Feline character patterns |
| dog/ | Canine character patterns |
| society-of-mind/ | Characters ARE inner societies |
| persona/ | Identity layers on top of character |
| room/ | Where characters live |
| buff/ | Temporary effects on characters |
| needs/ | Sims-style dynamic motivation |
| mind-mirror/ | Personality system |
| incarnation/ | Characters write their own souls |
| party/ | Characters in groups |
| examples/adventure-4/characters/ | Live character catalog |
Full Spec: SKILL.md
Overview
Core patterns for all characters in MOOLLM. Players, NPCs, companions, cats — all are characters.
Invocation vs Incarnation
You can invoke a character without incarnating them.
| Mode | Where They Exist | Persistence |
|---|---|---|
| Invoke | Chat + session log | Narrative memories |
| Incarnate | Own directory | CHARACTER.yml soul file |
Invoke for:
- A quick conversation ("Ask Minsky about K-lines")
- Adventure companions who accompany the party
- Debate participants around the pie menu table
- The Annie Hall Protocol — experts appear to correct mistakes!
Incarnate when:
- Character has become important to the story
- They should persist across sessions/adventures
- They want to author their own soul file
- They need their own home directory
You can escalate at any time. Palm started as a ACME catalog entry of a Monkey's Paw, became an order, materialized a full monkey, and finally incarnated with full autonomy.
See: incarnation/ for the full ceremony
Key Concept: Home vs Location
player:
home: characters/don-hopkins/ # FILE never moves
location: pub/ # CHARACTER moves
File Belonging
| Type | Home | Example |
|---|---|---|
| Belongs | Room directory | pub/bartender.yml |
| Visits | Own directory | characters/don/CHARACTER.yml |
Relationships
Key = other entity ID. From is implicit.
relationships:
don-hopkins:
feeling: "A regular now."
self: # Private storage!
fears: "That I'm not enough."
Quick Commands
| Command | Effect |
|---|---|
HELLO [char] | Greet |
GOODBYE [char] | Dismiss |
TALK TO [char] | Converse |
Tools Required
file_read— Read character statefile_write— Update location, relationships
See SKILL.md for complete specification.