Welcome to the Sansar Platform Documentation

Greetings, Sansarian! Whether you're a seasoned user or taking your first steps into the game our documentation is here to be your guide on this virtual journey.

What is Sansar Documentation?

Think of it as your trusty guidebook, helping you navigate the ins and outs of the Sansar platform. From the basics to advanced features, we are currently crafting this documentation to make your experience as seamless as possible.

Ever find yourself wondering how to customize your avatar, build your virtual haven, or troubleshoot a pesky issue? Look no further. This documentation is your guide, providing step-by-step instructions, tips, and troubleshooting info to ensure you get the most out of Sansar.

Real Answers for Real Challenges

We get it, sometimes things don't go as planned. Our troubleshooting and guide sections is dedicated to addressing common issues, so you can spend less time figuring things out and more time enjoying your time in Sansar.

A Community Connection

Sansar is more than just a platform; it's a community. Our new documentation is currently under construction and a revamp, we have collected together as much of the old info into one place from all over the previous community forums that have existed in the past so some info may be out of date while we sort through it all, in the mean time head on over to our where many members of staff and the community are happy to help with any questions!

Ready to Begin?

Whether you're here to create, explore, or connect, the Sansar Platform Documentation is a great starting point, check out the tabs on the side for what you are trying to do and have a read!

Features

• There's lots of them

• and many more to come

Get Started

Sign up at !

Join our

When using Sansar with a VR headset, you have access to some different settings than desktop users, the menu is in the same place but only some settings affect VR users vs Desktop users.

Coming soon...

Via our Discord

For most support requirements we are currently using our discord in a open manner so you are able to see previous support posts of other users with similar issues, you can sign up by joining our Discord! and heading to the Support page then creating a new post by clicking at the top of the page.

Via Email

General Support

[email protected]

Appealing a ban

[email protected]

Document info

These documents are still being worked on and is currently a repository of all the old information from the previous help pages, We're putting in a lot of effort to update all the links and information to make sure everything is current. If you're looking for something that isn't ready yet, is missing or outdated consider joining our Discord!

Broken Links

You ended up on this page because you tried to click on a link that isn't available right now. We're actively working on updating the existing documentation and image links as quickly as we can. and undergoing a restructure of the content. In the meantime, feel free to use the wayback machine with any link that fails as it holds archives of the old forums.

https://archive.org/web/

Missing info

If you cannot find something or the information is missing/hard to find or understand we are happy to try and resolve this by creating guides and new pages during this restructuring phase, reach out on

What is the Cache?

The cache is a pair of files used to speed up loading of worlds, textures, sounds and a few other things, visiting a world for the first time will add it to the cache and it will load significantly faster the next time you visit.

Ports used by Sansar

If you are having trouble updating or connecting to Sansar, you may need to configure your computer's or network's firewall (typically by ) to allow the use of certain ports by your computer.

The ports used by our services are as follows:

This content is licensed under the terms of the Creative Commons Attribution 4.0 International License. When using this content, you must:

• Acknowledge that the content is from the Sansar Knowledge Base.

• Include our copyright notice: "© 2017 Linden Research, Inc."

• Indicate that the content is licensed under the Creative Commons Attribution-Share Alike 4.0 International License.

This article covers the usage of the Valve Index controllers for the HTC Vive in Sansar. For information about other control methods, see .

Note: We currently do not support the Vive Index headset.

Experience controls

Use these controls while visiting an experience:

Some General problems and solutions, for Import errors please see

A specific world keeps failing to load

• Your cache may have become corrupted try clearing it by following this guide.

While in VR, you can use your Oculus Touch or HTC Vive wand controllers to perform hand gestures, such as pointing, thumbs-up, or "ok".

Note: The HTC Vive wand controllers have limited support for hand gestures in Sansar. At this time, the only available hand gesture for Vive is to make a fist (activated by pressing the trigger on either controller).

Performing hand gestures

The basic controls for performing hand gestures are as follows:

This is not supported officially but we have had some success at running sansar using this method. As this is unsupported use at your own risk and expect there may be some bugs.

1. Update your OS to the latest

2. Download the game porting toolkit here: https://developer.apple.com/download/all/?q=game%20porting%20toolkit

3. Copy your Sansar game client folder over to your Mac C:\Program Files\Sansar\Client

4. Download this installer that will do all the work: This is the file you need:

• Run the Installer you just downloaded Choose the game porting toolkit and SansarClient.exe files as shown below

• During the installation you will see a window prompt pop up that says windows 7 in bottom of it. Change that drop down to windows10

• Done. Sansar should launch

• To launch Sansar another time just run the game porting toolkit installer a second time, but you only need to select the SansarClient.exe

Deploying unpublished NON-event world content to an event world

Say you've created a private, event-specific version of a published world that you want to use for an event listing — yet you can't select it during the event creation process! Initial events can only link to published worlds, to register them as connected for popularity metrics.

However, after you've created that event, you can easily link the event to ANY unpublished content.

Here's a simple workaround you can do in less than a minute:

First, the usual event creation process:

1. Click Create menu > Host an event.

2. Fill out the event details. You should base it on the "main" published world that the variant was derived from, as it attributes the original with subsequent "popularity" info for the event hosted within. In any case, you'll be changing this shortly.

3. Click Save & Publish.

Time to deploy:

1. Open Create menu > Build worlds. In this MY WORLDS window, your new event will be on the top of the list.

2. Now, in the same MY WORLDS window, scroll to the actual world variant you want to use for this event.

3. Click (...) > Deploy scene and read the instructions inside.

You're done, have an eventful time!

Have more questions? Join our

The Chat panel

The Chat panel allows you to communicate with other people in your current experience and respond to direct messages.

When you are visiting experiences, the Chat panel opens automatically to the Nearby tab. However, in Edit Scene mode, the Chat panel opens to the Friends tab by default.

In desktop mode

|

To chat with all nearby people in your experience:

• Open the Chat panel by choosing Socialize > Chat from the main menu.

• Once the Nearby tab opens, write something in the Enter Message field at the bottom of the Chat panel, then click Send Message or press Enter to send a message.

• All Nearby messages sent and received from others appears under the Nearby tab, along with the name of the experience you are visiting.

To send or reply to a private message:

