Table of Contents

MuffinTR Ankle Monitor


Description

MuffinTR is a livestock location control system. This system allows livestock, or others, to have approved parcels they are allowed to be. This system also allows for users to travel to non approved parcels for a specified limited amount of time. Once a user requests travel, they must wait for the system to recharge for a specified amount of time to be allowed another travel window.


Please note that this device is intended to work with RLV. The majority of the features will not function correctly without RLV support.



*Please note this device is meant to be purchased by the livestock then setup by an owner or the dairy they are part of.*



Features


  • Home position teleport (other than an sl home location)
  • Local settings (stored in the device)
  • Dairy / Farm Wide settings (stored from a Dairy / Farm owner setting up settings on the website)
  • Multiple owners (local settings)
  • Controlled by farm hands (manager or owner by default with web settings)
  • Allowed Parcels by
  1. Name 
  2. Owner 
  3. Group
  4. Individual Spots (with radius setting)
  • Settings Import and export
  • Sound indications 
  • Travel outside of allowed parcels for settable time periods
  • Recharging (waiting) for next travel window 
  • Ability to turn on and off the travel all together


Basic Info


The MuffinTR ankle monitor requires a home position and a starting parcel to be set before tracking can be turned on


To set an allowed parcel, click the ankle monitor and go to parcel management. Here a user can add a parcel where the user is currently at, by name, group, owner, or the specific spot. 


A user can turn tracking on for themselves by going to the owner menu and hitting the "Tracking Toggle" option. If the user adds an owner and they lock the ankle monitor, the user will be unable to set their own allowed parcels. 


The “Allowed Travel” option allows the user to travel ANYWHERE for an specified period of time. Then the user must remain in an approved parcel till their travel time is recharged. This was designed this way so users can still travel but are required to "return home".



Adding Parcels


Local Settings

-----------------------

  1. Ensure the device is not locked and that tracking is disabled.

  2. Click the Device

    1. As an added owner to the device, you will need to click the “Main” option to go to the main menu as the first menu is the owner’s menu

    2. As the owner of the device, your device must be unlocked to be able to access the parcel control

  3. Select the option “1 - Parcel Control”

  4. Next select the option “2 - Allowed Parcels”

  5. Now at the Allowed Parcels menu, select how you want to add the *CURRENT PARCEL* to the device. There are various reasons to use each type of option.

    1. Parcel Name: use this option to add the current parcel’s exact name to the device

    2. Parcel Group: use this option to add the current parcel’s group to the device. All other parcels owned by this group will also be allowed.

    3. Parcel Owner: use this option to add the parcel’s owner to the device. All other parcels owned by this owner will be also allowed

    4. Parcel Location: use this option to allow just the exact specific location to the device. The location is an exact spot in a sim. The radius a wearer can travel from this spot is set in the owner’s menu.


Dairy Settings
-----------------------

Dairy / Farm settings are done by uploading a config settings up when logged on as a dairy owner or manager.

You can find the MuffinTR settings button on your dairy farm page. 


1.) Follow local settings to create a local config settings for a livestock

2.) Click the Device 

3.) Click on the "Utilities" Option

4.) Select "Output Settings" options 

5.) Copy and paste these full settings, including the { }, to the MuffinTR settings page. 

You will see a big white text box with the words 

"Paste In - MuffinTR - Ankle Monitor Settings"

6.) Hit the upload button on the MuffinTR settings page.

Once uploaded you can then come back to this page to make edits dairy wide to the settings. Including uploading new setting full files. 

7.) Click the device 

8.) Select "Utilities" Option 

9.) Select "Set Settings To Web"

This will now set the device to use the dairy settings for the livestock. The livestock must be part of the dairy for this to work. 

Once on this setting, farmhands or dairy owner can access and control this device. 


Example Main Menu



Akari Armitage's 'MM - MuffinTR *beta* v.1.09'

MM - MuffinTR *beta* :v.1.09

--------------------------------

*Locked*

*Tracking ENABLED*

Mode: Dairy / Farm

Parcel Counts: 8

Travel Allowed

Total Travel Time: 10 minutes

--------------------------------

1 - Parcel Control

2 - Request Travel

3 - Owner Menu

4 - Utilities Menu

5 - Help

--------------------------------



Top Status Info


The top of the main menu shows the status of the MuffinTr ankle monitor. 


-Locked shows the current locked status. This refers to if the ankle monitor is locked with rlv and menu restrictions are enabled 


-Tracking enabled is displayed next. This is representing if the device is current making sure the user is in allowed parcels 


