LSL Protocol/RestrainedLoveAPI/ja

From Second Life Wiki
< LSL Protocol‎ | RestrainedLoveAPI
Revision as of 02:01, 1 January 2011 by Mako Nozaki (talk | contribs) (Yay!)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Restrained Love viewer v2.3 の仕様

著者 Marine Kelley


みなさまへ

このドキュメントは、RestrainedLove viewerの機能を使用して独自のLSLスクリプトを作成したい方へ向けて書かれたものです。メッセージやイベントといったLSLの概念については説明していません。また、UUIDなどの普遍的な概念についても説明していません。

この文書は RestrainedLove ビューアそのものの仕様について説明されています。RestrainedLove ビューア連携 (RLV Relay) についての情報が欲しい場合は、 RLV relay specification を参照してください。

はじめに

RestrainedLove viewerは、インワールドのスクリプトから特定のメッセージを受け取ったときに、対応した動作をするものです。これらのメッセージは、ほとんどがllOwnerSay()と呼ばれるLSLの関数の呼び出しによって作成されます。

仕組み

RestrainedLove viewerは、ビューアに送信された全てのllOwnerSay メッセージを傍受します。アットマーク('@')で始まる行は、RLV のコマンドとして解釈されます。他の行は、通常通り、ローカルチャットに転送され、ユーザが見ることができます。例えば、llOwnerSay ("@detach=n") と呼び出すと、スクリプトを実行するオブジェクトが引数 n の detach コマンドをビューアに送信することと同じことになります。

メッセージの書式は次のようになります。

@<command1>[:option1]=<param1>,<command2>[:option2]=<param2>,...,<commandN>[:optionN]=<paramN>

'@'は、メッセージの先頭にただ一つだけ存在するようにしてください。ビューアはこれを「この llOwnerSay() メッセージの全文が、1つ以上の実行命令を含んでいる」と解釈します。記載上の都合により、コマンドは常に先頭に'@'がついた形で示されています。しかし、複数のコマンドを含むメッセージのそれぞれのコマンドの先頭に'@'をつけるのは誤りで、2個目以降のコマンドは正常に実行されません。

歴史的な注釈: 1.10 より前のバージョンでは、RLV は1つのメッセージにつきただ1つのコマンドだけを書くことができました。1.10 のバージョンで、RLV に対応していないビューアを使用しているユーザにメッセージをスパムすることにならないように、1つのメッセージに複数のコマンドを書くことができるようになりました。

少なくとも1つのコマンドの実行に失敗すると(例えばタイプミス)、ビューアは"... fails command : ... "というメッセージを出力し、全てのメッセージを表示します。しかし、正しいコマンドは解析と実行が行われ、誤っているものだけが無視されます。

コマンドの多くが、オブジェクトやアバターの次の「挙動」を規定します。例えば、@detach=n というコマンドは特定のオブジェクトにロックをかけ、取り外しできないようにします。コマンドの送信元オブジェクトに限定しない「グローバルな挙動」を規定するコマンドもあります。例えば、@sendchat=n というコマンドは、ユーザがローカルチャットで発言できないようにします。

注意 例外があるコマンド、例えば @sendim や @sendchannel などですが…。 @(rule):(exception)=n は正確には(かつ、単刀直入に言うと)既にあるルールに 例外を追加します 。例えば、@sendchannel:1=n はチャネル1での発言を 許可します。これは、スクリプターが陥る少なくとも２つの混乱の元となっていました。 =add (=n と同義) と =rem (=y と同義) は、それぞれ、例外の追加と削除のために存在します。こちらを使ってください。


Emblem-important-red.png Warning!

これらの挙動はセション間で引き継がれることは ありません 。オブジェクトの UUID は rez のたびに変わるため、オブジェクトの状態(取り外し不能、IM禁止など...)が変化したときにそうするように、オブジェクトは on_rez() イベントの中で状態を再送信 しなければなりません 。

コマンド一覧

注意： これらのコマンドは大文字小文字を区別しませんが、スペースは区別します。言い換えると、"@detach = n" は動作 しません　。

表記について: [角括弧] のパラメタは任意指定で省略可能です。パイプ (|) やスラッシュ (/) で区切られているオプションは、どれか一つを指定しなければならないものです。<山括弧> のパラメタは必須です。

  • 自動バージョンチェック : "@version=<channel_number>"

実装 v1.0b 搭載している RLV のバージョンをビューアに <channel_number> のチャネルで直ちに発言させ、スクリプトが拾えるようにします。常に正の値を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。

警告 : ログインすると、全てのアタッチメントの on_rez イベントはアバターが実質的にチャットメッセージを送ることができるようになる前に発生します (だいたいログインのプログレスバーが半分までいったぐらいの時点です) 。このため、ビューアから自動返答を受け取るために、タイムアウトは 30 秒から 1 分ぐらいの充分に長い時間にしなければなりません。

警告２ : 2010年2月22日、Linden Lab はサードパーティ・ビューアの指針を発表し、サードパーティ・ビューアの名前の中に "Life" という文字を使用することを禁止しました。このため "Restrained Life" は"Restrained Love" に名前を変えざるをえませんでした。しかし、互換性維持の観点から、この @version コマンドは動作しますし、今後も動作します。しかし、新しく書くスクリプトではこれを 使用せず 、ユーザに "Restrained Life" という文字をどこにも 見せない ようにすることを推奨します。新しく書くスクリプトには、 代わりに @versionnew を使用してくださるようお願いします。


  • 自動バージョンチェック : "@versionnew=<channel_number>"

実装 v1.23 搭載している RLV のバージョンをビューアに <channel_number> のチャネルで直ちに発言させ、スクリプトが拾えるようにします。常に正の値を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。

このコマンドは @version の後継で取って代わるものです。それでも、 @version は下位互換性のために維持されています。これは "RestrainedLove viewer v... (SL ...)" と返します("RestrainedLove" は 1 語です)。

警告 : ログインすると、全てのアタッチメントの on_rez イベントはアバターが実質的にチャットメッセージを送ることができるようになる前に発生します (だいたいログインのプログレスバーが半分までいったぐらいの時点です) 。このため、ビューアから自動返答を受け取るために、タイムアウトは 30 秒から 1 分ぐらいの充分に長い時間にしなければなりません。


  • 自動バージョン番号チェック : "@versionnum=<channel_number>"

実装 v1.21 ビューアにバージョンを <channel_number> のチャネルで直ちに発言させ、スクリプトが拾えるようにします。常に正の値を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。このコマンドは @version よりは扱いやすいです。スクリプトがレスポンスを解析することがない分、番号をすぐに取得します。

バージョン番号は純粋な integer で、ビューアのバージョンを表しています。バージョンが X.Y.Z.P ならば、番号は X.10^6 + Y.10^4 + Z.10^2 + P になります。例えば、.21.1 は 1210100 になります。


  • 自動バージョンチェック、第二の方法 : llGetAgentLanguage (key id) 廃止: 使用しないでください！

実装 v1.16 この LSL 関数を呼び出すと、結果がすぐに返ります (リスナーやタイマーを使用する必要はありません)。これは、"@version" を送信した場合とまったく同じで、ユーザによって隠されることがありません。通常の SL ビューアから返される言語表記、"en-us", "fr", "ko" などはこの文字列で上書きされます。もしくはユーザが言語設定を隠すようにしている場合、何も返りません。通常のビューアではオプションとなっているため、スクリプトはこれを信用して使っていません。なので、この特性を RLV のバージョンチェックのより便利な代替手段になるように「ハイジャックする」のが理にかなっています。重要な注意点：この機能は RestrainedLove が v1.16 であっても、v1.21 以前のバージョンには実装できないため、llGetAgentLanguage() が空文字列で返ってきた場合は常に @version をあてにするようにしてください。これも注意点： RestrainedLove 1.16 では、llGetAgentLanguage() は、ログイン中に on_rez で呼ばれた場合、呼び出しが何秒か (何秒かは決まってません) 遅れることがなければ、空文字列を返します。最後の注意点： この機能はv1.16.1(とv1.16b、 Cool SL Viewerの場合) で削除されました。


  • 手動バージョンチェック : "@version"

実装 v1.0a このコマンドはアバターからユーザに IM で送信されなければなりません (オブジェクトからはうまくいきません)。ビューアは送信者に自動的にバージョンを返答しますが、ユーザの IM 窓にはメッセージも回答も表示されないため、すごくこそこそしています。


  • オブジェクトを取り外し可能／不可能にする : "@detach=<y/n>"

実装 v1.0a "n" オプションで呼ばれると、メッセージを送信したオブジェクト (アタッチメントである必要があります) は取り外し不可能となります。"y" オプションで呼ばれると、取り外し可能に戻ります。


  • 装着ポイントをロック解除／ロックする : "@detach:<attach_point_name>=<y/n>"

実装 v1.20 "n" オプションで呼ばれると、<attach_point_name> で示された装着ポイントは、full (その時点でオブジェクトが装着されている) でも empty (装着されていない) でもロックされます。制約がかかった時点でそのポイントに装着されているオブジェクトは、取り外し不能とされます。これは、"@detach=n" コマンド自体が発行されたのとちょうど同じような感じです。装着ポイントが空であればその状態のままとなり、いかなるアイテムもそこに装着することができなくなり、llAttachToAvatar() が呼び出されると失敗するようになります (オブジェクトは装着されますが、すぐに取り外されます) 。


  • 装着ポイントを empty でロック解除／ロックする : "@addattach[:<attach_point_name>]=<y/n>"

