Communities

ValheimSwornProtectors

Install

Last Updated

First Uploaded

Downloads

389

Likes

Size

164KB

Dependency string

MitchMods-SwornProtectors-1.1.0

Dependants

1 other mods

Mods Misc Utility NPCs AI Generated

Download

Details Required (1)Wiki Changelog Versions Analysis

Changelog

v1.1.0

New Features

Custom Placement Mode: Click "Custom Placement" in the H menu to enter point-and-click placement. Your cursor becomes free, a green marker shows exactly where protectors will spawn. Left-click to place, right-click to cancel
Single Placement: Set count to 1 and place protectors one at a time, clicking wherever you want them. Keep going until you hit the cap or right-click to stop
Group Placement: Set count to 2+ and place an entire formation grid at once, centered on your click
Hold On Activate: Custom-placed protectors stay where you put them when equipped, instead of running to follow you

Fixes

Structure-Aware Spawning: Protectors now spawn on castle floors, platforms, and built structures instead of falling through to terrain below
Floor Clip Prevention: Upward raycast check ensures protectors never clip through floors
No More Punch-Through: Clicking menu buttons or placing protectors no longer triggers player attacks
Surface Detection: All spawn and teleport positions use Physics.Raycast with proper Valheim layer masks instead of terrain-only heightmap

v1.0.0

New Features

Ship Boarding: Board any ship with your full squad. Protectors sit in formation on the deck, weapons sheathed, locked in place while sailing. Works with Karve, Longship, and Ashlands viking ship
Slaughter Mode: 60-meter aggressive seek-and-destroy radius. Toggle on and protectors sprint after every hostile creature in range
Invincible Toggle: Make protectors unkillable for cinematic filming
Dismiss All: One button to despawn every protector instantly for a clean reset
Menu-Only Commands: Follow, Stay, Defend, Slaughter, and Invincible all controlled from the H panel

Fixes

Shield Wall: Now positions protectors in front of the player in 3 rows of 5, all facing the player's direction. Fast response when player turns around
Parade Formation: Uses stable positioning (no Perlin drift) so protectors hold clean parade positions without fidgeting
Ship Physics: Protectors disable colliders and rigidbody while boarded so they don't sink the ship
Water Splash: Suppressed on boarded protectors so they don't get splashed while sitting inside the boat
Weapon Sheathing: Weapons stay hidden while on ship (per-frame enforcement)

Removed

F9/F10/F11 keybinds removed (replaced by menu buttons to prevent input conflicts)

v0.5.0 - Initial Release

Core Systems

NPC companion spawning (1-15 protectors) using cloned Player prefab with fresh Humanoid + BaseAI
State machine: Awaiting, Following, MovingTo, Attacking, Holding
Summoning ritual: protectors spawn kneeling in parade grid, activate on equipment application
NavMesh pathfinding with direct-movement fallback for stuck paths
Smart teleport when protectors fall 40+ meters behind
Cloth physics reset on teleport to prevent cape warping

Formations

6 formation types: Diamond, Line, Wedge, Shield Wall, Circle, Parade
Diamond scales from 1-15 with ring-based slot placement
Parade auto-holds protectors at attention on arrival
Instant reposition on formation switch

Movement & AI

Walk-default following with distance-based run catch-up
Perlin noise drift for organic, human-like movement
Per-protector reaction delay (point man fast, flankers relaxed)
Settle hysteresis to prevent idle fidgeting
Player avoidance steering (protectors go around you, not through you)
Hard repulsion zone to prevent clipping into player model
Swimming support with direct movement (no NavMesh in water)

Equipment

Full equipment system: Head, Chest, Legs, Cape, Weapon, Offhand
Runtime ObjectDB scan — supports all items including modded gear
Cape color variants (Linen Cape: 10 colors, Lox Cape: 3 variants)
Save/Load/Delete up to 3 outfit presets
Default loadout: Flametal armor, red Linen Cape, Splitnir, Flametal Shield
Equipment browse mode with scrollable item lists

Weapon Display

Weapon draw/sheathe synced with player's R key
Per-frame VisEquipment sync to display back-mounted weapons
ZDO-based fallback for equipment visual state
Explicit back-item/hand-item push via reflection

Combat

Auto-defend toggle (12m scan range)
Max weapon proficiency (GetSkillFactor = 1.0)
Friendly fire prevention (Harmony patches on IsEnemy + Damage)
Attack command via crosshair targeting

Voice Barks

100 random spawn barks (medieval humor, groveling, confused)
100 random equip barks (hyped, loyal, over-the-top)
Speech bubbles above protector heads via Valheim's NPC text system
Staggered random delays so barks feel natural

GUI

Dark warrior aesthetic panel with golden glow border and blood-rope trim
Formation selector (2 rows of buttons)
Equipment browser with per-slot dropdown
Outfit save/load/delete rows
Cinematic keybinds: F9 (Attack/Move), F10 (Follow), F11 (Hold)
Minimap pins for all protectors (P1, P2, P3...)

Technical

BepInEx plugin framework (net462)
Harmony patches for game integration
Reflection-based access to protected Humanoid/VisEquipment members
Prefab registered with ZNetScene for networking
Non-persistent ZDOs (protectors are ephemeral, despawn on logout)
Try-catch wrapped UpdateAI to prevent silent AI death

Valheim

Details

Categories

Changelog

v1.1.0

New Features

Fixes

v1.0.0

New Features

Fixes

Removed

v0.5.0 - Initial Release

Core Systems

Formations

Movement & AI

Equipment

Weapon Display

Combat

Voice Barks

GUI

Technical

Categories

Changelog

v1.1.0

New Features

Fixes

v1.0.0

New Features

Fixes

Removed

v0.5.0 - Initial Release

Core Systems

Formations

Movement & AI

Equipment

Weapon Display

Combat

Voice Barks

GUI

Technical

Categories