STOBE

Dwemer Dynamics Home Overview Installation Configuration Roleplay Settings Kenshi Settings Large Language Models Text-to-Speech Modders Guide FAQ Remote Hosting Guide Linux Setup Guide Log Files

⬇️Download 🎥Video Guide DiscordDiscord YouTubeYouTube PatreonPatreon

STOBE Modders Guide

STOBE mod support is mainly a CSV auto-import workflow. You package supported CSV files with your mod, STOBE finds them on startup, and the server imports them automatically.

Auto Import

On startup, STOBE scans these folders for top-level .csv files:

  • mods\Stobe\
  • mods\<YourMod>\Stobe\

If it finds a supported CSV there, it uploads it to StobeServer/csv_import.php. The server then sorts the file into the right import type based on the filename and header row.

Supported CSV Types

  • *_bio_random.csv or *_bios.csv: random biography traits for NPC types.
  • *_bio_unique.csv: biography entries for specific named NPCs.
  • *_bio_token.csv or *_rename_token.csv: rename-token words like guard titles and generic labels.
  • *_descriptions.csv: item, faction, or object descriptions.
  • *_world_knowledge.csv, *_worldstate.csv, or files with oghma in the name: world knowledge topics.

What The Files Look Like

STOBE includes sample files for each supported format. These are the practical shapes the importer expects:

You can download the current sample CSVs from the STOBE Nexus files page.

  • Random bios: stringid,name,description,race,gender,faction
  • Unique bios: stringid,name,description
  • Rename tokens: token
  • Descriptions: stringid,name,description
  • World knowledge: topic,topic_desc,topic_desc_basic,knowledge_class,knowledge_class_basic,aliases,tags

How To Package It

  • Create a Stobe folder inside your Kenshi mod folder.
  • Put your CSV files directly in that folder, not in subfolders.
  • Use filenames that clearly match one of the supported import types.
  • Ship those CSVs as part of the mod so the player installs them normally.

The result is simple: the player installs the mod, launches STOBE, and the data is picked up automatically.

Important Rules

  • STOBE only scans the top level of each Stobe folder.
  • Files must be real .csv files.
  • The startup importer rejects files over 10 MB.
  • For biography imports, valid STOBE bio types are personality, backstory, speechstyle, occupation, appearance, and goals.
  • If the importer cannot match the filename or header to a supported format, it skips the file.

How To Verify It Worked

  • Install the mod and launch the game with STOBE running.
  • Give STOBE time to finish its startup import pass.
  • Look for CSV_IMPORT lines in the STOBE log.
  • Open the matching STOBE server page and confirm your rows appeared there.

In practice, this is the STOBE modding path to use for custom bios, rename tokens, descriptions, and world knowledge.