• Open the Chat panel by choosing Socialize > Chat from the main menu. If you have any private messages waiting, a green light appears on the Friends tab; click it to view your messages.

• On the Friends tab, click the private message you want to reply to then click the > arrow to view the conversation. To start a new conversation, click New Message instead.

• Type a message into the Say something to field, then press Enter to send a message to only that person.

While visiting an experience in Desktop mode, you can press F7 to toggle Mouselook mode. With the following effects:

• The Menu UI disappears

• F7 has a target reticle pop up an the camera follows mouse movement.

• You can steer the camera and your avatar by moving the mouse without having to hold right click.

• Your avatar only turns when moving, so you won't turn in place while looking around, But if holding a object your arm will follow the cameras movement.

Mouselook mode facilitates a more immersive movement and aiming with certain tools and weapons your avatar has picked up while in Desktop mode (VR users can easily aim using their VR controllers).

Have more questions? Join our

In Sansar, you have the ability to gather a nearly-unlimited amount of people in your event.

This is accomplished through our Instancing feature. When a scene reaches its designated max capacity, Sansar will automatically create a copy of that scene. These copies are called "Instances"

When multiple instances are created, users can choose which Instance they want to be in.

To do this:

• Open your Codex, and select the world you desire by clicking the world's portrait. (NOT the "Visit" button)

• Click on "View Instances"

• Select an Instance from the list.

If you and your friends become separated in different Instances you can easily find each other.

Simply go to:

• "View Instances"

• Click on "Share my instance URL"

You will then be able to copy and paste your instance URL to your friends and they can follow you to the instance that you are currently occupying.

With this knowledge you can now successfully travel between Instances in Sansar and bring your friends along with you!

Have more questions? Join our

People Panel

The People panel has tabs to show who's nearby, your Friends list, and pending Friend requests. You can open the People panel by choosing Socialize > Friends & People from the main menu.

This article delves into managing avatar-related inventory items. To learn more about managing scene-related items, check out the action menu section of the Scene creation inventory page.

If you imported an avatar item, you may have been prompted to provide an inventory name and image for your avatar upon import. If you skipped adding an image during the import step or want to change the item name, you can do so by editing the item's information. To edit the item's name:

1. Open the avatar editor by clicking on the Style my avatar button on the main menu.

2. Once you are in the lookbook, click the Customize button on any avatar look you have on the list. This opens the avatar editor, where you can access your inventory panel.

3. On the inventory panel, simply right-click on the item that you want to manage and a sub-menu opens.

4. Click Edit Info in the sub-menu. A panel that allows you to change the inventory image or name appears.

5. To change the name of the item, simply type the new name on the Name of item in inventory field.

6. Click on Update to finalize your changes.

note: If you plan to sell the item in the store, the inventory name you designated also appears in the item buyer's inventory. Make sure to finalize the name prior to starting the listing process or you can change the inventory name as it appears to other users' from the . Inventory level changes don't propagate to any active listings.

Have more questions? Join our

This article delves into managing avatar-related inventory items. To learn more about managing scene-related items, check out the action menu section of the Scene creation inventory page.

You can delete items you've uploaded to the inventory or purchased from the Sansar Store from the inventory. To delete an avatar item from the inventory:

1. Open the avatar editor by clicking on the Style my avatar button on the main menu.

2. Once you are in the lookbook, click the Customize button on any avatar look you have on the list. This opens the avatar editor, where you can access your inventory panel.

3. On the inventory panel, simply right-click on the item that you want to manage. Once clicked, a sub-menu pops up with options.

4. Depending on the operation that you want to conduct, click on List Item, Edit Info, or Delete. We will delve into these operations in the next section.

5. Click Delete in the sub-menu.

6. A dialog with the message, Are you sure you want to delete this item?" appears.

7. Click Ok to permanently delete the item or click Cancel to go back to the avatar editor.

note: You can still retrieve lost or deleted purchased items back to your inventory provided that the content creator hasn't taken the item down. See to learn more.

Have more questions? Join our

When using Sansar with a VR headset, you should make sure to calibrate your height. Height calibration affects the elevation of you your first-person point of view, and plays a role in scaling how your avatar is animated when you move your arms, legs, and head.

Entering your height manually

You can set your height manually while in VR:

1. Open the main menu on your left wrist by pressing Y on your Oculus Rift controller or Left Menu on your HTC Vive controller.

2. Using your opposite hand, select Set height from the main menu.

3. Use your VR controller to activate the up and down arrows until your correct height is displayed.

4. Click Ok to confirm your height.

Detecting your height automatically

Sansar can estimate your height automatically by measuring the length of your arms:

1. Open the main menu on your left wrist by pressing Y on your Oculus Rift controller or Left Menu on your HTC Vive controller.

2. Using your opposite hand, select Set height from the main menu.

3. Choose Detect.

4. Extend your arms outward, then hold any button on your VR controller until calibration completes.

Height calibration settings

There are some Sansar that affect height calibration:

• Remember height - Remembers your height between sessions so you don't need to calibrate every time you log in.

• Show height in meters - Shows height in meters rather than the default feet and inches.

Have more questions? Join our

The Blender avatar files we provide contain the base skeleton that we use for the avatar and a copy of the body mesh skinned to the avatar. These files have been modified for improved visibility and quality of life when used with Blender.

These files can be found in Avatar reference files.

Special features of the Blender avatar files

The blender files provided in Avatar reference files, include the full-resolution avatar mesh, skinned to the avatar skeleton. We have hidden all of the bones that are unnecessary for skinning and animation, and the face and twist bones display as cubes for improved visibility. To see this "cleaner" view, you must enable Pose Mode by toggling the option in the bottom of the 3D View panel or by clicking Pose under Armature in the Outliner.

How Blender displays bones differently

If you are in Edit Mode, you will see the full skeleton with no bones hidden, and all bones will be drawn using the default Blender "Octahedral" view. These bones resemble the joint objects in Maya and 3DS Max, but Blender's display method is different. Every bone object has a head and a tail, which resemble Maya and 3DS Max's bones, but with an important distinction: The tail of the bone is actually a vector that tells Blender which direction the bone is facing (similar to Joint Orientation in Maya). This is why the face bones look so cluttered in Blender when you first import them or view them in Object Mode.

Have more questions? Join our

What items are sunsetting with the release of avatar 2.0?

