Skip to content

Instantly share code, notes, and snippets.

@typhartez
Created April 3, 2020 13:42
Show Gist options
  • Select an option

  • Save typhartez/e88bf381eb98b8ab88ef89f4e1586102 to your computer and use it in GitHub Desktop.

Select an option

Save typhartez/e88bf381eb98b8ab88ef89f4e1586102 to your computer and use it in GitHub Desktop.
LockGuard V2 Protocol

Description of how LockGuard is supposed to work.

Specification were taken on SecondLife Wiki:

Protocol

This is very simple. An object sends commands on the channel -9119, following this format:

lockguard <destination avatar key> <item id> <command> <command parameters>
Command Parameters Description
link key the object LockGuard items should link to (PSYS_SRC_TARGET_KEY)
unlink - stop particles
ping - asks LockGuard to reply to check for its presence. The reply has the format lockguard <avatar key> <item id> okay
free - asks LockGuard if item is free (not chained)
gravity float how the particles fall between the two chain points (it is the negative of Z component of particles acceleration (PSYS_SRC_ACCEL)
life float number of seconds a particle stays alive (PSYS_PART_MAX_AGE)
color float float float Respectively the red, green, blue components of the color to give to the particles (PSYS_PART_START_COLOR and PSYS_PART_END_COLOR)
size float float size of a particle (X and Y components of PSYS_PART_START_SCALE and PSYS_PART_END_SCALE)
texture key particles texture UUID (PSYS_SRC_TEXTURE)

LockGuard assume the script is associated with a notecard named LockGuard V2 Config, which contains command as described above, but allowing returns between commands in addition to spaces. Example for right wrist:

ID rightwrist
ID wrists
ID allfour
texture 796ef797-1726-4409-a70f-cd64304ada22
size 0.07 0.07
life 1
gravity 0.3

Item IDs are free but a set of standards have been defined so that both objects and LockGuard enabled objects can communicate with the same IDs:

Head, neck, collar

ID Description
collarfrontloop the front loop of the collar, usually what leashes are attached to
collarbackloop
collarleftloop
collarrightloop
leftearring
rightearring
nosering
leftnosering
rightnosering
upperlipring
lowerlipring
tonguering
gag
leftgag
rightgag
topheadharness
frontheadharness
backheadharness
leftheadharness
rightheadharness

Members

ID Description
leftwrist
rightwrist
leftankle
rightankle
wrists leftwrist and rightwrist
ankles leftankle and rightankle
allfour right and left wrists and ankles
leftupperarm
rightupperarm
arms leftupperarm and rightupperarm
leftupperthigh
rightupperthigh
thighs leftupperthigh and rightupperthigh
leftknee
rightknee
knees leftknee and rightknee

Torso

ID Description
leftnipplering
rightnipplering
nipples leftnipplering and rightnipplering
harnessfrontloop
harnessbackloop
harnessleftloopfront
harnessrightloopfront
harnessleftloopback
harnessrightloopback
harnessleftshoulderloop
harnessrightshoulderloop
frontbeltloop
backbeltloop
leftbeltloop
rightbeltloop
bellyring
clitring
leftlabia
rightlabia
cockring
ballring
buttplug
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment