Owner’s manual / KC Love Ring

The complete guide.

KC Love Ring + Companion HUD for Second Life. Start here · The Ring · The Companion HUD · How they work together · Walkthroughs · Technical reference.

A partner ring for Second Life. Not a collar. Not a leash-club. A ring.

The 30-second version

The RingThe Companion HUD
What it isThe brain. Worn on your finger. Holds your friend list, permissions, and all the features.A quick-action remote for one partner at a time.
Best forManaging everyone, setting rules, the full menuTapping a button while you’re actually with someone
StoresFriend list, permissions, rez days, hold positions, last partnerAlmost nothing — just its own look & settings
Works alone?Yes. Every feature works with no HUD.No. It talks to the ring, so it needs one.
Golden rule

The ring is the boss. The HUD is just a very fast messenger. Take the HUD off and nothing in the ring breaks.

The big picture

ConnectionHow it travels
Your worn HUD ↔ KC-BridgePrivate channel -7391250 inside your own setup.
KC-Bridge ↔ ring scriptsLink messages reach RingCore, FriendTP, HoldHand, FriendStatus, SitWMe and Wearing.
Your ring ↔ friend’s ringRing-to-ring channels -8765432 and -7654321.

Three conversations are happening, and each one is locked down:

  1. HUD ↔ your ring — only you can talk to your own ring. A rezzed stranger-object can’t hear the replies; the HUD has to be worn.
  2. Your ring ↔ their ring — every message is checked: “is the sender an object really owned by the avatar it claims to be?” (spoofers get ignored).
  3. Their ring has the final say. You ask, their ring decides, and if it says no you get a clear message back: “Ivy Moonvale’s ring says no — they haven’t switched that on for you.”

Part 1

The Ring

1.1 Opening the menu

You typeYou get
/7 <ini>menuMain menu
/7 <ini>sitSit With Me, skipping the menu
/7 <ini>wearingWearing? scanner
/7 <ini>holdhandHold Hand menu
/7 <ini>friendsOnline/offline list in local chat

<ini> = first two letters of your first name, lowercase. Tara → ta, Ivy Moonvale → iv, Jesse → je. (So /7 tamenu for Tara. Yes, it’s that easy. No, you don’t need to memorize anything else.)

1.2 The main menu, button by button

ButtonWhat it does (plain English)
Lock Ring / Unlock RingUses RLV to stop the ring from being detached. The label flips to show the action you’d take. Survives relogs — it re-locks itself ~5s after you log in.
Add FriendPaste a friend’s UUID. The ring looks up their name for you.
FriendsYour friends list → tap a name → their Friend Panel (see 1.3).
Sit With MeLists friends within 96 m → tap one → their ring shows furniture → they sit.
Wearing?Pick any avatar within 96 m → get a list of everything they wear, with clickable creator links.
TrackerOnline-notification settings (Popup / Message).
HelpVersions (every script reports its version) · Help File (notecard).
CloseCloses the menu. The ring keeps running.

1.3 The Friend Panel — one stop per friend

Main Menu → Friends → [name]

ButtonMeaning
Grab HandYOU lead, THEY follow. Instant. No sub-menu.
Hold HandYOU follow, THEY lead. Instant.
Let GoEnds any active hold. Safe to tap even if nothing’s active.
Sit With MeOpens furniture list for them.
Set PositionWhere they walk relative to you: Directly Behind · Beside Right · Beside Left · In Front
SettingsJumps straight to this friend’s permission switches (next section).
Note

Action buttons always show. They’re things you do to them, so their ring decides. If it says no, you get told why — no mystery silence.

1.4 Permissions — the “give it once” system

Friends → [name] → Settings

Every friend gets their own switches on your ring. They control what that friend is allowed to do to you.

SwitchIf ON, they can…
Auto TPTeleport you to them — your ring auto-accepts their offers
Auto TPMeRequest a teleport — your ring auto-answers their requests
Sit With MeSit you on furniture
Tracking(You’ll be notified when they come online/offline)
Hold HandsHold your hand — works both directions (lead you or follow you). One toggle.
SuspendPause everything above without losing the settings
The philosophy

Once that right is set, it stays. That is the ONLY permission needed. No popups. No “are you sure?” boxes. You give it ONCE.

1.5 Hold Hand — the star of the show

The 60-second walkthrough

StepRing-to-ring walkthrough
1 / RequestTara selects Grab Hand for Ivy Moonvale. Tara’s ring sends HH_REQUEST (follow me).
2 / CheckIvy Moonvale’s ring checks the friend entry, Hold Hands permission and whether it is suspended.
3 / AcceptIvy Moonvale’s ring sends HH_ACCEPTED. Tara sees “Leading Ivy Moonvale” and Ivy Moonvale sees “Tara is leading — holding hands!”
4 / WalkLeader sends HH_POS once a second. Follower sends HH_ALIVE every five seconds.
5 / ReleaseTara taps Let Go. Her ring sends HH_RELEASED and Ivy Moonvale sees “Tara let go of your hand.”