Any asset under the following item types (avatars, rigged hair, rigged clothing) created using the avatar 1.0 avatar skeleton will no longer be usable in the new avatar 2.0 system. It is key to be aware of which items are sunseting so purchasers have better insight on the items prior to purchase.

Which avatar 1.0 assets can I still wear after the release of avatar 2.0?

All Marvelous Designer clothing, accessories and emotes created against the 1.0 avatar skeleton will still be usable on the 2.0 avatar. These items will still be available in your inventory and any listed items will still be accessible from the store for purchase.

However, any rigged hair, rigged clothing or avatars will no longer be usable on any 2.0 avatar.

Why do avatars, rigged hair, and rigged clothing have to sunset?

Changes to the base avatar's skeletal structure had to be made in order to support Avatar 2.0. Because of this, we had to make a tough decision to no longer support avatar 1.0, which meant that avatars, rigged hair and rigged clothing uploaded prior to the change would no longer be supported.

Will I be able to update my broken content?

Yes, you will be able to update any of the affected content such as avatars, rigged hair, and rigged clothing. Creators will be given one opportunity per affected store listing to update their listings with Avatar 2.0-compatible content.

Have more questions? Join our

This article delves into managing avatar-related inventory items. At this time, scene creation items do not support inventory images.

If you imported an avatar item, you may have been prompted to provide an inventory name and image for your avatar upon import. If you skipped adding an image during the import step or want to change the item name, you can do so by editing the item's information. To edit the item's information:

1. Open the avatar editor by clicking on the Style my avatar button on the main menu.

2. Once you are in the lookbook, click the Customize button on any avatar look you have on the list. This opens the avatar editor, where you can access your inventory panel.

3. On the inventory panel, simply right-click on the item that you want to manage and a sub-menu opens.

4. Click Edit Info in the sub-menu. A panel that allows you to change the inventory image or name appears.

5. To change or add an inventory image, click on Browse to choose the file to upload as an image.

6. Click on Update to finalize your changes.

note:

• An inventory image is required in order to be able to list an item.

• If you plan to sell the item in the store, the inventory image you designated also appears in the item buyer's inventory. Make sure to finalize the image prior to starting the listing process otherwise the original image at the time of listing will still be the image that will be shown on the users' inventory. Inventory level changes don't propagate to any active listings.

Have more questions? Join our

You can use to track the positions of your right foot, left foot, and waist for improved body tracking and avatar movement in Sansar.

VIVE tracker setup

For each tracker:

1. In SteamVR, choose Devices > Pair Controller.

Finding and visiting events using the Codex

You can use the Events section of the Codex to browse all upcoming events in Sansar. To open the Codex, choose Go > Events from the main menu.

Or by selecting the events tab at the top of the codex.

The Events section of the Codex has four tabs:

To use Sansar. you must first register to join Sansar. Joining Sansar is quick and easy. There are currently two parts to setting up your account, which are processed in both the Sansar website and client.

Part 1: Create your account

These controls are for use with the optional Xbox One or Xbox 360 game controller. To see available controls using other controllers, see

Controls for visiting worlds

• A Button (A) - Jump

You can import custom animations for use as avatar emotes. The file must be in .FBX format.

To import a custom emote:

1. Open the Lookbook by choosing Create > Style my avatar from the menu buttons.

System Requirements

For a list of recommended and minimum system specifications for people using desktop only or desktop with VR headsets, please see .

Install Sansar

To install Sansar:

1. Download the client from the .

2. Locate the file in your browser's download folder.

Creating your own events

You can create your own in Sansar.

To add an event:

1. Choose Create > Host an event from the main menu.

Do I need VR to play Sansar?

No, you do not need VR in order to enjoy Sansar. You can play Sansar without a VR headset in desktop mode.

Which VR headsets are compatible with Sansar?

Tipping

If you are enjoying a particular artists performance, you can now show your appreciation by leaving a tip!

When tipping is enabled you will see an icon on the left side of your screen above all of the other buttons.

Finding people in Sansar

There are many ways to find other people in Sansar. Whether you are looking for a specific friend or browsing for a popular location, you can use one of the available tools to help you connect with others.

Popular worlds

Overview

By performing certain and activities in Sansar, you can accumulate experience points (usually abbreviated as XP). Experience points contribute to your overall level, which is visible for other people to see in your

Using the Decimate Geometry tool to reduce triangle count on a skinned mesh

The mesh decimation is done algorithmically, so the final results usually are not as nice as they would be if a human artist were to reduce the geometry by hand, but it does allow you to reduce your custom avatar mesh to a triangle count supported by Sansar.

Using the Decimate Geometry tool

To use the Decimate Geometry tool while editing a model in Blender:

This page provides information on how to delete your Sansar account and all information associated with it.

Before you delete your account:

• All your content will be permanently removed. This includes your avatar, inventory items, created experiences, Store items, and any other data associated with your account.

Previewing and setting custom emotes

Custom emotes are set separately for each of your avatar looks. At this time, you may only replace the animations used for existing slash commands, such as /clap, but you may not add additional slash commands.

To replace an emote animation for one of your avatar looks:

Redemption Codes

When you purchase a ticket from a third party website you will be given a redemption code.

To redeem this code and claim your ticket, follow these steps!

1. Head to a third party ticketing site and find the event you wish to purchase a ticket for.

You can interact with certain objects in an experience to trigger actions and effects. Interactive objects are created using Sansar's script API, and act as input controls for those API scripts. Some examples of interactive objects might be: a door that opens when you click it, or a button that plays an audio clip.

Using interactive objects

Exporting custom avatars from Blender

When exporting from Blender, you must use the following (non-default) settings.

Main tab

Using the animation skeleton to create custom animations

We provide a simplified, "lower resolution" animation skeleton that is suitable for creating animations and uploading them to Sansar for your avatar to use. This skeleton is different from our main avatar skeleton and is suitable for creating custom animations but cannot be used to create avatars.

Note: Sansar is able to interpret the animation skeleton for the purposes of importing animations, but any avatars that attempt to use this simplified skeleton are rejected during the import process.

Adding events to your calendar

While browsing events you might want to attend, you can save them to your calendar for easy reference later.

Adding events to your calendar using the Codex

Subscriptions are currently not available (17/09/24)

