aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/1ring test README.txt
blob: d18a75dbd38cb7540976e51bdb7a78ffbf01ad47 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
This is a test version of onefangs 1ring thingy.  This is a pre-release
test version, it's not even alpha quality yet.  Things will be broken. 
There are known bugs.  There are bits not written yet.  You get to keep
both parts.  I'm not happy with the speed when running under standard
OpenSim, but it's fine with opensim-SC.  It's not documented, except the
few things you'll find in this notecard.

1ring is a combination of things.  AO & swimmer / collar / couples carry
& interaction / emoter / smiler / poser / probably something I forgot,
but those are the main ones.

RLV will be needed for the couples carry thing, and the collar.

The default object is worn on the skull as a halo.  It's all full perms
(or should be unless I broke that to), so you can easily resize it to be
a bracelet for your wrist, or a collar for your neck, or just plain turn
the prims into what ever you want.  "1ring to do it all, and in the
loveness bind them." is what the text on the ring says, in Tolkien
Tengwar (Elvish, sorta, go read Lord of the Rings, which inspired this
theme).  Yes, "loveness" is a word, I looked it up.

You can simply click on it and use it via the menus.  Some things in the
menu will be upside down, that means I have not written them yet.  Some
things in the menu will have little circles obscuring the letters, that
means you don't have access to that (likely other people wont have access
to it on YOUR device).  Hopefully it's reasonably self explanatory.

AO & swimmer
---------------------

The AO part is a more or less standard ZHAO II compatible AO.  You can
edit the ZHAO II notecard and add the animations from your own AO, or
just drag the ZHAO II card plus animations from your AO.  It currently
has the Linda Kellie "RUGGED AO" loaded, which is a kinda boring male AO. 
While you can turn the built in AO off, it'll be needed for those carry
interactions that include moving.  For example the shoulder rides use a
sitting animation for the one on the shoulders, but uses the various AO
animations for the one carrying them.  So they'll walk, stand, fly, swim,
all like they usually would in an AO, but with the other person sitting
on their shoulders.  The AO also acts as a swimmer, if you are flying and
under water, you'll swim.

The AO might fight with your existing AO, but it's needed for the couples
carry thing.  You can turn it on and off.

Collar
---------

The collar part is a fairly standard basic collar.  You can even use the
usual method of bringing up the menu - "/1ormenu" for example (first
letters of your name, and the word menu, in channel 1).  It supports RLV,
but no RLV relay yet.  Leash and follow should handle border crossings
and TPs fine.  There is an included "onefang's leash holder" script that
should go into your favourite leash holder.  As well as the usual "make
the leash connect here" function, it is a helper script for the border
crossing and TP following features.  BTW, it is compatible with ***insert
the standard leash holder names here***.

Couples carry & interaction
----------------------------------------

The couples carry & interaction part is probably the main reason people
will want this.  Among other things it lets one avatar carry another.

There is no end of problems with how OpenSim and Second Life "work" that
had to be worked around to get this to work at all, mostly coz it is
strictly forbidden to sit on an attachment.  Even the old work around has
been stopped.  I had a few options, the one that seems to work best is to
use a single prim that you both sit on, it's not an actual physics prim,
but I replicate most of the avatar movement system in the script.  So you
can walk around, use UP arrow to fly up, fly under water to start
swimming, use DOWN arrow to stop flying, or to crouch (you can crouch
walk to), or to ground sit.  Walking on prims is a little unreliable ,
especially climbing stairs and ramps.  Both people can move, even at the
same time.  Both people can adjust the position of either.  You can save
the current positions.  The border crossing support is VERY clunky, and
not well tested, still working on that.  I plan to add TP follow support
in the future.  It currently works better if the 1ring wearer is the one
selecting the pose and stuff, this will get fixed.

It tries to be clever about who is in what role, but there's a swap
button to take care of that.

Note that you can walk off sim, but steering then becomes horrid. 
Rotations are hard, m'kay.

Emoter
----------

The emoter part is from something I wrote long ago.  During a sub
auction, the subject of emoters came up.  I declared that they are
actually quite trivial to write, and wrote one in five minutes while
every one watched.  Who says programming isn't a spectator sport?  Oh
wait, that was me that said that.  That code is now a part of 1ring.  You
say something in channel 12 or 123 -

/12 something
    Script owners first name is used for a "/me something" emote.
/123 someone something
    someone: something

Smiler
----------

Randomly changes your smile every now and then.  Planning to do more.

Poser
-------

Single person animations are also available.  There are several
categories, and a "left overs" category that is just any animation that
isn't part of something else.

Menus
----------

1ring has customizable menus, though it is beyond the scope of this
document to describe any of it.  Have a look at the .1AOor2.theme and
.1ring.theme notecards, those are the current menu theme files.  If you
are clever you might be able to work out how they work.  Some of the
commands are similar to MLP menu commands.