-Mode shows the current settings mode. This is either Local or Dairy / Farm settings. Note that dairy or farm settings only will work if the user is part of a dairy / farm. 


-The total allowed parcel count is displayed next


-Travel allowed means that a user can request travel outside of allowed parcels. If a user tries to leave the allowed parcel without requesting travel, they will be force teleported back. 


-Total Travel Time shows the current specified amount of time the user will be allowed to travel when travel is requested before being teleported home.

-Info not shown here is Recharge Times. When a user is traveling, their total remaining time is displayed in this status. When a user is recharging their travel time, their remaining recharge time is also displayed here.



Main Menu Options


1 - Parcel Control

This is for settings allowed parcels. This is disabled for users when the device is locked.


2 - Request Travel 

This option will enable travel for a user if travel is allowed. 


3 - Owner Menu 

This option is for locking, unlocking, setting tracking status, and many other options specific to an owner or farm hand to control the device.


4 - Utilities Menu

This option is for displaying all the utility options for this device. Note that this includes where setting the current settings type (local or dairy / farm) is set. 


5 - Help Menu

This option displays help options for the user.



Owner Menu


*NOTE* This menu can only be reached if the user accessing the menu is an owner already, a farm hand or dairy owner when on dairy / farm settings, or the user of the system when not locked.


1 - Lock Toggle

This option locks or unlocks the device. When locked a few options are disabled for the user. 


2 - Tracking Toggle

This option toggles whether or not the device is tracking the user’s current location or not.


3 - Add Owner

This option will bring up a few prompts to add an owner to the device.


4 - Remove Owner

This option will bring up a few prompts to remove an owner from the device.


5 - Travel Request Toggle

This option will disable the ability for a user to request travel. Toggling this to off means a user can no longer travel to non approved parcels.


6 - Travel Time Allowance

This option will set the amount of time a user can travel outside allowed parcels during requested travel periods.


7 - Travel Time Recharge

This option will set the amount of time a user must recharge the device between requesting travel again. 


8 - Set Allowed Position Distance

This option is specific to the allowed “Parcel Location”. Parcel Locations are a specific point in a sim. This option will set the distance a user can travel from that specific spot. For example, if the distance is set to 10, a user can only travel 10 meters from a specific Location Parcel spot.




Parcels Menu



1 - Set Home Position

This will set the user’s current home location. Please note this is not the SL specific home location. It’s the device’s home location which a user will be teleported to if they are found to be outside allowed parcels. 


2 - Allowed Parcels

This option will allow a user to add new parcels to the allowed parcels list.


3 - Remove Parcels

This option will allow a user to remove existing parcels from the allowed parcel list


4 - List Parcels

This will output all current allowed parcels.



Allowed Parcels Menu


These menu options are for adding allowed parcels to the device. 


************************************************************

Please note, all these options add the current parcel the user is at just in the different ways. Be careful how you add parcels to the device. You may give more freedom than you expect depending on the option.

************************************************************


1 - Parcel Name

Use this option to add the current parcel’s exact name to the device.



2 - Parcel Group

Use this option to add the current parcel’s group to the device. All other parcels owned by this group will also be allowed.


3 - Parcel Owner

Use this option to add the parcel’s owner to the device. All other parcels owned by this owner will be also allowed



4 - Parcel Location

Use this option to allow just the exact specific location to the device. The location is an exact spot in a sim. The radius a wearer can travel from this spot is set in the owner’s menu.




Utilities Menu


1 - Force Tp Home

This option will force teleport a user to the device’s home location.


2 - Force Parcel Check

This option will force the device to verify the current parcel is an allowed location. This can be helpful when setting up the device. Note that tracking does not have to be enabled to use this option.


3 - Output Settings

This option will output the settings for the device to be uploaded or pasted into a notecard. The output is in JSON format. All parts of the JSON must be included (this means the { } ) when upload settings to a Dairy / Farm or pasted in a notecard.


4 - Set Settings To Local

This option is only available when the device is not locked. This option will set the current settings for the device to local. The notecard inside the device will be loaded by default for settings. 



5 - Set Settings To Web (Uses Farm / Dairy membership)

This option is only available when the device is not locked. This option will load the settings from the server for a specific Dairy / Farm the user is a registered livestock of. If the user is not a registered livestock of any farm, no settings will be loaded. Note that once this setting is loaded, local settings will be overridden with the web settings.


6 - Color Toggle

This option will toggle the device color from black to white. 


FAQ