Is my subscriptions status transferable to another account?

No, your subscription status is non-transferable.

Will my subscription renew automatically?

Yes, your subscription will renew automatically on a monthly basis.

How can I change my subscription plan?

To change your subscription plan, go to the page.

How can I cancel my subscription?

To cancel your subscription, you will need to visit the

Quests are acquired tasks that provide you with rewards for completing their objectives. You can get quests from the quest givers named Agent Animus and Agent Forma at the quest giver terminal in the Sansar Social Hub.

Getting quests

You can receive quests from the quest givers Agent Animus and Agent Forma at the terminal in the Sansar Social Hub. To receive quests:

1. Visit the . You can find it in the , or by entering the in your Home world.

2. In the Sansar Social Hub, find and approach the quest giver terminal, which shows holograms of Agent Animus and Agent Forma.

3. Click one of the quest givers to receive a quest.

4. Review the quest information and rewards in the panel that appears.

5. Click Start the quest to add the quest to your Quests panel and begin tracking its objectives. If you wish do decline the quest, click Maybe later.

Tracking quest objectives

Your Quests panel tracks your current quests and progress on your quest objectives. To open the Quests panel, choose Go > Quests from the main menu.

The Quests panel has two modes: All quests, and quest details.

All quests

This mode displays all of your current quests. You can view a brief description of the quest by moving your mouse over the quest's thumbnail image.

Progress on quest objectives is shown in bars below the thumbnail. Gray bars represent incomplete objectives, and blue bars represent completed objectives.

Click Continue quest to view the quest's objectives and rewards.

Quest details

This mode displays all information, objectives, and rewards for completing the selected quest. You can view a brief description of the quest by clicking the Info tab. To view the quest's rewards, click the Rewards tab. To view your quest objectives, click the Objectives tab.

Progress on quest objectives is represented visually for each objective:

• Objective appears normally - Objective may be completed.

• Objective is grayed out - Objective is locked or has already been completed.

• Lock icon - Objective is locked until other requirements have been met. Usually, all other quest objectives must be completed before unlocking the final objective.

While viewing quest details, you can click the minimize icon in the lower-right of the panel to condense it into a small tracker, with blue and gray bars representing progress on quest objectives. Blue bars represent completed objectives, and gray bars represent incomplete objectives.

Click Quests in progress to return to the list of your current quests.

Have more questions? Join our

The controls in this article are specific to editing a scene with a mouse and keyboard. For additional controls available while visiting an experience, see Keyboard shortcuts (visiting an experience).

To see available controls using other controllers, see Sansar controls.

Edit mode camera controls

Use these controls when editing a scene in desktop mode:

• Arrow keys: Move the camera forward, backward, left, and right.

• W,A,S,D: Move the camera forward, backward, left, and right.

• E,C: Move the camera up and and down.

• I,J,K,L: Rotates the camera, If a object is 'Focused' orbits the object.

• NUMPAD+ and NUMPAD- : Increase and decrease camera speed.

• Hold left click and drag: Move the camera left and right.

• Hold right click and drag: Rotate the camera up, down, left, and right.

• F key : Focus to a selected object, camera rotation will orbit selection.

• ScrollWheel Zooms in and out of a selected or 'focused' object

Action buttons

Use these controls when editing objects placed in a scene:

Selecting objects

• Left Click: Select an object or expose the translate tools to move the object.

• Shift Left/Right Click Clicking one object after another selects multiple objects while shift is held.

• Right Click Opens the objects options menu, Will also select if nothing is selected.

Moving Objects

• Hold CTRL while an object is selected: Changes the translate tool to rotate.

• Hold CTRL + SHIFT while an object is selected: Changes the translate tool to scale.

• CTRL + Z : Undo last action.

Note: If multiple objects are selected movement controls will be located at a center of all selected objects origins.

Other Hotkeys

• CTRL + L key: Move Lock, Stops a object from being moved

• ALT + L : Edit Lock, Disables all options in the properties menu of the object except movement ones.

• CTRL + P : Opens the Properties menu of a selected object.

Have more questions? Join our

If you have Steam installed on your computer, you can use it to install Sansar, create a Sansar account, and easily log into Sansar. As a Steam user, your Steam Wallet functions as your payment method for purchasing Sansar dollars.

Note: Only new Sansar accounts may use your Steam credentials. Existing Sansar accounts cannot be linked to your Steam account.

Installing Sansar with Steam

You can find Sansar in the Steam Store. To install it, click the Play Game button on Sansar's store page.

Note: You may only have Sansar installed from one source at a time. If you previously installed Sansar from Sansar.com, Viveport, or another source and attempt to run Sansar from Steam, you will receive a message asking you to uninstall the non-Steam client.

Creating a Sansar account using your Steam credentials

If you do not yet have a Sansar account, you can create one using your Steam credentials:

1. While Steam is running, launch Sansar.

2. On Sansar's login screen, click Steam.

3. If you have not previously created a Sansar account using your Steam credentials, you are prompted for the following information:

   • Email - This is the email address we will use to verify your account and send you Sansar-related information. It does not need to be the same as your Steam email account.

Once your account is created, you are prompted to verify your email address. When your address is verified, you are immediately provided a default avatar and transported to a curated first Sansar experience.

Logging into Sansar using your Steam credentials

If you have created a Sansar account using your Steam credentials, you can quickly log into Sansar:

1. While Steam is running, launch Sansar.

2. If you previously logged into Sansar using Steam, you are automatically logged in using the same credentials. Otherwise:

   • On the login screen, click Steam to log in using your Steam credentials.

Steam Wallet integration

If you signed up for Sansar using you Steam account, your Steam Wallet is used as your payment method for purchasing Sansar dollars.

Linking your Steam Wallet to your Sansar account

To link your Steam Wallet to your Sansar account:

1. Visit the tab of your Sansar Account page.

2. Under Payment Methods, click Link Steam Wallet.

3. Enter your name and address. If you want to know more about why we collect certain information, see our

4. Click Next to finish linking your Steam Wallet.

Once your Steam Wallet is linked to your Sansar account, you may use it to purchase Sansar dollars.

Have more questions? Join our

Wearing rigged clothing