The fine print (the good kind)

  • Smooth physics. The follower is gently pulled to an anchor spot — no jerky teleport-snapping.
  • Either person can TP away at any time. This is a partner ring, not a control system.
  • Dead-leader safety: if the leader crashes/logs/TPs out, the follower auto-releases after ~10 seconds. Nobody gets stuck.
  • Too far away? Follower ignores anchors >20 m away; two in a row = auto-release.
  • Region change = auto-release.
  • Remembers positions per friend. Ivy Moonvale always walks beside your right if that’s what you picked.
  • Swap directions cleanly. Tap the opposite button with the same partner and it flips — no blocking.
  • One leader, one follower. On purpose.

1.6 The Tracker

Polls Second Life every ~25 seconds for each friend with Tracking ON.

Example / local chat notificationIvy Moonvale is ONLINE
FeatureDetail
Message3-line banner in local chat (ON by default)
PopupDialog box with OK (OFF by default)
Silent first pollNo spam when you log in. Then you get a status list once it finishes: [online] online / [offline] offline (last seen 3h ago)
Rez-day reminders7 days before, and on the day
SoundOptional. Upload a chime, name it exactly kt_notify, drop it in the ring. Delete it to mute.
Note

SL limit, not a bug: online status only works for people on your actual SL friends list with “can see when I’m online” enabled.

1.7 Lock, update, the other stuff

LockRLV @detach=n. State is saved and re-applied on login.
Wireless updaterSeparate box/HUD owned by you. Touch → Update. One-time random PIN, 120 s window, same-owner only. Pushes all scripts while the ring stays on your finger. Friends & settings survive untouched.
Update checkAfter an update the ring prints a report: which scripts changed, which are unchanged (green = healthy).
Owner transferNew owner? Friend list and every kt_ setting is wiped automatically. Clean slate.
No-script parcelsThe ring asks for zero movement controls, so it keeps running where scripts are restricted.

Part 2

The Companion HUD

2.1 The idea

The ring manages everyone. The HUD is for the person you’re with right now.

Companion HUD in-world with a fictional partner selected
In-world HUD / fictional friend names
  • Center circle = your partner’s SL profile photo, with a green/red online indicator.
  • Orbit buttons = one-tap shortcuts. They always act on the partner already picked. They never ask “who?” (the one exception: if nobody is picked yet, it opens the picker first, then does what you tapped).
  • The HUD remembers your partner — saved on the ring, so after a relog the photo and target come right back.
  • If Linden’s web server has a bad day (HTTP 502), it retries 3× and keeps showing the last good photo. Your partner doesn’t turn into a blank circle because SL sneezed.

2.2 The orbit buttons

Prim nameButtonTap to…
KC_HoldHold HandOpens a small adaptive box (below)
KC_SitSit With MeStarts Sit With Me to your partner
KC_CamCam ShareOpens the camera menu
KC_SettingsSettingsHUD’s own settings
KC_RingMenuRing MenuPops open the ring’s main menu — the HUD’s door back to the big menu

The adaptive Hold Hand box

It changes depending on whether you’re already holding hands:

Position → Behind · Right Side · Left Side · In Front (current one is ticked). Position is the leader’s choice; if you’re leading, it applies instantly.

Cam Share

Share your camera view with your partner so they see what you see.

ButtonDoes
Share My CamSends your current camera to your partner
Last Known ShareRe-applies the last view you received
Release CamGives their camera back to them
CloseCloses the menu
Note

Both people need the HUD (with KC-CamShare) and RLV on for the view to apply. Adapted from the KithCart HUD cam-share script — same camera math, but locked to one partner.

2.3 The center circle

SituationTap the center →
No partner yetFriend picker (nearby friends)
Partner pickedThe “More” menu
More-menu buttonPlain English
Pick PartnerChoose who the buttons act on
Clear PartnerForget them (and their cached photo)
Who’s OnWhich of your friends are online right now
Is Partner On?Is your partner online?
What Can I Do?What their ring currently lets you do (teleport / sit / track / hold hands)
Hand StatusAre you holding hands right now?

Switching partners takes a tap on the center + a pick on purpose — so a stray tap never swaps your person.

2.4 HUD settings

Saved on the HUD itself — they’re few and not friend-specific.

SettingOptions
Names 🟢/🔴Show online friends’ names in the floating text
Text 🟢/🔴Show the floating text at all
Refresh30 / 60 / 120 / 300 s — faster = a bit more work for the ring
Color…Hover-text color: Rose Gold · Pink · Lavender · White · Gold · Mint · Sky · Coral
Lock HUD 🟢/🔴RLV-locks the HUD itself so it can’t be removed
Save ImageSaves the HUD’s current art as its normal look (clear your partner first so it saves the badge, not their face)

