CHIM

Dwemer Dynamics Home Overview Installation Plugins Configuration Roleplay Settings Background Life Skyrim Settings Large Language Models Local LLMs Text-to-Speech Speech-to-Text Image-to-Text Modders Guide FAQ Remote Hosting Guide Linux Setup Guide Log Files

⬇️Download 🎥Video Guide DiscordDiscord YouTubeYouTube PatreonPatreon

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.

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, and Compact Chat context size.
  • Translation: Handles DeepL-based text and audio translation for players who want CHIM to speak across languages.

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.

Playthrough Manager

What this page does: Playthrough Manager is CHIM's snapshot system for your AI database state. It is for saving, switching, and restoring full CHIM playthrough states.

  • Active Database: CHIM keeps one live database in use right now. That is the state your current conversations and systems are using.
  • Stored Snapshots: You can save named snapshots with notes so you can return to an earlier AI state later.
  • Copy to Public: Loading a snapshot replaces the live CHIM database with that saved state and first auto-saves your current live state for safety.
  • Restart required: After switching snapshots, CHIM needs to be restarted before the new state is fully active.
  • Cleanup: Old snapshots can be deleted, but the active one cannot be removed from the page.

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.