Changelog

[1.4.0] - 2026-10-14

Safe Harbor: servers can now keep unattended ships safe from monsters and rescue capsized ones. Update the mod on your server and for every player at the same time; 1.3 and 1.4 can't share textures with each other.

New

• Safe Harbor: Two server options, off by default. EnemiesIgnoreUnoccupiedShips: monsters don't go after a ship with nobody aboard (one already attacking keeps at it until you deal with it). RescueCapsizedShips: a capsized ship stops taking damage at 10% of its health, and holding your interact key on its hull turns it upright.
• RequireMatchingMod: A server option that only lets players join with a matching version of the mod. Players already connected without it get a 10 second countdown, then are disconnected with their character saved. The Safe Harbor options turn it on, since they only work when every player has the mod.

Fixed

• Hover text on the hull: Looking at a ship's hull showed nothing; it now shows the ship's name, builder and prompts, like the rudder and the rest of the ship.
• Name box after rejoining: The customization panel no longer loses its name box, color code box and texture list scrollbar after you log out and join a world again in the same game session.

Changed

• The server settings are listed in a fixed order in Configuration Manager: sail textures first, then the mod requirement and Safe Harbor.

[1.3.0] - 2026-10-06

Safer texture sharing: only clean pictures ever reach other players. Update the mod on your server and for every player at the same time; 1.2 and 1.3 can't share textures with each other.

New

• Clean shared images: A texture is converted to a plain PNG before it's shared, by your game and again by the server, and players only ever receive the server's copy. Nothing but the picture leaves your computer or reaches anyone else's: no camera location, no editor metadata, no hidden data.
• JPG sharing: JPG images can now be shared too.
• Moderation flags: The moderation panel flags an upload whose file held more than image data. Servers can deny those automatically with the new AutoDenyUnexpectedContent setting (off by default); the uploader sees it as auto-denied and can ask a moderator to review it.
• Transfer speed limit: The new MaxTransferKBPerSecond setting can slow texture transfers down to leave more room for world updates. Off by default.

Changes

• Size limit counts the converted PNG: A converted image is often larger than the original file (about 1.5× for typical artwork), so the default MaxTextureFileKB is now 2048. Servers set up with 1.2 keep their value until changed. The panel shows the converted size when a texture is over the limit.
• Upgrading a server: On first start, textures already shared are converted; the originals are kept in uploads/pre-1.3.0, and ships keep their sails.

Fixes

• Stalled uploads: If an upload stops arriving, the server now says so right away, instead of the player waiting for a timeout.

[1.2.1] - 2026-10-05

Fixes

• Included sails missing with mod managers: r2modman and Thunderstore installed the four included sails without their folder, so the game never found them. Reinstalling or updating puts them back.
• Version mismatch notice: joining a server that runs a different version of Shipwright's Touch now tells you so, and whether the server's or yours is newer. Sail sharing stays off until they match, as before.
• Requires BepInExPack Valheim 5.4.2351.

[1.2.0] - 2026-10-05

Custom sail textures, any sail color, and a new customization panel. Install the mod on your server too if you want to share textures with other players.

New

• Customization Panel: Left Shift + E on a ship now opens a panel for its name, sail color, sail texture, and owner. Changes preview live on the ship and are saved when you click Apply.
• Any Sail Color: Pick a preset or type any #RRGGBB color. Your recent custom colors are kept as swatches.
• Custom Sail Textures: Four historically inspired Viking Age sails are included. Add your own PNG or JPG images in BepInEx/config/ShipwrightsTouch/sails and choose them in the panel. The sail color tints the image.
• Sail Packs: Any ShipwrightsTouch-Sails folder under BepInEx/plugins is used, so sail packs can be installed with a mod manager.
• Sharing: On a server with this mod, a PNG texture you put on a ship is shared with the server, so everyone sees it. Server owners decide whether players may share, set size and count limits, and can require approval first. A server's own textures go in its sails folder.
• Moderation: Admins, and moderators listed in the server's moderators.txt, approve, deny, or remove shared textures in an in-game moderation panel.
• Public Ships: The panel can make your ship public, so anyone can customize it, or claim a public ship as yours.
• New Settings: ShareMyTextures, ShowOtherPlayersTextures, CompressTextures, ScrollSensitivity, the OpenModeration key, and the server's texture settings. See the README.

Changes

• RenameShip is now CustomizeShip: same default key (Left Shift + E), and your saved key carries over.
• ChangeSailColor is unbound by default for new installs, since the panel covers it. If you had it set, it stays set.
• Left and right Shift, Ctrl, and Alt are now separate keys, as they are in the game. The default shortcuts use the left-hand keys, so if you pressed the right-hand ones, rebind the shortcut or switch hands.
• Log messages now appear in the BepInEx log under the mod's name, and routine messages are no longer logged as warnings.

[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.