Seatapult

Seatapult

A half-size, rideable catapult. You don't load a ballista and watch it aim — you climb into the operator's seat, aim the machine yourself, fire items from its ammo-store chest, and (optionally) eject yourself across the map.

A Valheim BepInEx 5 plugin built on Jotunn.

Features

• Seatapult build piece (Hammer > Misc), 20x Wood / 15x Stone / 5x Iron, cloned from the vanilla Ashlands Catapult at half size.
• Operator's seat with full aiming: arm angle, aim yaw, and launch power.
• Ammo store: a chest on the machine — anything placed inside can be fired (or filter it with AllowedItems).
• Ejector seat: launch yourself along the aim direction, with no fall damage and a synthesized cartoon scream by default.
• Deploy legs, adjustable power, in-game HUD panel while seated.

Requirements

• BepInEx 5 (denikson-BepInExPack_Valheim)
• Jotunn 2.30.x (ValheimModding-Jotunn)

Installation

• Install through your mod manager (recommended).
• Manual: drop Seatapult.dll into BepInEx\plugins\.

How to use

• Restart the game after installing (the build piece is registered at startup).
• Build the Seatapult from the Hammer under Misc and place it on solid ground.
• Open the ammo-store chest (on the machine) and load it with items to fire.
• Hover the seat and press E to sit. A HUD panel shows angle / aim / power / cooldown.
• While seated:

| Key | Action |

|-----|--------|

| Shift+F | Fire — launches the next allowed item from the store |

| Shift+Up / Shift+Down | Increase / decrease power |

| W/S or Up/Down | Raise / lower the arm angle |

| A/D or Left/Right | Swing aim left / right |

| V | Deploy / retract the legs |

| T | Eject yourself along the aim direction |

| E | Stand up |

Configuration

Generated on first launch at BepInEx\config\com.seatapult.seatapult.cfg:

| Section | Key | Default | Description |

|---------|-----|---------|-------------|

| General | Enabled | true | Master toggle. |

| General | AddBuildPieces | true | Register the piece (restart). |

| General | Scale | 0.55 | Model scale (0.25-1.0). Restart. |

| General | DebugLogging | true | Log Seatapult events. |

| General | DeployHeight | 0.9 | Lift height when legs are deployed (m). |

| Controls | DefaultAngle | 25 | Starting arm elevation (deg). |

| Controls | AngleMin / AngleMax | -10 / 75 | Arm elevation range (deg). |

| Controls | AngleSpeed | 30 | Arm speed (deg/s). |

| Controls | YawSpeed | 45 | Aim yaw speed (deg/s). |

| Controls | PowerStep | 0.08 | Power per Shift+Up/Down. |

| Controls | DefaultPower | 0.5 | Starting power (0-1). |

| Combat | FireCooldown | 2.5 | Seconds between shots. |

| Combat | EjectMultiplier | 1.0 | Power multiplier for the ejector seat. |

| Combat | EjectNoFallDamage | true | No fall damage when ejecting. |

| Combat | EjectScream | true | Play a cartoon scream on eject. |

| Combat | EjectScreamVolume | 1.0 | Scream volume (0-2). |

| Ammo | AllowedItems | (empty) | Comma-separated item names to load. Empty = anything in the store. |

Notes

• Co-op: only the ZDO owner of the piece can fire (others see a warning). Projectile visuals are local to the owner.
• AddBuildPieces and Scale need a restart; most other settings apply immediately.

Changelog

See CHANGELOG.md.