You are viewing a potentially older version of this package. View all versions.
Searica-Extra_Snap_Points_Made_Easy-1.2.4 icon

Extra Snap Points Made Easy

Quality of life building mod that adds snap points to most vanilla pieces and allows you to manually select snap points for the piece you are placing and the piece you are snapping to. Also has a snap to world grid mode.

Date uploaded 11 months ago
Version 1.2.4
Download link Searica-Extra_Snap_Points_Made_Easy-1.2.4.zip
Downloads 3375
Dependency string Searica-Extra_Snap_Points_Made_Easy-1.2.4

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

ExtraSnapPointsMadeEasy

This is a quality of life building mod for Valheim.

Features

  • Allows for manual selection of snap points for both the piece you are placing and the piece you are snapping to.
  • Allows for manual selection of snap points on only the piece being placed.
  • Allows snapping pieces to the world grid.
  • Provides notifications of which snapping mode is active and the snap points selected. The location of these notifications can be set in the mod configuration.
  • Automatically determines the type of each build piece and adds extra snap points accordingly.
  • Dynamically updates to configuration changes while in-game.
  • Extra snap points can be enabled/disabled:
    • For all pieces,
    • On a piece-by-piece basis,
    • Or by piece type.
  • Built in config-file watcher.
  • Works with other mods that add build pieces.

Snapping Modes

This mod adds two different modes of manual snapping to provide greater precision when placing pieces.

Manual Snapping

Press a key to toggle Manual Snapping Mode, which allows you to cycle through snap points when targeting a piece in game - without needing to point at them directly with the mouse!

Manual (Closest) Snapping

Press a key to toggle Manual (Closest) Snapping Mode, which allows you to cycle through the snap points of the piece you are placing while snapping to the closest snap-point on the piece being targeted with your mouse.

Grid Snapping

Press a key to toggle Grid Snapping Mode, which snaps pieces to the world grid. Pieces are only snapped to the world grid on the horizontal plane to avoid snapping pieces to thin air. Precision of the grid can be toggled between 1m and 0.5m.

Key Bind Configuration

The key-binds for manual snapping are configurable via editing of the configuration file at Valheim/BepInEx/config/searica.valheim.extrasnappointsmadeeasy.cfg or via an in-game configuration manager (live updates, no restart required).

The default key-bindings are:

  • Toggle Manual Snapping Mode: Left-Alt
  • Toggle Manual (Closest) Snapping Mode: Caps-Lock
  • Cycle Snap Points on the piece you are placing (source piece): Left-Ctrl
  • Cycle Snap Points on the piece you are snapping to (target piece): Left-Shift
  • Toggle Grid Snapping Mode: F3
  • Cycle Grid precision: F4

Usage

Grab a hammer and select a piece to place. Hit Left-Alt to enable Manual Snapping Mode, a notification will then appear in the center of your screen indicating whether the snapping mode is set to Auto or Manual. Point your piece at the piece you want to snap to and hit Left-Control to cycle through the snap points on the piece you're holding. Use Left-Shift to cycle through destination snap points. For example you can snap a horizontal pillar to the middle of the vertical pillar by cycling both to their midpoint snap points. While cycling through snap points you will also receive notifications indicating which snap point is currently selected on each piece. Alternatively press Caps-Lock to enable Manual (Closest) snapping mode which will snap to the closest snap point on the target piece while still allowing you to manually select the snap point of the piece you are placing.

Extra Snap Points

This mod adds extra snap points to increase precision when building. The type of each piece is automatically determined and extra snap points are added based on the type (also works with pieces added by other mods).

Custom Snap Points: Many of the crafting and furniture items that were missing snap points have had custom ones added. For example chests, torches, sconces, and banners all have snap points added. The custom snap have been chosen to minimize clipping when snapping banners and sconces to walls of any material.

Line Pieces: If the piece has two snap points then an extra snap point is added midway between them. So all beams and poles have a snap point in the center of them.

Triangle Pieces: If the piece has three snap points that form a triangle then snap points are added midway between each pair of points and in the center of the triangle.

