1. Features
2. How the snapping works
3. What gets snapped
4. Installation
5. Configuration
6. Multiplayer
7. Compatibility
8. Troubleshooting
9. Bug reports
10. Discord
11. Building
12. Design notes
13. Author
14. Part of Longhouse

Sinka adds snap points to the vanilla pieces that ship without any, mainly chests, fences and stake walls. Place one and the next snaps flush beside it or squarely on top, the same way walls and floors already do.

Named for the dovetail joint. It started as a chest mod and now covers fences too; the name stayed so existing config files keep working.

Features

• Eight snap points, one on each corner of a piece's own measured footprint.
• Fences and stake walls get a ladder of points up each end instead, so a fence line can follow sloping ground.
• A standing wood torch placed on a wood pole snaps down into it, centred, with only its head showing above the top.
• Containers are matched by component, so modded chests are covered without naming them.
• Fences are matched by a config list you can extend.
• PointOverrides takes exact coordinates for a named prefab when the derived box is wrong.
• Optional: snap every buildable piece the game never gave points to.
• Pieces that already have snap points, vanilla or from another mod, are left alone.
• Nothing is added to prefabs you cannot build, so dungeon loot chests and pots stay unsnappable.

How the snapping works

A snap point in Valheim is a child transform tagged snappoint, and that is all the game needs. While you hold a placement ghost, FindClosestSnapPoints picks the closest pair of points within 0.5m, one on the ghost and one on a placed piece nearby, then moves the ghost so the two points become the same point.

That rule is why Sinka uses corners and nothing else. A ghost's left corner landing on a placed chest's right corner is flush adjacency, and a bottom corner landing on a top corner is a clean stack. Mixing corners with face centres would let a chest snap half its own width out of line.

Gap pushes the corners outward by half its value, since both pieces contribute half the space between them. Gap = 0.1 leaves 10cm between two chained chests.

Footprints are measured at load from collider data, and only from the geometry that will actually be standing there. A built piece carries its damage states and destruction chunks in the same prefab, and measuring all of them at once inflates the box: wood_fence comes out 2.72 x 2.30 x 0.85 that way against a panel of roughly 2.0 x 1.5, which would leave chained fences standing 0.72m apart.

The fence ladder

Eight corners give a fence two heights to attach at, its base and a full panel up. Neither helps you run a fence up a hill, so a fence gets points up both ends instead, at mid-depth, every FenceLadderStep metres, starting FenceLadderBelow metres under its own base so the next panel can step down as well as up. The rungs run along whichever horizontal axis of the piece is longer.

The ladder is capped at 24 rungs per piece. A tall piece with a small step hits that cap and logs a warning saying where the ladder stopped.

Torches on poles

Aim a standing wood torch at the top of a 1m or 2m wood pole and it snaps down into the pole, centred on it, with the top TorchStickOut metres of the torch (0.25 by default) standing above the pole. Build the pole first; the torch goes on afterwards.

The torch snaps only while the crosshair is on a listed pole's top face, and only into that pole. Aimed at anything else, a floor, a wall, the side of a pole, the ground beside one, a torch has no snap point at all and places exactly as it does without Sinka. Nothing ever snaps to a torch. Hold the place-without-snapping key to set a torch on a pole top without sinking it.

The snap has to slide the torch down most of its own length, and the game only looks half a metre around the ghost for something to snap to. So for a torch aimed at a pole top, Sinka widens that search to the distance it measures off the torch at load.

TorchStickOut has a floor, about 0.21 for the wood torch. A burning torch spreads fire into a zone around its flame, and sunk any deeper that zone reaches into its own pole, which in the Ashlands burns the pole out from under it. A lower value is raised to the floor with a warning in the log.

Picking a snap point by hand

Q and E cycle the ghost's snap point while you are holding a piece (TabLeft / TabRight in the keybinds, so they follow a rebind), and the chosen point's name shows in the middle of the screen. Sinka names its points by position for that reason: snap_top-front-left for corners, snap_left-y0.60 for a fence rung, snap_into-pole for a torch, snap_custom1 for a point you supplied through PointOverrides.

What gets snapped

A piece has to be something you can actually build. The buildable set is read off the game's own piece tables, so the Hammer, Hoe, Cultivator and any modded tool with its own table all contribute and nothing needs listing. Turning BuildablePiecesOnly off drops that filter and snaps anything with a Piece component, which includes dungeon loot chests and pots.

Past that filter there are three ways in:

• Containers (SnapContainers, on): anything with both a Piece and a Container. Ships are excluded.
• Fences (SnapFences, on): the prefab names in FencePrefabs. Nothing about a fence's components distinguishes it from any other wall, so this one needs names.
• Everything else with no points of its own (SnapUnsnappedPieces, off): mostly chests, fences and loose decoration, since walls, floors and beams ship with their own. It also catches chairs, banners and item stands, where snapping tends to get in the way.

ExcludePrefabs wins over all of it, including PointOverrides. Prefab names are matched case-insensitively everywhere.

Installation

1. Install BepInEx 5.4.2350. BepInEx 5 only, not 6.
2. Install Sinka from Thunderstore with a mod manager, or drop Sinka.dll into BepInEx\plugins\Sinka\.

No other dependencies. Sinka does not use Longhouse Core.

Snapping happens on the client while you place a piece, so only the players who want it need it. A dedicated server gains nothing from having it installed, and loses nothing either.

Configuration

BepInEx\config\ezomic.valheim.sinka.cfg, written on first run.

The four torch settings are in the [Torches] section, Verbose is in [Diagnostics], and everything else is in [Snapping].

