Differences

This shows you the differences between two versions of the page.

--- touchbound_system:nose_hook [2023/09/19 16:01] – [Supported locks] fixed the accessory link kyrahabattoir
+++ touchbound_system:nose_hook [2023/09/20 12:56] (current) – [config.grab.enabled] fixed incorrect options config.grabbable kyrahabattoir
@@ Line 1: / Line 1: @@
-^  {{:touchbound_system:nose-hook-header.png?128}}  ^
+^  {{:touchbound_system:nose-hook-header.png?128}}{{:touchbound_system:nose-hook-parts2.png?128}}  ^
 |  KDC Nose Hook  |
 ====== Supported TouchBound functions ======
@@ Line 16: / Line 16: @@
    * [[touchbound_system:timepadlock|Time-release padlocks]].
    * [[touchbound_system:tag_plate|Lockpoint accessories]].
+====== Click & Grab function ======
+The standalone version of the Nose Hook comes with a special feature that allows others (or the wearer) to click and "drag" the top of the wearer's head to effectively "pull" on the nose hook either forward, causing their head to pitch down, or backward causing their head to pitch up. it is accompanied with a suitable leather "creaking" sound effect.
 ====== Customization ======
@@ Line 25: / Line 28: @@
   * None of the mesh parts are essential, and can be swapped and/or removed.
   * All the elements have been uploaded with tweaked rotations and points of origin to allow the best possible non-uniform scaling of each strap element.
 ===== Raider Harness Gag add-on =====
@@ Line 30: / Line 34: @@
 (this modification requires a piece of land with build rights)
+{{  :touchbound_system:nose-hook-raider.png?200}}
 Step-by-step instructions :
   - Drag the **Raider Harness Gag** to the ground to rez it in-world.
@@ Line 39: / Line 44: @@
   - Drag and drop into the Content tab the following items from the **Box of Extras**.
       * config.nose.angle=10
-      * Nose5
+      * anim:Nose0
-      * Nose10
+      * anim:Nose5
-      * Nose15
+      * anim:Nose10
-      * Nose20
+      * anim:Nose15
-      * Nose25
+      * anim:Nose20
+      * anim:Nose25
       * _KDC Raider Harness gag - nose hook
   - (optional) Rename the **Raider Harness Gag**.
   - Right-click the modified **Raider Harness Gag** and pick the "take" from the menu to put the modified version back in your inventory.
-===== Configuration Options =====
+=====Configuration Options=====
+A handful of configuration flags can be set by renaming notecards in the nose hook inventory.
-You can adjust the nose pulling animation by renaming the included notecard "config.nose.angle" and set the nose pulling effect from 0 (disabled) to 25 degrees up.
+====config.nose.angle====
+You can adjust the nose pulling animation by renaming the included notecard "config.nose.angle" and set the nose pulling effect from 0 to 25 degrees up.
 <code>
@@ Line 59: / Line 67: @@
 //NOTE: This feature only works properly with mesh avatars with a humanoid nose weighted to the FaceNoseCenter bone.//
+==== config.grab.enabled====
+When this feature is enabled, the wearer and other avatars can click the invisible area at the top of the head and "pull" it forward/backward to make the avatar head move.
+<code>
+config.grab.enabled=Yes : The click and grab feature is enabled.
+config.grab.enabled=Self : The click and grab feature is enabled but only available to the wearer.
+config.grab.enabled=No : Disables the feature.
+</code>
+==== config.grab.notify====
+By default, the KDC Nose Hook will notify the wearer in chat when someone is pulling on their nose hook.
+<code>
+config.grab.notify=Yes : The wearer will be notified when someone grabs their nose hook.
+config.grab.notify=No : The wearer will not notified.
+</code>
 ===== Styling HUD =====
 {{ :touchbound_system:nose-hook-hud.png?200}}
@@ Line 81: / Line 105: @@
   * **HOOK_PINCHED**: Variant of the nose hook with a pinch point at the center.
   * **HOOK_ZIGZAG**: "Fancy" variant of the nose hook, with wavy sides.
-  * Nose angle animations.
   * **HOOK_ADDON**: Short nose hook with a tiny strap to connect it to the Raider Harness Gag as an add-on.
   * **config.nose.angle=10**: Configuration card for the nose angle of the Raider Harness Gag add-on.
+  * **anim:Nose0**: 0° nose pull animation.
+  * **anim:Nose5**: 5° nose pull animation.
+  * **anim:Nose10**: 10° nose pull animation.
+  * **anim:Nose15**: 15° nose pull animation.
+  * **anim:Nose20**: 20° nose pull animation.
+  * **anim:Nose25**: 25° nose pull animation.
-It is recommended to keep their original name if you want the different parts to be recognized by the styling HUD receiver and add-on script.
+It is recommended to keep their original names (the HOOK_/HOOKSTRAP_ part at the very least) if you want it to be recognized by the styling HUD receiver and add-on script.