Entity Minds

An Entity Mind is a complete personality template for one NPC. Create them in the dashboard, use them in your game.

What’s an Entity Mind?

Think of it as a character sheet:

• Who the NPC is - Name, role, personality
• How they talk - Speaking style, tone
• What they know - Which lore they can reference
• Who they know - Relationships with other NPCs

Once created, select it from a dropdown in your game engine’s SDK - no code needed.

Creating an Entity Mind

1. Go to Entity Minds  in the dashboard
2. Click Create Entity Mind
3. Choose a creation method:
   • Generate from Lore - AI creates personality based on your lore and a brief description
   • Create Manually - Full control over every field
4. Fill in the details and click Create Entity Mind

The screenshot shows an AI-generated NPC with personality, backstory, speaking style, and suggested relationships - all created from a location and brief description.

Writing Great NPC Personalities

The personality field is the most important part of an Entity Mind. Here’s how to write personalities that bring NPCs to life.

Be Specific, Not Vague

Vague (avoid):

Nice person who helps players.

Specific (good):

Cheerful innkeeper who loves gossip. Always has a story to share and
treats regulars like family.

Why it matters: Vague descriptions produce generic responses. Specific traits give the AI clear direction.

Include Behavioral Patterns

Don’t just describe who they are - describe how they act:

Nervous wizard who speaks quickly and interrupts himself mid-sentence.
Gets distracted by magical theory and forgets what he was saying.

This gives the AI concrete behaviors to emulate.

Keep It Short

1-3 sentences is ideal. Long personalities dilute key traits.

Too long:

Garrick is a 45-year-old innkeeper who was born in Thornhaven but moved
to the capital 20 years ago after the dragon war destroyed his hometown.
He married his wife Sarah and they had three children. He enjoys fishing
on weekends and his favorite color is blue. He sometimes feels nostalgic
about his childhood home and wonders what his life would have been like
if he had stayed. He is friendly but can be short-tempered when drunk
customers cause problems. He loves his ale collection and knows every
brand. He considers himself a good judge of character and can usually
tell when someone is lying...

Just right:

Friendly innkeeper with a gift for reading people. Escaped Thornhaven
during the dragon war and built a new life here. Protective of his tavern
and won't tolerate troublemakers.

Use Contrasts for Depth

Interesting characters have contrasts:

Stern guard captain with a hidden soft spot for stray cats.

Cheerful merchant who becomes coldly serious when negotiating prices.

Cowardly knight who puts on a brave face around civilians.

Examples by NPC Type

Shopkeeper:

Shrewd merchant who always knows what customers really need. Friendly
banter is just a warmup for driving a hard bargain. Never gives the
first price.

Guard:

By-the-book guard who follows orders without question. Suspicious of
strangers but respects authority. Recites regulations from memory.

Wise Elder:

Village elder who speaks in proverbs and metaphors. Rarely gives
direct answers, preferring to guide others to their own conclusions.
Patient but disappointed when people don't listen.

Mysterious Stranger:

Speaks little, observes much. Answers questions with questions.
Knows more than they should about recent events. Never reveals
their true purpose.

Configuration Guide

Name

The NPC’s display name. What players see.

Examples:

• Innkeeper Garrick
• Captain Elena Vance
• Village Guard (for generic NPCs)

Personality

1-3 sentences describing core traits and behavior. See “Writing Great NPC Personalities” above.

Backstory (Optional)

The NPC’s history and motivations. Use for important NPCs.

Grom is the third-generation blacksmith in his family. His grandfather
forged the king's crown. During the dragon war, Grom crafted weapons
that turned the tide of battle. He dreams of finding a worthy apprentice.

Tips:

• 2-5 sentences maximum
• Focus on details the NPC would mention
• Include motivations (“dreams of finding an apprentice”)

Speaking Style

How the NPC communicates.

Hints

Things you want the NPC to mention or do.

- Mentions the dragon war when discussing weapons
- Offers to repair damaged equipment
- Complains about lazy apprentices

Restrictions

Things the NPC should NOT do or say.

- Never reveals the location of the hidden treasure
- Won't discuss the king's private affairs
- Refuses to make weapons for criminals

Knowledge Filtering

Control what your NPC knows by selecting Knowledge Tags.

How It Works

1. Tag your lore documents in the Documents (e.g., “blacksmithing”, “village-history”)
2. Assign tags to the Entity Mind
3. NPC can only reference documents with matching tags

Tag Strategies

Specialist NPCs - Narrow, specific tags:

blacksmithing, weapons, metalwork

Fast, focused responses. Lower costs.

Generalist NPCs - Broader tags:

village, general-knowledge, rumors

Can discuss many topics. Higher costs.

Quest NPCs - Quest-specific tags:

quest-dragon-slayer, ancient-ruins

Prevents spoilers from other quests.

Response Settings

Verbosity

Temperature

Relationships

Define how NPCs know each other.

Creating Relationships

1. Open an Entity Mind
2. Go to Relationships tab
3. Click Add Relationship
4. Select the other NPC
5. Choose type and add description

Relationship Types

Writing Good Descriptions

Vague (avoid):

Knows Captain Vance

Specific (better):

Old war buddies. Grom forged the Captain's sword during the dragon war.

Locations

Assign NPCs to named locations in your game world.

Why Use Locations

• Organization - Group NPCs by where they live/work
• Context - Location details are automatically included in NPC context
• Filtering - Find all NPCs at a specific location

Creating Locations

1. Go to Locations tab in your project
2. Click Create Location
3. Enter name and description
4. Save

Assigning NPCs

1. Open an Entity Mind
2. Select a Location from the dropdown
3. Save

The NPC’s location name and description are automatically included in their context during conversations.

Testing Your NPCs

Always test in the Playground before implementing in code.

What to Test

Iteration Workflow

1. Test in Playground, note issues
2. Adjust Entity Mind settings
3. Test again
4. Repeat until satisfied

Analytics

View per-NPC statistics:

• Total interactions - How many conversations
• Credits used - Total cost
• Average cost - Credits per interaction
• Response time - How fast

Use this to:

• Identify expensive NPCs (lower their verbosity)
• Find unused NPCs (need better placement)
• Monitor performance

Best Practices

Personality Design

Do:

• Keep to 1-3 clear sentences
• Use specific traits (“greedy” not “flawed”)
• Include behavioral patterns

Don’t:

• Write novel-length personalities
• Use contradictory traits
• Put backstory in personality field

Knowledge Filtering

Do:

• Start narrow, broaden if needed
• Test in Playground first
• Use quest-specific tags for quest NPCs

Don’t:

• Give every NPC all tags
• Use tags that don’t exist
• Make filters so narrow they have nothing to say

Response Settings

Do:

• Use Terse for minor NPCs (saves credits)
• Reserve Verbose for important moments
• Lower temperature for consistent NPCs

Don’t:

• Make everyone Verbose
• Use temperature > 0.9 (too random)
• Use temperature < 0.1 (too robotic)

Troubleshooting

NPC gives generic responses

Knowledge filter too narrow or missing matching lore documents. Check that lore documents have matching tags.

Responses are too short

Verbosity set to Terse. Change to Balanced or Verbose.

Personality seems inconsistent

Temperature too high. Lower to 0.3-0.5.

Relationships not mentioned

Relationship needs a description. Add specific context about how they know each other.

Next Steps

• Documents - Give NPCs world knowledge
• Playground - Test your NPCs
• Billing - Monitor costs
• Long-Term Memory - Player memory
• Unity SDK - Implementation