Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
ShipPins
Pins vanilla and modded ships and carts with their build icons. Includes a collapsible map menu with category filters and overlapping label handling. Client-side, standalone, with optional ValheimPlus support.
| Date uploaded | 3 weeks ago |
| Version | 1.2.0 |
| Download link | Onononoki-ShipPins-1.2.0.zip |
| Downloads | 977 |
| Dependency string | Onononoki-ShipPins-1.2.0 |
This mod requires the following mods to function
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.2351README
ShipPins
Pins every ship and cart on the map, modded ones included.
Ships and carts from mods such as OdinShip or LoxWagon get a map pin like the vanilla ones. Works on its own, and with ValheimPlus too.
What it does
- Pins ships, carts, wagons, and siege machines built on the game's ship or cart components, using their build icons and in-game names.
- Pins follow their ship or cart every 2 seconds by default. The ship you steer has no pin because your own marker is there.
- Known ships and carts are updated separately from the periodic background search for new objects. The search is spread across frames.
- Pins are never saved to your map.
Map options
Click ShipPins Options above Cartography Table on the large map to expand the category switches. The panel uses the game's map style and opens upward. It starts collapsed whenever the map opens, and category choices stay saved when it closes.
- Vanilla ships includes Raft, Karve, Longship, and Drakkar.
- Modded ships includes every other ship prefab.
- Vanilla carts includes the vanilla Cart.
- Modded carts includes other carts, wagons, and modded siege machines, including Crafty Carts Remake carts using the game's cart component.
- Siege carts includes the vanilla Catapult and Battering Ram.
Overlapping ShipPins labels are hidden by default while their icons remain visible. Zoom in to separate the labels, or turn off HideOverlappingLabels to show every label.
With ValheimPlus
- V+'s displayCartsAndBoats option pins only the vanilla Cart, Raft, Karve, and Longship. With V+ installed, ShipPins switches that routine off and pins everything itself, so each object has one pin. Those four keep V+'s labels.
- It works whatever the server's V+ map setting says.
- If a V+ update changes its pin code, ShipPins leaves V+'s four vanilla pins to V+, pins the rest, and logs a warning. In that fallback, the category switches affect only ShipPins' own pins.
Requirements and config
- BepInExPack Valheim. ValheimPlus is optional.
- Client-side only. It is not needed on the server.
- Ships and carts use the position data available to your client. One that moves while you are far away can keep its last known position until the client receives an update.
- Settings are saved in BepInEx/config/onononoki.ShipPins.cfg.
| Section | Setting | Default | Effect |
|---|---|---|---|
| General | Enabled | true | Enables ShipPins. Off restores V+'s own pins when applicable. |
| General | UpdateSeconds | 2 | Seconds between position updates for known ships and carts. Range 0.5 to 10. |
| General | IconSize | 1.5 | Pin size multiplier. Range 1 to 2. |
| Map | ShowMapToggles | true | Shows ShipPins Options. Off hides the menu while category settings still apply. |
| Map | HideOverlappingLabels | true | Hides colliding ShipPins labels while keeping their icons. |
| Map | ShowVanillaShips | true | Shows Raft, Karve, Longship, and Drakkar pins. |
| Map | ShowModdedShips | true | Shows other ship pins. |
| Map | ShowVanillaCarts | true | Shows vanilla Cart pins. |
| Map | ShowModdedCarts | true | Shows other cart, wagon, and modded siege pins. |
| Map | ShowSiegeCarts | true | Shows vanilla Catapult and Battering Ram pins. |
Compatibility
- Works with mods that build ships and carts on the game's ship and cart components. Checked with OdinShip, LoxWagon, and Crafty Carts Remake carts.
- Safe to add or remove. Pin data is never saved to your map.
Thanks
- aasmall for the client-side mode and two pin fixes, first made in aasmall's fork.
Feedback and bug reports
Found a bug or have an idea? Open an issue on GitHub. The source code is in the GitHub repository.
CHANGELOG
Changelog
1.2.0
- Added a collapsible ShipPins Options menu on the large map using the game's map UI style.
- Added separate switches for vanilla ships, modded ships, vanilla carts, modded carts, and siege carts. Category choices are saved when the menu is closed.
- The menu starts collapsed whenever the map opens. ShowMapToggles can hide it while category settings remain active.
- Overlapping ship and cart labels are hidden while their icons remain visible. Zoom in to separate them, or disable HideOverlappingLabels to show every label.
1.1.2
- Much lighter. The pins now follow only the ships and carts already found, and the search for new ones runs slowly in the background. A ship or cart that loads near you is pinned at once, one built far away by someone else within about 30 seconds.
- The pins of destroyed ships are now always cleared from ShipPins' own list when the game reuses their record.
1.1.1
- Lighter on big worlds. The search for ships and carts is spread over several frames, so it no longer causes a short stutter every few seconds.
1.1.0
- Works on its own now, ValheimPlus is no longer needed. With V+ installed, ShipPins replaces V+'s own boat and cart pins, so each ship has one pin.
- Client-side only: the pins show whatever the server's V+ map setting says.
- Pins of destroyed ships no longer stay stranded on the map when the game reuses their object record.
- Pins show up as soon as the map loads.
- New setting
UpdateSeconds(default 2): how often the pins follow the ships and carts. - Pins are 1.5 times the normal pin size, with the name below the icon instead of over it. New setting
IconSize(1 to 2, V+'s pins are 2). - Thanks to aasmall for the client-side mode and both pin fixes, first made in aasmall's fork.
1.0.2
- Added links to the GitHub page for feedback and bug reports. Shorter description.
1.0.1
- Small build cleanup. No gameplay changes.
1.0.0
- First release.
- Runs V+'s boat and cart map pins for every ship and cart prefab, modded ones included, in place of its four vanilla ones.
- Same look as V+'s pins. Modded ones are labeled with their in-game name.