FencePrefabs defaults to wood_fence, piece_sharpstakes, piece_stakewall_blackwood, piece_dvergr_sharpstakes, piece_dvergr_stake_wall. Names that match no prefab are listed in the log at startup.

BepInEx writes every setting to the .cfg on first run, and the saved value beats a new default in a later version. If a setting looks like it is being ignored, edit the .cfg.

PointOverrides

One axis-aligned box cannot describe an L-shape or a piece whose geometry sits off centre. piece_dvergr_sharpstakes measures 2.40 x 1.70 x 3.94 centred 0.35 off in x, so the corners of its box are nowhere near the actual stakes. PointOverrides replaces the derived points with exact ones:

PointOverrides = piece_dvergr_sharpstakes: -0.5,0,2 | -0.5,0,-2 ; wooden_fence_1_gate: -2.4,0,0 | -2.4,1.17,0

Semicolons separate prefabs, a colon follows the prefab name, pipes separate points, and commas separate the three local coordinates of one point. Decimals must use a dot, because a comma already means something here.

Naming a prefab is enough to get it snapped: it does not also have to be a container or a listed fence, and it skips the buildable filter. Gap and the fence ladder do not apply, since a point given by hand is used exactly as written. A malformed entry is reported in the log and dropped, and the rest of the config still loads.

Multiplayer

Snap points are added to prefabs in your own game, nothing is sent over the network, and world data is unaffected. A player without Sinka sees the pieces exactly where you placed them, they just have more work to do lining up their own.

Sinka does not register with Longhouse Core's version check, so nothing tells you when two players are running different builds of it. In practice that only shows up as one player finding a piece harder to align than the other did.

Compatibility

Sinka skips any piece that already has snap points, so it will not fight another mod for the same prefab, but whichever one registers first wins and the order is not something you control. Do not run it alongside other mods that add snap points to prefabs:

• FenceSnap by MSchmoecker
• ChestSnap by Frogger
• Extra Snap Points Made Easy by Searica

Extra Snap Points Made Easy is much broader than this mod: manual point cycling with keybinds, grid snapping, and points derived per piece shape across beams, triangles, rectangles and roofs. If you want the whole toolbox rather than chests and fences that line up, use that instead.

These work alongside Sinka, because they do not touch prefabs:

• Snap Points Made Easy by MathiasDecrock cycles the points a piece already has, with separate keys for the ghost's point and the target's. It adds none of its own, so Sinka supplies the points and it picks between them.
• PrecisePlacement, originally by Koosemose and re-uploaded by AcidWerks, now marked deprecated. Free rotation, arrow-key nudging, and copying a targeted piece's rotation and position onto the one you are holding.

Troubleshooting

A piece snaps at the wrong distance. Set Verbose = true and restart. Every piece that gets points logs its measured footprint followed by the colliders it was measured from, so you can see which collider is inflating the box. If the box cannot describe the piece, give it exact points through PointOverrides.

A fence name in the config does nothing. Check the startup log for a FencePrefabs names that match no prefab warning. The same check runs on PointOverrides, TorchPrefabs and PolePrefabs, and a listed pole with no snap points or no place in a build menu gets a warning of its own.

A torch will not snap into a pole. The pole's name has to be in PolePrefabs. With Verbose = true the log names the torch's socket height and how far it reaches.

A piece snaps while I place it, but nothing will snap to it afterwards. The game finds nearby pieces with a search limited to the piece and piece_nonsolid layers, and a piece whose colliders sit elsewhere is invisible to it. Sinka lists these in one warning at startup. Rewriting another mod's or the game's colliders onto a different layer changes what they collide with, so Sinka reports it rather than fixing it.

"No piece tables found after 900 frames". The buildable filter could not be built, so Sinka fell back to snapping anything with a Piece component, loot chests and pots included. Usually means another mod delayed or replaced ObjectDB.

Snap points did not appear at all. They are added to prefabs when the scene loads, so a config change needs a restart to the main menu at minimum. Check the startup line reading Added snap points to N piece(s).

Bug reports

Post in the Discord or open an issue at github.com/Ezomic/valheim-sinka. Useful to include:

• BepInEx\LogOutput.log, ideally with Verbose = true.
• Your ezomic.valheim.sinka.cfg.
• The prefab name of the piece involved. The log lines from Verbose give you these.
• Whether you were in single player or on a server, and any other snapping or building mods installed.

Discord

The Discord is where mod information, updates, support, bug reports and compatibility questions go.

There's also a small EU server running the Longhouse pack if you want somewhere to play. Details are in the Discord.

Building

dotnet build

Targets net462 and references the game's managed DLLs from the default Steam path. Output deploys to the repo-local testprofile\; override with -p:ProfileDir=..., or build it into the shared play profile with own-profile\build-all.ps1.

Design notes

How the corner set is derived, why face centres were left out, what the measured footprint has to exclude, and why the one-way pieces are reported rather than fixed: DESIGN.md.

Credit where it is due: the fence ladder is MSchmoecker's idea, from FenceSnap. Sinka derives its rungs from the measured footprint instead of hand-placing them, which is how a modded fence gets the same treatment from one config entry. FenceSnap's hand-tuned numbers are also what caught a measuring bug here, since it puts wood_fence points at x = 1.0 where Sinka's inflated box said 1.36.

Author

Sinka is an original mod by Robbin Thijssen (Thijssen Software). Copyright (c) 2026 Robbin Thijssen. MIT licensed, see LICENSE.

Part of Longhouse

Sinka ships in the Longhouse modpack, which pins the exact versions of the Ezomic mods used on the Ezomic setup. It behaves exactly the same installed on its own.

Changelog