Differences

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

--- touchbound_system:nose_hook [2023/09/19 14:49] – Added header image 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 15: / Line 15: @@
    * [[touchbound_system:keyedpadlock|Keyed padlocks]].
    * [[touchbound_system:timepadlock|Time-release padlocks]].
-   * [[touchbound_system:accessories:|Lockpoint accessories]].
+   * [[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.
-  - Drag **HOOK_METAL_ADDON** from the KDC Nose Hook **Box of Extras** to rez it in-world.
+  - Drag **HOOK_ADDON** from the KDC Nose Hook **Box of Extras** to rez it in-world.
-  - Right click **HOOK_METAL_ADDON** and pick the "edit" option from the menu to select it.
+  - Right click **HOOK_ADDON** and pick the "edit" option from the menu to select it.
   - Hold the shift key and left-click the **Raider Harness Gag** to select it too.
   - Ctrl+L to link the two objects together.
@@ 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 58: / Line 66: @@
 </code>
+//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 72: / Line 97: @@
 The KDC Nose Hook comes with an "extra" box/folder that contains spare and alternate parts you can use for customization:
-  * **HOOK_STRAP_BUCKED**: A curved strap with a locking buckle.
+  * **HOOKSTRAP_BUCKED**: A curved strap with a locking buckle.
-  * **HOOK_STRAP_CURVED**: A curved piece of leather strap.
+  * **HOOKSTRAP_CURVED**: A curved piece of leather strap.
-  * **HOOK_STRAP_STRAIGHT**: A smaller, straight piece of leather strap.
+  * **HOOKSTRAP_STRAIGHT**: A smaller, straight piece of leather strap.
-  * **HOOK_METAL_REAR**: The rear hook part, to attach the rear of the nose hook strap to a collar for example.
+  * **HOOK_REAR**: The rear hook part, to attach the rear of the nose hook strap to a collar for example.
-  * **HOOK_METAL_RING**: Square metal ring to connect straps with each-others.
+  * **HOOK_RING**: Square metal ring to connect straps with each-others.
-  * **HOOK_METAL_PLAIN**: Normal nose hook.
+  * **HOOK_PLAIN**: Normal nose hook.
-  * **HOOK_METAL_PINCHED**: Variant of the nose hook with a pinch point at the center.
+  * **HOOK_PINCHED**: Variant of the nose hook with a pinch point at the center.
-  * **HOOK_METAL_ZIGZAG**: "Fancy" variant of the nose hook, with wavy sides.
+  * **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.
-  * **HOOK_METAL_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.