Component:ToolMultiplexer

Component image 

Tool Multiplexer component as seen in the Scene Inspector

A Tool Multiplexer is a key component in almost every multitool to ever exist. It handles the switching and usage of multiple tools, and allows all of them to act as one tool tip the user can equip, making multiple tool usage easier. Multitools can be assigned to the Tools list of other multitools.

Usage

Fields

Name	Type	Description
persistent	Bool	Determines whether or not this item will be saved to the server.
UpdateOrder	Int	Controls the order in which this component is updated.
Enabled	Bool	Controls whether or not this component is enabled.
_equipLink	direct LinkTarget`1<ITool>	This is Internal, and is used by the engine to retrieve the component this field is a part of. It cannot be assigned to.
TipReference	Slot	The slot to use as the tool's tip, instead of the component's slot.
BlockGripEquip	Bool	Whether to prevent legacy double grip equipping from equipping this tooltip.
BlockRemoteEquip	Bool	Whether to prevent equipping by clicking via laser
EquipName	String	The name of the tool in the context menu when equipping via context menu.
_overrideActiveTool	InteractionHandler	The interaction handler to use instead of this tool as an interaction handler.
_gripPosesGenerated	Bool	Whether the Grip Pose Reference components and slots have been generated for this tool.
ActiveToolIndex	Int	The tool that this tool tip is currently using
Tools	list of ITool	A list of tools that this tool tip is to switch between using ActiveToolIndex as the one it should be currently using.

Behavior

Curiously, the transform position of the slot of a tool listed in the Tools list and its tip transform position can cause the multitool's laser tip to move if that tool is selected. Putting all the tools used by the multitool under one slot and making sure their tip and tool roots are in the same transform place is the preferred way of making sure your tool tip laser position stays consistent.

Examples

From Uki's Redprint tip, to the default multitool in Resonite Essentials to H3's tool, this component is vital in a multitool, and what makes them function.