Shipwright's Touch

A Valheim mod that lets you name your ships and customize sail colors.

Features

• Ship Naming: Rename your ships using Shift + E while looking at the rudder, seats, mast, or hull.
• Dynamic Hover Text: The ship's custom name is displayed in yellow at the top of the hover text for all ship parts, including storage containers.
• Sail Coloring: Customize your ship's sail color during construction or afterwards. Press E while placing a ship with your Hammer, or Alt + E while looking at an existing ship.
• Configurable Keybindings: Every keybinding can be changed in the config, and the hover text always shows the keys you have set.
• Builder Identity & Restrictions: When a ship is constructed, the builder's identity is recorded. Only the builder (owner) can rename, recolor, or deconstruct the ship. The owner's name is displayed in the hover text.
• Mod Compatibility: Specifically designed to work alongside popular mods like QuickStackStore. Interaction prompts are disabled on containers to ensure no conflict with storage-specific features.
• Server Sync: Names, colors, and owners are stored in the ship's ZDO and synchronized across the server.

Installation

Thunderstore / r2modman (Recommended)

• Install via Thunderstore Mod Manager or r2modman.
  -or-
• Download the mod from Thunderstore, and follow the Manual Installation instructions below.

Nexus Mods / Vortex

• Install via Vortex Mod Manager.
  -or-
• Download the mod from Nexus Mods, and follow the Manual Installation instructions below.

Manual Installation

1. Install BepInExPack Valheim.
2. Download the latest release of Shipwright's Touch from GitHub.
3. Extract the ShipwrightsTouch.dll file into your <Valheim Install Folder>\BepInEx\plugins directory.

Compatibility: tested with Valheim 1.0.

Configuration

The mod generates a configuration file at BepInEx/config/com.malafein.shipwrightstouch.cfg after the first run. Settings can also be changed in-game with a configuration manager such as shudnal's Configuration Manager.

General

• AssignBuilderIdentity: Set to true (default) to assign your character as the owner when constructing a ship, restricting modifications to yourself.
• AllowShipDeconstruction: Set to true to allow removing ships with the hammer tool.

Controls

• RenameShip: Rename the ship you are looking at. Default Shift + E.
• ChangeSailColor: Cycle the sail color of the ship you are looking at. Default Alt + E.
• ChangeSailColorWhilePlacing: Cycle the sail color while placing a ship with the Hammer. Default E.

Either the left or right Shift, Ctrl, or Alt key satisfies a modifier. Plain E still works as normal on a ship: it takes the helm or sits you down.

If one of these keybindings is also bound to a game action, a warning is written to the BepInEx log (LogOutput.log) at startup and whenever a binding changes.

Technical Details

• Uses Harmony for patching Player, Ship, Container, Chair, ShipControlls, HoverText, and ZInput.
• Custom data is stored in ZDO keys: custom_ship_name, custom_sail_style, shipwrightstouch.builder_id, and shipwrightstouch.builder_name.
• Interaction logic is precisely focused to avoid conflict with container-specific mods.

License & Development

This project is licensed under the GNU General Public License v3.0 (GPLv3). You are free to modify and redistribute this mod under the same license terms.

Development Note: This mod was primarily developed with the assistance of Google Antigravity, Gemini, and Claude. The source code is open to the community to learn from, modify, and improve.

Changelog

[1.1.1] - 2026-09-10

• Corrected documentation.

[1.1.0] - 2026-09-10

• Updated for the Valheim 1.0 release, which moved the game to Unity 6. Version 1.0.2 of this mod does not work with Valheim 1.0, so updating is required.

Changes

• New Sail Color Keys: Valheim 1.0 uses G for its new radial menu, so sail coloring has moved. Use Alt + E while looking at an existing ship, or E while placing a ship. Renaming is unchanged (Shift + E).
• Configurable Keybindings: Renaming and both sail color actions can now be rebound in the new Controls section of the config. The hover text always shows the keys you have set.
• Keybinding Conflict Warning: If one of these keybindings is also bound to a game action, a warning is written to the log.

Fixes

• Typing a capital E in chat while looking at a ship's hull or mast no longer opens the rename box.

[1.0.2] - 2026-03-22

Features

• Sail Coloring on Existing Ships: You can now change the sail color of an existing ship using Shift + G.
• Builder Identity & Restrictions: The mod now optionally (enabled by default) tracks who built a ship. If tracking is enabled, only the owner can deconstruct, rename, or recolor the ship. The owner's name is also displayed on the ship's HoverText.

[1.0.1] - 2025-12-26

• Updated README with instructions for changing sail color.

[1.0.0] - 2025-12-25

Initial Release of Valheim Boat Customizer.

Features

• Ship Naming: Rename your ships using Shift + E while looking at the rudder, seats, mast, or hull.
• Universal Ship Header: The ship's name is dynamically displayed in yellow at the top of the hover text for all components (Cargo, Rudder, Mast, Hull).
• Sail Coloring: Support for custom sail styles synchronized via ZDO.
• Mod Compatibility: Precisely targeted interactions to avoid conflicts with container-specific mods like QuickStackStore.