Legend: 🟢 = on · 🔴 = off. (No “ON/OFF” words — the dots say it.)

Part 3

How the ring and HUD work together

3.1 One tap, end to end

“I tap Hold Hand → Lead on the HUD.” Here’s the whole journey:

StepWhat is sent
1 / HUD → BridgeHUD|42|lead|<partner key>. Bridge checks rate limit and friend membership.
2 / Bridge → HoldHandLink message 93007 with on.
3 / Bridge → HUDKCR|42|ACK|ok: the ring received the command.
4 / Ring → partner’s ringHoldHand sends HH_REQUEST; partner’s ring responds HH_ACCEPTED.
5 / HoldHand → BridgeState leading|<key> via link message 93030.
6 / Bridge → HUDKCR|0|EVT|hh|leading|<key>. HUD shows green for the active hold.

The “ok” you first get just means “my ring accepted the command”. The outcome (accepted / declined / busy / timed out) arrives a moment later as an event. That’s why the HUD button only goes green when it’s really happening.

3.2 Who does what

TaskHUD doesBridge doesRing does
Show partner photoFetches the picture from SL——
Remember partnerAsks to saveStores in kt_hud_partnerKeeps it in LSD
Online checkAsksAsks FriendStatusPolls SL
Hold HandSends lead/follow/letgoRelays to HoldHandTalks to their ring
Sit With MeSends sitRelays to RingCoreSends KC_CTRL to their ring
PositionSends pos:behind etc.Relays + storesHoldHand applies it
Open ring menuSends menuRelays to RingCoreShows main menu
Cam ShareDoes it itself (own script)——
PermissionsNever stored—The ring is the only source of truth

3.3 The safety net

LayerProtection
HUD → ringMust be a worn HUD owned by you; ring checks llGetOwnerKey(id). 6 commands/second max.
Ring → ringSender must be an object owned by the claimed avatar. Their permission bits decide.
UpdatesSame-owner only · random PIN · 120 s expiry · throttled
Version mix-upsOlder rings ignore extra fields; unknown protocol versions answer badproto politely
Owner changeWipes all kt_ data on the ring

Part 4

Guided walkthroughs

Walkthrough A — “I just got the ring”

  1. Wear the ring. Wait a few seconds for RLV to warm up.
  2. Type /7 <ini>menu (e.g. /7 tamenu). Menu pops up.
  3. Tap Add Friend and paste your friend’s UUID. Name auto-fills.
  4. Tap Friends → [their name] → Settings and flip on what you’re comfortable with for them (Tracking, Hold Hands, Sit With Me…).
  5. Success looks like: the friend appears in your Friends list, and — if Tracking is on — you get a status list in chat within ~25 s.
  6. Optional: Lock Ring if you don’t want it coming off by accident.
Note

They need a ring too, and they need to add you + switch on what they’re happy with. Permissions are per-ring, per-direction.

Walkthrough B — “Let’s hold hands”

  1. Make sure both rings have Hold Hands ON for each other (Settings).
  2. You: Friends → [them] → Grab Hand.
  3. Success looks like: “Leading Ivy Moonvale” for you, “Tara is leading — holding hands!” for them.
  4. Walk! Use Set Position to change where they stand (Behind / Right / Left / In Front).
  5. End it with Let Go (either person can).

If it didn’t work: read the message. “…haven’t switched Hold Hands on for you” → they need to flip it. “Not available right now” → they’re already holding hands with someone.

Walkthrough C — “Sit with me”

  1. Main menu → Sit With Me.
  2. Pick a friend from the “who’s nearby” list (≤96 m).
  3. Their ring shows a list of nearby furniture → they pick → RLV sits them.
  4. Success looks like: your friend sits down. If not, you get the “ring says no” line.

Walkthrough D — “Setting up the HUD”

  1. Wear the Companion HUD (it must be an attachment).
  2. Tap the center circle → pick your partner from the nearby-friends list.
  3. Success looks like: their profile photo fills the circle, tinted green if online.
  4. Tap an orbit button — e.g. Hold Hand → Lead. The button goes green while it’s active; open the box again for Let Go.
  5. Relog. Your partner comes back by itself — it’s remembered on the ring.
  6. For Cam Share: both of you wear the HUD, RLV on → Cam → Share My Cam.

Walkthrough E — “Something’s off”

SymptomLikely causeFix
Friend always shows offlineThey’re not on your SL friends list / can’t-see-online is offSL limit — add them as an SL friend
HUD does nothingHUD isn’t worn / ring isn’t runningWear it; check /7 <ini>menu works
“Ring says no”They haven’t enabled it for youAsk them to flip it in Settings
Blank partner photoLinden web hiccupWait — it retries 3×
Hold Hand won’t startAlready holding with someone, or suspendedLet Go, check Settings
Wrong versions?—Help → Versions

Part 5

Cheat sheet

The one-page version — plus the channel list and every script’s version — lives on its own page.