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

Action	Default Key	Config Option
Dismiss Skeleton	Mouse2 (Middle Click)	DismissKey
Cycle Summon Mode	G	CycleModeKey
Quick-Invert Mode	Left Shift (Hold while casting)	HoldShiftInvertsMode

---

⚙️ 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.