Differences

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

--- touchbound_system:handcuffs [2025/08/08 05:43] – clarified the position saving 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.
@@ Line 52: / Line 53: @@
 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.
-Each animation has multiple wrist spacing variants, you get 11 options per animation  (front/back/suspension)
+[[touchbound_system:handcuffs#config.spacing.*|Each animation has multiple wrist spacing variants]].
-  * **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.//
+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 64: / 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 81: / 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 =====
+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.
+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.
+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}} ^