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.

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.
• Dynamic Hover Text: The ship's name is displayed in yellow at the top of the hover text for all ship parts, including 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

r2modman (Recommended)

• Install Mod Manager or r2modman.

-or-

• Download the mod, and follow the Manual Installation instructions below.

Vortex

• Install via Vortex Mod Manager.

-or-

• Download the mod, and follow the Manual Installation instructions below.

Manual Installation

• Install BepInExPack Valheim.
• Download the latest release of Shipwright's Touch from GitHub.
• Extract the contents of the zip's plugins folder (ShipwrightsTouch.dll and the ShipwrightsTouch-Sails folder) into your \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.

• The image is stretched to fill the sail, on every ship type. Square images work well.
• Up to 2048×2048 pixels and 4 MB. Servers may set lower limit