The common menu buttons are -
▲ Exit                Exits out of the current menu, back to the previous menu.
◄ Previous      If a menu is too long for the stupid limitations of LL menu system, it's broken into pages.  Go to the previous page.
Next ►              Go to the next page.
☐   ▣                    Any menu item with one of these squares is something you can turn on and off.
                              Do I have to say that the empty square ☐ means off, the one with a solid square in it ▣ means on?

The default menus are -
access...           Access control for everything, like setting who owns your collar and similar.
clothes...          Put on or take off clothes.  Uses #RLV inventory folder, and RLV.
couples...         Couples carry & interactions menu.
leash...              Collar leash menu.
mood...             Non functional mood adjustment menu for the smiler.
moves...            Control your speed, go places, sit, AO, teleport.
other...              Various things, most of which are not written.
PANIC                 Release you from everything.
poses...              Individual poses.
restrictions... Control RLV restrictions, mostly not written.
sound...            Control sound, mostly not written.

Menu - access...
-------------------------
Add or remove a boss / trustee / or blocking someone.
Set group or public access.
Control the built in RLV relay.  (Did I actually write that?)
Run away from your current set of bosses / trustees.
List all these details.

Menu - clothes...
------------------------
RLV is needed for any of this to work.
outfits...       is the #RLV inventory folder, where you can put on and take off outfits.
attached... is for removing attachments.  Note that RLV does not tell scripts WHAT is attached, just what attachment points have                                  something.  For mesh avatars this is a big problem.  Are you about to remove their skirt, or their legs?  Be careful.
worn...          is for removing "system" clothing.  Might work on BoM clothes to.

Menu - couples...
-------------------------
adjust...       For adjusting the positions of the couple.
save                Save the adjusted positions.  Makes a backup of the .POSITIONS note card first.
sync                May or may not resynchronize poses that have drifted out of sync.
swap...          Swap menu.  I may or may not have written this.  lol

The others are collections of couples things you can do.  Currently
includes dances, hugs, hugglefucks, kisses, lay cuddles, rides, sit
cuddles, spank, wash, and XXX.

You first select the thing you want to do, then who you want to do it
with.  If that's an NPC, they automatically join you, otherwise they are
asked if they want to join you.  If OhSilly Threat System lets you, and
you have RLV enabled, them the thing happens.  Otherwise one or both of
you needs to sit on the big yellow heart manually.  If you are not
allowed to rez things where you are, the big yellow heart doesn't appear. 
The other person might need to sit first.

Both people can use normal movement keys to move you around.  While
adjusting, the movement keys will adjust instead.

You can both hop on and off the big yellow heart.  Note that if there are
two people on it, one of them has to be the 1ring wearer, for technical
reasons that I blame LL for.  So the one that is not wearing 1ring can
hop off, and someone else can hop on.

Menu - leash...
----------------------
Grab their leash, leash them to something / someone, unleash them, adjust
the length of the leash, the size of the leash, and the texture of the
leash.

Menu - moves...
-----------------------
Adjust your speed slower, faster, or back to normal.  This applies to AO
and couples movement.
Follow someone.  Goto someone / something.  Stop following them.
Sit on something.  Stand up.
AO... -
    Turn AO on or off.
    Various types of AO menus that are not currently written.
    Turn on and off the various OhSilly Threat Level system OpenSim functions that might cause error messages.
        NOTE - 1ring tries to detect these, but OpenSim devs are smoking the wrong drugs.  Or something.

Menu - other...
---------------------
Only thing that works here is hide, for hiding 1ring.

Menu - poses...
---------------------
Various sub menus for various individual poses.  Most are built in viewer animations.
left overs...         Any animations that are in 1ring but not used by oter parts of the system.
                                 So you can just drop animations in, and they'll turn up here.
dancing...          Built in dance moves, that don't loop.  Blame LL I suspect.
submissive...    OpenCollar sub poses.
viewer animations...  All built in viewer animations.
The other sub menus I hope are self explanatory.


Other stuff
---------------

https://sledjhamr.org/mantisbt/project_page.php?project_id=12 is the
issue tracker for 1ring. Feel free to create an account if you want to
report an issue or request a feature.  Accounts need to be approved by
me.

I'm sure I should have mentioned other stuff here.

The source code is available at https://sledjhamr.org/cgit/1ring/


The soap bubble image was downloaded from https://www.pngall.com/soap-bubbles-png/download/26145
From the collection at https://www.pngall.com/soap-bubbles-png
License Info: Creative Commons 4.0 BY-NC  I think "Rojal" https://www.pngall.com/author/rojal was the creator, it doesn't really specify.

Most animations are from  Linda Kelly, some are from OpenCollar.  The
leash textures are from OpenCollar.  Most of the individual poses are
built into the viewers.