実装 v1.22 "n" オプションで呼ばれると、<attach_point_name> で示された装着ポイントは empty でロックされます。制約がかかった時点で装着ポイントに装着されているオブジェクトは取り外し可能ですが、そこに何も装着することができません。装着ポイントが空であればその状態のままとなり、いかなるアイテムもそこに装着することができなくなり、llAttachToAvatar() が呼び出されると失敗するようになります (オブジェクトは装着されますが、すぐに取り外されます) 。<attach_point_name> の指定がない場合、全ての装着ポイントに対して作用します。このコマンドは @addoutfit の片割れで、アタッチメントに対するものです。


  • 装着ポイントを full でロック解除／ロックする : "@remattach[:<attach_point_name>]=<y/n>"

実装 v1.22 "n" オプションで呼ばれると、<attach_point_name> で示された装着ポイントは full でロックされます。制約がかかった時点でそのポイントに装着されているオブジェクトは、取り外し不能とされます。装着ポイントが空であればユーザは何かを装着することができますが、そのオブジェクトは取り外し不能となり、いかなるアイテムに取り替えることもできなくなり、llAttachToAvatar() が呼び出されると失敗するようになります (オブジェクトは装着されますが、すぐに取り外されます) 。<attach_point_name> の指定がない場合、全ての装着ポイントに対して作用します。このコマンドは @remoutfit の片割れで、アタッチメントに対するものです。


  • コンテキストメニューからの「装着」を許可／禁止する : "@defaultwear=<y/n>

実装 v1.21 許可すると、ユーザはいつでもインベントリのコンテキストメニューから「装着」メニューを選ぶことができます。オブジェクトがアバター上でロックされていてもです。これはロックされているオブジェクトをないがしろにするリスクがありますが、5 秒以内に自動的に再装着されます (他に同じようにロックされているオブジェクトがあったら、再装着すべきものがなくなるまで、 1 秒おきに順次行われます) 。しかしながら、デタッチの際に制約を解除するようにスクリプトが組まれたオブジェクト、言い換えると、RLV を使用していればロックされているオブジェクトもデタッチされる可能性があるという事実を考慮していないものもあります。

そのため、このコマンドを "n" オプションで呼び出せばこのメニューは抑制されるものの、名前かフォルダ名に装着先ポイント名称が含まれているオブジェクトは装着できるようになっています。1.21 以前の RLV とちょうど同じように。これはユーザにはちょっと扱いにくい仕様ですが、ロックされているオブジェクトがうっかりデタッチされてしまうことのないようにしなければならないことを考えると、こちらのほうが安全です。


  • プライベートチャネルでの通知を開始／停止する : "@notify:<channel_number>[;word]=<rem/add>"

実装 v1.20, improved in v2.2 (and v1.24) 全ての制約、もしくはセミコロン (";") の後に指定された単語を含んだ名称をもつ制約の追加削除を、ビューアに特定のチャネルで自動的に復唱させます。<channel_number> のプライベートチャネルに返される内容は、他のスクリプトに意図しないコマンドを送ってしまわないように、先頭にスラッシュ ("/") がついています。そして、等号 ("=") の後に、 "n" か "y" がついており、それぞれ制約の追加と削除を示しています。"@clear" コマンドは等号を付加しません。他のスクリプトについての情報が無防備に開示されるのを避けるため、どのオブジェクトが制約を付加したのか撤廃したのかを知ることはできません。one-shot コマンド (force コマンド) も復唱しません。例えば、"@notify:2222;detach=add" はオブジェクトがロックされるたびに "/detach=n" を送信し、オブジェクトのロックが解除されるたびに "/detach=y" を送信します。チャネル 2222 でスクリプトがこれらを受信することになります。

注意 : v2.2 (と v1.24) からは、インベントリの提供時に表示するメッセージを設定できるようになっています。オブジェクトがアイテムやフォルダを提供すると、RLV v2.2 (と v1.24) 以上を使用しているユーザは指定されたチャネルで以下のどれかで自動応答します。 

- /accepted_in_rlv inv_offer <folder> : このフォルダは受け取られ、 #RLV 配下に格納されて使用可能な状態になっています (ビューアはフォルダを変名して、頭にある "#RLV/" を削除してしまいますのでご注意ください) 。
- /accepted_in_inv inv_offer <folder> : このフォルダは受け取られましたが、まだ共有されていません。
- /declined inv_offer <folder> : このフォルダは受取拒否されたか、"ブロック"(かつての "ミュート") を押されたかしました。

<folder> はフォルダやアイテムの受取先のフルパスです。例えば、#RLV/~MyCuffs のようになっています。"inv_offer" の前にはスペースがあり、通知を設定しやすいようにトークンになっています。#RLV/~MyCuffs というフォルダが #RLV フォルダに受け取られたか知りたいのであれば、"@notify:2222;accepted_in_rlv inv_offer #RLV/~MyCuffs=add" というコマンドを発行してください。アバターが何か受け取ったか知りたいのであれば、"@notify:2222;inv_offer=add" とコマンドを発行すればよいです。


  • チャットを許可／禁止する : "@sendchat=<y/n>"

実装 v1.0b 禁止されると、チャネル 0 でタイプされたものは全て無視されます。しかし、スラッシュ ('/') で始まる emote やメッセージは、それぞれ 30 文字と 15 文字に丸められて通過します (以後変更になる可能性があります) 。()"-*=_^ のような特殊文字が入るメッセージは送信できず、読み捨てられます。ピリオド ('.') が現れると、以降のメッセージは切り捨てられます。


  • emote の丸めを行わない／行う : "@emote=<rem/add>"

実装 v1.01 この例外が追加されると、emote は丸められなくなります (しかし、特殊文字が読み捨てられることには変わりありません) 。


  • shout を許可する／しない : "@chatshout=<y/n>"

実装 v1.15 禁止されると、アバターが shout したときでも、通常の範囲のチャットとなります。メッセージを変更することは全くなく、範囲だけを変更します。


  • 普通の声の大きさで話すことを許可する／しない : "@chatnormal=<y/n>"

実装 v1.15 禁止されると、アバターが普通にチャットしたときでも、whisper となります。メッセージを変更することは全くなく、範囲だけを変更します。


  • whisper を許可する／しない : "@chatwhisper=<y/n>"

実装 v1.15 禁止されると、アバターが whisper したときでも、通常の範囲のチャットとなります。メッセージを変更することは全くなく、範囲だけを変更します。


  • パブリックなチャットをプライベートチャネルにリダイレクトする : "@redirchat:<channel_number>=<rem/add>"

実装 v1.16 有効になると、この制約はパブリックチャネル ("/0") で話した内容を全てオプションで指定されたプライベートチャネルにリダイレクトします。複数の制約がかかると、チャットのメッセージはそれぞれのチャネルにリダイレクトされるようになります。これは emote には適用されず、話している時にアニメーション (タイプ開始、終了、うなずき) が実行されなくなります。この制約は @sendchannel に取って代わるものではありません。

注意: RLV v1.22.1 / RLVa 1.1.0 の時点では、@redirchat はチャネル 0 では emote が転送されなくなるというバグがありました。@emote=add を別に発行すると、これを回避できます。このバグは、v1.23.0 までに修正されたようです。


  • オープンな emote をプライベートチャネルにリダイレクトする : "@rediremote:<channel_number>=<rem/add>"

実装 v1.19 有効になると、この制約はブリックチャネル ("/0") で話した emote を全てオプションで指定されたプライベートチャネルにリダイレクトします。複数の制約がかかると、emote はそれぞれのチャネルにリダイレクトされるようになります。


  • インスタントメッセージの送信を許可する／しない : "@sendim=<y/n>"

実装 v1.0b 禁止されると、IM で入力した内容は全て破棄され、受信者には代わりにわけのわからないメッセージが送信されます。


  • インスタントメッセージの送信を許可する／しない（セキュリティ強化） : "@sendim_sec=<y/n>"

実装 v1.21 禁止されると、IM で入力した内容は全て破棄され、受信者には代わりにわけのわからないメッセージが送信されます。このコマンドは、先のコマンドと違い、全てのオブジェクトからでなく、同じオブジェクトから発行された例外のみ受け付けます。


  • インスタントメッセージの送信制限の例外を追加／削除する : "@sendim:<UUID>=<rem/add>"

実装 v1.01 例外を追加すると、コマンドで指定された UUID のユーザは IM を受け取れるようになります。当該アバターの制約のみ上書きします。 (例外の数に制限はありません) 使用しなくなったら必ず削除してください。


  • 指定した人へのインスタントメッセージの送信を許可／禁止する : "@sendimto:<UUID>=<y/n>"

実装 v2.3 と v1.25 禁止されると、指定した人に IM で入力した内容は全て破棄され、受信者には代わりにわけのわからないメッセージが送信されます。


  • チャットメッセージの受信を許可／禁止する : "@recvchat=<y/n>"

実装 v1.0b 禁止されると、パブリックチャットで受信した内容は emote を除いて全て破棄されます。


  • チャットメッセージの受信を許可／禁止する（セキュリティ強化） : "@recvchat_sec=<y/n>"

実装 v1.21 禁止されると、パブリックチャットで受信した内容は emote を除いて全て破棄されます。このコマンドは、先のコマンドと違い、全てのオブジェクトからでなく、同じオブジェクトから発行された例外のみ受け付けます。


  • チャットメッセージの受信制限に例外を追加／削除する : "@recvchat:<UUID>=<rem/add>"

実装 v1.01 例外を追加すると、コマンドで指定された UUID のユーザからのチャットメッセージを聞けるようになります。当該アバターの制約のみ上書きします。 (例外の数に制限はありません) 使用しなくなったら必ず削除してください。


  • 指定した人からのチャットメッセージの受信を許可／禁止する : "@recvchatfrom:<UUID>=<y/n>"

実装 v2.3 と v1.25 禁止されると、指定したアバターからパブリックチャットで受信した内容は emote を除いて全て破棄されます。


  • emote の表示を許可／禁止する : "@recvemote=<y/n>"

実装 v1.19 禁止されると、パブリックチャットでの全ての emote が破棄されます。


  • emote の表示を許可／禁止する（セキュリティ強化） : "@recvemote_sec=<y/n>"

