User Guide - RuthAndRoth/Ruth2 GitHub Wiki

Ruth2 - Open Source Mesh Avatar for Virtual Worlds

Ruth2 is a low-poly mesh body specifically designed for OpenSimulator. It is built to use standard Second Life(TM) UV maps using a scratch-built open source mesh by Shin Ingen, Ada Radius and other contributors from the OpenSimulator Community.

BAKES ON MESH

Ruth2 v4 is designed to work well with Bakes on Mesh. It has a simple alpha masking capability without needing many separate mesh parts. Alpha masks can be worn to give more control over hidden areas. As an alternative to Bakes on Mesh skin textures may also be applied, but you should then add a full body alpha mask to hide the underlying system avatar.

The "Ruth2 v4 Mesh Avatar" box contents are designed so that they form a complete initial avatar using Bakes on Mesh. Flat (posable), Medium and High Feet will all be attached as well as related toenails, and a number of fingernail options. You can remove the options you don't want to wear. You can switch to your own shape, skin, eyes and hair and/or use the HUD to change your appearance. Some example skins, hair, clothing and a range of alpha masks are provided in the "Ruth2 v4 Extras" box.

HUD

Ruth2 v4 uses a single combination HUD for alpha masking, skin and eye texture application and other features. The skins and eyes that are available are set via a notecard (!CONFIG) in the Contents of the HUD which can be edited to incorporate your own skins (10 slots are available) and/or eye textures (5 slots are available).

BOX CONTENTS

Ruth2 v4 - Mesh Avatar

This is the normal distribution box and is designed so that once unpacked its contents can be "worn" and then adjusted to a user's needs.

  • !README, !LICENSE and !CHANGES
  • Ruth2 v4 (Body+Hands+Head)
  • Ruth2 v4 Flat Feet (posable)
  • Ruth2 v4 Medium Feet (optional)
  • Ruth2 v4 High Feet (optional)
  • Ruth2 v4 Eyes
  • Ruth2 v4 Eyelashes
  • Ruth2 v4 Toenails (3 options: for flat, medium and high feet)
  • Ruth2 v4 Fingernails (5 options: long, medium, oval, pointed, short)
  • Ruth2 v4 HUD
  • Initial skin, shape, basic eyes, basic hair, etc.
  • Basic underwear

Ruth2 v4 - Mesh Avatar - Business

A special version of Ruth2 v4 with smoother body shape. This is the normal Business-friendly distribution box and is designed so that once unpacked its contents can be "worn" and then adjusted to a user's needs.

  • !README, !LICENSE and !CHANGES
  • Ruth2 v4 Business (Body+Hands+Head)
  • Ruth2 v4 Flat Feet (posable)
  • Ruth2 v4 Medium Feet (optional)
  • Ruth2 v4 High Feet (optional)
  • Ruth2 v4 Eyes
  • Ruth2 v4 Eyelashes
  • Ruth2 v4 Toenails (3 options: for flat, medium and high feet)
  • Ruth2 v4 Fingernails (5 options: long, medium, oval, pointed, short)
  • Ruth2 v4 HUD Business
  • Initial skin, shape, basic eyes, basic hair, etc.
  • Basic underwear

Ruth2 v4 - Extras

This is a box of useful extra elements and options.

  • !README-EXTRAS and !LICENSE
  • Ruth2 v4 Business (Body+Hands+Head)
  • Ruth2 v4 Business Headless (Body+Hands)
  • Ruth2 v4 Body (only)
  • Ruth2 v4 Hands
  • Ruth2 v4 Head
  • Ruth2 v4 Headless (Body+Hands)
  • Ruth2 v4 Head+Vneck (section of body)
  • Ruth2 v4 Elf Ears
  • Basic underwear alternatives
  • Shoe height adjustments for fixed medium and high feet
  • Alternative skins
  • Alternative shapes
  • Sample alpha masks
  • Sample hair
  • Sample hair tattoos
  • Sample universal wearables for nail textures

Ruth2 v4 - Resources

This box is not normally needed. It contains textures and other resources with original UUIDs as used within the other assets. This can be useful of moving the assets across grid, or to repair elements.

  • !README-RESOURCES and !LICENSE
  • Skin and eye textures used in default HUD

Ruth2 v4 - Mesh Uploads

This box is not normally needed. It contains mesh for all Ruth2 v4 elements as originally uploaded with LOD settings described in https://github.com/RuthAndRoth/Ruth2/wiki/Ruth2-v4-Assembly-Instructions and before attaching a root prim or any texturing and addition of scripts.

  • !README-MESH-UPLOADS and !LICENSE
  • Collada (.dae) Mesh for all Ruth2 v4 elements as originally uploaded

R2 Skins - Female

Textures for skins used in the Ruth2 v4 HUD and alternatives from https://github.com/RuthAndRoth/Skins

  • Skin Textures
  • Assembled skins

APPEARANCE SLIDERS

See this Wiki page for information on Bento Mesh Bodies and Heads... http://wiki.secondlife.com/wiki/Project_Bento_Resources_and_Information

The following avatar appearance slider controls are not supported due to technical constraints as described in this Wiki page... http://wiki.secondlife.com/wiki/Project_Bento_Skeleton_Guide

  • Head Shape
  • Eyelash Length
  • Eye Pop
  • Ear Angle
  • Attached Earlobe
  • Jowls
  • Chin Cleft
  • Upper Chin Cleft

KNOWN ISSUES AND TROUBLESHOOTING

Ruth2 v4 with attached Bento head will work with most shapes. The headless body, to use with system head or other mesh head, will work well with the sliders except body fat, and extremes to neck length and thickness, because of the neck seam. There are a few head sliders that don't work: Head Shape, Ear Angle, Jowls, Chin Cleft.

Texture Alpha Mode - Alpha Blending or Alpha Masking? Ruth2 v4 is set initially with mode Alpha Masking with a mid cutoff of 128 (the cutoff range can be 0 to 255) as this may work well with the addition of clothing and hair that use Alpha Blending as transparent edges can appear if too many overlapping items use the same alpha mode. But Alpha Blending can often look smoother. The Eyelashes are set to Alpha Blending mode for this reason since they act more like a hair attachment.

The Ruth2 v4 mesh near the toes is adjusted to avoid the toenail area of the skin, as many skins bake in toenails. Ruth2 v4 is designed to make use of separate mesh toenails. For best result, paint over the system toenails and remove as much detail as you can from your foot skin that is probably designed for the system avatar's duck feet.

The HUD Options Tab allows for the posable flat foot pose to be altered and an "ankle lock" facility attempts to keep animations from moving a joint or two. The ankle lock is sometimes needed to counter-act an interaction between some poses/animations and non-flat feet that otherwise bends the foot back another 45-60 degrees. Not every raised foot needs it due to variations in rigging and if the feet were posed with animations already or not.

Multiple fingernail shapes are available. The HUD is not currently enabled to support selection between these. Just add and remove the option you wish to use.

Due to the scripting facilities used in the HUD, Ruth2 v4 scripts will not work on early versions of OpenSim such as 0.8.2.1 (now five years old). Please update. But to help, a box with unscripted versions of the main mesh avatar is available on OSGrid on the RuthAndRoth region. This version does not include the HUD, the body parts are unscripted except for relaxed hand pose activation in Ruth2 v4 (Body+Hands+Head). This version should work for BoM with an appropriate viewer, or apply skins and manually apply alphas where needed.

RUTHANDROTH COMMUNITY

Please contribute via the GitHub Repository and send your feedback by posting to the Discord Channel.

CREDITS