Mare Control: Difference between revisions

From sNr Wiki
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 125: Line 125:
==== [MC Access] ====
==== [MC Access] ====
This toggles the ability for staff to access the animals Mare Control. Please consider using this carefully, as it may restrict staff from being able to assist your pony in your absence. If selected, other staff will receive a message saying the owner of the animal has blocked access to its mare control if they try and access it in the course of their duties.
This toggles the ability for staff to access the animals Mare Control. Please consider using this carefully, as it may restrict staff from being able to assist your pony in your absence. If selected, other staff will receive a message saying the owner of the animal has blocked access to its mare control if they try and access it in the course of their duties.
This setting blocks all access except Force Sit. Including the settings that could be otherwise toggled on or off individually.
==== [MH Access] ====
==== [MH Access] ====
This toggles the ability for staff to access the animals Mare Hearing.  
This toggles the ability for staff to access the animals Mare Hearing.  
Line 167: Line 170:
== Troubleshooting ==
== Troubleshooting ==
* Note that the environment settings are locked so it is a good idea to make sure the animal uses a fixed day setting under World | Environment Editor | Environment Settings before they are locked as they may find it hard to train in darkness and not be able to change it.
* Note that the environment settings are locked so it is a good idea to make sure the animal uses a fixed day setting under World | Environment Editor | Environment Settings before they are locked as they may find it hard to train in darkness and not be able to change it.
* One possible reason for unexpected behaviour of Mare Control or Mare Hearing can be a conflict with other attachments that implement RLV(a) restrictions. One step in troubleshooting conflicts can be to type @list in the IM window with the animal. As a response the viewer the contents of the RLVa / Restrictions list after getting permission from the user.


== Change Log ==
== Change Log ==

Latest revision as of 20:20, 29 August 2024

Mare Control is effectively a specialised collar and by default is designed to be used by sNr staff.

It can be accessed by an activated staff member via touch, a text command or the Staff HUD buttons. Quite often, the mare control collar can be obscured by something like a neck corset, so the chat command or Staff HUD is often easier.

Chat Commands

The command in local chat to access Mare Control is:
/321 mare <name> control

Where <name> is the target’s login first name.

If successful, the dialog box will appear. If the text ‘This animal has an owner’ appears at the top then you may be limited in what you can adjust, or may not be able to access it at all.

Mare Controls are glowing red when the animal kneels down (using F7). When they get back (using F8) the red glow is removed again. If you see an animal working or being not-afk with a glowing red mare control, you can release them:
/321 mare <name> release

To request a pony or mare to accept yourself as their owner:
/321 mare <name> addowner UUID

You can find the UUID (Unique User ID) on your/new owner's profile.

The owner can use the following to remove themselves as owner at a later date:
/321 mare <name> remowner
/321 mare <name> replaceowner UUID(of new owner)

A Trainer or above can check who the owner of an animal is:
/321 mare <name> owner

A Sim Manager can also remove any existing owner:
/321 mare <name> reset_owner

Menu

Lock Menu.png

Once you have accessed the Mare Control, if it is unlocked you will get a menu with the option to lock the animal. You can now lock the animal and Mare Hearing (if worn) will be locked and activated at the same time.

Typical Main Menu of Mare Control.png

After you have locked the animal, you will get something like the following menu:

Main Menu.png

The first thing to note is the message at the top in this example which says ⚠ This animal has an owner. This means that some of the mare Control options may be disabled for you. As you can see in this example, all the IM options have been disabled by the owner, and you are unable to release the animal either. Here is an example of a Mare Control menu with no owner:

The top-level Mare Control options by default are as follows:

  • Force Sit
  • TP Options
  • IM Me
  • IM All
  • RLV
  • Release

Force Sit

Force Sit.png

Back takes you back to the Mare Control main menu. Sit scans for nearby objects and gives you a button for each one, and provides a more detailed list in the local chat. This is important for something like different cart types as the button can only display limited text, so you may not have enough information to tell which cart is which. When you select an item, the pony will be sat on it. The pony should not have to deactivate their AO. Unsit will force unseat the pony from whichever object they were sat on previously.

Important: If you use Mare Control to force sit someone you must also use it to unseat them as well, or the object they were previously sat on will try and grab them again later.

TP Options

TP Options.png

Back takes you back to the Mare Control main menu.

TP all allows non members of staff to lure the pony via a teleport. This need to be enabled if non-staff members want to TP the pony to another sim, perhaps for carting. Staff members don’t need this, they just need to make sure they access mare control at least once during the session so that MC identifies them as staff and authorises teleports.

Set Position is used when the pony is in its stall at sNr. This means that their home position is set and if they log on elsewhere, they will be returned to their home stall. This is usually set when the pony is processed.

RLV

RLV Menu.png
  • Back takes you back to the Mare Control main menu.
  • Inventory controls the pony’s access to its inventory.
  • Wear/Remove controls whether the pony can add or remove attachments or clothes.
  • Running controls if they can run. This may need to be enabled for some pony sports.
  • Rez/Edit controls if the pony can rez or edit items.
  • Touch HUD controls if the pony can touch a HUD on their screen. In most cases, a pony should not need to click a HUD if they have set things up as directed in this manual.
  • Strict Mode locks a pony for at least seven days with a number of strict restrictions which can not be adjusted during this period. Please use with caution and only in special circumstances.
  • IM Me/IM All

Pressing this button toggles the type of IM access granted, so it’s important to look at the text above the buttons to see what you have set. With each press it will toggle between denied to receive only then receive and send. It’s important to notice the distinction between IMs with You and IMs with all. In most cases you would only grant IMs to yourself to discuss or resolve an issue with a pony. IMs to you are reset if another staff member overrides it or when the pony relogs.

Release

Release is used to unlock the pony from its Mare Control. You will get a warning first which you need to acknowledge. The Mare Control collar is very powerful so although an animal may have a separate ownership collar, it is recommended that only the detach restriction be used on the separate collar to avoid having restriction clashes and conflicts which can be hard to diagnose. The release menu also provides a timer option. Clicking this takes you to a webpage link. Here you can set the date and time for the Mare Control to be automatically released.

Mare Vision

Mare Vision is a paid plugin to the Mare Control which provides additional vision restrictions for the pony including cam lock, forced mouselook and full Mare Vision which makes avatars silhouettes at a certain distance and a foggy atmosphere. You may need to disable some of these features for training.

To obtain Mare Vision, the pony needs to purchase the plugin from the vendor wheel, where it is currently called "RLV 2.9 Mouselook for Mare Control v4". Then they rez the Mare Control on the ground, edit it, select the contents tab and then drag the provided script into the contents tab. They then wear the Mare Control again, and the staff member will see a new Mare Vision option in their Mare Control menu.

The Mare Vision main article has more details and troubleshooting tips.

Ownership

Mare Control allows you to add yourself or someone else as an owner of any animal wearing it. This will give you ultimate control over their Mare Control including what functions are available to other sNr staff.

Setting Owner

Setting or Removing an Owner.png

Although the ownership command can be done via text, it is safer to use the Staff HUD to use the owner functions to avoid mistakes.
So, first the staff member clicks the blue key icon, then on the ownership button and the following menu will appear:

Next, click the Add Owner button.

Owner Acceptance.png

When you ask to be their owner, the animal will get a confirmation dialog explaining what this means and the extra control you - the new owner - will have.

You will be notified if the animal accepts or declines ownership through a confirmation message in local chat.

Main Menu with Owner Options enabled.png

Assuming they accept, you will then get another menu option called Owner Sett, in addition to the options you had before, available in your Mare Control for that animal as shown below:

Owner Settings

Owner Settings Menu.png

There are a number of buttons on this menu which toggle how much access other staff have to your mare. Text above the buttons show which extra owner restrictions are active, as shown below:

[back]

Returns you to the Mare Control main menu.

[unlock]

This toggles whether other staff can release and unlock your animals mare control. When activated, only you will be able to release the mare and no one else. A Sim Mistress and above and override this, but it is only done in extreme circumstances.

[IM Send]

This toggles the staff ability to enable IMs between the animal and other staff.

[IM All]

This toggles the staff ability to enable IMs between the animal and anyone else.

[MC Access]

This toggles the ability for staff to access the animals Mare Control. Please consider using this carefully, as it may restrict staff from being able to assist your pony in your absence. If selected, other staff will receive a message saying the owner of the animal has blocked access to its mare control if they try and access it in the course of their duties.

This setting blocks all access except Force Sit. Including the settings that could be otherwise toggled on or off individually.

[MH Access]

This toggles the ability for staff to access the animals Mare Hearing.

[Bridle access]

This toggles whether other trainers can access your animal's bridle at all. Please consider using this carefully because if blocked, no staff can take your animal out for training.

RLV Restrictions

  • Teleport
  • Detach
  • Maps
  • Edit
  • Rez
  • Show Names
  • Show Name Tags
  • Show Tags
  • View Notes
  • View Scripts
  • Touch
  • Show Location
  • Set Environment
  • Run
  • Set Group
  • Show Nearby Avatars
  • Cam Zoom
  • Add or remove clothes or attachments
  • Show Inventory
  • Touch HUDs
  • Start, send or receive IMs

Updating

Staff can update all available Mare Control. Please note that there are different approaches for different versions of Mare Control:

Mare Control before 5.0

Mare Control versions lower than 5.0.0 doesn't have an integrated update mechanism. You will always need an object called "sNr Mare Updater v5" which is availabe through the sNr Staff Terminal near the stable. Rez a copy of this item near the animal you like to update. Wait until the hover text changes to green, then click the box. Select the wanted actions in menu, the most current version of the picked device will be delivered directly to the target. Note: You can use this procedure even with version 5 and up, though it is not the recommended way of updating.

Mare Control 5 and up

If an animal asks for an update of Mare Control or you see the message in someone's Mare Control that an update is available,

Get update.png

please be advised to take the following steps for a succesful update procedure:

  • click the button labelled Get Update
  • the menu will show you a confirmation message and the option to cancel
Do update.png
  • click button "Update!"
  • an update of the current settings and owner will be transferred to the database, the chat will show a message like: Mare Control: A backup of the current settings is created and the most recent version of Mare Control will be sent to the animal now. Please be patient for a moment.
  • after this is done, the most recent version of Mare Control is sent directly to the animal. You should tell them to check their inventory and let you know when they have received it. They should detach the old one and attach the new version.
  • when you access their Mare Control menu again you'll see this menu
Restore backup.png

When you click "Restore Bckp" the backup is downloaded from the database and restored in the Mare Control. If you just lock the Mare Control without restoring the backup the data is discarded. In chat you'll read something like The restore progress was started. Please wait a moment before opening the menu again



Troubleshooting

  • Note that the environment settings are locked so it is a good idea to make sure the animal uses a fixed day setting under World | Environment Editor | Environment Settings before they are locked as they may find it hard to train in darkness and not be able to change it.
  • One possible reason for unexpected behaviour of Mare Control or Mare Hearing can be a conflict with other attachments that implement RLV(a) restrictions. One step in troubleshooting conflicts can be to type @list in the IM window with the animal. As a response the viewer the contents of the RLVa / Restrictions list after getting permission from the user.

Change Log

Changelog of Mare Control.

5.1.0 (2021-05-28)

  • fixed: a typo
  • fixed: a bug with owner not loading correctly from database
  • added: rlv code updated for vision spheres (requires Vision 510)

5.0.9 (2021-01-07)

  • fixed: bug introduced with 5.0.8 which silently unset all restrictions
  • added: version number now also shown in lock menu

5.0.8 (2020-12-30)

  • fixed: bug with MC blocking touch and sit when it's unlocked

5.0.7 (2020-08-03)

  • fixed: setting tp postion does no longer affect IM settings
  • fixed: force to to a set tp position doesn't work (note:only works if ponies are logging in outside sNr, no position check on sim)
  • fixed: unlocked MC didn't remove tp and im exceptions
  • fixed: an owner was unable to access Mare Vision if access was locked for everyone

5.0.6 (2020-05-27)

  • fixed: a long outstanding fix for force sit not displaying back/next pages (sorry Devi!)

5.0.5 (2020-05-23)

  • fixed: if owner was set but release was allowed, it still did not show the options in the menu for any user except owner
  • fixed: settings are reset to default when owner removes themself
  • added: security question was added before locking the Mare Control in case an owner is set and has unlock blocked

5.0.4 (2019-11-18)

  • fixed: menu access is not available from sub menu
  • fixed: IM me doesn't show a blank string anymore
  • fixed: RLV unsit/interact is issued when MC is not locked
  • changed: overhaul of force sit script
  • changed: new panic call script
  • added: option to stop a panic call

5.0.3 (2019-11-03)

  • fixed: IM settings were falsely get reset from the server
  • fixed: Force Sit menu didn't work correctly when MC access was blocked by owner
  • fixed: Force Sit linked back to full MC menu even when MC access was blocked by owner
  • fixed: restrictions are applied only when MC is locked
  • fixed: item now reports correct wearer name instead object name if no RLV is detected
  • changed: new check for RLV

5.0.2 (2019-09-09)

  • fixed bug where tp exception was not set for owner of MC
  • fixed bug where owner was not able to access MC with staff HUD
  • changed: workaround for force sit/interact hickup in Marine's RLV

5.0.1 (2019-08-07)

  • fixed: a horrible lag making thing that kept querying the server over and over again in certain cases
  • changed: backup and restore process overhauled, having separate buttons available now.

5.0.0 (2019-07-20)

  • fixed: IM me opens to only one person at a time
  • fixed: autotp after unlocked will no more happen (hopefully)
  • changed: new update behaviour, updates availibility is detected from server automatical and update can be initiated inside the MC
  • changed: re-applying all restrictions after tp/sim change
  • changed: (internal) all new web server connection and new serverside scripts and database
  • added: show name of avatar who has currently open the IM
  • added: tpglobal added to restrictions list

4.5.1 (2019-04-18)

  • fixed: Staff HUD did not have access to MC after owner was set
  • fixed: wearer of the MC cannot be added as owner anymore
  • added: give wearer a confirmation message when owner was removed by administration

4.5.0 and earlier

it comes from an dark age where noone knows about the troubles it has seen...


top most entry means current version available at this time