CHIM Configuration

This page explains the main CHIM setup pages inside HerikaServer in plain language. Use it once your install is working and you want to tune how CHIM behaves in play.

Global Settings, Profiles, and CHIM NPCs can also be edited in game from the Settings hub on the Prisma Master Menu, so quick changes do not need a trip to the web interface.

General Settings

What this page does: This is the global behavior page for CHIM. Changes here affect the whole playthrough, not just one NPC or one profile.

  • Prompt: Sets the main instruction text CHIM follows and the mood list it can use when it formats emotional tags.
  • Rechat: Chooses how follow-up conversation is targeted. Tight, Conversational, Group, and Random modes range from strict speaker continuity to looser multi-NPC conversation, and the active mode can also be changed from the Prisma chatbox.
  • Memory: Turns long-term memory on or off, controls whether text2vec is used, and decides how often CHIM writes fresh summaries.
  • Global Connectors: Chooses the shared AI brains used for player respeech, summaries, middle-term memory and Background Life, scene classification, dynamic profiles, director mode, relationship handling, and custom Oghma work.
  • Context: Filters what world information is sent into prompts, including event types, timestamps, power awareness, item detail policies, and noisy item, location, or magic data you may want to trim out.
  • Prompt Context Selections: Lets you choose which character, appearance, equipment, inventory, relationship, and general-context buckets CHIM should carry into conversations.
  • Misc: Covers auto-locking profiles, auto-filling custom profiles, Background Life Trigger Time in hours, end-conversation cooldowns.
  • Translation: Handles DeepL-based text and audio translation for players who want CHIM to speak across languages.

Background Life: Choose its model under Global Connectors, set its timing under Misc, and give each NPC a routine in Background Life Goals. See the Background Life guide for the full walkthrough.

Profiles

What this page does: Profiles are reusable behavior presets for NPCs and narrator setups. Instead of configuring every character one by one, you build profile bundles and assign characters to them.

  • Basic profile setup: Each profile has a label and an optional slot from 1 to 4 so you can swap to it more easily in game.
  • Behavior defaults: A profile can be the default for newly discovered NPCs or the default narrator setup, and it also decides whether dynamic profile changes are allowed.
  • Dynamic Profile fields: You can choose whether CHIM is allowed to evolve personality, speech style, and goals for NPCs using that profile.
  • Diary options: Profiles control automatic diary writing, wait-event diaries, physical in-game diary books, and whether the latest entry is included in that NPC's conversation context.
  • Connector choices: Each profile can use its own Standard, Fast, Powerful, Experimental, Diary, and Formatter large language models, plus its own Text-to-Speech and Image-to-Text connectors.
  • Random LLM selection: A profile can rotate between its assigned conversation models instead of always using one fixed LLM.
  • Import and assignment: Imported names are cleaned before saving. During import you can make the profile the default and optionally move NPCs using the previous default or no profile onto it.
  • Workflow tools: The page also supports cloning, exporting, importing, testing all profiles, and assigning simple profile rules by source mod, faction, race, or other character details.
  • In play: NPCs using the same profile inherit the same overall behavior style, so this is the fastest way to make groups of characters feel different.

API Keys

What this page does: API Keys is the shared login page for CHIM services. You save provider keys here once, then the connector pages reuse them.

  • Preset keys: The page has built-in entries for OpenRouter, OpenAI, Deepgram, Google, Azure, and ElevenLabs.
  • Custom keys: You can also add your own named key rows for other supported services.
  • Used across CHIM: These saved keys are then selected by the Large Language Model, Text-to-Speech, Speech-to-Text, and Image-to-Text pages.
  • Quick testing: Some providers can be tested directly from this page so you can catch a bad key before troubleshooting the rest of the setup.

OpenRouter is optional. Follow Use Your Own LLM Provider to connect CHIM to another compatible hosted or local service.

See Playthrough Saves for saving and switching your AI history.

Narration

