Differences

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

--- touchbound_system:handcuffs [2025/08/08 05:03] – [Suspension poses] Image and some details kyrahabattoir
+++ touchbound_system:handcuffs [2025/08/09 14:54] (current) – [LED Indicators] kyrahabattoir
@@ Line 6: / Line 6: @@
    * [[touchbound_system:chaining_leashing|Chaining/leashing]].
    * [[touchbound_system:handcuffs#bondage_poses|Bondage animations]].
-   * [[touchbound_system:suspension|Suspension]] ([[touchbound_system:handcuffs#suspension_poses|Poses]])
+   * [[touchbound_system:suspension|Suspension]] ([[touchbound_system:handcuffs#suspension|Poses]])
 ====== Sensing zones ======
@@ Line 42: / Line 42: @@
   * **GREEN**: The handcuffs are loose, but unlocked (in this state, the wearer can remove them at any time by using the "Uncuff" option).
+NOTE: When using a [[touchbound_system:timepadlock|Time-release padlocks]] on the cuffs, the LEDs will animate to reflect the remaining time.
+====== Adjustments & Fitting =====
+Depending on your avatar proportions (shoulder width, arm length, etc...) It might be difficult to get the wrists to line up properly with the handcuffs.
+Because the handcuffs disable editing when worn, it is strongly recommended to do your adjustments without wearing the KDC RLV Activator.
+The handcuffs have been built in multiple mesh parts and the product is +modify, you can extend the centerpiece of the cuffs by moving the ratchets, bracelets and lock blocks independently.
+{{touchbound_system:hc-01-w-parts.png?256}}{{touchbound_system:hc-01-w-stretchpng.png?256}}//These handcuffs can stretch a lot!//
+For each pose (unequipped/back/front/suspension) **the handcuffs will remember their last position/rotation and will restore it**. If the handcuffs position is wrong for a given pose, simply move the attachment into position and it will be saved.
+[[touchbound_system:handcuffs#config.spacing.*|Each animation has multiple wrist spacing variants]].
+A secondary animation that makes bento-compatible hands look a little less static will be triggered when the wrists are handcuffed together, it can be safely removed (or replaced) if this behavior is undesirable (TB_CFF_BCK_BENTO & TB_CFF_FNT_BENTO animation assets)
 ====== Extra configuration options ======
 Because of the way this product operates, there are a lot of optional configuration options to help with fitting.
@@ Line 48: / Line 62: @@
   * **config.clicker.hidden=Yes**  (hidden when the handcuffs are unequipped)
   * **config.clicker.hidden=No**   (visible when the handcuffs are unequipped)
+^ {{touchbound_system:hc-01-w-clicker-visible.png?256}} ^ {{touchbound_system:hc-01-w-clicker-hidden.png?256}} ^
+|            config.clicker.hidden=No                   |            config.clicker.hidden=Yes                 |
 //NOTE: The click helper is designed to remain readable when highlight transparent (Ctrl Alt T) is used.//
+The click helper can be freely moved and resized, or even removed, but one should avoid covering the chain point or the lock points with it.
 ===== config.colorblind =====
 Rename this notecard to enable/disable the LED colorblind mode.
@@ Line 65: / Line 83: @@
 ===== config.detach.closed =====
+Rename this notecard to configure whether the bracelets should be open or closed when the handcuffs are unequipped.
+Possible values: (case sensitive)
+  * **config.detach.closed=Yes** The bracelets will close after the handcuffs have been unequipped.
+  * **config.detach.closed=No** The bracelets will remain open.
 ===== config.detach.hidden =====
+Rename this notecard to configure whether the handcuffs should be visible or hidden when unequipped.
+Possible values (case-sensitive):
+  * **config.detach.hidden=Yes** The handcuffs will become invisible in their 'unequipped' position.
+  * **config.detach.hidden=No** The handcuffs will remain visible, even in their 'unequipped' position.
 ===== config.offsets =====
-===== config.spacing.back =====
+This configuration card is the only one in the handcuffs where the actual content of the card is parsed by the scripts. It regroups all the **default** position and rotation offsets for each handcuff state.
-===== config.spacing.front =====
-===== config.spacing.suspend =====
-===== config.tightness =====
-====== Bondage poses ======
+Offsets are automatically saved, so there is no need to edit this configuration card unless you reset/update your scripts often and want your offsets to be saved more permanently.
-Cuffed front
-Cuffed back
+This configuration card is only read once, when the scripts are booting and will be ignored otherwise.
+===== config.spacing.* ====
+Each animation has multiple wrist spacing variants, you get 11 options per animation  (front/back/suspension)
+  * **config.spacing.back=0**
+  * **config.spacing.front=0**
+  * **config.spacing.suspend=0**
+//The "0" value is the default and can go from -5 to +5.//
+===== config.tightness ====
+Rename this notecard to configure the tightness of the handcuff bracelets.
+Can be adjusted to any positive or negative angle (1 degree increment), to make the bracelets more or less tight and fit your avatar wrists better.
+^ {{touchbound_system:hc-01-w-tightness2.png?256}} ^ {{touchbound_system:hc-01-w-tightness1.png?256}} ^
+|            config.tightness=20                   |               config.tightness=-20               |
+**config.tightness=0** Is the default where the cuff bracelets are circular.
+====== Bondage poses ======
+^ {{touchbound_system:handcuff-front.png?256}} ^ {{touchbound_system:handcuff-back.png?256}} ^
+|                 In Front                     |                   In Back                   |
 ====== Suspension ======
 Once the wrists have been cuffed together, it is possible to use the chain point to hang the wearer by the wrists from an overhead anchor point. The suspension animation will temporarily override the cuffed animation.