User Tools

Site Tools


touchbound_system:cage

This is an old revision of the document!


Built to last by a local blacksmith, this cage has seen its fair share of use and abuse as shown by the amount of edge wear and the corrosion stains on the marble block it was erected upon.

Nonetheless, it will serve its new owner for a long time in exchange for a little bit of hinge grease and a touch of paint.

Supported TouchBound functions

Sensing zones

  • Door: Will open/close the cage, or rattle it if locked.
  • Door lockpoint: Can be used with TouchBound Padlocks to lock/unlock the door.
  • Hatch: Will open/close the feed port, or rattle it if locked.
  • Hatch lockpoint: Can be used with TouchBound Padlocks to lock/unlock the feed port.
  • Anchor plates: Can be used to leash TouchBound compatible accessories to the cage.

Supported locks

Anchors

The cage features 4 anchors placed (by default) on the left, right, back and top face of the cage. These anchors can be used as regular TouchBound Anchor plates however, they count as a single target, allowing you to use all 4 anchors on the same avatar, at the same time.

Poses

The cage includes a sit point with a set of 9 poses. You can change pose by using the up/down arrow keys and adjust the offset with the pageUp pageDown keys. The position chosen will be saved until the cage configuration/animation list is changed.

Adjusting

The pose's default Z offset is set to work for me (Kyrah Abattoir) a 1m76 tall avatar, however setting the Z offset to your liking is easy:

  • Select the pose you wish to adjust.
  • Use the PgUp/Down arrows to set your avatar to the desired height, pay special attention to the offset value, which shows up for a few seconds as a hover text in the middle of the cage.
  • Right click/Edit the cage content and find the animation you just used.
  • Change the animation name so that the height offset is at the very end of it with a SPACE right before it. Ex: “My Animation Name -0.25” (without quotes)
  • The cage will automatically reload the animation list and use this value from now on.

Adding more

All you have to do is to drag and drop the new animations inside the cage and it will be detected automatically.

NOTE: Animations are loaded in alphabetical order

Configuration

The Lattice Cage comes with a notecard based configuration allowing to tweak some of its features.

**IMPORTANT!! As of version 5, the configuration is adjusted by RENAMING the different configuration notecards rather than editing their content. With the exception of the “config.whitelist” notecard.

config.allow-everyone=YES : Disables access control.
config.allow-everyone=NO : The user will have to be whitelisted or part of the group to lock this object.
config.allow-group=NO : Group members are not allowed to lock this object.
config.allow-group=YES : Group members are allowed to lock this object.
config.allow-whitelist=NO : config.whitelist will be ignored.
config.allow-whitelist=YES : Users entered in config.whitelist will be able to lock this object.

if you enable the whitelist, you can then add people to “config.whitelist”

You can use either user names such “John Doe” and “Mary Resident” or account names such as “john.doe” and “mary”

config.door.auto-open=YES : Then door will auto-open when the lock is removed.
config.door.auto-open=NO : The door have to be manually opened when unlocked.
config.hatch.auto-open=YES : Then hatch will auto-open when the lock is removed.
config.hatch.auto-open=NO : The hatch have to be manually opened when unlocked.
config.max-locktime=0 : Locks will behave normally.
config.max-locktime=<minutes> : Any lock used on this object will be converted into "time release locks" so they can be removed after the configured time has elapsed.
config.rlv.force-teleport=YES : The cage will try to teleport escapees.
config.rlv.force-teleport=NO : The cage will ignore escape attempts.

These two notecards determinate which skin texture will be loaded by the cage color script, possible values are: AGED,BLACK,BLUE,GREY,OLIVE,PINK,PURPLE,RED,WHITE,YELLOW

config.texture-base=AGED
config.texture-cage=AGED

These two notecards determinate which tint will be loaded by the cage color script, values are expressed in RGB colors <R,G,B>, if you prefer to use manual tinting, you can safely delete those two notecards.

config.tint-base=<255,255,255>
config.tint-cage=<255,255,255>

Anchor modding

The position of the anchor plates doesn't affect their function, feel free to edit the cage and place them where you prefer, or unlink them entirely, however, do not rename them if you want to keep them functional.

Textures

A set of 10 materials is provided with the cage, basic UV maps are also provided.

touchbound_system/cage.1545479091.txt.gz · Last modified: 2018/12/22 11:44 by kyrahabattoir