実装 v1.21 禁止されると、パブリックチャットでの全ての emote が破棄されます。このコマンドは、先のコマンドと違い、全てのオブジェクトからでなく、同じオブジェクトから発行された例外のみ受け付けます。


  • emote の表示制限に例外を追加／削除する : "@recvemote:<UUID>=<rem/add>"

実装 v1.19 例外を追加すると、コマンドで指定された UUID のユーザからの emote を見ることができるようになります。当該アバターの制約のみ上書きします。 (例外の数に制限はありません) 使用しなくなったら必ず削除してください。


  • インスタントメッセージの受信を許可／禁止する : "@recvim=<y/n>"

実装 v1.0b 禁止されると、受信した IM は全て破棄され、送信者にはメッセージを読むことのできない旨の通知が送信されます。


  • インスタントメッセージの受信を許可／禁止する（セキュリティ強化） : "@recvim_sec=<y/n>"

実装 v1.21 禁止されると、受信した IM は全て破棄され、送信者にはメッセージを読むことのできない旨の通知が送信されます。このコマンドは、先のコマンドと違い、全てのオブジェクトからでなく、同じオブジェクトから発行された例外のみ受け付けます。


  • インスタントメッセージの受信制限に例外を追加／削除する : "@recvim:<UUID>=<rem/add>"

実装 v1.01 例外を追加すると、コマンドで指定された UUID のユーザからのインスタントメッセージを読むことができるようになります。当該アバターの制約のみ上書きします。 (例外の数に制限はありません) 使用しなくなったら必ず削除してください。


  • 指定した人からのインスタントメッセージの受信を許可／禁止する : "@recvimfrom:<UUID>=<y/n>"

実装 v2.3 と v1.25 禁止されると、指定した人から受信した IM は全て破棄され、送信者にはメッセージを読むことのできない旨の通知が送信されます。


  • ランドマークへのテレポートを許可／禁止する : "@tplm=<y/n>"

実装 v1.0 禁止されると、 ユーザはランドマーク、プロフィールの Picks、その他の手段を使って、事前に設定されている場所へテレポートすることができなくなります。


  • 場所へのテレポートを許可／禁止する : "@tploc=<y/n>"

実装 v1.0 禁止されると、ユーザは地図やその他の手段を使った、座標指定によるテレポートができなくなります。


  • フレンドからの呼び出しによるテレポートを許可／禁止する : "@tplure=<y/n>"

実装 v1.0 禁止されると、ユーザは全てのテレポートの誘いを自動で拒否し、招待者に通知されます。


  • フレンドからの呼び出しによるテレポートを許可／禁止する（セキュリティ強化） : "@tplure_sec=<y/n>"

実装 v1.21 禁止されると、ユーザは全てのテレポートの誘いを自動で拒否し、招待者に通知されます。このコマンドは、先のコマンドと違い、全てのオブジェクトからでなく、同じオブジェクトから発行された例外のみ受け付けます。


  • フレンドからの呼び出しによるテレポートの制限に例外を追加／削除する : "@tplure:<UUID>=<rem/add>"

実装 v1.0 例外を追加すると、コマンドで指定された UUID のユーザから招待を受けてテレポートすることができるようになります。当該アバターの制約のみ上書きします。 (例外の数に制限はありません) 使用しなくなったら必ず削除してください。


  • Sit によるテレポートを制限／制限解除する : "@sittp=<y/n>"

実装 v1.0 制限されると、アバターは 1.5 m 以内に近づかないとプリムにすわれないようになります。これでアバターが壁をすり抜けられないようにすることで、檻を強固なものにすることができます(プリムがすぐそばにないことが条件です)。


  • 座った位置と違う位置で立ち上がることを許可／禁止する : @standtp=<y/n>

実装 v2.1.2 と v1.24 この制限が有効になっている状態でアバターが立ち上がると、座った位置に自動的に引き戻されます。この制限を有効にすると、「最後に立っていた位置」も記録されますので、ひったくりの類で、被害者を座らせて、引きずって檻の中に閉じ込め、そこで制限を有効にして、被害者を立たせた場合は、大丈夫です。この場合、アバターは檻の中にいます。


  • 許可の例外を許可する／拒否する : "@permissive=<y/n>"

実装 v1.21 拒否すると、全ての制限は(あれば)セキュリティ強化となります。つまり、制限に対する、同じオブジェクトから発行されていない例外は無視されます。 セキュリティ強化でない制限 (@sendim や @recvim などの元々のバージョン) を使っていたり、 @permissive を使っていなかったりすると、他のオブジェクトから発行された例外で当該アバターが救われるようになってしまいます。

注意 : このコマンド (または、セキュリティが強化されたコマンド) を使うと他のオブジェクトから発行された例外は (そのオブジェクトの主要な機能であっても) 何の通知もなしに破棄されます。このため、この制約が有効になっていると、製品によっては動作しなくなったように見えることもあります。例えば、指定したフレンドに常に IM を送信することのできるようにする製品は、他のオブジェクトから @sendim_sec や @permissive コマンドを送信されると、壊れたような挙動を示したりします。このため、これは気をつけて使うようにし、あなたが作った製品がどんなに堅牢かを 知ってもらうようにしましょう。


  • オブジェクトに紐づいた全てのルールを消去する : "@clear"

実装 v1.0a、ただし動作するのは v1.04a から このコマンド特定の UUID に紐づいた、全ての制約や例外を消去します。

警告 : デフォルトでデタッチの際に発動することになっていると、@defaultwear が有効の場合に自動的に再装着がされないことがあります。@clear は @detach=n 制約も解除してしまうので、そのアイテムが default-wear-action によってたまたまデタッチされてしまったとビューアが思い込み、再装着しなくなるからです。

考えられる回避方法：

  • @clear=<pattern> で、追加した制約だけを解除する
  • アタッチメントがロックされていないと確信できる場合にだけ、デタッチの際に @clear を発動させる
  • @clear はどんな場合も発動させず、ビューアが制約を回収するまで待つ


  • オブジェクトに紐づいた一部のルールを消去する : "@clear=<string>"

実装 v1.0a、ただし動作するのは v1.04a から このコマンド特定の UUID に紐づいた、<string> という名前をもつ制約や例外を消去します。良い例として、"@clear=tp" があります。これはオブジェクトに紐づいた全ての teleport 制約と例外を消去します。一方で、"@clear=tplure" は友人によるテレポートを許可しない制約のみを消去します。


  • オブジェクトの編集を許可／禁止する : "@edit=<y/n>"

実装 v1.03 オブジェクトの編集・オープンを禁止されると、建造・編集ウィンドウは開かなくなります。


  • 編集制限に例外を追加／削除する : "@edit:<UUID>=<rem/add>"

実装 v2.3 と v1.25 例外を追加すると、ユーザは指定したオブジェクトの編集・オープンができるようになります。


  • 持ち物の rez を許可／禁止する : "@rez=<y/n>"

実装 v1.03 持ち物の rez を禁止されると、オブジェクトの作成・削除・持ち物からのドロップ・アタッチメントのドロップは失敗します。


  • 指定したオブジェクトの編集を許可／禁止する : "@editobj:<UUID>=<y/n>"

'実装 v2.3 と v1.25 禁止されると、指定したオブジェクトの編集・オープンしようとしても、建造・編集ウィンドウは開かなくなります。


  • 服の装着を許可／禁止する : @addoutfit[:<part>]=<y/n>

実装 v1.10, スキン、髪、目の追加 v1.10.1 指定できるパーツ : 

gloves|jacket|pants|shirt|shoes|skirt|socks|underpants|undershirt|skin|eyes|hair|shape|alpha|tattoo

パーツの指定がない場合、現在装着しているものの他に何も装着することができなくなります。

注意: Viewer 2.0 から、スキンのレイヤーが２つ増えました: Tatoo (タトゥー) と Avatar Transparency Mask (透明マスク) です。arpha と tatoo のレイヤーは、Viewer 2.0 の機能を実装した RLV 対応ビューアでのみサポートします。


  • 脱衣を許可／禁止する : @remoutfit[:<part>]=<y/n> (underpants と undershirt はティーンに許可できません)

実装 v1.10, スキン、髪、目の追加 v1.10.1 指定できるパーツ : 

gloves|jacket|pants|shirt|shoes|skirt|socks|underpants|undershirt|skin|eyes|hair|shape|alpha|tattoo

パーツの指定がない場合、現在装着しているものは何も外すことができなくなります。

注意: Viewer 2.0 から、スキンのレイヤーが２つ増えました: Tatoo (タトゥー) と Avatar Transparency Mask (透明マスク) です。arpha と tatoo のレイヤーは、Viewer 2.0 の機能を実装した RLV 対応ビューアでのみサポートします。


  • 強制的に服を脱がす : @remoutfit[:<part>]=force (*) (underpants と undershirt はティーンに脱がせることはできません)

実装 v1.10 指定できるパーツ : 

gloves|jacket|pants|shirt|shoes|skirt|socks|underpants|undershirt|alpha|tattoo

パーツの指定がない場合、全て脱がします。

注意: Viewer 2.0 から、スキンのレイヤーが２つ増えました: Tatoo (タトゥー) と Avatar Transparency Mask (透明マスク) です。arpha と tatoo のレイヤーは、Viewer 2.0 の機能を実装した RLV 対応ビューアでのみサポートします。

注意: スキン、シェイプ、目、髪は体の一部のため、取り外すことができません。 (そして、全て脱がすということは、アバターを見えなくすることになります)


  • 強制的にアタッチメントを取り外す : @detach[:attachpt]=force (*)

実装 v1.10 指定できるパーツ : 

