# CUSTOM SNAP
{% hint style="info" %}
*Version tested here: 1.2.6*
{% endhint %}
{% hint style="danger" %}
*Version 1.2.5 of this mod is included in Dungeondraft 1.2.0.0 and 1.2.0.1.* Two versions of the same mod can't exist at the same time, so you might need to manually update the file in the install folder (`C:\Program Files\Dungeondraft\mods` on Windows) for it to work. \
\
\&#xNAN;*Deleting the old one and placing the update in your mods folder is not recommended as it might cause issues.*
{% endhint %}
[Custom Snap](https://cartographyassets.com/assets/45748/custom-snap-mod/) gives you the ability to customize your grid. You can set:
* Custom snap values (row and colums of pixels that assets will align with)
* A grid matching your snap values
* Various grid shapes (square, hex, triangle, isometric)
{% hint style="warning" %}
*The first time you load the mod, you might be suprised to see a very tiny grid on your map.*
*Once you change the grid settings to your liking, it will stay that way until you change it, even between sessions and maps.*
{% endhint %}
## BASIC KNOWLEDGE
In [Vanilla Dungeondraft](#user-content-fn-1)[^1], the grid is set to 256x256 pixels. You can snap to each grid cell or to each half-cell, but there's nothing more.
This mod adds a new tool in the [Settings Tab](https://dungeondraft-encyclopaedia.gitbook.io/guide/all-the-tools/settings-tab), called **Custom Snap Settings**.
By clicking on it, you will display a new tab where you'll be able to tweak the **snap** and **grid settings**.
### Enabling/Disabling the Mod
By default, both the Custom Snap and its Custom Grid are enabled, set to 1/4th of the default grid (64px instead of 256). \
\
You can disable the mod by pressing the **Enabled** toggle button. You can also turn off both Custom Snap and Default Snap by pressing **S** on your keyboard.
You can also just disable the Custom Grid by pressing the **Custom Grid** toggle button. This won't disable the default grid. If you want to hide the custom grid without disabling it, press **G** on your keyboard.
{% hint style="info" %}
The **Custom Grid** will always adapts to your **Custom Snap** settings, you can't have a **Custom Grid** with different values.
{% endhint %}
### Understanding the Different Grids
There are a few grid/snap shape options:
* Square (regular grid)
* Horizontal Hex (allowing horizontal lines)
* Vertical Hex (allowing vertical lines)
* Isometric (for isometric perspective)
This is represented by these four shapes you can click on:
Square
Horizontal Hex
Vertical Hex
Isometric
Depending on the shape you chose, you might get two more options:
* **Corner/Edge** will define if the amount of pixels you've set is measured from the center to the corner or from the center the edge of the Hex shape. The **Corner** option will always result in a **smaller grid** than the **Edge** option.
* **Triangle/Hex** is only useful when you choose to display the grid. Hex will display regular Hex shapes while Triangle will display lines between all the corners of the Hex shape, visually resulting in triangles. This will appear only with the two Hex shapes.
Regular Hex
Triangle
### Presets
In the **Presets** dropdown menu, you can select between several snap presets (and grid presets, if that option is enabled).
There are a few options:
* *1/4th (64 px)*
* *1/8th (32 px)*
* *Large Horizontal Hex (128x128 px)*
* *Small Horizontal Hex (64x64 px)*
* *Large Vertical Hex (128x128 px)*
* *Small Vertical Hex (64x64 px)*
* *Roll20 Horizontal (128x128 Horizontal Hex)*
* *Roll20 Vertical (128x128 Vertical Hex)*
{% hint style="warning" %}
*If your R20 presets are not 128x128 but 150x150, click on Open User Folder in the top left menu and delete the file named `custom_snap_mod_data.txt` (you don't need to close Dungeondraft).*
{% endhint %}
For a standard battlemap with a square grid, using either **1/4th (64 pixels)** or **1/8th (32 pixels)** should be more than enough for most cases. Some people like to use **1/16th (16px)**, which can be achieved in the **Advanced Settings**.
## ADVANCED SETTINGS
You can display more controls by clicking the **Enable Advance** toggle button.
### Scaling
In Advanced mode, you can now choose your own values. There's a slider for the horizontal scaling and one for the vertical scaling. Values go from 1 to 256 and represent the gap in pixels between two snapping points (and the size of a grid cell when Custom Grid is enabled).
By default, both sliders are working together to keep the same ratio, but you can move them separately by pressing the **Lock Aspect Ratio** toggle button.
### Offset
In Advanced mode, you can offset the snapping points (and the grid when Custom Grid is enabled).
You can offset the snapping points/grid up to 256 pixels right and down with two sliders.
{% hint style="success" %}
That option can be very useful when you're trying to match a premade grid (for example with the [Trace Tool](https://dungeondraft-encyclopaedia.gitbook.io/guide/all-the-tools/settings-tab/trace-image)) that doens't start right at the corner of the image.
{% endhint %}
By default, both sliders are working together, but, as for **Scaling**, you can choose to move them separately by pressing the **Lock Aspect Ratio** toggle button.
## SNAP SELECTION
In the selection tool, you can now see a **Snap Selection** button. Clicking on it after selecting a asset will bring it to the closest snapping point.
### Snapping a Multiple Selection
When you select and move multiple assets, [vanilla snap](#user-content-fn-2)[^2] doesn't work correctly. This can be especially frustrating when you copy some assets that were snapped but you need to snap back each copied asset manually, one by one.
*The Snap Selection feature fixes that issue.*
When multiple assets are selected, clicking on **Snap Selection** several times will cycle through several reference points to snap to the grid.
It will either align the center of the selection’s bounding box to the nearest snapping point or the different assets in the selection.
Unsnapped selection
Click #1: Snapping the selection box's center
Click #2: Snapping the right asset
Click #3: Snapping the left asset
***
{% hint style="danger" %}
### KNOWN BUGS
**Version:**\
\&#xNAN;*1.2.0.0 (fixed in 1.2.0.1)*
**Bug description:**\
Custom Snap is packaged with Dungeondraft but doesn't even appear in the mod list unless you have set a custom folder for your mods. Each time you will start Dungeondraft, the mod will be enabled even if you have disabled it before. \
\
As a side effect, the mod will display a 64x64 **custom grid** the first time you load it, which might confuse users.
**Workaround:**
* Install Dungeondraft 1.2.0.1 or higher
* The mod itself can be disabled from the [Settings](https://dungeondraft-encyclopaedia.gitbook.io/guide/all-the-tools/settings-tab), in the Custom Snap Settings tab. You can also just disable the custom grid or change its settings.
* You can also move your mod from the internal mod folder (in the install folder) to your custom mod folder.
{% endhint %}
***
{% hint style="warning" %}
Usually, creators post some minor updates of their mods on [Discord](https://discord.com/invite/J9Czgpu) and release a bigger update from time to time on [CartographyAssets.com](https://cartographyassets.com/asset-category/specific-assets/dungeondraft/mods-scripts/), so if you're missing some features from there, you might find the most recent version on Discord.
{% endhint %}
***
{% hint style="success" %}
