ShipwrightsTouch

Shipwright's Touch

A Valheim mod that lets you name your ships, color their sails any color, and put your own images on them, shared with everyone on your server. Servers can also offer Safe Harbor: monsters leave unattended ships alone, and a capsized ship can be turned upright before it's lost.

Features

• Customization Panel: Press Left Shift + E while looking at a ship (rudder, seats, mast, or hull) to open a panel where you name the ship, pick its sail color and sail texture, and choose who owns it. Changes preview live on the ship and are saved when you click Apply.
• Any Sail Color: Pick a preset swatch or type any #RRGGBB color. Your last few custom colors are kept as swatches for next time. Press E while placing a ship with your Hammer to cycle the presets before it's built.
• Custom Sail Textures: Four historically inspired Viking Age sails are included, and you can add your own PNG or JPG images and choose them in the panel. The sail color tints the image; pick white to show it as-is.
• Sharing on Servers: On a server with this mod, a texture you put on a ship is shared with the server the first time you use it, so everyone sees it. Only a clean PNG copy of the picture is ever shared. Server owners decide whether players may share, set limits, and can require a moderator's approval first.
• Moderation: Server admins, and moderators they choose, review shared textures in an in-game panel: approve, deny, or remove them.
• Safe Harbor (server options): Monsters stop picking on ships nobody is aboard, and a capsized ship no longer breaks apart on its own: hold your interact key on the hull to turn it upright. See Safe Harbor below.
• Dynamic Hover Text: The ship's name is displayed in yellow at the top of the hover text for all ship parts, including the hull and storage containers.
• Builder Identity & Restrictions: When a ship is constructed, the builder is recorded as its owner. Only the owner can customize or deconstruct it; a ship made public can be customized by anyone. The owner's name is displayed in the hover text.
• Configurable Keybindings: Every keybinding can be changed in the config, and the hover text always shows the keys you have set.
• Mod Compatibility: Designed to work alongside popular mods like QuickStackStore. Interaction prompts are disabled on containers to ensure no conflict with storage-specific features.

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 contents of the zip's plugins folder (ShipwrightsTouch.dll and the ShipwrightsTouch-Sails folder) into your <Valheim Install Folder>\BepInEx\plugins directory.

On a dedicated server, install it the same way to share textures between players. Without the mod on the server, names and colors still work for everyone who has the mod, but custom textures show only to the player who chose them.

> Compatibility: tested with Valheim 1.0.

Custom Sail Textures

Included sails

Four sails come with the mod, styled after surviving Viking Age sails, all woven wool sewn together from strips of cloth:

• Gokstad Stripes: white wool with sewn-on red stripes, after the sail remnants found with the Gokstad ship.
• Gotland Lozenge and Gotland Checks: diamond and chequered sails, as carved on the Gotland picture stones.
• Plain Wadmal: undyed wool (vaðmál), the everyday sailcloth.

On a server with this mod they're the server's own textures: everyone sees them, no download or approval needed. Sail packs installed with a mod manager work the same way: any ShipwrightsTouch-Sails folder under BepInEx/plugins is used.

Your own sails

Put PNG or JPG images in BepInEx/config/ShipwrightsTouch/sails (the folder is created on first run) and pick them in the customization panel. Keep your own images here, not under plugins: mod managers replace a mod's plugin folder when it updates.