What this page does: This page controls how The Narrator behaves, how often it speaks, and what voice and profile it uses.

  • Core narrator toggles: You can turn the narrator on or off, keep it limited to book-style narration, hide it from normal context, and decide whether it can write diary content.
  • Inline narration: This decides what happens to *asterisked* narration. It can be spoken by the NPC, handed to The Narrator, removed, or left visible as text while being excluded from TTS.
  • Cleanup options: Asterisk cleanup is handled separately for display and speech, so action text can remain readable without forcing a particular narration voice.
  • Welcome, random, and bored commentary: You can tune welcome lines on load, random scene comments, and bored-event narrator takeovers with chance and cooldown controls.
  • Quest comments: Lets The Narrator react to quest objective updates, again with its own chance and cooldown settings.
  • Profile and voice: You choose the narrator profile, voice ID, and Oghma knowledge tags from here.
  • Diary memory: The Narrator can recall relevant diary entries from NPCs, or be restricted to entries written by The Narrator.
  • Advanced narrator behavior: The page also includes narrator-specific dynamic profile options, narrator action toggles, and narrator prompt overrides.

Player Roleplay

What this page does: This page is your player character sheet for CHIM. It tells the system who your character is, how they sound, and what information CHIM should track about them.

  • Identity: You can define the player name, physical description, and character background so NPCs have a stable idea of who you are.
  • Bio visibility: A simple toggle decides whether all NPCs know your background or whether that knowledge stays mainly with The Narrator.
  • Speech style: You can write your own player speech style or generate one so CHIM better preserves your character voice during roleplay.
  • Player diaries: The player has independent Auto Diary and Auto Diary Wait controls, so sleeping or waiting does not have to follow the NPC profile diary policy.
  • Player TTS: The page includes a dedicated player voice path with connector, voice, language, and provider-specific overrides.
  • Live tracked data: It also shows and stores current equipment, inventory, skills, and grouped Skyrim stats so the roleplay stays grounded in your actual playthrough.

Action Editor

What this page does: Action Editor controls which gameplay actions CHIM is allowed to use and where those actions are allowed to appear.

  • Main editor: The normal table keeps the action name, description, enabled state, and the controls most players need visible without exposing the full implementation.
  • Enabled state: Disabling an action removes the AI's permission to use it without changing the shipped base definition.
  • Require Confirmation: Supported actions can run automatically or wait for an Accept or Decline prompt in Prisma. Declining hard-cancels the action without generating another AI reply.
  • Custom actions: Imported and plugin-provided actions use the same confirmation control when their dispatch path supports game-side confirmation.
  • Advanced Options: Scope, return message, follow-up behavior, parameters, metadata, script proxy details, requirements, and action-specific settings live in a separate modal.
  • Reset Override: Removes your custom action settings and returns the row to its shipped definition.
  • Filtering: The page includes live search and scope filters so you can quickly find the exact action you need.

Prompts Manager

What this page does: Prompts Manager is the page for editing CHIM's built-in prompt text one prompt at a time.

  • Prompt browsing: The table is searchable by prompt key, description, status, and preview text.
  • Default versus custom: Each row shows the shipped default prompt and any custom replacement you have added.
  • Edit and clear: You can override only the prompts you care about, or clear a custom prompt to instantly fall back to the default.
  • Import and export: Custom prompt changes can be exported or imported as CSV for backup or sharing.

Playthrough Saves

Keep a separate AI history for each character. These saves hold CHIM conversations, memories and character state; keep saving your game normally too.

  • Choose a playthrough: Use the picker on the server home page to switch or start a new playthrough. Read the save details before choosing.
  • Save and transfer: Open Playthrough Management to manage your saves. Download a save for backup or import one when moving your AI history.
  • Automatic switching: Turn on Automatically switch playthroughs in the storage controls to match your loaded character. This is off by default. Reload your game save after enabling it and follow any prompt to associate an existing playthrough.
  • Before switching: The current AI progress is saved before the other playthrough is loaded.
  • Loading an older game save: AI history follows the game timeline. Automatic recovery saves use the Game days behind threshold. Check the recovery message and saved playthroughs if you need the later AI state.
  • Cleanup: Storage and Cleanup lets you choose which categories to clean and how old entries must be. Event cleanup is off by default. Review the category carefully before deleting anything.

Profile Updates And Event Filters

Choose how often characters develop and which events they use in conversation.

  • Profile timing: Set the dynamic-profile interval in the web settings, in game hours. Check the selected profile and any NPC override when one character needs a different schedule. The old game-menu timer is no longer the place to set it.
  • Event Type Filter: Tick an event type to exclude it from conversation context. Add a custom event type when it is not listed. This does not delete the saved event.
  • Voice: See Voice Tools for voice effects and pronunciation changes.