chest|skull|left shoulder|right shoulder|left hand|right hand|left foot|right foot|spine|
pelvis|mouth|chin|left ear|right ear|left eyeball|right eyeball|nose|r upper arm|r forearm|
l upper arm|l forearm|right hip|r upper leg|r lower leg|left hip|l upper leg|l lower leg|stomach|left pec|
right pec|center 2|top right|top|top left|center|bottom left|bottom|bottom right

パーツの指定がない場合、全て取り外します。


  • 強制的にアタッチメントを取り外す (エイリアス) : @remattach[:attachpt]=force (*)

実装 v1.22 このコマンドは @detach[:attachpt]=force のエイリアスです。(下位互換性維持のために存在します)


  • 装着している服の一覧を取得する : @getoutfit[:part]=<channel_number>

実装 v1.10, スキン、髪、目の追加 v1.10.1 ビューアに自動的に現在の服のレイヤの使用状況を回答させます。結果は 0(空) か 1(使用中) の並びで、チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。

0 と 1 の並びは順に次の項目に対応します。 

gloves,jacket,pants,shirt,shoes,skirt,socks,underpants,undershirt,skin,eyes,hair,shape

パーツが指定されると、パーツにより 0(空) か 1(使用中) だけが回答されます。 

例 1 : @getoutfit=2222 => "0011000111" => アバターは pants, shirt, underpants, undershirt, skin を装着しています。
例 2 : @getoutfit:socks=2222 => "0" => アバターは socks を履いていません。

注意: Viewer 2.0 の機能を実装しているビューアでは、このような並びになります:

gloves,jacket,pants,shirt,shoes,skirt,socks,underpants,undershirt,skin,eyes,hair,shape,alpha,tattoo


  • 装着しているアタッチメントの一覧を取得する : @getattach[:attachpt]=<channel_number>

実装 v1.10 ビューアに自動的に現在のアタッチメント装着ポイントの使用状況を回答させます。結果は 0(空) か 1(使用中) の並びで、チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。

0 と 1 の並びは順に次の項目に対応します。 

none,chest,skull,left shoulder,right shoulder,left hand,right hand,left foot,right foot,spine,
pelvis,mouth,chin,left ear,right ear,left eyeball,right eyeball,nose,r upper arm,r forearm,
l upper arm,l forearm,right hip,r upper leg,r lower leg,left hip,l upper leg,l lower leg,stomach,left pec,
right pec,center 2,top right,top,top left,center,bottom left,bottom,bottom right

パーツが指定されると、パーツにより 0(空) か 1(使用中) だけが回答されます。 

例 1 : @getattach=2222 => "011000011010000000000000100100000000101" => アバターは 
chest, skull, left and right foot, pelvis, l and r lower leg, HUD bottom left, HUD bottom right に装着しています。
例 2 : @getattach:chest=2222 => "1" => アバターは chest に何か装着しています。

注意 : 最初の文字 ("none") は常に '0' なので、それぞれの装着ポイントのインデックスは LSL の対応する ATTACH_* 定数と完全に一致します。例えば、インデックス 9 を示す定数は ATTACH_BACK ("spine") となります。インデックスが 0 で始まるので気をつけてください。


  • ビューアにアタッチメントの受け入れとコントロール権取得の許可を出させる : @acceptpermission=<rem/add>

実装 v1.16 アバターに自動的にアタッチメントとコントロール権取得を受け入れさせます。確認ダイアログは表示されません。もちろん、このコマンドよりも @denypermission のほうが優先度が高くなります。


  • アタッチメントの受け入れとコントロール権取得を許可／禁止する : @denypermission=<rem/add>

実装 v1.16, 非推奨化 v1.16.2 禁止されると、全ての装着・コントロール権取得のリクエストが自動的に拒否されます。確認ダイアログは表示されません。 かなり迷惑をかけるのと、v1.16.1 でロックされたオブジェクトは自動的に再装着されるようになったという理由から、このコマンドは今では非推奨となりました。使用しないでください。


  • 持ち物の使用を許可／禁止する : @showinv=<y/n>

実装 v1.10 持ち物ウィンドウを強制的に閉じ、開かないようにします。


  • ノートカードの閲覧を許可／禁止する : @viewnote=<y/n>

実装 v1.10 ノートカードを開けないようにしますが、既に開いてあるものは閉じません。


  • スクリプトの閲覧を許可／禁止する : @viewscript=<y/n>

実装 v1.22 スクリプトを開けないようにしますが、既に開いてあるものは閉じません。


  • テクスチャの閲覧を許可／禁止する : @viewtexture=<y/n>

実装 v1.22 テクスチャ（スナップショット）を開けないようにしますが、既に開いてあるものは閉じません。


  • 立つことを許可／禁止する : @unsit=<y/n>

実装 v1.10, v1.15 でテレポートもできないように修正 「立ち上がる」ボタンを隠します。v1.15 からは、立つ手段ともなるテレポートもできないようになっています。


  • オブジェクトに強制的に座らせる : @sit:<UUID>=force (*)

実装 v1.10 ユーザが Sit によるテレポートを禁止されており、 1.5 m 以上離れている場合、または、立つことを禁止されている場合は無効となります。


  • 強制的に立たせる : @unsit=force (*)

実装 v1.10 言い訳がましいですが、さまざまな事情により失敗することもありますので、今のところ信頼しないでください。もっとテストが必要です。


  • 座ることを許可／禁止する : @sit=<y/n>

実装 v1.16.2 いかなるものの上にも座れないようにします。@sit:UUID=force で指定されているオブジェクトの上にでもです。


  • 指定したチャネル以外のチャネルを使用することを許可／禁止する : @sendchannel[:<channel>]=<y/n>

実装 v1.10 @sendchat の補完コマンドです。このコマンドはユーザがメッセージをパブリックでないチャネルに送信することを禁止します。チャネルが指定されると、当該チャネルには先の制約は適用されません（このため、 "y" や "n" ではなく、"rem" や "add" を使用するほうがいいでしょう）。この制約がかかっていても、ビューアは @version=nnn や @getstatus=nnn などと自動返答することができます。


  • 指定したチャネル以外のチャネルを使用することを許可／禁止する（セキュリティ強化） : @sendchannel_sec[:<channel>]=<y/n>

実装 v1.10 の補完コマンドです。このコマンドはユーザがメッセージをパブリックでないチャネルに送信することを禁止します。チャネルが指定されると、当該チャネルには先の制約は適用されません（このため、 "y" や "n" ではなく、"rem" や "add" を使用するほうがいいでしょう）。この制約がかかっていても、ビューアは @version=nnn や @getstatus=nnn などと自動返答することができます。 このコマンドは、先のコマンドと違い、全てのオブジェクトからでなく、同じオブジェクトから発行された例外のみ受け付けます。


  • 現在アバターに発行されている制約の一覧を取得する : @getstatus[:<part_of_rule>]=<channel>

実装 in v1.10, v1.16 でちょっとおかしくなった ビューアに自動的にアバターに対する制約の適用状況を回答させます。コマンドを実行したオブジェクトが発行した制約のみ回答されます。チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。結果はスラッシュ ('/') で区切られた制約名称のリストとして返却されます。注意: v1.16 からはスラッシュは文字列の先頭であるとみなされるようになっています。llParseString2List() で処理するのであれば大丈夫ですが、llParseStringKeepNulls() で処理する場合はおかしくなります！

このコマンドは、同じオブジェクト内にある違うスクリプトが競合する制約を発行する可能性のあるようなスクリプトを作成している人にとっては役に立ちます（例: サードパーティープラグイン）。他のオブジェクトと競合することはありません。これが、このコマンドで返される制約が、呼び出し元で発行されたものに限定されている理由です。

<part_of_rule> は制約名、もしくは制約名の一部です。スクリプトが特定の制約の有無だけを確認したい場合に便利です。 

例 : アバターが tploc, tplure, tplm, sittp の制約下に置かれているとき、スクリプトはこのような回答を得ます:
@getstatus=2222  =>  /tploc/tplure/tplm/sittp
@getstatus:sittp=2222  =>  /sittp
@getstatus:tpl=2222  =>  /tploc/tplure/tplm  ("tpl" は "tploc"、"tplure"、"tplm"  の一部ですが、"sittp" の一部ではないため)


  • 現在アバターに発行されているすべての制約の一覧を取得する : @getstatusall[:<part_of_rule>]=<channel>

実装 v1.15, v1.16 でちょっとおかしくなった ビューアに自動的にアバターに対する制約の適用状況を回答させます。@getstatus と異なり、UUID に関わらずすべてのオブジェクトが発行した制約が回答されます。チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。結果はスラッシュ ('/') で区切られた制約名称のリストとして返却されます。注意: v1.16 からはスラッシュは文字列の先頭であるとみなされるようになっています。llParseString2List() で処理するのであれば大丈夫ですが、llParseStringKeepNulls() で処理する場合はおかしくなります！


  • アバターの持ち物の中の共有フォルダの一覧を取得する : @getinv[:folder1/.../folderN]=<channel_number>

実装 v1.11, v1.13 でサブフォルダを追加 ビューアに自動的に "#RLV# というフォルダの中にあるフォルダの一覧を (あれば) 回答させます。チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。フォルダが指定されると、共有フォルダのルートでなく、指定されたパスに存在するフォルダの中にあるサブフォルダのリストが返却されます (例: "@getinv:Restraints/Leather cuffs/Arms=2222")。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。

結果はカンマ (",") で区切られた、フォルダ名のリストとして返却されます。ドット(".") で始まるフォルダは無視されます。


  • アバターの持ち物の中の共有フォルダの一覧を取得する（アイテムの使用状況つき） : @getinvworn[:folder1/.../folderN]=<channel_number>

実装 v1.15 ビューアに自動的に "#RLV# というフォルダの中にあるフォルダの一覧を (あれば) 回答させます。チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。フォルダが指定されると、共有フォルダのルートでなく、指定されたパスに存在するフォルダの中にあるサブフォルダのリストが返却されます (例: "@getinv:Restraints/Leather cuffs/Arms=2222")。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。

