Don't Touch Me v1.0.* Instructions

Gimmick Overview

This gimmick uses the Non-Destructive Modular Framework and Modular Avatar to non-destructively enable the Avatar's head to dodge when other players' hands come close, and to play emote defined by the tool during the dodge.

This gimmick works by inserting a head proxy with a PhysBone into the Avatar’s head bone, allowing it to dodge when other players' hands approach.

Notes

• This gimmick has only been tested with VRCSDK3 and Unity 2022.3.22f1.
• This gimmick only supports humanoid Avatars that include head bone.
• Since this gimmick modifies the Avatar’s bone hierarchy, it may conflict with other gimmicks (such as detachable head gimmicks, etc.).
• Do not modify or delete the contents of the prefab, except for the menu item names.

_{Gimmick Overview end}

---

Installation

Dependencies

This gimmick depends on the following package. Make sure you have installed it before installing this gimmick.

• Modular Avatar (1.13.0 or higher): https://modular-avatar.nadena.dev/

---

Importing Unity Package

Drag Don't Touch Me.unitypackage into Project window, click the Import button on the dialog to import the package to your avatar project:

---

Installing Don't Touch Me

1. Adding the Prefab to Scene

Find and drag Assets/LuiStudio/Don't Touch Me/Dont't Touch Me.prefab from product window into your avatar inside hierarchy:

2. Setting up the Gimmick

After adding the prefab, a white spherical wireframe will appear around the Avatar's head:

warning

If the white spherical wireframe does not appear, please make sure the current window is the Scene view, and Gizmos are enabled in the upper right corner of the Scene view.

If your Avatar does not have a VRC Avatar Descriptor component, an Animator component, or if the Animator does not contain a humanoid avatar, the head collider will appear at position (0, 0, 0). However, since the Avatar does not meet the requirements, the head collider cannot be edited.

1. Adjust the Position and Size of the Head Collider

In the Hierarchy, select Don't Touch Me^[1], then in the Inspector, find the Don't Touch Me Setup Tool component^[2] and click the Edit Head Collider button^[3]:

After clicking Edit Head Collider, a transform tool will appear at the center of the white spherical wireframe. Use the Move and Scale tools^[1] to adjust its position and size:

Once you're done adjusting, either select any other GameObject or click Apply on the DTM Head Transformer component in the Inspector^[1] to finish:

2. Enable Smoother Dodging (Optional)

Smoother dodging refers to whether the generated PhysBone component uses Stiffness to achieve smoother head movement.

In the Don't Touch Me Setup Tool component, check Smoother Dodging^[1] to enable this feature:

warning

Enabling smoother dodging may cause the head to occasionally rotate due to inertia during movement, especially when changing direction (especially on PC).

3. Add Dodging Emotes (Optional)

Dodging emotes refer to the emotes played during a dodge, implemented via blendshape animations. You can add multiple emotes and choose to have them play in order, play randomly, or lock one to play during each dodge.

1. Emote Notes

Depending on the number of emotes, the menu structure and sync parameter usage will vary:

Number of Emotes	Menu Contents	Sync Parameter Usage
0	A main toggle to enable/disable the dodging feature	1 bit
1	A submenu containing the main toggle and an emote toggle	2 bits
2	A submenu containing the main toggle, an emote toggle, and a lock emote submenu	11 bits
>2	A submenu containing the main toggle, an emote toggle, a random emote toggle, and a lock emote submenu	19 bits

Any emotes in the list that are missing their corresponding blendshapes will be removed.

2. Add Emotes

In the Don't Touch Me Setup Tool component, click the + button^[1] at the bottom right of the emote list to add a new emote:

3. Add Emote BlendShapes

Click the + button^[1] at the bottom right of the BlendShape list for the added emote to add a new emote BlendShape:

After adding a new emote BlendShape, the list will look like this (the labels in the image are explained below):

In the newly added entry:

• Mesh^[1] refers to the Skinned Mesh Renderer that contains the BlendShape to be played;
• BlendShape^[2] is the name of the BlendShape to be played;
• Weight^[3] is the weight of the BlendShape when played.

Drag the GameObject that has the Skinned Mesh Renderer with BlendShapes into the Mesh^[1] field, select the desired BlendShape in the BlendShape^[2] field, and adjust the Weight^[3].

While adjusting the weight, Unity will automatically enter animation mode so you can preview the emote effect in real time:

To exit emote preview mode, uncheck Preview^[4] or select a different GameObject.

4. Other Setup

1. Change the Position of the Submenu or Toggle in the Action Menu (Optional)

By default, the submenu entry / toggle for this gimmick is placed under the root menu, which may not be ideal for Avatars with many features. You can change the position of the submenu using the MA Menu Installer component:

• In the Hierarchy, select Don't Touch Me
• In the Inspector, find the MA Menu Installer component and click the Select Menu button
• Choose the menu where you want to place the submenu or toggle

note

When no emotes are added, the gimmick replaces the original submenu with a single toggle. For details, see Emote Notes.

_{Installation end}

---

Testing

After installing “Don't Touch Me,” you can test its functionality by entering Play Mode.

First, you’ll need the Gesture Manager, which can be installed via the VRChat Creator Companion.

Once Gesture Manager is installed, click Tools/Gesture Manager Emulator in the Unity menu:

Clicking this will add a GameObject named GestureManager^[1] to the scene. Select it, go to the Inspector, and click Enter Play-Mode^[2] on the Gesture Manager component to enter Play Mode:

After entering Play Mode, you will see a GameObject named [EditorOnly] DTM Testing Collider in the Avatar’s hierarchy. This object is used to test whether the gimmick is functioning correctly.

Switch to the Scene view, select [EditorOnly] DTM Testing Collider^[1], and use the Move Tool^[2] to bring it closer to or farther from the Avatar. Use it along with the Gesture Manager’s Action Menu to test the dodging and emote functionality of the gimmick:

If the Avatar's head dodges when the Dodging Toggle is enabled and stays still when it's disabled, and if emotes play or don't play according to the Emote Toggle, then the gimmick is working correctly.

note

The [EditorOnly] DTM Testing Collider GameObject is only added during Play Mode and will not be included when uploading the Avatar.

_{Testing end}

---

How to Use

Enable and Disable Dodging

Number of Emotes	Method
0	Open the Action Menu and find the Don't Touch Me toggle to enable/disable the dodging feature
>0	Open the Action Menu, navigate to the Don't Touch Me submenu, and use the Don't Touch Me toggle inside to enable/disable the dodging feature

Enable and Disable Dodging Emotes (Only When Emotes Are Present)

Open the Action Menu, navigate to the Don't Touch Me submenu, and use the Enable Emotes toggle to enable or disable the playback of dodging emotes.

Enable and Disable Random Dodging Emotes (Only When Number of Emotes > 2)

By default, dodging emotes play in the order they appear in the list. If random emote is enabled, a random emote from the list will be played during each dodge.

Open the Action Menu, navigate to the Don't Touch Me submenu, and use the Random Emote toggle to enable or disable random dodging emotes.

Lock Dodging Emote (Only When Number of Emotes ≥ 2)

When a dodging emote is locked, the specified emote will be played for every dodge.

Open the Action Menu, navigate to the Don't Touch Me/Lock Emote submenu, and use the Emote toggle inside to select the emote you want to lock.

_{How to Use end}