Skip to content

About

Public Repo for the VoiceControl Mod

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

XNPC Voice Control

A voice-command and AI-conversation mod for 7 Days to Die, built on SphereII's 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, nothing leaves your machine.

📦 This repository is SOURCE ONLY. Downloads are on Nexus.

Get the mod → nexusmods.com/7daystodie/mods/10627

The packages are up to 3.6 GB of models and voices, which is far past what GitHub can host, so the built mod lives on Nexus and this repo holds the code that produces it. Building here gives you the mod DLL, not a playable package — see Building.

Which download do I want?

Package Size What you get
Complete ~3.6 GB Everything: voice commands, TTS, speech-to-text, LLM conversation and RAG memory. The chat model is included
Voice ~590 MB Voice commands, TTS and speech-to-text. No LLM conversation.
Core ~670 KB Voice commands only, no AI payload at all. This is the base Client and also the dedicated-server package — servers need no models or engines.

All three are self-contained; Core is the smallest choice in the lineup, not a base the others sit on top of.

Requirements

  • 7 Days to Die v3.2.0 (b10)
  • 0-SCore in Mods\0-SCore — SphereII.Mods
  • 0_TFP_Harmony in Mods\0_TFP_Harmony — ships with the game
  • NPCCore (0-XNPCCore) for the NPCs themselves

⚠️ Keep 0-SCore current. This mod is tested against 3.2.19.1009. Older builds carry a bug that could leave a parked companion permanently missing from a save, which is exactly the kind of thing you notice a week later — SphereII fixed it in 3.2.19.

Features

  • Voice commands — follow, stay, guard, patrol; formation positioning (cover/hold/watch north|south|east|west) with an auto-spreading squad allocator and an eight-point radial; 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, deterministic, no chat, clarify-on-miss.
  • Local AI conversation — LLM chat with per-NPC personality and RAG memory, local speech-to-text (whisper) and text-to-speech (Supertonic, 50 selectable voices).
  • Single-player and dedicated-server support.

🔊 Browse and listen to every voice — 50 voices, two samples each, with the exact name to paste into personalities.xml.

Building from source

⛔ A source build produces 1-XNPCVoiceControl.dll and nothing else — no sidecar servers, no models, no voices. The packaging pipeline needs the sidecar sources, which are not in this repo, so you cannot build Complete, Voice or Core here. Download a package from Nexus, then replace its DLL with yours.

That is the normal workflow for modifying this mod, and it works fine — the DLL is the part you'd want to change.

You need: .NET SDK 8+ (download), the game installed, and 0-SCore + 0_TFP_Harmony in the game's Mods\ folder.

dotnet build -c Release

On a standard Steam install that is the whole thing — 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 elsewhere, point the build at it (highest precedence first):

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 there.

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

Output: bin\Release\1-XNPCVoiceControl.dll. Back up the DLL in your installed Mods\1-XNPCVoiceControl\ and replace only that file — keep the existing Config/, Resources/, Plugins/ and server folders.

BUILDING.md has the same steps with full troubleshooting.

Docs

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

Credits & License

Built on SphereII's 0-SCore and NPCCore. Text-to-speech uses Supertonic; see the licence shipped alongside the voice models in the download. This project's licence is in LICENSE.

About

Public Repo for the VoiceControl Mod

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages