BlueBeard.SnapLogic 0.1.0-ci.24

.NET Framework 4.8.1 This package targets .NET Framework 4.8.1. The package is compatible with this framework or higher.
This is a prerelease version of BlueBeard.SnapLogic. 
dotnet add package BlueBeard.SnapLogic --version 0.1.0-ci.24
                    


                    

                
NuGet\Install-Package BlueBeard.SnapLogic -Version 0.1.0-ci.24
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="BlueBeard.SnapLogic" Version="0.1.0-ci.24" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="BlueBeard.SnapLogic" Version="0.1.0-ci.24" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="BlueBeard.SnapLogic" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add BlueBeard.SnapLogic --version 0.1.0-ci.24
                    


                    

                
#r "nuget: BlueBeard.SnapLogic, 0.1.0-ci.24"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package BlueBeard.SnapLogic@0.1.0-ci.24
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=BlueBeard.SnapLogic&version=0.1.0-ci.24&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=BlueBeard.SnapLogic&version=0.1.0-ci.24&prerelease
                    


                            Install as a Cake Tool

BlueBeard.SnapLogic

Reusable snap-point system for Unturned barricades. Define attachment points on host barricades and child barricades are automatically moved into position when placed nearby.

Features

  • Named snap points -- Define positions on a host barricade where children can attach. Each point has a name and a position offset relative to the host.
  • Automatic snapping -- When a barricade is placed within range of a host, it is automatically moved to the nearest available snap point.
  • Asset filtering -- Restrict which barricade types can snap to each point, or allow any barricade.
  • Rotation inheritance -- Snapped children inherit the host barricade's rotation.
  • Events -- OnItemSnapped, OnItemUnsnapped, OnHostRegistered, OnHostDestroyed for hooking additional logic.
  • Targeted snapping -- Optionally snap to a specific named point, or let the manager pick the nearest available one.
  • Salvage protection -- Snapped children are blocked from being salvaged directly.
  • Host cleanup -- When a host is destroyed, all children are optionally destroyed too.
  • Debug tools -- /snap dump command (debug builds only) to capture barricade positions for defining snap points.

Quick Start

var snapManager = new SnapManager();

snapManager.RegisterDefinition(new SnapDefinition
{
    Id = "weapon_rack",
    HostAssetId = 50633,
    SnapRadius = 1.5f,
    SnapPoints = new List<SnapPoint>
    {
        new SnapPoint { Name = "slot_1", PositionOffset = new Vector3(-0.5f, 0.3f, 0f) },
        new SnapPoint { Name = "slot_2", PositionOffset = new Vector3(0.5f, 0.3f, 0f),
                         AcceptedAssetIds = new ushort[] { 50632 } }
    }
});

snapManager.OnItemSnapped += (host, attachment) =>
{
    Logger.Log($"Barricade {attachment.AssetId} snapped to {attachment.PointName}");
};

snapManager.Load();

Documentation

Page Description
Getting Started Project setup, core concepts, and first snap definition
Snap Points Defining snap points, asset filtering, and positioning
Configuration SnapLogicConfig properties and defaults
Events Event hooks for snap lifecycle
Examples Complete implementation examples

Source Classes

Class / Interface Role
SnapManager Central manager -- registers definitions, handles barricade events, manages snap lifecycle
SnapDefinition Declares a barricade type as a snap host with its attachment points
SnapPoint A single attachment position on a host barricade
SnapHost Runtime state for a placed host barricade and its occupied points
SnapAttachment Record of a child barricade occupying a snap point
SnapLogicConfig Configuration defaults (snap radius, auto-register, cleanup behavior)
Product Compatible and additional computed target framework versions.
.NET Framework net481 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-ci.24 83 7/4/2026
0.1.0-ci.23 94 6/25/2026
0.1.0-ci.22 89 5/8/2026
0.1.0-ci.19 73 5/7/2026
0.1.0-ci.18 63 5/7/2026
0.1.0-ci.17 74 5/3/2026
0.1.0-ci.16 73 5/3/2026
0.1.0-ci.15 81 4/13/2026
0.1.0-ci.14 76 4/12/2026
0.1.0-ci.13 70 4/12/2026
0.1.0-ci.12 80 4/12/2026
0.1.0-ci.11 68 4/12/2026
0.1.0-ci.10 74 4/11/2026
0.1.0-ci.9 76 4/7/2026