¶ Profile Management
Every AI NPC that has been AI activated ingame will have their own profile in the Configuration Wizard. This is so you can fine tune each AI NPC to your exact preference.
- Character Profile: Change activated AI NPC profiles
- Configuration Depth: Hide or expose advanced options in the Configuration Wizard
- Current AI Service: Currently used AI connector that will be used. For most users just leave it as "openrouterjson".
This is what you will see if you click the Blue Button in the top left:
The default profile is very important as this is the “Narrator” profile and the baseline for all other profiles. Also when a new NPC is added for the first time the AI/LLM and TTS settings (with different voiceid’s set for each character) will be copied and set into their profile.
Example:
- I have OpenRouter and CHIM XTTS set in my default profile.
- I make Heimskir an AI NPC for the first time.
- Heimskir will use OpenRouter and CHIM XTTS for his AI dialogue.
Certain settings such as STT, Player TTS Voice, minime-t5, etc can only be configured in the default profile. These are “global” settings.
When a new character profile is created, the Dwemer Database is checked to see if they have a character biography.
If it is there it will be copied into their profile, if not it will just be a simple generic one line entry.
You can pre upload custom or overwrite existing character profiles using the NPC Biography Management page.
Right now when a character profile is created and you change the “default” profile to use a different service, you will need to use the “Copy to All Profiles” button to apply the changes to all other profiles.
Example:
- I have CHIM XTTS set in my default profile.
- I activate Lydia for the first time as an AI NPC and she is using CHIM XTTS to speak.
- I then change the default profile to use MeloTTS.
- I then activate Belethor for the first time he will be using MeloTTS to speak.
- If I want Lydia to now use MeloTTS I can go to the default profile and use the “Copy to All Profiles” button to set her, and all other activated AI NPCs, to MeloTTS.
You can also Lock Profiles to prevent them from being updated by Copy to all profiles & prevent them for being deleted.
The reason we have this detailed profile management is to empower you to finetune EACH AI NPC to your specific liking.
You can have one AI NPC use llama3 LLM and another using gpt-4o mini LLM and see how they interact with each other like a “chatbot war”.
We encourage you to experiment with all the settings present.
¶ NPC Biographies
When an NPC is AI activated they will be given an appropriate character biography to help them roleplay.
These biographies are initially stored in our PSQL database under the npc_templates table.
This table will only hold biography information for vanilla Skyrim NPCs and a few custom ones with the standard installation.
We provide support for custom followers from mod authors who give us explicit permission to officially integrate their character within our AI framework.
If you are a mod author and want your follower officially integrated, read this: Official Custom Follower Integration Guide
You can easily upload your own biographies for custom characters from mods using the NPC Biography Management page in the CHIM server.
These templates will be saved in the npc_templates_custom table. This table will overwrite any character entries from the npc_templates table.
When you activate a character ingame their biography can be edited in the Configuration Wizard under their profile.
If you already imported a character and want them to use a new biography from the database, you can delete their profile and reactivate them.
Or just copy/paste the new biography info into their existing character profile.
If an AI character is activated and they do not have a database entry, then a default generic template will be used instead.
Basic biography settings for a character profile:
HERIKA_NAME = The character's name, do not change this!
PROMPT_HEAD = Defines the rules of the roleplay. Use this to control how you want characters to behave.
PLAYER_BIOS = Information about the player that ALL AI NPCs will know about you.
Do not put information in here you don’t want them to know!
HERIKA_PERS = Static roleplay information about the character (race, gender, job, etc).
HERIKA_DYNAMIC = Dynamic roleplay information about the character (mood, feelings, goals, etc).
More information about how Dynamic Profiles work can be found below!
Just click Save once you have finished making your changes. You can also do this while ingame, with no restart required!
Tip!
If you use the words #SpeechStyle you can adjust how an NPC will speak.
E.G.
"#SpeechStyle: elevated, poetic tone, reminiscent of epic literature. It uses archaic vocabulary (e.g., "hearken," "forbears," "ye"), metaphorical imagery (e.g., "chains of fear," "fire of hope"), and rhythmic patterns, creating a sense of gravitas and timelessness. Sentences often blend lyrical interludes with more straightforward exhortations, evoking both song and speech. This style thrives on themes of heroism, unity, and destiny, making it well-suited for fantasy worlds steeped in grandeur and peril.. "
Using the Configuration Wizard to edit NPC information after they have been imported is much easier than editing the database, which you will see below.
Remember these are the settings that will beused when a character profile is created.
Once they have a profile generated, further changes need to be made in the Configuration Wizard.
TL;DR
- Each NPC has their own configuration wizard profile once they have been activated. You can fine tune LLM, TTS, etc settings for each NPC individually.
- When an AI NPC is activated ingame, it pulls their name and character information from the character biography database into the appropriate fields.
- It is much easier to edit biography information after an AI NPC has been imported. You can do it while the game is running with no restart required! Just click Save.
- If you want to pre-set biographies for a large number of NPCs, specially for custom ones, use the NPC Biography Management page.
¶ Dynamic Profiles
NPC Biographies are split into 2 sections, Static & Dynamic.
The goal here is to have AI NPC’s dynamically evolve through gameplay and interactions.
While also not completely rewriting their character due to AI hallucinations!
Static information is about the core traits of a character, such as their gender, race, job etc.
Dynamic information is about traits on a character that can change, such as current mood, likes, dislikes, goals etc.
Dynamic informationcan be triggered to update automatically or manually. It will pull the current event context log and character information to generate a summary of their current feelings and thoughts. For some NPC’s this may be empty by default. This is fine as it will get filled in automatically if enabled.