Rigged clothing is clothing that has been designed in a 3D modeling tool and has been rigged to move with your avatar's skeleton. Each piece of rigged clothing must usually be created to fit over a specific avatar body shape, and cannot be altered once uploaded to Sansar.

Wearing rigged clothing

Once you have purchased or uploaded some clothing, you can add it to your avatar the same way you would add any other piece of clothing or accessory. Some rigged clothing comes standard in your Sansar Lookbook:

1. Open the Lookbook by clicking the Lookbook button in the App Launcher.
2. Select an avatar from the Lookbook and click Customize.

3. Click the Clothing tab to view your available clothing. Marvelous designer clothing is marked with a Marvelous Designer logo; all other clothing is rigged clothing.
4. Click the thumbnails in the clothing tab to add or remove articles of clothing. Note that there is currently a limit on the number of pieces of clothing you can wear at one time.

Compatibility with Marvelous Designer clothing

Sansar also supports Marvelous Designer clothing, which may stretch to fit multiple body types and can be adjusted on your avatar using cloth simulation. Rigged and Marvelous Designer clothing may be worn together, and Marvelous Designer clothing can be worn over rigged clothing. Use the appearance editor to to correct any obvious interpenetration by the rigged mesh clothing.

A note about layering clothing

It is possible for clothing to interpenetrate, or "poke through" other clothing under certain circumstances. Typically, Sansar avoids this issue by hiding any clothing or body parts that are covered by a layer of clothing. However, any layer of clothing that includes transparency prevents the layer underneath from being hidden.

For example, if your avatar wears a shirt with a hole in it, Sansar must also show the avatar's torso behind the shirt and cannot hide the torso as it normally would. During certain animations, this can cause unexpected overlap or interpenetration between the avatar and layered clothing as they move in slightly different ways.

Creator resources

Avatar reference files

A selection of default avatars, skeletons and poses can be found in the article:

Import requirements

See for more information.

Have more questions? Join our

Notes:

• Both Freecam and Cinecam are currently only available to Desktop users and cannot be used in VR.

• They must be enabled by a worlds creator to be available.

• The cameras currently ignore collision.

• The mic is located at the avatar, not the camera's position.

• Other users' mics cannot be heard in freecam mode unless the avatar is within hearing range.

FreeCam Aka F4cam

Press F4 on the keyboard or (start) on Xbox Controller

In freecam mode, Desktop users can detach their camera from their avatar and navigate through the virtual environment without being bound to the movements of the avatar itself. This can be especially handy for taking screenshots, recording videos, or simply exploring areas in a more flexible way.

CineCam Aka F10Cam

Press F10 on the Keyboard or (back) on Xbox Controller

CineCam is similar to Freecam but has smoothed movements to assist in a smoother-looking video or stream when flying around.

Controls

Both modes have the same control scheme.

Keyboard:

• F4: Toggle Free camera mode on or off.

• F10: Toggle Cinematic Cam, a smoothed version of Freecam.

• Arrow keys: Move camera forward, backward, left, and right (free-camera mode).

Controller:

• Back: Cinecam toggle like F10.

• Start: Freecam toggle like F4.

• X Button (X): Drops avatar at cam location.

• Y Button (Y):

Avatar broadcasting FAQ

What is avatar broadcasting?

Avatar broadcasting is a feature that allows event hosts to project their avatars into parallel "clone" instances of the same world in order to circumvent the usual limits on the number of people who are allowed to visit a world simultaneously. This allows you to reach a much larger audience and provide a "front row" experience to all visitors, regardless of the number of attendees.

Why is avatar broadcasting necessary?

For performance reasons, worlds normally have a maximum occupancy of about 50 avatars. Once this limit is reached, new visitors are instead sent to a parallel copy, called an instance, of the same world where they can explore the scene without worrying about degrading performance due to the excessive number of avatars in the scene. However, this arrangement can be problematic during events where the presenter wants to reach more than 35 guests; under default circumstances, any visitors over the instance limit are unable to see or hear the presenters, since they have been sent to a copy of the scene with a different set of visitors.

Avatar broadcasting allows avatars from one "broadcasting" scene to be projected into other instances of the same scene, allowing a much larger audience to see and hear them.

How does avatar broadcasting work?

Avatar broadcasting makes use of two or more instances of a scene: A broadcasting instance, inhabited by the event hosts and VIPs, and one or more clone instances, which may be visited by event guests.

Broadcasting instance

The broadcasting instance is typically where the event host and certain VIPs reside during an event. These broadcasters can be seen and heard in all the clone instances of the world, as though they were actually there. However, this projection goes only one direction: people in the broadcasting instance cannot see people in clone instances or hear their voice chat. Text does carry across all broadcasting and clone instances.

As a broadcaster, this means it may feel as though you are talking to an empty room, but remember that for your audience it most likely appears to be a full house.

Clone instances

Visitors to an avatar broadcasting event are sent to copies, or clones of the the world the broadcaster is in. There can be multiple clones depending on the number of visitors. Visitors in the clone instances can see and chat with each other if they are in the same instance, and they can also see and hear everyone who is in the broadcasting instance. Broadcasters cannot see or hear visitors to the clone instances, but text chat carries across all broadcasting and clone instances. This lets everyone communicate with each other across instances.

Broadcasters who appear in a clone instance look and sound just like everyone else, but are marked with a red Broadcasting tag to set them apart from other visitors. Broadcasters also have an icon above their head that consists of animated concentric circles.

Interactions between broadcasting and clone instances

Visitors to a clone instance cannot affect the environment in the broadcasting instance. However, broadcasters may take certain actions that have an effect on the clone instances. Here are some of the effects you may observe:

• Visitors to a clone instance cannot run into, or collide with broadcasters. Instead, the avatars pass harmlessly through each other. (Remember, broadcasters cannot even see visitors so they may accidentally walk through someone.)

• Visitors can hear broadcasters in voice chat, but the broadcasters cannot hear visitors.

• Visitors may see movable dynamic objects that appear in the broadcasters' scene, but they cannot move them or pick them up. They may see the broadcasters manipulating some objects, while they cannot see others. Broadcasters cannot see or collide with dynamic objects that appear in a clone instance.

One notable exception to these rules is that text chat carries both ways between the broadcasting and clone instances, giving visitors a means to communicate with broadcasters in the broadcasting instance.

How can I visit an event that is using avatar broadcasting?

Currently, the only way to participate in an avatar broadcasting event is to obtain a special URL for the event. While in Sansar, paste this URL into the Chat app and click the Go button that appears.

How can I create a broadcasting instance?

The ability to create a broadcasting instance is coming soon. Currently, the use of avatar broadcasting is limited to special events curated by Sansar.

Have more questions? Join our

This article delves into managing avatar-related inventory items. To learn more about managing scene-related items, check out the action menu section of the Scene creation inventory page.

You can manage your avatar-related inventory items in the avatar editor. To manage your avatar items:

1. Open the avatar editor by clicking on the Style my avatar button on the main menu.

2. Once you are in the lookbook, click the Customize button on any avatar look you have on the list. This opens the avatar editor, where you can access your inventory panel.

3. On the inventory panel, simply right-click on the item that you want to manage. Once clicked, a sub-menu pops up with options.

4. Depending on the operation that you want to conduct, click on List Item, Edit Info, or Delete.

To learn more about these action buttons, see:

Note: Avatar items are currently classified as either male or female. Switch between a female or male avatar in order to access the item that you want to manage. On some item tabs, you have the option to show both male and female inventories at the same time.

Have more questions? Join our

Wearing accessories

You can upload and attach accessory objects to your avatar. Accessories attach to and move with your avatar, and can be used to customize your look. Currently, the types of accessories allowed are: glasses, earrings, necklaces, watches, and rings. Each type of accessory attaches to your avatar and moves in a way that corresponds to that type.

Wearing accessories

1. While in Sansar, click Create > Style my avatar from the main menu.

2. Click the Customize button on any avatar in your lookbook.

3. Click the Accessories tab of the panel at the right side of the screen.

4. Choose an accessory type from the top row of accessory icons. The types of accessories currently available are: glasses, earrings, necklaces, watches, and rings.

5. Choose an accessory and click its thumbnail image once to add it to your avatar. You can click again to remove it.

Creator Resources

Avatar reference files

A selection of default avatars, skeletons and poses can be found in the article: .

Import requirements

See for more information.

Have more questions? Join our

We encourage you to get the word out about Sansar by live streaming your exploration and experiences. If you are new to live streaming, here are a few popular sites for streaming live content:

Launched as a game streaming platform in 2011, Twitch.tv has evolved into the world's largest streaming platform offering a diverse array of streaming content featuring games, music, art, and more.

Twitch.tv official links and documentation

• Twitch.tv

• Online help portal

Launched in 2015, is a product of that specializes in on-demand and live streaming video game content. As with regular YouTube, you can subscribe to specific content creators to keep up with their work. With YouTube Gaming, you can also subscribe to specific games to follow content about your favorite game regardless of the streamer.

YouTube Gaming official links and documentation

Formed in 2017 by the merger of eSports streaming services Hitbox and Azubu, offers live streams of video games, competitive eSports, and even live stock trading.

Have more questions? Join our

What is the benefit of joining the Sansar Discord community?

Discord acts as an extension of our community, allowing you to chat with other Sansar users, make friends, and plan meet-ups in real time. Discord works on the web, a desktop app, and a mobile app, so you can stay connected with the Sansar community wherever you are. Discord keeps you connected with the community, whether you are at home or on the go.

Your Codex is a directory of all the worlds and events you have visited (or created) in Sansar. It allows you to browse and return to those worlds or events from anywhere.

Navigating worlds in the Codex

The Worlds section of the Codex allows you to browse and revisit all the worlds you have previously visited. It also displays listings for your favorite worlds and worlds you and your friends have created. You can revisit any world listed in the Codex by moving your mouse cursor over the listing's thumbnail and clicking the

Adding a credit card to your account

To add a credit card to your account:

• Visit your page on the Sansar website. You may need to provide your Sansar login information to proceed.

This article explores the roles that both the Avatar Name and Avatar ID play in Sansar.

Avatar Name and Avatar ID

In Sansar, your Avatar Name and Avatar ID play an important role in creating your identity and personal branding. When you first log into the Sansar client, you are asked to name your avatar.

Both the Avatar Name and the Avatar ID are tied to your account, your avatar, the items you have listed on the store, and the worlds that you have created. The name and the ID are used to identify you within Sansar. We highly encourage you to choose your Avatar Name and Avatar ID carefully because the Name and ID are finalized once you hit the _Next_** button.**

What is the AABB?

The AABB, or 'Active Area Bounding Box,' is a set size limit for avatars, clothing, accessories, and emotes. All parts of the mesh and skeleton of avatars, clothing, and avatar accessories must be within the bounding boxes to be imported.

Identifying and interacting with avatars

While visiting a scene, you can identify and interact with other visitors. The way in which you perform these actions depends upon whether you are in desktop mode or VR mode.

You can quickly and easily capture images of a scene in Sansar while either visiting or editing the scene. Sansar includes tools to help capture images at the correct aspect ratio for various purposes, such as the , event listings, and world listings.

Taking a photo

To take a photo in Desktop mode:

• Choose

Emotes overview

Avatar emotes are short, predefined animations that your avatar can perform in order to non-verbally express emotions and sentiments. Emotes are triggered by using the Emotes menu or Numbers 1 - 9 on your Keyboard

Keyboard shortcuts (styling your avatar)

Controls for avatar customization

The client keeps a local running log of what you mouse over and click plus a few other basic details to help aid in figuring out what caused a crash or problem, these logs can be really helpful when needing help from support staff,

No personal information is retained within the logs other than some hardware information, worlds visited during that session and your public username. most of what can be found is chatter between the client and sansar services.

locating the log files

By default the Client log files are located in C:\Users\YOURUSERNAME\AppData\Local\LindenLab\SansarClient\log

or by pasteing %localappdata%\LindenLab\SansarClient\log into your file browser.

Portals

Portals are a way to easily travel between worlds with a group of friends. When you open a portal, it appears at your location and stays open for up to two minutes. While the portal is open, other visitors may click it to travel to the world you have provided.

Opening a portal using the Codex

The easiest way to open a portal is to use the :

1. Choose Go > Codex from the main menu to open your Codex.

2. Click one of the tabs under Worlds.

3. Choose a world and view its details by clicking the world's thumbnail image (but not the Visit button).

Opening a portal using Nearby Chat

You can open a portal using the Nearby tab of the Chat panel by using the /portal command:

1. If the Chat panel is not already open, open it by choosing Socialize > Chat from the main menu.

2. On the Nearby tab of the Chat panel, enter the command /portal, followed by a valid world URL.

3. Press Enter or click Send Message to open the portal at your location. The portal stays open for up to two minutes, or until you open another portal.

Note: You may only have one portal open at a time. If you open a second portal, the first one closes immediately.

Getting a world's URL

In order to open a portal, you must first obtain the URL of the world you would like to visit. You can easily get a world's URL from the Codex:

1. Open the Codex by choosing Go > Codex from the main menu.

2. Find your desired world and view its details by clicking its thumbnail (but not the Visit button).

3. Click the Copy this world URL button to copy the world's URL to your clipboard.

Traveling through a portal

To travel through an open portal, you must move close enough to it that the portal's name appears when you hover your mouse or VR pointer over it. Then, click the portal and agree to the prompt in order to follow the portal's creator to the new destination.

Teleporting to a friend

You may teleport directly to one of your friends, as long as that friend is in an experience that you would normally be able to enter.

Note: Experience creators can exercise control over whether new arrivals are allowed to bypass the experience's spawn point. If the creator has disabled this option, you may need to take extra steps to locate your friend after you arrive.

Teleporting to a friend using the People panel

There are two ways to teleport to one of your friends by using the People panel: The Friends tab, or your friend's

To teleport to a friend using your friends list:

1. Choose Socialize > Friends & People from the main menu to open the People panel.

2. Click the Friends tab.

3. Choose a friend who is online and click the Teleport to friend button. If your friend is not in an accessible experience, the button becomes grayed out and cannot be clicked.

To teleport to a friend using their user profile:

1. Choose Socialize > Friends & People from the main menu to open the People panel.

2. Open your friend's , accessible by clicking their name from any tab where they appear in the People panel.

3. Click Teleport to friend to teleport to your friend. If your friend is not in an accessible experience, the button becomes grayed out and cannot be clicked.

Note: Although the Teleport to friend button appears on all profiles, you can only teleport to someone who appears on your Friends list.

Teleporting to a friend using Nearby chat

You can teleport to a friend who has entered text into Nearby chat:

1. If it is not already open, open the Chat panel by choosing Socialize > Chat from the main menu.

2. Click the Nearby tab of the Chat panel.

3. Find your friend's message and move your mouse cursor over their name to reveal additional buttons.

Have more questions? Join our

The Nexus is the central hub of Sansar's many worlds; only the Prime Portal, which is located at the center of The Nexus, provides access to all other discoverable worlds. Since The Nexus serves as a natural crossroads and gathering place, several areas have been set aside for social interaction.

The Prime Portal

Located at the center of The Nexus, the Prime Portal provides access to every discoverable world in Sansar. The Prime Portal is the primary way for you to find new worlds to add to your Codex, which automatically records the worlds you visit and allows you to revisit them later without needing to access the Prime Portal.

Accessing the Prime Portal

To access the Prime Portal, approach it and interact with one of its curved pillars using your mouse cursor or VR controller. This opens the Prime Portal panel, which displays a feed of different worlds sorted by different categories:

• Events - A queue of upcoming events in Sansar, sorted by events starting soonest. For more information about events, see

• Popular - Worlds that receive a high volume of visitors.

• Featured - Worlds currently featured by the Sansar team.

You may also search for a world using the world's name or the creator's name, using the Search worlds field at the top of the panel. Enter part or all of the name, and the matching search results appear automatically.

Visiting a new world

To visit a world displayed in the Prime Portal panel, move your cursor over the world's thumbnail and click the Visit button.

You can view additional information about the world by clicking elsewhere in the thumbnail image. This opens a panel that contains a brief description of the world, as well as statistics for the number of Favorites it has received. If you have visited the world before, you may also use the available buttons to Favorite the world, open a personal to the world, or get the world's direct URL.

When you visit a new world for the first time, it is automatically added to your . For more information about the codex and revisiting previously-visited worlds, see

Core Portals

There are a number of smaller, secondary portals called Core Portals surrounding the Prime Portal. Some of these portals allow access to one of the facets of the Prime Portal, such as the Events listing, but others can lead to venues for special events or other featured worlds. To activate a Core Portal, approach it and interact with it using your mouse cursor or VR controller.

Gathering spaces

The Nexus is a natural gathering place for visitors and explorers in Sansar; everyone must pass through in order to discover and access new worlds. This makes The Nexus a fun place to linger and watch passing avatars, strike up a conversation, or make new friends. Several seating areas have been set aside at the edges of The Nexus for small social gatherings.

To interact with a seat, approach it and interact with it using you mouse cursor or VR controller. Your avatar should then sit on the seat. To leave the seat, simply use the movement controls to move your avatar and they will stand up automatically.

Have more questions? Join our

HTC Vive controls

This article covers the usage of the HTC Vive controllers in Sansar. For information about other control methods, see Sansar controls.

World controls

Use these controls while visiting a world:

• Right trackpad: Rotates the camera.

• Left trackpad: Move forward, back, left, or right.

• Double-press left trackpad: Run forward, backward, left, or right.

Simple controls:

• Right trackpad - Disabled.

• Left trackpad - Move forward, back, left, or right.

• Double-press left trackpad: Run forward, backward, left, or right.

Advanced controls:

• Right trackpad - Rotates the camera.

• Left trackpad - Moves avatar forward, back, left, or right.

• Double-press left trackpad: Run forward, backward, left, or right.

In third person mode:

• Right trackpad - Moves camera around your avatar.

• Left trackpad - Moves avatar forward, back, left, or right.

• Double-press left trackpad: Run forward, backward, left, or right.

Edit mode controls

Use these controls while editing a scene in VR:

• Right trackpad - Rotate the camera left and right.

• Left trackpad - Move the camera forward, back, left, and right.

• Hold Forward/Up (Right trackpad): Bring up the teleport beam.

Have more questions? Join our

Objects

Currently, you may import the following item types. For tips on uploading each file type into Sansar and adding them into your Scene see the other sections contained in: Importing things to sansar

Texture Maps

