Module Snapping Tool: Difference between revisions

From Resonite Wiki
Created page with "The '''Module Snapping Tool''' is a common editing tooltip which allows the user to snap together modular components which have been set up for it, such as those found in the Dawn Modular set that the cloud home was made out of. == Where To Get The Tool == The Module Snapping Tool may be found in the Resonite Essentials public folder that every user has in their inventory, under the Tools / Custom folder directory. [Tools]"
 
No edit summary
Line 1: Line 1:
The '''Module Snapping Tool''' is a common editing tooltip which allows the user to snap together modular components which have been set up for it, such as those found in the Dawn Modular set that the cloud home was made out of.
The '''Module Snapping Tool''' is a common editing tooltip which allows the user to snap together modular components which have been set up for it, such as those found in the Dawn Modular set that the cloud home was made out of.


== Where To Get The Tool ==
== Spawning the Module Snapping Tool ==


The Module Snapping Tool may be found in the Resonite Essentials [[Public Folders|public folder]] that every user has in their [[inventory]], under the Tools / Custom folder directory.
The Module Snapping Tool may be found in the Resonite Essentials [[Public Folders|public folder]] that every user has in their [[inventory]], under the Tools / Custom folder directory.
== Using the Module Snapping Tool ==
The Module Snapping Tool can be equipped by clicking it, but requires Builder Permissions, like most other tools.
When the tool is equipped, components with a "Snap Points" slot will be highlighted with a purple box when scrolled over.
Primary clicking while an object is highlighted will select it as the part to be moved, and show a display of the available Snap Points.
Clicking on a Snap Point will select it as the location which the object will attach at, and allow you to select the second onject.
Clicking on a second purple-box highlighted object will show the snap points to which you can link the first object to using the point you've selected on it: note that there is a filter which can be disabled in the Radial Menu.
Clicking a point on the second object will cause the first object to "snap" to the position and rotation of the point on the other object, while also scaling itself to the same size and parenting itself to that object's parent.
This process can be cancelled at any time by pressing the alt-fire / R key.
== Setting up a Modular Part for Snapping ==
The Module Snapping Tool works by finding a slot within an object's hierarchy named "Snap Points", and moving the position, rotation, and scale of slot with the Object Root component to mirror the Snap Point of the second object along the Z plane.
This means, to set up a modular component for it, you must give the top-level slot of the object an Object Root component, and make a slot somewhere beneath it named "Snap Points".
A good point of reference is that the Z axis should be pointed outwards, towards the other object.
It is highly recommend that you use building parts from either Dawn Modular or (for faster loading) Dusk Modular, as reference for positions and names, even aligning the slots and copying them directly, so that your modular parts will be compatible with those parts.




[[[Tools]]]
[[[Tools]]]

Revision as of 03:49, 12 January 2024

The Module Snapping Tool is a common editing tooltip which allows the user to snap together modular components which have been set up for it, such as those found in the Dawn Modular set that the cloud home was made out of.

Spawning the Module Snapping Tool

The Module Snapping Tool may be found in the Resonite Essentials public folder that every user has in their inventory, under the Tools / Custom folder directory.

Using the Module Snapping Tool

The Module Snapping Tool can be equipped by clicking it, but requires Builder Permissions, like most other tools.

When the tool is equipped, components with a "Snap Points" slot will be highlighted with a purple box when scrolled over.

Primary clicking while an object is highlighted will select it as the part to be moved, and show a display of the available Snap Points.

Clicking on a Snap Point will select it as the location which the object will attach at, and allow you to select the second onject.

Clicking on a second purple-box highlighted object will show the snap points to which you can link the first object to using the point you've selected on it: note that there is a filter which can be disabled in the Radial Menu.

Clicking a point on the second object will cause the first object to "snap" to the position and rotation of the point on the other object, while also scaling itself to the same size and parenting itself to that object's parent.

This process can be cancelled at any time by pressing the alt-fire / R key.

Setting up a Modular Part for Snapping

The Module Snapping Tool works by finding a slot within an object's hierarchy named "Snap Points", and moving the position, rotation, and scale of slot with the Object Root component to mirror the Snap Point of the second object along the Z plane.

This means, to set up a modular component for it, you must give the top-level slot of the object an Object Root component, and make a slot somewhere beneath it named "Snap Points".

A good point of reference is that the Z axis should be pointed outwards, towards the other object.

It is highly recommend that you use building parts from either Dawn Modular or (for faster loading) Dusk Modular, as reference for positions and names, even aligning the slots and copying them directly, so that your modular parts will be compatible with those parts.


[[[Tools]]]