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.