The following maps are used in sansars predefined shaders, you are able to utilize the color channel of your texture maps. some maps use black and white to keep it simple indicated by 'BW' but you can use the RGB channels listed instead. for more info see:

Oculus Rift controls

This article covers the usage of the Oculus Touch controllers for the Oculus Rift in Sansar. For information about other control methods, see Sansar controls.

Experience controls

Use these controls while visiting an experience:

• Rotate right thumbstick: Rotate the camera up, down, left, and right.

• Rotate left thumbstick: Moves the avatar forward, back, left, or right.

• Press left thumbstick while moving: Run in the current movement direction.

Note: Matching your height with your avatar is now accomplished through the VR app launcher.

Edit mode controls (currently unavailable)

Use these controls while editing a scene in VR:

• Right thumbstick - Rotate the camera up, down, left, and right.

• Left thumbstick - Move the camera forward, back, left, and right.

• Tap A or X button - Select/Deselect currently targeted object.

  Note: Select an object again to deselect it. Alternatively, you can also point and select the skybox in order to deselect all selected objects when in multiselect mode (You must have a visible line of sight to the skybox).

Have more questions? Join our

You can select preferences in the Settings panel to adjust certain Sansar user interface elements to your liking. Once set, these preferences persist between logins.

To access the Settings panel, choose More options > Settings from the main menu.

| Choose More options > Settings from the main menu. |

Available settings

You may toggle the following options in the Settings panel:

Audio output

• Master audio - Adjust all audio sliders at once.

• Voice audio - Adjust the voice chat level when visiting a world.

• World audio - Adjust all music and video sounds that play in a world.

• UI music - Adjust the background music that plays when not visiting a world or editing a scene, such as when viewing the login screen.

• UI sound effects - Adjust the sound effects that play when you interact with Sansar's user interface, such as when you click a button.

• Desktop device - Choose a device for audio output when in Desktop mode.

• VR device - Choose a device for audio output when in VR.

Microphone

• Check mic level - Click the microphone button to activate the monitor, then speak into your microphone to hear your own voice and see the volume level displayed in the monitor. This option is helpful for helping you determine how others hear your voice.

• Microphone level - Set the volume level of your microphone.

• Desktop device - Choose a device for audio input when in Desktop mode.

• VR device

General

• Starting World - Choose where you enter Sansar when you log in. You may choose between The Nexus, your private home space, or your avatar Lookbook.

• Toast notifications - Toggle notifications that appear when events occur in the People and Chat apps.

• Toggle Run - When set to On, you can press Shift to toggle between running and walking without having to hold down the Shift key.

Known issue: If you make changes to notifications, you must restart Sansar in order for the changes to take into effect.

Graphics

• Shadowed Atmospherics - Enables/Disables godrays on Desktop and/or VR. This is disabled for VR by default to improve frame rate.

• Ambient occlusion - Enables/disables ambient lighting in the scene. It is beneficial for users with lower-end PCs to disable this.This is disabled for VR by default to improve frame rate.

• Render quality - Adjust the streaming quality of media streams. There are a few options available to adjust the video quality. Take note that if you change the Media Graphics Mode settings, you must restart Sansar in order for the changes to take into effect.

Note: If you are continuously experiencing crashing issues when entering worlds with media streams, try adjusting the Media Graphics Mode's setting to medium or low. You may have to test it out by trial and error to see what works best for your hardware.

VR

• Remember height - Remembers your height between sessions so you don't need to calibrate every time you log in.

• Show height in meters - Shows height in meters rather than the default feet and inches.

• Snap Turn Angle - Sets the degree of rotation when Snap Turn is enabled. When set at 0, Snap Turn is disabled and rotation will be smooth. To turn Snap Turn on, set the rotation anywhere between 15 to 90 degrees.

Comfort zone

To mitigate the feeling of someone invading your personal space, the comfort zone is an area around your avatar in which other avatars disappear from your sight. Comfort zones work in both desktop and VR mode.

• Friends - Set the distance at which the comfort zone will trigger with friends. By default, this is set at 0 meters (Off). You can turn this on and set your desired comfort zone radius by moving the slider.

• Non-friends- Set the distance at which the comfort zone will trigger with non-friends. By default, this is set at 0 meters (Off). You can turn this on and set your desired comfort zone radius by moving the slider.

Desktop Avatar Controls

• Keyboard Turn - If set to On, your avatar turns left and right when pressing A or D respectively. If set to Off, your avatar sidesteps to the left or right (without turning) instead.

• Face Forward - If set to On, your avatar attempts to face the direction your camera is looking while you are moving. If set to Off, your avatar faces the direction your are moving.

Desktop Camera

• Horizontal offset - Change the default left-right position of the camera behind your avatar. The default value for this setting is 0.65.

Have more questions? Have more questions? Join our

The Avatar editor lets you select from a lineup of currently available avatars. In the instructions below, “click” means either:

• Left-click using the mouse

• Press the “A” button on Oculus Rift controls or game controller.

• Press the "right menu" button on the HTC Vive controls.

Note: The Avatar Editor is not available in VR mode.

To change your avatar

1. On the Main Menu, click on Create > Style my avatar.

2. Click one of the available avatars; you may pan left and right by moving your mouse cursor to the left or right side of the screen.

3. To save changes, click Next. To keep the original appearance of your avatar, click Cancel**.**

Have more questions? Join our

User Profiles

Everyone in Sansar has a user profile, a one page overview of their Sansar identity that includes their , a brief autobiography, a link to their , and links to any worlds they have listed in You can also use someone's profile to add them as a friend, send them a message, or report them for inappropriate behavior or content.

Viewing a profile

In Sansar

To view someone's profile in Sansar:

The controls in this article are for using Sansar with a mouse and keyboard while visiting an experience. For additional controls available while editing a scene, see

To see available controls using other controllers, see

Avatar controls

These controls can be used to move your avatar in VR and desktop mode:

After you have , chosen an and customized your avatar, you may wish to explore some of the worlds created by the Sansar community.

Finding worlds

The allows you to browse through a full list of worlds by their creators. If you know the name of a world you would like to visit (or the name of the world's creator), you can search for them in the Prime Portal as well.

When you find a world you would like to explore, move your mouse cursor over the world's image and click the

Avatar reference files

The files in this article may be used as a reference when creating clothing, avatars, and animations for Sansar.

Update Notes