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