Rect2D Pieces: If the piece has four snap points that form a rectangle then snap points are added midway along each edge and in the center of the rectangle.

Roof Top Pieces: If the piece is tagged as a "roof" piece and has six snap points that form a V shape (roof top pieces) then snap points are added midway along the two bottom edges and midway along the top ridge.

Cross Pieces: If the piece has five snap points that from a cross with snap point in the center then no extra snap points are added.

Torch Pieces: If the piece is a torch and has no snap points then a snap point is added at the local center and another at the base of the torch.

Ship Pieces: If the piece is a ship then no snap points are added to it.

Cart Pieces: If the piece is a cart then no snap points are added to it.

Other Pieces: If a piece has no snap points then a snap point is added at the local center of the piece. If a piece has only a single snap point then no extra snap points are added.

Donations/Tips

My mods will always be free to use but if you feel like saying thanks you can tip/donate.

My Ko-fi: ko-fi

Source Code

Source code is available on Github.

Github Repository: Extra Snap Points Made Easy

Contributions

If you would like to provide suggestions, make feature requests, or reports bugs and compatibility issues you can either open an issue on the Github repository or tag me (@searica) with a message on my discord Searica's Mods.

I'm a grad student and have a lot of personal responsibilities on top of that so I can't promise I will respond quickly, but I do intend to maintain and improve the mod in my free time.

Credits

This mod was inspired by Snap Points Made Easy which is originally by yardik and FenceSnap by MSchmoecker and parts of the code are based on those mods.

Shameless Self Plug (Other Mods By Me)

If you like this mod you might like some of my other ones.

Building Mods

Gameplay Mods

CHANGELOG

Version Notes
1.3.1
  • Improved warnings in log file for pieces added by mods that cannot have extra snap points added.
1.3.0
  • Updated for Ashlands release.
1.2.4
  • Bugfix to correct typo that broke adding extra snap points.
1.2.3
  • Changed it so snapping mode only changes while in placement mode.
1.2.2
  • Added option to set terrain tools to have snap point or not.
  • Minor optimizations.
  • Changed removal of extra snap points to prevent possible side-effects.
1.2.2
  • Compiled against newest game version.
  • Improves snap points for item stands.
  • Update short description to mention world grid snapping.
1.2.0/1.2.1
  • Changed configuration file formatting. You need to regenerate your config file.
  • Added Grid Snap mode.
  • New icon.
1.1.3
  • Added more configuration options.
  • Changed public API to no longer require a string argument.
1.1.2
  • Removed accidental Jotunn dependency due to using a nuget package build file.
  • Improved shutdown performance.
  • Built against BepInEx 5.4.2202
1.1.1
  • Improved robustness of classifying pieces as RoofTop pieces. Should hopefully reduce classification errors for non-Vanilla pieces added by other mods.
  • Improved shutdown performance.
  • Improved automatic classification of torches.
1.1.0
  • Altered internal function of mod to automatically infer the type of build piece and add snap points accordingly.
  • Re-wrote mod to dynamically update to config changes while in-game.
  • Improved interactions with MoreVanillaBuildPrefabs and other mods that add build pieces.
  • Added option to disable adding extra snap points for all pieces at once.
1.0.6
  • Update for patch 0.217.25
  • Slight improvements in load times.
1.0.5
  • Fixed null excpetion error caused when in manual snap mode and switching to place pieces that have no snap points.
1.0.4
  • Added a built-in config file watcher to ensure configuration changes are not lost.
1.0.3
  • Speed up inital load time slightly.
  • Added prefabs from MoreVanillaBuildPrefabs that will be ignored.
1.0.1/1.0.2
  • Update for patch 0.217.22
  • Added snap points to new build piece.
1.0.0
  • Feature complete release.
  • Added snap points to all build pieces with the option to enable/disable snap points on a piece by piece basis.
  • Added Manual (Closest) snapping mode.
0.0.1/0.0.2
  • Initial release and README updates.