Calzone0131-OutDatedNpcFixer icon

OutDatedNpcFixer

Brings outdated NPC mods back to life. Broken NPCs that spawn as limp, ungrabbable ragdolls get a fresh working AI, grabs and haptics, while keeping their model, voice, jiggle physics and stats.

Last updated 2 weeks ago
Total downloads 510
Total rating 0 
Categories Code Mods AI Generated Utility
Dependency string Calzone0131-OutDatedNpcFixer-1.7.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

bonelib-BoneLib-3.2.2 icon
bonelib-BoneLib

A BONELAB mod for making life easier for other mod creators.

Preferred version: 3.2.2

README

Outdated NPC Fixer

Old NPC mods often break after BONELAB updates: they spawn as a limp ragdoll on the floor that you can't grab, with no AI. Outdated NPC Fixer fixes them automatically.

When a broken NPC spawns, it gets swapped for a fresh, fully working NPC wearing the old NPC's model. It walks, fights, reacts, takes damage and dies like a normal NPC, and you can grab it again with normal hand poses and controller haptics.

Features

  • Auto Refresh Mode: every outdated NPC is fixed the moment you spawn it
  • Refresh Broken NPCs button: fixes any broken NPCs already in the level
  • Keeps the look: the old model, clothes, hats and accessories are moved onto the new NPC
  • Works with different skeletons: Ford-based NPCs, models attached to a Ford rig (e.g. ValveBiped/Source models), and other humanoid rigs
  • Original sounds: copies the old NPC's voice (aggro, pain, death, attacks, efforts...) and silences leftover default sounds it didn't have
  • Original behaviour: copies the old NPC's health, damage resistance, speed, ranges and combat settings
  • Jiggle physics: rebuilds the mod's own jiggle bones (hair, clothes, gear...) with an adjustable strength and touchable colliders
  • Everything resets when the NPC despawns, so normal NPCs stay normal

BoneMenu > Outdated NPC Fixer

Option What it does
Refresh Broken NPCs Fix broken NPCs in the level right now
Auto Refresh Mode Fix broken NPCs automatically when they spawn
Scan Report (console) Logs every ragdoll in the level and why it was / wasn't detected
Keep Jiggle Physics Rebuild the mod's jiggle bones
Jiggle Amount 0.1 = barely moves, 1 = the mod's original settings
Touchable Jiggle Hands and objects can push jiggle parts
Copy Sounds Use the old NPC's voice and sound players
Only Original Sounds Silence default sounds the old NPC didn't have
Copy Behaviour Use the old NPC's health / speed / combat settings
Keep Original Weight Keep the old NPC's body part weights (when part names match)
Notifications Show popups

Settings are also in UserData/MelonPreferences.cfg under [NPCReviver].

Tested

Tested in-game (BONELAB patch 6, MelonLoader 0.7, BoneLib 3.2.2) on outdated Ford-based NPCs and on old NPCs whose model is attached to a Ford-style rig. Made with AI assistance and tested by the author.

Notes

  • Singleplayer. In Fusion other players may not see the swap.
  • The old NPC's own AI "brain" (who it targets, special scripted behaviour) was removed by the game update, so the core AI is the standard NPC AI.
  • Jiggle made with custom scripts (instead of joints) can't be restored.
  • If an NPC isn't fixed, press Scan Report and check the MelonLoader console.

Credits

Made by Calvin. Requires BoneLib.