RoleplayNPCs

Give your Valheim settlement a daily life. Create residents with their own homes, work, conversations and relationships.

Playtest build: movement, animations and multiplayer are still being refined.

Features

• Daily routines: work, sleep, meals, baths, sheltered breaks and optional social hours.
• Professions: Trader, Blacksmith, Tavernkeeper, Fisherman, Patron and Harlot.
• Resident personalities: persistent traits, moods, friendships, rivalries and spouse bonds influence dialogue.
• Settlement life: daily shops, tavern table service, fishing and resource upkeep using eligible stored supplies.
• Customization: names, appearance, cosmetic outfits, areas and schedules through the Settlement Charter.
• English and Russian dialogue, with optional server-side text overrides.

Residents are civilians. Their equipment and work gestures are cosmetic; routines operate in loaded areas.

Getting started

1. Install BepInExPack Valheim and RoleplayNPCs through your mod manager. For a local build in Gale, import the release ZIP; for manual installation, put the DLL in BepInEx/plugins/RoleplayNPCs/.
2. Use the same mod version on the server and every client. Close Valheim before updating and keep world backups.
3. As host/server administrator, craft a Settlement Charter with 2 Leather scraps + 1 Coal. Open it from your inventory or hotbar.
4. Summon a resident and assign a home. Add a profession/workplace, bed and social area as needed. The journal also manages hours, appearance and outfits.

Interact with residents for conversation and available profession services. Most setup is handled by the journal; console commands are optional.

Useful admin commands

Aim at a resident, or add their name after the command.

Command	Purpose
rpnpc_audit [name]	Check routes, setup and activity problems.
rpnpc_dialogue_debug [name]	Inspect mood, trait and dialogue choices.
rpnpc_rescue [name]	Bring an eligible nearby resident to safe floor beside you.
rpnpc_debug	Toggle the local movement overlay.

Settings and help

General settings are in the BepInEx config. Resident assignments are saved in the world. Built-in dialogue works without configuration; custom text is optional.

The download includes NPC_BEHAVIOUR.md for detailed rules and commands, and README-dialogue.md for editing conversations.

Host recovery archives are stored in BepInEx/config/RoleplayNPCs/archives/. Copy them separately when moving a world to another profile or server; keep normal world backups too.

For bug reports, include the mod version, host/client role, resident's intended activity and the relevant BepInEx/LogOutput.log excerpt.