結果はカンマ (",") で区切られた、フォルダ名のリストとして返却されます。それぞれの項目の後ろにパイプ ("|") と２桁の数字がついています。(現在のフォルダを見せない @getinv とは異なり) 現在のフォルダが最初の項目にありますが、名前はなく、パイプと２桁の数字だけがついています。 

オブジェクトの問い合わせ: "@getinvworn:Restraints/Leather cuffs=2222"
ビューアの回答        : "|02,Arms|30,Legs|10"

ドット(".") で始まるフォルダは無視されます。２桁の数字は次のように算出されます。

１桁目: 当該フォルダ内のアイテムの装着割合（編集不可能なアイテムも含む）。この例では、"30" の "3" というのが、「Arms フォルダにある全てのアイテムが装着されている」こと、 "10" の "1" というのが、「Legs フォルダのアイテムは何も装着されていないが、装着できるアイテムはある」ことを意味します。

２桁目: 当該フォルダのサブフォルダ全体での装着割合。この例では、"02" の "2" というのが、「Leather cuffs というフォルダに含まれるどこかのフォルダで、一部のアイテムが装着されている」ことを意味します。

数字は 0 から 3 まであり、それぞれ次のような意味をもちます。

  • 0 : フォルダの中にアイテムがない
  • 1 : フォルダの中にアイテムがあるが、装着されているものはない
  • 2 : フォルダの中にアイテムがあり、一部は装着されている
  • 3 : フォルダの中にアイテムがあり、全て装着されている


  • 検索条件に該当する共有フォルダのパスを取得する : @findfolder:part1[&&...&&partN]=<channel_number>

実装 v1.13.1 ビューアに自動的に<path1>, <path2>, ... <pathN> を名前の一部に含む最初の共有フォルダのパスを回答させます。チャネル <channel_number> ですぐに回答され、スクリプトでそれを拾うことができます。深さ優先探索で検索されます。 "and" のように "&&" で連結します。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。隠しフォルダ (ドット "." で始まるフォルダ) や、チルダ ("~") で始まるフォルダは検索されません。結果はスラッシュ ("/") で区切られたパス形式で返却されます。


  • 共有フォルダ内のアイテムを強制的に装着する : @attach:<folder1/.../folderN>=force (*)

