Settler Debugger
⚪ Last updated 2023⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview

🔍 Analysis
- 👍 4.1% endorsement rate — high engagement, a strong quality signal
- 🏆 #18 of 34 Utilities mods in this game by downloads
📋 About This Mod
Console based debugger tool for Settlers.
About this tool:
First of all, it's not a mod. It's a debugger tool (a custom set of console commands) that can be used to debug (identify and possibly fix) NPC (mainly settler) errors.
This tool is designed especially for my recruitment mod series' (Recruit Virgil, Sierra Petrovita, etc.) recruitable characters but of course it works with any NPCs, both vanilla and mod added ones (which is not suprising considering that most of my recruitment mods allow players to recruit the "original" NPCs, not duplicates aside from some exceptions like Private Hart).
It can be configured to give feedback about function calls / display returned NPC data either in the form of a message box or print them directly as text to the Papyrus log (see SetDebugTypeIndex).
Why release a debugger tool:
Today, (on 2023. 02. 05., the day I wrote this description) I have about 30 recruitment mods with at least 45 named recruitable characters (plus the unlimited random encounter settlers and traders) on nexusmods. I decided to publish a debugger tool (which is actually pretty similar to the one I use) for these characters.
Even though I do my best to make my mods compatible with other settlement mods (especially with the "big titles"), occasional conflicts are inevitable. Either on the "record level" (e.g., Magnolia replacer) or "AI level" (e.g., "I have mod X that adds several quests for recruitable NPC Y and I can't assign Y."). So, I wanted to publish a tool that can easily identify conflicts and other possible errors. Of course, (while I know it is named "Settler Debugger"), later I decided to add many more features to it, such as the ability to manipulate the NPCs themselves.
Notes: the debugger isn't just for settlers, it can also edit/display many Actor-related data (which is applicable to all NPCs). For example, changing the essential and protected flags, refreshing the actor (3D reload with AI recalculation ), force (instant) pathing to the AI target location, etc.
Request NPC Info:
==> Returns if NPC has WorkshopNPCScript.
Example: would return if Piper is considered to be a settler by the settlement system.
[CQF SettlerDebugger Req
📊 Mod Details
- Game
- Fallout 4 Mods
- Author
- LarannKiar
- Version
- 1.3
- Downloads
- 3,025
- Endorsements
- 125
- Category
- Utilities
- Created
- 2/5/2023
- Updated
- 2/6/2023
🔧 How to Install Fallout 4 Mods
Download from Nexus.
📖 Full step-by-step install guide for Fallout 4 →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Fallout 4 commands, item IDs, and more.
Keep browsing — more Fallout 4 mods await