SkeletonCrew

Better Skeleton Summons for Valheim by Jubaroo

Empower your Blood Magic necromancy with intelligent quality-of-life enhancements for summoned skeletons.

✨ Features

1. 🎯 Middle-Click Dismissal with Hover HUD

• Hover Prompt: Hovering over any summoned skeleton of yours displays an intuitive prompt:
  [Middle Click] Dismiss skeleton (Keybind and text are customizable in config).
• Instant Unsummon: Clicking middle mouse unsummons the targeted skeleton with a satisfying puff of magic, freeing up your summon slots without damaging or killing them.
• Combat Safe: Intercepts secondary weapon attacks while aiming at your skeleton so your equipped weapon won't accidentally swing or waste stamina.

2. 🏹 Intuitive Bowman vs Swordsman Summoning

• Cycle Mode Key ([G]): While holding the Dead Raiser staff, press G to smoothly cycle between:
  • Swordsman (Equipped with sword & shield)
  • Bowman (Equipped with bow)
  • Random (Vanilla RNG behavior)
• Quick-Invert Modifier (Left Shift): Hold Left Shift while casting to temporarily invert your summon on the fly!
  • If you're on Swordsman mode, holding Shift spawns an archer.
  • If you're on Bowman mode, holding Shift spawns a swordsman.
• On-Screen Summon HUD: Displays your current summon mode directly below your crosshair when the Dead Raiser is drawn.
• Inventory Tooltip: Item tooltip for Dead Raiser displays the currently selected summon mode and keybindings.

3. ⛵ Automated Boat Boarding & Disembarking

• Sail with your Skeletal Crew: When you step aboard any boat (Raft, Karve, Longship, Drakkar), following skeletons within boarding distance automatically hop aboard.
• Stable Deck Positioning: Skeletons match the boat's physics, remain firmly in symmetrical deck slots around the mast, and will not slide off, clip through, or fall overboard.
• Anti-Despawn Protection: Prevents distance-based unsummoning while sailing across vast oceans.
• Automated Disembarking: When you reach land or a dock and disembark, your skeletons smoothly disembark alongside you, resuming standard guard and follow behaviors.

⌨️ Controls & Keybindings

⚙️ Configuration

A configuration file is generated at BepInEx/config/com.jubaroo.skeletoncrew.cfg:

• 1 - General: Server config sync options and debug logging.
• 2 - Dismissal: Customizable keybind (DismissKey), prompt text, and HUD notifications.
• 3 - Summon Selection: Default launch mode (Swordsman / Bowman / Random), cycle hotkey (G), quick-invert modifier (Shift), and vanilla Key Hints bar toggle (ShowSummonModeKeyHint).
• 4 - Boat Riding: Enable/disable ship riding, boarding radius (default 25m), deck positioning, and anti-despawn safety.

📦 Installation

Install using r2modman / Thunderstore Mod Manager, or extract SkeletonCrew.dll into your Valheim/BepInEx/plugins/ folder.

Changelog

All notable changes to SkeletonCrew will be documented in this file.

[1.0.0] - 2026-10-30

Added

• Initial release of SkeletonCrew for Valheim.
• Middle-Click Dismissal with Hover HUD:
  • Intuitive hover prompt on player's summoned skeletons: [Middle Click] Dismiss skeleton (customizable key and text).
  • Instant unsummoning without damaging or killing minions.
  • Secondary attack interception prevents accidental weapon swings or stamina waste while aiming at skeletons.
• Intuitive Bowman vs Swordsman Summoning:
  • Cycle hotkey (G) while holding the Dead Raiser staff to smoothly toggle between Swordsman, Bowman, and Random modes.
  • Quick-invert modifier (Left Shift) while casting to temporarily swap summon type on the fly.
  • Seamless vanilla Key Hints bar integration at the bottom of the screen (alongside Attack, Block, Dodge) displaying active summon mode and cycle hotkey.
  • Dead Raiser inventory tooltip displaying current summon mode and hotkey hints.
• Automated Boat Boarding & Disembarking:
  • Follower skeletons automatically board boats (Raft, Karve, Longship, Drakkar) when the summoner boards.
  • Symmetrical deck positioning around the mast with stable physics to prevent clipping or sliding overboard.
  • Ocean sailing anti-despawn protection.
  • Smooth automated disembarking when reaching shore or docks.
• Configuration & ServerSync:
  • Comprehensive BepInEx configuration file (com.jubaroo.skeletoncrew.cfg).
  • Full multiplayer ServerSync support with server configuration enforcement and admin lock.