実装 v1.11、編集不可能なアイテムについては v1.12 で対応、サブフォルダは v1.13 で対応 ビューアに指定されたパス (#RLV の配下にある必要があります) にあるフォルダの中にある全てのオブジェクトと服を装着させます。オブジェクトの名前は 必ず 装着先ポイント名を含んでいなければならず、含んでいないと装着されません。編集不可能なオブジェクトは、名称変更ができないため、 必ず それぞれ名称に装着ポイントの名称を含むフォルダの中に入っていなければなりません( 1 つのフォルダに 1 個のオブジェクト) 。名称の先頭にドット (".") があってはなりません。そのようなフォルダはスクリプトからは見えないからです。

装着ポイントの名前は、「装着先」サブメニューにある名前と同じものです。"skull", "chest", "l forearm" などなど。

注意 1：フォルダの名前にスラッシュを含めることは 可能 です。そのときには、その名前がフォルダ名となっているものがあれば優先して選択されます。 (例えば、"@attach:Restraints/cuffs=force" が発行されると、"Restraints/cuffs" フォルダが選択され、その後に "Restraints" という親フォルダの中の "cuffs" フォルダが選択されることになります)

注意 2 : フォルダの名前の頭に＋記号がついているときは、@attachover と同じような挙動となります。このルールはデバッグ設定 "RestrainedLoveStackWhenFolderBeginsWith" で変更することができます。


  • 共有フォルダ内のアイテムを強制的に装着する（既に装着されているものは変更しない） : @attachover:<folder1/.../folderN>=force (*)

実装 v2.1.2 と v1.24 このコマンドは先ほどの @attach と全く同じように動作しますが、既に装着されているオブジェクトや服を取り替えることはしません。


  • 共有フォルダ内のアイテムをサブフォルダも再帰的に強制的に装着する : @attachall:<folder1/.../folderN>=force (*)

実装 v1.15 このコマンドは先ほどの @attach と全く同じように動作しますが、サブフォルダの中にあるものも全て装着します。


  • 共有フォルダ内のアイテムをサブフォルダも再帰的に強制的に装着する（既に装着されているものは変更しない） : @attachallover:<folder1/.../folderN>=force (*)

実装 v2.1.2 と v1.24 このコマンドは先ほどの @attachall と全く同じように動作しますが、既に装着されているオブジェクトや服を取り替えることはしません。


  • 共有フォルダ内のアイテムを強制的に取り外す : @detach:<folder_name>=force (*)

実装 v1.11 ビューアに <folder_name> (#RLV の配下にある必要があります) の中にあるオブジェクトを取り外し、服を脱ぐようにさせます。"@detach" が装着ポイントの名称 (skull, pelvis... 上記参照のこと) と一緒に使われていると、同じコマンドのため、そちらがこの方法より優先します。


  • 共有フォルダ内のアイテムをサブフォルダも再帰的に強制的に取り外す : @detachall:<folder1/.../folderN>=force (*)

実装 v1.15 このコマンドは先ほどの @detach と全く同じように動作しますが、サブフォルダの中にあるものも全て取り外します。


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダのパスを取得する : @getpath[:<attachpt> or <clothing_layer>]=<channel_number>

実装 v1.16 以下の条件にあてはまるアイテムを含む共有フォルダのパスをビューアに回答させます。

    • オプションを指定しない場合、コマンドを発行したアイテム。
    • オプションで指定された装着ポイントに装着されているアタッチメント。 例 : @getpath:spine=2222 => "Restraints/Collar"
    • オプションで指定されたレイヤに装着されている服。例 : @getpath:pants=2222 => "Casual/Jeans/Tight"

常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。隠しフォルダ (ドット "." で始まるフォルダ) も検索されます。結果はスラッシュ ("/") で区切られたパス形式で返却されます。

注意: 1.40.4 がメイングリッドで稼働して、今では同じ装着ポイントに複数のオブジェクトを装着することが可能となっています。このため、このコマンドの結果はもはや大した意味をもちません。というのも、複数のフォルダに分散されていても、1 つのフォルダしか結果として返ってこないからです。このため、@getpathnew を利用するのをおすすめします。@getpath はユーザが 2.1 以上のバージョンに移行しだい、段階的に廃止していく予定です。


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダのパスを全て取得する : @getpathnew[:<attachpt> or <clothing_layer>]=<channel_number>

実装 v2.1 と v1.24 以下の条件にあてはまるアイテムを含む共有フォルダのパスをビューアに回答させます。

    • オプションを指定しない場合、コマンドを発行したアイテム。
    • オプションで指定された装着ポイントに装着されているアタッチメント。 例 : @getpathnew:spine=2222 => "Restraints/Collar,Jewelry/Cute necklace"
    • オプションで指定されたレイヤに装着されている服。例 : @getpathnew:pants=2222 => "Casual/Jeans/Tight"

常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。隠しフォルダ (ドット "." で始まるフォルダ) も検索されます。結果はスラッシュ ("/") で区切られたパス形式で返却されます。複数のアウトフィットが関係しているため、複数のフォルダを返却しなければならない場合は、カンマ (",") で区切ったリスト形式で返却されます。

2.1 より複数のオブジェクトが同じ装着ポイントに装着できるようになったため、このコマンドは @getpath の代替として追加されました。


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダのアイテムを全て強制的に装着する : @attachthis[:<attachpt> or <clothing_layer>]=force (*)

実装 v1.16 このコマンドは @getpath と @attach コマンドの連続発行と同じ動きをするショートカットです（リスナーやタイマーの節約になります。）


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダのアイテムを全て強制的に装着する（既に装着されているものは変更しない） : @attachthisover[:<attachpt> or <clothing_layer>]=force (*)

実装 v2.1.2 と v1.24 このコマンドは先ほどの @attachthis と全く同じように動作しますが、既に装着されているオブジェクトや服を取り替えることはしません。


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダとサブフォルダのアイテムを全て強制的に装着する : @attachallthis[:<attachpt> or <clothing_layer>]=force (*)

実装 v1.16 このコマンドは @getpath と @attachall コマンドの連続発行と同じ動きをするショートカットです（リスナーやタイマーの節約になります。）


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダのアイテムを全て強制的に取り外す : @detachthis[:<attachpt> or <clothing_layer>]=force (*)

実装 v1.16 このコマンドは @getpath と @detach コマンドの連続発行と同じ動きをするショートカットです（リスナーやタイマーの節約になります。）


  • 指定した装着ポイントにあるオブジェクト・服を含む共有フォルダとサブフォルダのアイテムを全て強制的に取り外す : @detachallthis[:<attachpt> or <clothing_layer>]=force (*)

実装 v1.16 このコマンドは @getpath と @detachall コマンドの連続発行と同じ動きをするショートカットです（リスナーやタイマーの節約になります。）


  • アイテムを強制的に取り外す : @detachme=force (*)

実装 v1.16.2 このコマンドを発行したオブジェクトをアバターから取り外します。このコマンドは @clear を呼んだ後で llDetachFromAvatar() を呼び出すときに起こる競合問題（制約をクリアする前にオブジェクトを取り外してしまい、しばらくして自動的に再装着されてしまう場合がある）を解消するためにあります。このコマンドが導入されたことにより、@clear を呼び出して、@detachme=force を呼び出すことで、必ず @clear が先に実行されるようにすることができるようになりました。


  • フォルダ内のアイテムの取り外しを許可／禁止する : @detachthis[:<layer>|<attachpt>|<path_to_folder>]=<y/n>

実装 v2.3 と v1.25 禁止されると、ユーザは以下の条件にあてはまるフォルダに含まれるアイテムを取り外すことができなくなります。 - オプションを指定しない場合、コマンドを発行したアイテムが含まれるフォルダ。 - オプションで指定されたレイヤに装着されている服が含まれるフォルダ。 - オプションで指定された装着ポイントに装着されているアタッチメントが含まれるフォルダ。 - オプションで指定されたパスで参照されるフォルダ。

さらに、禁止されたフォルダは名前の変更、移動、削除、編集ができなくなります。


  • フォルダ内とそのサブフォルダ内のアイテムの取り外しを許可／禁止する : @detachallthis[:<layer>|<attachpt>|<path_to_folder>]=<y/n>

実装 v2.3 と v1.25 このコマンドは @detachthis と同じように動作しますが、サブフォルダにも再帰的に適用されます。


  • フォルダ内のアイテムの装着を許可／禁止する : @attachthis:<layer>|<attachpt>|<path_to_folder>=<y/n>

実装 in v2.3 と v1.25 禁止されると、ユーザは以下の条件にあてはまるフォルダのアイテムを装着することができなくなります。 - オプションで指定されたレイヤに装着されるようになっている服が含まれるフォルダ。 - オプションで指定された装着ポイントに装着されるようになっているアタッチメントが含まれるフォルダ。 - オプションで指定されたパスで参照されるフォルダ。

さらに、禁止されたフォルダは名前の変更、移動、削除、編集ができなくなります。


  • フォルダ内とそのサブフォルダ内のアイテムの着用を許可／禁止する : @attachallthis[:<layer>|<attachpt>|<path_to_folder>]=<y/n>

実装 in v2.3 and v1.25 このコマンドは @attachthis と同じように動作しますが、サブフォルダにも再帰的に適用されます。


  • 1.5 m 以上離れたオブジェクトのタッチを許可／禁止する : @fartouch=<y/n>

実装 v1.11 禁止されると、アバターは 1.5 m 以上はなれた場所にあるオブジェクトをタッチすることができなくなります。このコマンドでより現実的な制約をつけることができます。なぜなら、アバターはオブジェクトをクリックするためには、オブジェクトを押すことのできる状態でなければならないはずだからです。


  • 世界地図の閲覧を許可／禁止する : @showworldmap=<y/n>

実装 v1.11 禁止されると、アバターは世界地図を参照することができなくなり、制約が有効になった時点で開かれていた地図は閉じます。


  • ミニマップの閲覧を許可／禁止する : @showminimap=<y/n>

実装 v1.11 禁止されると、アバターはミニマップを参照することができなくなり、制約が有効になった時点で開かれていたミニマップは閉じます。


  • 現在の場所を知ることを許可／禁止する : @showloc=<y/n>

実装 v1.12 禁止されると、当該ユーザは現在自分がどこにいるかを知ることができなくなります。つまり、世界地図は隠され、メニューバーにある区画や地域の名前は隠され、ランドマークは作成できず、土地も買うことができず、テレポートした後もどこにテレポートしたか表示されず、「Second Life について」のダイアログボックスにも場所は表示されず、システムやオブジェクトのメッセージも、地域や区画の名前が含まれていたらぼかされます。しかし、llOwnerSay はありのままに表示しますので、レーダー類は正常に動作します（RLV コマンドも大丈夫です）。


  • ユーザを強制テレポートさせる : @tpto:<X>/<Y>/<Z>=force (*)

実装 v1.12 このコマンドはアバターを指定した座標にテレポートさせます。ここで注意しておきたいのは、座標は常に グローバル なので、コマンドの呼び出しを簡単に考えてはいけないということです。もっと言うと、テレポート先がテレハブやテレポート・ルートを含む場合、指定された場所ではなくそちらに飛んでしまいます。これは SL の制約です。また、@tpto は @tploc=n によって打ち消され、v1.15 以上では、@unsit によっても打ち消されることを覚えておいてください。

このコマンドを正しく呼び出している例を示します。

<lsl>

// 強制テレポートのサンプル // チャネル 4 で ローカル座標と SIM 名を取得し、 // ビューアにそこにテレポートするように指示します // // 作者 Marine Kelley 2008-08-26 // 動作する RLV のバージョン : 1.12 以上 // // 使い方 : // * 箱の中にスクリプトを作成します // * スクリプトの中身をこれに書き換えます // * 箱を装着します。 // * テレポート先をチャネル 4 で 地域/X/Y/Z のように言います // 例： /4 Help Island Public/128/128/50

key kRequestHandle; // dataserver へのリクエストの UUID vector vLocalPos; // 取得した ローカル座標

Init () { 

 kRequestHandle = NULL_KEY;
 llListen (4, "", llGetOwner (), "");

}


default { 

 state_entry () {
   Init ();
 }
 
 on_rez(integer start_param) {
   Init ();
 }
 
 listen(integer channel, string name, key id, string message) {
   list tokens = llParseString2List (message, ["/"], []);
   integer L = llGetListLength (tokens);

   if (L==4) {
     // ローカルの X, Y, Z 座標を取得します
     vLocalPos.x = llList2Float (tokens, 1);
     vLocalPos.y = llList2Float (tokens, 2);
     vLocalPos.z = llList2Float (tokens, 3);

     // SIM 情報を取得します
     kRequestHandle=llRequestSimulatorData (llList2String (tokens, 0), DATA_SIM_POS);
   }
 }
 
 dataserver(key queryid, string data) {
   if (queryid == kRequestHandle) {
     // dataserver の返答を解析します (vector を string にキャストします)
     list tokens = llParseString2List (data, ["<", ",", ">"], []);
     string pos_str = "";
     vector global_pos;

     // dataserver から取得した座標は、この SIM の南西端の座標です
     // => 指定された ローカル座標で補正します
     global_pos.x = llList2Float (tokens, 0);
     global_pos.y = llList2Float (tokens, 1);
     global_pos.z = llList2Float (tokens, 2);
     global_pos += vLocalPos;

     // コマンドを構成します。
     pos_str =      (string)((integer)global_pos.x)
               +"/"+(string)((integer)global_pos.y)
               +"/"+(string)((integer)global_pos.z);
     llOwnerSay ("Global position : "+(string)pos_str); // デバッグ用

     // ちゅどーん！
     llOwnerSay ("@tpto:"+pos_str+"=force");
   }
 }

}

</lsl>


  • 特定のアバターからのテレポート呼び出しの自動受諾をする／しない : "@accepttp[:<UUID>]=<rem/add>"

実装 v1.15, v1.16 でちょっと改善 このルールを追加すると、<UUID> をキーにもつアバターからのテレポート呼び出しを全て自動的に受け入れます。ちょうど Linden からの呼び出しを受けたときと同じような感じです（確認ダイアログ、メッセージ、キャンセルボタンはありません）。このルールは @tpto より優先されるわけでもされないわけでもなく、前者の制約では誰かのもとにテレポートしても、後者の制約によりランダムな場所に飛ばされるからです。注意: v1.16 では UUID は任意となりました。@accepttp=add は誰からのテレポート呼び出しも受け入れることになります！注意して利用してください！


  • 周囲の人の名前を表示する／しない : @shownames=<y/n>

実装 v1.12.2, v1.16 でダミーの名前のバリエーションを増やした 禁止されると、ユーザは周りにいる人が誰かを知ることができなくなります。名前はスクリーンに表示されず、チャットに表示される名前は "Someone" や "A resident" のようなダミーの名前になり、ツールヒントは隠され、右クリックメニューはほとんど役に立たなくなり、ユーザはプロフィールを参照できなくなくなるなどします。


  • フローティングテキストの表示をする／しない : @showhovertextall=<y/n>

実装 v1.19 禁止されると、ユーザはフローティングテキストを見ることができなくなります。


  • 指定されたプリムのフローティングテキストの表示をする／しない : @showhovertext:<UUID>=<y/n>

実装 v1.19 禁止されると、ユーザは UUID で指定されたプリムのフローティングテキストを見ることができなくなります。@detach が自分自身にだけ制約をつけられるのとは異なり、この制約は他のオブジェクトや他の人がつけることができるようになっています。


  • HUD のフローティングテキストの表示をする／しない : @showhovertexthud=<y/n>

実装 v1.19 禁止されると、ユーザは HUD オブジェクトのフローティングテキストを見ることができなくなりますが、インワールドのフローティングテキストは見ることができます。


  • インワールドのフローティングテキストの表示をする／しない : @showhovertextworld=<y/n>

実装 v1.19 禁止されると、ユーザはインワールドのフローティングテキストを見ることができなくなりますが、HUD オブジェクトのフローティングテキストは見ることができます。


  • 飛行を許可／禁止する : @fly=<y/n>

実装 v1.12.2 禁止されると、ユーザは飛べなくなります。


  • アバターが座っているオブジェクトの UUID を取得する : @getsitid=<channel_number>

実装 v1.12.4 ビューアにアバターが現在座っているオブジェクトの UUID を回答させます。座っていなければ NULL_KEY が返ります。


  • アバターを回転させ、ある方向を向かせる : @setrot:<angle_in_radians>=force

実装 v1.17 アバターを回転させます。向かせる方向は、北を基準とした角度をラジアンで指定します。このコマンドはそんなに正確でなく、回転する角度が 10° 未満となる場合は何も起こりません（経験則です。どこかで、最低ラインが 6° と書かれていたのを見たことがあります）。つまり、llGetRot() を先に発行して確認するか、アバターを 2 回回転させ、最初は 180° で、次に向かせたい方向に角度を指定して回すといいようです。あまりエレガントな方法ではありませんが、とりあえずなんとかなります。


  • デバッグ設定の変更を許可／禁止する : @setdebug=<y/n>

実装 v1.16 禁止されると、ビューアのデバッグ設定（Advanced > Debug Settings) を変更することができなくなります。ほとんどのデバッグ設定が役に立たないか、ユーザの使い勝手に重大な影響を与えるため、ホワイトリスト式となっています。つまり、限られたデバッグ設定だけがロックされ、他は常にアクセス・変更ができます。これを書いている時点で、許可されているデバッグ設定は、

    • AvatarSex (0 : 女, 1 : 男) : アバターの作成時の性別
    • RenderResolutionDivisor (1 -> ...) : スクリーンの "ぼやけ"。@setenv コマンドと組み合わせると、すてきな効果が得られます。注意: Note: RenderResolutionDivisor は Windlight のみで有効なオプションです。（グラフィック設定で基本シェーダを有効にする必要があります） そういうわけで、v1.19.0.5 以前のビューアでは使用できません。


  • デバッグ設定を強制的に変更する : @setdebug_<setting>:<value>=force (*)

実装 v1.16 ビューアに指定したデバッグ設定を <value> の値に変更させます。このコマンドは、"@setdebug_..." にグルーピングされる、たくさんのサブコマンドの集合となっています。例えば、"@setdebug_avatarsex:0=force"、 "@setdebug_renderresolutiondivisor:64=force" などのようにします。

指定可能なデバッグ設定の一覧は直前にある @setdebug コマンドの記述を参照してください。


  • デバッグ設定の設定値を取得する : @getdebug_<setting>=<channel_number>

実装 v1.16 ビューアにデバッグ設定の設定値を回答させます。常に正の値を使用してください。常に正の整数を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。結果は @setdebug コマンドの対応する <setting> パートで設定した値か、手動で設定した値となります。

指定可能なデバッグ設定の一覧は直前にある @setdebug コマンドの記述を参照してください。


  • 環境の設定の変更を許可／禁止する : @setenv=<y/n>

実装 v1.14 禁止すると、ユーザはビューアで環境の設定を変更することができません。 (世界 ＞ 環境の設定 ＞ 日の出／正午／日没／深夜／地域の標準設定に戻す／環境編集は全てロックされます)。


  • 環境の設定を強制的に変更させる : @setenv_<setting>:<value>=force (*)

実装 v1.14 ビューアに特定の環境の設定 (時刻や Windlight) を　<value> の値に変えさせます。このコマンドの実態はたくさんのサブコマンドの集合体です。これらは "@setenv_..." の配下にグルーピングされます。例えば、"@setenv_daytime:0.5=force"、 "@setenv_bluehorizonr:0.21=force" などです。

このコマンドは (他の "force" コマンドと同じように) 既に当該制約が設定されていれば、何もせずに復帰します。しかし、 "@setenv" の場合は、制約を作成したオブジェクトから変更がかかると、その制約が無視されます。言い換えると、首輪は環境の設定の変更を強制させることができますが、それ自身によって変更することができます。しかし、他のオブジェクトは、首輪がその制約を撤廃するまでそれを変更できません。

それぞれに指定できる値の範囲が定められていますが、ビューアではチェックされません。そのため、スクリプトではブラウザからはできないような、面白い効果を出すことができます。ただし自己責任で使ってください。ここでの範囲は、環境編集ダイアログのつまみの動かせる範囲を参考までに示しています。

それぞれのサブコマンドは、以下のように動作します (名前はなるべくビューアの Windlight パネルに似たものを選んでいます)。

@setenv_XXX:<value>=force where XXX is... <value> range Sets...
daytime 0.0-1.0 and <0 時間帯 (日の出:0.25, 正午:0.567, 日没:0.75, 深夜:0.0, 地域の標準設定に戻す:<0). 注意。全ての Windlight の設定をリセットします
preset String 環境の事前設定, 例えば Gelatto, Foggy など。 注意。事前設定をロードするのはブラウザに負担がかかり、一瞬動作が重くなるので、１秒おきに実行することのないように
ambientr 0.0-1.0 アンビエント光, 赤
ambientg 0.0-1.0 アンビエント光, 緑
ambientb 0.0-1.0 アンビエント光, 青
ambienti 0.0-1.0 アンビエント光, 輝度
bluedensityr 0.0-1.0 空の配色と濃度, 赤
bluedensityg 0.0-1.0 空の配色と濃度, 緑
bluedensityb 0.0-1.0 空の配色と濃度, 青
bluedensityi 0.0-1.0 空の配色と濃度, 輝度
bluehorizonr 0.0-1.0 空の色, 赤
bluehorizong 0.0-1.0 空の色, 緑
bluehorizonb 0.0-1.0 空の色, 青
bluehorizoni 0.0-1.0 空の色, 輝度
cloudcolorr 0.0-1.0 雲の色, 赤
cloudcolorg 0.0-1.0 雲の色, 緑
cloudcolorb 0.0-1.0 雲の色, 青
cloudcolori 0.0-1.0 雲の色, 輝度
cloudcoverage 0.0-1.0 空を覆う雲の量
cloudx 0.0-1.0 雲の位置 X
cloudy 0.0-1.0 雲の位置 Y
cloudd 0.0-1.0 雲の密度
clouddetailx 0.0-1.0 雲の詳細 X
clouddetaily 0.0-1.0 雲の詳細 Y
clouddetaild 0.0-1.0 雲の詳細 密度
cloudscale 0.0-1.0 雲のスケール
cloudscrollx 0.0-1.0 雲の移動速度 (X 方向)
cloudscrolly 0.0-1.0 雲の移動速度 (Y 方向)
densitymultiplier 0.0-0.9 大気の不透明度の増幅
distancemultiplier 0.0-100.0 視界の増幅
eastangle 0.0-1.0 東の角度, 0.0 が普通
hazedensity 0.0-1.0 大気の不透明度
hazehorizon 0.0-1.0 空と遠景の露光
maxaltitude 0.0-4000.0 最大高度
scenegamma 0.0-10.0 風景ガンマ, 1.0 が普通
starbrightness 0.0-2.0 星の輝き
sunglowfocus 0.0-0.5 太陽の輝き フォーカス
sunglowsize 1.0-2.0 太陽の輝き サイズ
sunmooncolorr 0.0-1.0 太陽/月の色, 赤
sunmooncolorg 0.0-1.0 太陽/月の色, 緑
sunmooncolorb 0.0-1.0 太陽/月の色, 青
sunmooncolori 0.0-1.0 太陽/月の色, 輝度
sunmoonposition 0.0-1.0 太陽/月の位置, 「時間帯」とは異なります。 事前設定をロードした後に、太陽の光を設定するのに使用してください

注意： 上記の設定のうち、"daytime" のみが v1.14 以上の RestrainedLove が実装されている v1.19.0 の (もしくはより古い) ビューアでサポートされています。他の設定は無視されます。これらのビューアには Windlight レンダラが実装されていないからです。


(*) 相応の制約によってユーザがそうすることができない場合は、何もせずに復帰します。これは仕様です。 

   Ex : オブジェクトが取り外し不能の場合、Force detach はできません。ユーザが脱衣不能の場合、Force undress はできません。


  • 環境の設定の設定値を取得する : @getenv_<setting>=<channel_number>

実装 v1.15 ビューアに環境の設定の設定値を自動的に回答させ、<channel_number> で指定したチャネルにすぐに載せてスクリプトが拾えるようにします。常に正の値を使用してください。通常のビューアは何も回答しないので、必ずタイムアウト後にリスナーを削除するようにしてください。復帰値は 対応する @setenv コマンドで <setting> パートにセットされた値か、手動で設定した値です。上述の設定内容一覧表を参照してください。
注意： @getenv_daytime だけが RestrainedLove v1.15 以上が実装されている v1.19.0 の (もしくはより古い、 例えば Windlight でない) ビューアでサポートされています。

sendchat などのグローバルな挙動に関する重要な注意点

挙動がグローバルである、というのは、それが特定のオブジェクトに依存しないことを意味します。しかしながら、これらは可変の UUID が設定されているオブジェクトから引き起こされるものです。複数のオブジェクトが同じ挙動を追加することができます。これらは、UUID が異なることから、複数回にわたって格納されることになります。

これには嬉しい副作用があります。チャットを禁止する2つの装置を装着しているときは、両方の装置のロックを解除しないとチャットを再開することができません。しかしこれにはいやらしい副作用もあります。(例えばrezし直されたりして)アイテムの UUID が変更され、そのアイテムがチャットを許可する設定となっていなかった場合、ユーザは少しの間待たなければなりません。これは、ガベージ・コレクタ が回収するまでの間、そのルールは「不明」(UUID が現存しない)のまま残るからです。

注意：1.16.1 から、オブジェクトにロックをかけると、どのようにしてロックをかけたかに関わらず(例えばllAttachToAvatar)、そのオブジェクトは必ず 5 秒後にビューアによって自動的に再装着されます。つまり、デタッチの際に @clear を呼び出すと、確かにオブジェクトのロックは解除されますが、再装着後に再びロックをかける必要があります。このため、デタッチの際に @clear を呼び出すことは、1.16.1 より前のバージョンとは反対に、今では推奨されません。

共有フォルダ

バージョン 1.11 から、ビューアはインワールドのスクリプトと一部のアイテムを「共有」し、強制的に着脱させたり、共有しているものをリストで表示したりすることができるようになりました。

「共有」というのは、他の人が欲しいときにそのアイテムを持っていくという意味ではなく(譲渡不能のアイテムもあるわけですから)、単に、他の人が自由自在に、アイテムを持つ本人に対する制約が含まれたスクリプトを通じて、それらの着脱を強制させることができるという意味です。これらのアイテムはインベントリに残ります。In fact, this feature would be best named "Exposed folder".

やり方：

  • 「#RLV」という名前のフォルダを「My Inventory」直下に作成します(「My Inventory」を右クリックして「新しいフォルダ」を選択)。これを以降の手順では「共有フォルダ」と呼びます。
  • 制約が含まれるフォルダや、その他装着するものを新しく作成したフォルダの直下に移動します。
  • あとは、フォルダの中のものを装着するだけです！

すると、このようなフォルダ構成になります。 

My Inventory
|- #RLV
|  |- cuffs
|  |  |- left cuff (l forearm)   (no copy)
|  |  \- right cuff (r forearm)   (no copy)
|  \- gag
|     \- gag (mouth)   (no copy)
|- Animations
|- Body Parts
.
.
.

例：RR Straps という名前の一式を持っている場合、「Straps BOXED」フォルダを共有フォルダ直下にとりあえず移動します。

移動したフォルダ(１度に１個のフォルダです！)の中のアイテムを全部装着するか、自分で変名して、それぞれのアイテムの名前が装着ポイントの名前を含むようにします。例えば、「left cuff (l forearm)」、「right ankle cuff (r lower leg)」のようにします。編集不能なアイテムを共有するのはちょっと難しいので注意してください。人の手でもビューアでも名前を書き換えることができないからです。これについては後ほど説明します。

装着ポイント名はインベントリのメニューの中の「装着先」から調べることができます。大文字小文字は関係ありません (例："chest", "skull", "stomach", "left ear", "r upper arm"...)。アイテムを装着したときに、変名されていなければ最初に自動的に変名されます。ただし、共有フォルダの中にあり、装着ポイント名が含まれておらず、編集可能なアイテムに限ります。もし他の装着ポイントに装着したい場合は、まず手で変名する必要があります。

服のパーツはまったく同じように扱われます(それどころか、制約フォルダに置け、同じコマンドで装着することができます)。例えば靴は、混在したアウトフィットの良い例となります。いくつかの装着パーツとレイヤ靴で構成されています。服は自動的に変名されることはありません。服のタイプと装着ポイントが対応しているからです (skirt, jacket, undershirt...)。

編集不能アイテムを共有する方法： 既に説明しましたが、編集不能アイテムは変名できないため、少し複雑な方法となります。アウトフィットのフォルダ (例えば上のフォルダ構成例だと"cuffs"という名前) にサブフォルダを作成し、そこに編集不能なアイテムを 1 つだけ入れます。そのアイテムを装着すると、フォルダが変名されていることに気づくでしょう。つまり、アウトフィットの中に複数の編集不能アイテムが入っている場合、同じ数のフォルダを作成し、1 つのフォルダに 1 個ずつ編集不能のアイテムを入れていくことになります。

例えば、編集不能の靴の場合はこうなります。 

My Inventory
|- #RLV
|  \- shoes
|     |- left shoe (left foot)
|     |  \- left shoe   (no modify) (no transfer)  <-- no-mod object
|     |- right shoe (right foot)
|     |  \- right shoe   (no modify) (no transfer) <-- no-mod object
|     \- shoe base   (no modify) (no transfer)     <-- this is not an object
|- Animations
|- Body Parts
.
.
.

バッドノウハウ：

  • 共有フォルダの中のフォルダの名前にカンマ (',') を含めないでください。フォルダの中がめちゃくちゃになる可能性があります。
  • 共有フォルダの中のアイテムは、必ず変名(するか、少なくとも一回は装着して自動的に変名されるように)してください。そうしないと、強制装着コマンドが何もしていないように見えることになります。
  • 共有フォルダにたくさんのフォルダを詰め込まないようにしてください。スクリプトによっては、@getinv コマンドで一覧を取得し、それを使って処理をするものがありますが、チャットによるメッセージは最大1023文字の制限があります。賢く選んで、短い名前をつけてください。しかし、平均 9 文字の名前であれば、約 100 フォルダまでもつことができます。
  • ビューアが名前を頼りにどこに装着するかを判断できるようにするために、編集不能なアイテムは必ず１つずつサブフォルダに入れてください。これらのアイテムは変名不能のため、編集可能なアイテムと同じようには共有できません。また、アウトフィットのフォルダ自体は (複数のアイテムが入っているため) 変名されません。

llGiveInventoryList() によって送られたサブフォルダの共有フォルダへの受け入れ :

RestrainedLove v1.16.2 より、あなたはターゲットのアバターにアイテム一式を送り、相手の #RLV フォルダの中のサブフォルダとして持たせることができます(それにより、後でそのアイテムを @attach させることができます)。

llGiveInventoryList(victim_id, "#RLV/~subfolder_name", list_of_stuff) コマンドを発行すると、スクリプトは相手(victim_id と同じキーをもつアバター)のビューアに通常の 受け取る／破棄／無視リスト ダイアログを表示します。

相手がオファーを受け入れると、list_of_stuff で指定されたアイテムが #RLV フォルダの中の新しいサブフォルダに格納されます。このサブフォルダの名前は ~subfolder_name で指定された名前となります(スクリプターには、一意となるようなサブフォルダの名前を指定する義務があります。既にあるサブフォルダの名前と同じであった場合、2 つの同じ名前のサブフォルダが #RLV フォルダに現れることになります)。

チルダ文字はサブフォルダの先頭に *必ず* つけるように留意してください (そうすることで、この方法で送られて来たサブフォルダを相手が見つけやすくなりますし、そのようなサブフォルダの名前は #RLV フォルダの中の最後尾に表示されます) 。

また、この機能は (Debug Setting の RestrainedLoveForbidGiveToRLV を TRUE に設定することで) ユーザが無効にできることにも注意してください。このような場合、#RLV フォルダの中には格納されず、インベントリのルート直下の"#RLV/~subfolder_name"という名前のフォルダの中に格納されます。

ユーザがインベントリのオファーを断ることも、ビューアで機能を無効にすることも、ラグのひどい日には SL がオブジェクトの実際の送信に時間がかかることもあることから、@attach コマンドを発行する前に、送信されたフォルダが存在するかどうかを (@getinv で) 確認しなければなりません。

参考情報

ここに、これが内部的にどのように動作するかを記します。あなたが遭遇するかもしれない暗黙仕様への理解を深めるのに役立つでしょう。

  • それぞれのコマンドは Behaviour (例: "remoutfit")、Option　(例: "shirt")、Param　(例: "force") に解析され、UUID (発信しているオブジェクトのユニークなID) から届きます。
  • コマンドには 2 種類あります。one-shot コマンド (Param が "force" であり、Param が "version" 呼び出しのチャネル番号のような番号であるもの) と、 rules コマンド (Param が "y"、"n"、"add"、"rem" のいずれか) 。 "clear" は特別ですが、one-shot コマンドとして捉えることができます。
  • チャネル番号を引数に指定するコマンドでは、チャネル番号は正または (RestrainedLove v1.23a (@versionnum = 1230001) 以降の場合) 負の数でなければなりません。チャネル 0

は使用できません。RestrainedLove は負のチャネルに最大 255 文字送信できます。一方で、正のチャネルには最大 1023 文字送信できます。負のチャネルはユーザにチートされにくいという便利な点があります。例えば、@versionnum の問い合わせを行うときなどです（ユーザは RestrainedLove ビューアを使っていない可能性がありますが、バージョン問い合わせコマンドに偽の返答をして、あたかも RestrainedLove ビューアを使っているかのように見せかけることができます。負のチャネルではそういったことができません）。正のチャネルは長い返答が返ってくる可能性のある場合に良い選択肢となります（例えば @getpath）。

  • "n" と "add" は まったく同じ で、まったく同じように 扱われます。これらは単なる シノニム です。同じようなことが "y" と "rem" にも言えます。ルール ("sendchannel=n") と例外 ("sendchannel:8=add") をスクリプトの中ではっきり区別するためだけのものです。
  • ルールは、発生元の UUID をルールそのものに関連付けた形でテーブルに蓄積されます。"n"/"add" の Param を受信すると 追加 され、"y"/"rem" の Param を受信すると 削除 されます。

UUID1 が首輪で UUID2 が猿ぐつわだとします。

UUID1 => detach, tploc, tplm, tplure, sittp

UUID2 => detach, sendim, sendim:(keyholder)

これらの 2 つのルールは、ユーザは keyholder 以外のアバターに IM を送信できず、どこにも TP ができないという意味になります。これらの 2 つのアイテムは取り外しできません。ここで、首輪が "@sendim=n" を送信したとすると、テーブルは以下のようになります。

UUID1 => detach, tploc, tplm, tplure, sittp, sendim

UUID2 => detach, sendim, sendim:(keyholder)

"@sendim=n" を 2 回目に送信すると何も起りません。追加する前に既に存在するかチェックがかかるからです。猿ぐつわのロックが解除され取り外されると、"@clear" が送信されるかガベージ・コレクタが開始されるかするため、UUID2 に関連づいたルールは消滅します。ところが、例外まで消滅してしまっため、アバターは keyholder にさえも IM を送信できない状態のままとなります。オブジェクトに関連付けられたルールは、他のオブジェクトに関連付けられたルールに矛盾しないからです。

  • One-shot コマンドは、これとは逆に、オンザフライで実行され、蓄積されません。
  • ログオンすると、プログレスバーが表示されている間、アバターはしばらく操作できない (チャットできない、移動できない) 状態となります。しかし、装着されているスクリプトの入ったオブジェクトはその間に rez して、ビューアが操作可能な状態になる前にルールとコマンドの送信を開始します。このために、ビューアはそれらを貯めておき、ユーザが操作可能な状態 (プログレスバーが消えたとき) になってはじめてそれらを実行します。
  • ビューアは定期的に (N 秒ごとに) 全てのルールをチェックし、既に存在しない UUID にリンクしているものを削除します (「ガベージ・コレクタ」) 。つまり、装着していない オブジェクトから発行されたルールは、アバターが テレポートして 他の場所に行くと、すぐに破棄されます。
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LSL_Protocol/RestrainedLoveAPI/ja&oldid=1129835"