sighsorry-BottleShips icon

BottleShips

Adds bottle items for ships and carts. Build full-size pieces from bottles, tune recipes and stations, quick-attach carts, auto-reload troll traps, resize battering rams, and improve ballista targeting.

Last updated 10 hours ago
Total downloads 15836
Total rating 5 
Categories Mods Crafting Server-side Client-side Utility Bog Witch Update
Dependency string sighsorry-BottleShips-1.1.9
Dependants 18 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333

README

BottleShips

BottleShips adds 11 bottle items, each containing a ship, cart, battering ram, catapult, portal, trap, or ballista. Use a bottle as the build resource and place the full-size piece when you need it.

BottleShips must be installed on the server and every connecting client because it adds synchronized network prefabs and gameplay settings.

  • Each bottle is tied to the matching piece.
  • Pieces can be configured to use the bottle recipe or their original build recipe.
  • Build stations, build resources, bottle recipes, bottle weight, stack size, teleportability, and removal behavior are all configurable.

  • Keep bottles on item stands and grab one whenever you are ready to build.
  • No more digging through containers for every ship, portal, or siege piece.

  • If a ship breaks, carrying a spare bottle lets you rebuild it quickly.

  • Bottles on item stands.

  • Raft, karve, longship, and drakkar bottles.

  • Cart, battering ram, and catapult bottles.

  • Wood portal and stone portal bottles.

  • Troll trap and ballista bottles.

  • Bottle recipes at the workbench.

  • Bottle recipes at the forge.

  • Bottle recipes at the artisan table.

  • Bottles can be configured with weight, stack size, and teleportability.

  • Build full-size pieces using bottles, with optional station requirements.

Configuration

BottleShips is configured through the normal BepInEx config file. No YAML editing is required.

General options:

  • Extended Cart Interaction: client-only toggle that expands the normal attach/detach interaction of Vagon-based vehicles such as carts, battering rams, and catapults without adding a separate hotkey or tooltip. Default: On.
  • Troll Trap Auto Reload Seconds: automatically rearms piece_trap_troll after it triggers. Default: 5. Range: 0-10, where 0 disables it.
  • Battering Ram Size: scales newly placed battering rams. Default: 0.75. Range: 0.5-1. Existing placed battering rams are not changed.
  • Ballista Targeting Tweaks: trophy targets are prioritized, but the ballista can still attack other valid enemies. Players, tamed creatures, and creatures in the PlayerSpawned faction are never selected as targets.
  • Ballista Ammo Capacity: raises the actual ammunition capacity of all vanilla ballistas, so the hover display and compatible fill-all mods use the same limit. Default: 0 (original capacity). Range: 0-1000; values at or below the captured original capacity preserve the original value, and lowering it does not delete stored excess ammo.

Ship tweaks apply to every object with a Ship component, including ships added by other mods.

Ship tweak options:

  • Explore Radius Multiplier: multiplies minimap exploration radius while aboard a ship. Default: 1.
  • Ship Power Multiplier: scales wind-driven force at Half or Full and manual propulsion plus paddle steering at Slow or Back. It does not multiply speed-based steering or directly set top speed. Default: 1.
  • Power Paddling Bonus Per Player: the helmsman and passengers seated in ship chairs can each hold Run to consume a base 10 stamina per second and add the configured share of the ship's globally scaled paddling force. Passive occupants add nothing. It works only at Back or Slow and is unavailable at Half or Full while the sails are deployed. Each active paddler gets a smooth +10 effect on their own camera FOV; other paddlers do not stack additional FOV on that player. Default: 0.5 (50% per active player). Range: 0-1, where 0 disables Power Paddling.
  • Ship Repair Durability Per Wood: allows the repairing player to fully repair a ship outside its required build-station range by spending one Wood per configured amount of missing durability, rounded up. Station range is checked from the player's position. The configured build station is used when present; ships with Build Station = None use a Workbench as the repair-station fallback. Repairs within range remain free. While the hammer's repair piece is selected and a damaged field-repairable ship is targeted, the required amount is centered over the Wood icon beside the vanilla durability bar. Default: 200. Range: 0-1000, where 0 disables this feature and preserves vanilla repair behavior.

BottleShips disables its minimap, handling, and Power Paddling tweaks when RockTheBoat is installed to avoid applying the same features twice. Field ship repair remains available.

Each bottle section can configure:

  • Use Original Build Recipe
  • Build Station
  • Can Be Removed
  • Build Resources
  • Weight
  • Stack
  • Teleportable
  • Recipe Enabled
  • Recipe Station
  • Recipe Resources

Synced options are enforced from the server when BottleShips is installed on both server and clients. Client-only options, such as extended cart interaction, remain local.

Localization support

  • There should be BottleShips.English.yml in plugins folder. Translate it to your language and put it anywhere inside of the Bepinex folder

List of prefabs

  • Raft_bottle
  • Karve_bottle
  • VikingShip_bottle
  • VikingShip_Ashlands_bottle
  • Cart_bottle
  • BatteringRam_bottle
  • Catapult_bottle
  • portal_wood_bottle
  • portal_stone_bottle
  • piece_trap_troll_bottle
  • piece_turret_bottle

Special Thanks

  • Many thanks to GraveBear for kindly teaching me Unity and for all the troubleshooting help!
  • A huge thanks to Azumatt for Modding tutorial videos, Itemmangertemplate and all the help!