XNPC Voice Control

A voice-command and AI-conversation mod for 7 Days to Die (built on 0-SCore / NPCCore). Talk to your hired NPCs by voice — squad and positioning commands, or a real conversation powered by a local LLM, speech-to-text, and text-to-speech (no cloud, no API keys).

This repo is the complete, runnable mod — sidecar servers, DLLs, and config included. You need to add an ai model in .gguf format into the mods resources/Llama/Models folder. A small model suitable for a 6 gig vram gpu is an additional download file in this repo. Better AI is recommended for better chats.

Features (v3.1.x)

• Voice commands: follow / stay / guard / patrol; formation positioning (cover/hold/watch north|south|east|west) with an auto-spreading squad allocator, plus an eight-point radial on ;; follow-distance; commanded crouch; go there to send a companion where you are looking.
• Three combat stances: weapons free hunts on sight, cover me defends you and holds position, full control is self-defence only — and disengage breaks off and brings them back.
• Tactical mode: command-only mode (voice toggle) — deterministic, no chat, clarify-on-miss.
• Local AI conversation: LLM chat with per-NPC personality + RAG memory; local STT (whisper) and TTS (Supertonic + Kokoro).
• Single-player + dedicated-server support.

Build from source (optional)

The compiled mod DLL ships in this repo, so you only need this if you want to modify it.

You need:

• .NET SDK 8 or newer — download
• 7 Days to Die installed
• 0-SCore in the game's Mods\0-SCore — SphereII.Mods
• 0_TFP_Harmony in Mods\0_TFP_Harmony — this ships with the game

Build. From the root of this repo, where NPCVoiceControl.csproj sits:

dotnet build -c Release

That is the whole thing on a standard Steam install — the game folder is auto-detected and every reference path, 0-SCore included, is derived from it. No file needs editing.

If your game is somewhere else, point the build at it in any one of these ways (highest precedence first) — you still edit no project file:

dotnet build -c Release -p:GamePath="E:\Your\Path\7 Days To Die"

set SDTD_GAMEPATH=E:\Your\Path\7 Days To Die
dotnet build -c Release

…or copy Local.props.example to Local.props (git-ignored) and put your path in it.

A wrong path fails with a single clear message naming what it could not find, rather than a wall of compiler errors.

Output is bin\Release\1-XNPCVoiceControl.dll. To use it, back up the DLL in your installed Mods\1-XNPCVoiceControl\ and replace only that file — keep the existing Config/, Resources/, Plugins/ and server folders, because a source build produces the mod DLL alone and none of the AI sidecars, voice models or runtime resources.

BUILDING.md has the same steps with the full troubleshooting list.

Docs

Config/voice-command-card.html — every voice command and its alternate phrasings on one printable page. Config/ReadMeFirst.md — setup, in-game settings, console commands, FAQ and known issues. Config/ — all mod XML. Plus BUILDING.md, ARCHITECTURE.md and CHANGELOG.md.

Credits & License

Built on SphereII's 0-SCore / NPCCore. See LICENSE.