Sansar Docs
  • 🚀Welcome to Sansar
  • 📚GLOSSARY
  • 🎏Patch Notes
  • 😇Work in Progress
  • ⚠️Creative Commons License
  • Support
    • General Troubleshooting
      • General FAQ
      • The Sansar Cache
      • The Sansar Log
    • Contact Support
  • Sansar Basics
    • Installation And Compatibility
      • Installing Sansar
      • System Requirements
      • Sansar Compatibility FAQ
      • Sansar on Mac
      • Body Tracking Vive
      • Configuring Firewalls
    • Account Management
      • Account Set Up
      • Avatar Name and ID
      • Adding Payment Method
      • Discord FAQ
      • Steam Integration
      • Subscription FAQ
    • Controls
      • Avatar Hand Gestures in VR
      • FreeCam and CineCam
      • Game Controller Buttons
      • HTC VIVE controls
      • Keyboard Shortcuts for Editing a Scene
      • Keyboard Shortcuts for Styling Your Avatar
      • Keyboard Shortcuts for Visiting an Experience
      • Mouselook Mode
      • Oculus Rift Controls
      • Vive Index Controls
    • Settings
      • General Settings
    • VR Settings
      • VR Settings Menu
      • Calibrating Height in VR
  • Exploring in Sansar
    • Navigate and Explore
      • The Codex
      • Instances
      • Interactive objects
      • The Main Menu
      • The Nexus
      • Portals
      • Quests
      • Quick Start: Exploring in Sansar
    • Socialize And Connect
      • Chat Panel
      • Experience Points, Levels, and Titles.
      • Finding People in Sansar
      • Identifying Interacting With Avatars
      • The People panel
      • User profiles
    • Attending events
      • Deploying Unpublished Event to Event World
      • Adding Events to Your Calendar
      • Attending Events in Sansar
      • Avatar Broadcasting FAQ
      • Creating Your Own Events
      • Redemption Codes
      • Tipping
    • Share Content
      • Streaming Sansar
      • Taking a photo
  • Avatar Creation
    • Avatar Basics
      • Avatar 2.0 FAQ
      • Customizing Your Avatar
      • Avatar Emotes
      • The Avatar Editor
    • Dressing The Avatar
      • Fitting Designer Clothing to your Avatar
      • Setting Custom Emotes
      • Wearing Accessories
      • Wearing Rigged Clothing
    • Managing Avatar Items
      • Importing Avatar-Related Items
      • Editing an inventory item's name
      • Editing an inventory item's image
      • Deleting avatar looks from your inventory
      • Importing a custom emote animation
      • Managing your avatar looks inventory items
    • Avatar Resources
      • Avatar Reference Files
      • Blender - Avatar files
      • Blender - Using Decimate Tool
      • Exporting Custom Avatars From Blender
      • Sansar Skeleton Skinning Details
      • Using Animation Skeleton
  • Creating In Sansar
    • Importing Things to Sansar
      • Supported file types
      • AABB Bounding Box and Item Restrictions
      • Importing Audio
      • Importing a Custom Avatar
      • Importing World Items
      • Importing Collision Volumes
      • Importing Accessories
      • Importing Clothing
      • Importing Emotes
      • Importing Hair
      • Importing Custom Scripts
      • Importing a Skybox
      • Troubleshooting Import Errors
    • Shaders and Materials
      • Shaders Information
      • Materials Information
      • VAT Shader Guides
        • VAT Shader Basics
        • VAT Technical Info
      • Displacement Guides
        • Simple Displacement
        • Advanced Displacement
    • Marvelous Designer Info
      • Marvelous Designer Integration
      • Marvelous Designer Creator Resources
      • Marvelous Import and Export
      • MD Limitations
    • Shader Scripting
    • Materials editing and shaders
    • Creator Tools
      • Creating a World
      • Creating Quests
      • Diagnostics Toolbar
      • Importing Items to Sansar
      • My Worlds Panel
    • Managing Worlds
      • Quick start: Creating experiences in Sansar
      • Deleting an experience or scene
      • Deploying a new scene to an existing experience
      • Editing a scene
      • Experience memos
      • Linking A Scene To A World
      • Managing your scenes and worlds
      • Moderation Tools for World Owners
      • Publishing Options for Your Experiences
      • Renaming a scene
      • Saving and Building A Scene
      • Sharing Your Experiences
      • Visiting your own experience
    • Part Of The World Editor
      • Object Stats Toolbar
      • Object Components
      • Parenting objects
      • Scene Item Inventory
      • Scene Objects Panel
      • Collision Volumes
      • Scene Settings
      • System objects
      • Object Motion Types
    • Working With Scripts
      • Working With Scripts
      • Working With Trigger Volume
      • Referencing Scene Components
      • Intro to Scripting in Sansar
      • Using the Script Console
      • Setting Script Parameters
      • Adding Scripts to an Object
      • Configuring Teleport Scripts
      • Simple Script User Guide
    • Working With Audio and Video
      • Working With Audio
      • Creating Media surface
      • Streaming Web Audio
      • Audio Emitter
      • Sansar Audio FAQ
      • Using Media Streams
      • Ambisonic Sounds
      • High Quality Spacial Audio
      • Audio Resource - Room Tones
      • Previewing Audio and Video in a Scene
      • Using Audio Materials
    • Working With Lights
      • Working With Lights
      • Light Types
      • Global Illumination
  • Sansar Store
    • Using the Sansar Store
      • The Sansar Store
      • Buying Items From The Store
      • Redelivering Lost Purchases
    • Buying and Selling Sansar Dollars
      • Gifting Sansar Dollars
      • Buying Sansar Dollars
      • Converting Sansar Dollars
      • Processing US Dollar Credit
    • Selling Your Content
      • Hidden Store Listings
      • Selling Items in Sansar Store
      • Selling Items in an Experience
      • Allowing Resale Of Items
      • Buyers Permissions
  • Guidelines and Moderation
    • Guidelines and Policies
      • Terms of service
      • Sansar's Discord Server Rules
      • Community Standards
      • Content Guidelines
      • World Publishing Guidelines
      • Store Listing Guidelines
      • Store Banner Guidelines
      • Event Guidelines
      • Privacy Policy
      • Sansar Freeware License Agreement
      • Intellectual Property Infringement Notification
      • Cookie Policy
    • Moderation and Reporting
      • Abuse and Griefing
      • Blocking Avatars
      • Muting Avatars
      • Reporting abuse
      • Reporting issues and bugs
      • Security issues
  • Script API Docs
    • General Information
      • External Script Repository's
      • Sansar Script API
      • Script API Updates
      • Restricted API's
    • Example Scripts
      • Example Scripts in Sansar
      • Cannonball
      • Follow The Path
      • Random Movement
      • Reflective Detector
      • Simple Script
      • Sound Randomizer
      • Stats Example
      • Teleport Hotkeys
      • Visitor Tracker
      • Mover Examples
    • Sansar Namespace
      • Namespace
      • Color
      • Mathf
      • Quarterion
      • Vector
      • Vector Extensions
    • Sansar.Script Namespace
      • AddEntryAttribute
      • CancelData
      • ComponentID
      • CoroutineException
      • Default Attributes
      • Editor Visible Attribute
      • Entries Attribute
      • Event Data
      • ICoroutine
      • IEvent Subscription
      • Instance Interface
      • Locked Attribute
      • Log
      • MaxEntriesAttribute
      • Memory
      • MinEntriesAttribute
      • NonReflectiveAttribute
      • ObjectID
      • OperationCompleteEvent
      • RangeAttribute
      • Reflective
      • Script.Base
      • Script Event Data
      • Script Handle
      • ScriptID
      • SessionID
      • Simple Script Event Data
      • ThrottleException
      • Timer
      • Tooltip Attribute
    • MetaData Namespace
      • Assembly MetaData
      • Script MetaData
    • Sansar Script Testing Namespace
      • Assertion Failure Exception
      • Assertions
    • Sansar Utility Namespace
      • GenericEnumerable <T>
      • GenericEnumerable<T>.GetItem
      • JSON Serialization Data
      • JSON Serialization Data 1
      • JSON Serializer
      • JSON Serializer Options
    • Sansar Simulation Namespace
      • Agent Info
      • Animation
      • Audio Component
      • Camera Control Mode
      • Character Tracker
      • Chat
      • Client
      • Cluster
      • Command Action and Data
      • Component Type
      • Control Point Type
      • Held Object
      • HTTP
      • Interaction
      • Light
      • Media Action
      • Mesh Component
      • Modal Dialogue
      • Move Mode and Mover
      • Objective
      • PlayHandle
      • PlaySettings
      • PlayStatus
      • Quest
      • RayCastHit
      • Rigid Body
      • Scene
      • Scene Public
      • Simple Script
      • Sit Event Type
      • Sit Object Data
      • Sound Resource
      • Stream Channel
      • Tutorial Hint
      • UI
      • User Data
Powered by GitBook
On this page
  • Importing avatar-related items
  • Import steps
  • Import requirements
  • Import notes and tips for creators
  • Import requirements
  1. Avatar Creation
  2. Managing Avatar Items

Importing Avatar-Related Items

PreviousManaging Avatar ItemsNextEditing an inventory item's name

Last updated 1 year ago

Importing avatar-related items

In Sansar, you can upload avatars, animation, or attachments such as hair, rigged clothing, Marvelous Designer clothing, and accessories. You can upload items for your own use or sell them in the .

Import steps

The import process is the same across the different avatar item types.

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


  • Select one of your looks and click the Customize button.

  • Click the appropriate item tab for the item you want to import: hairstyles, clothing, accessories, and animation.

    • If the item you are importing is an accessory, you also need to pick a sub-category based on the attachment point of your item: glasses, earrings, necklaces, watches, and rings.

    • It is important to have the right tab open because it will determine where your item will be uploaded to. The category tab is not changeable in the client nor the store.

  • Click Import.

    • If the item you are importing is an animation, you need to go to the Library tab to access the Import button.

  • In the Import panel that appears:

    • Click Browse to choose the appropriate file. (.fbx or .obj or .samd).

    • Click Browse to choose a thumbnail image (.png) to represent your clothing in your Lookbook inventory.

    • Name the item. It is assigned a name based on the object's file name by default.

  • Click Import to import the clothing object to your avatar editor inventory.

Note:



Import requirements

Some requirements and restrictions are imposed on importing items. Please make sure that your items follow these guidelines:

Asset type
File type
Triangle count
Size limit
Thumbnail assets
AABB constraints

Hair

.fbx, .obj (rigged mesh)

.samd (Marvelous Designer)

8,000

N/A, see AABB constraints

Yes, if selling the item in the store

From the center point:

0.9 meters left and right, front and back

2.2 meters above the avatar feet

.05 meters below the avatar feet (to account for shoes).

Clothing

.fbx, .obj (rigged mesh)

.samd (Marvelous Designer)

8,000

N/A, see AABB constraints

Yes, if selling the item in the store

From the center point:

0.9 meters left and right, front and back

2.2 meters above the avatar feet

.05 meters below the avatar feet (to account for shoes).

Accessory

.fbx, .obj (rigged mesh)

5,000

N/A, see AABB constraints

Yes, if selling the item in the store

From the center point:

0.9 meters left and right, front and back

2.2 meters above the avatar feet

.05 meters below the avatar feet (to account for shoes).

Animation

.fbx

N/A

N/A, see AABB constraints

Yes, if selling the item in the store

From the center point:

2 meters to the left, right, front and back of the avatar

4 meters above the avatar feet

.1 meters below the avatar feet

Avatar

.fbx, .obj

40,000

Yes, if selling the item in the store

From the center point:

0.9 meters left and right, front and back

2.2 meters above the avatar feet

.05 meters below the avatar feet (to account for shoes).


Import notes and tips for creators

All items

Avatars

  • Avatar 1.0 - As of July, 2018 it is possible to create custom avatars for Sansar using standardized male and female skeletons. The skeleton released at this time is referred to as avatar 1.0 and will no longer be supported once the new avatar 2.0 system rolls out.

Accessories

  • Be mindful of the available attachment types - The type your accessory is in determines how it moves with your avatar and provides hints as to how that accessory should be handled. Straying from the available attachment types may result in accessories improperly following your avatar as you move around.

  • It is not necessary to specify a collision mesh - Accessories do not currently use the collision mesh.

Import requirements

Hair

  • Naming the hair material - In order to render properly, the name of the hair material must include the word "_hair_". This is a signal that lets Sansar know that this is a hair object so it can render it accordingly. If you forget this step, your hair may not render correctly.

  • Recommended color to use - In order to work best with the color chooser in the avatar editor, the hair's albedo map should use white or light gray. Any other colors will blend with the selected color in the hair color picker and may not appear as intended.


Optionally, click to choose specific shaders and textures for the clothing.

You may now wear the item by clicking it in your inventory, or list it on the by right-clicking the thumbnail and choosing List.

See to know more about deleting, updating, or editing your inventory items.

If you wish to sell your item, see the section of

Name your items well - Make sure to provide a proper name for the item These are reflected on the purchaser's inventory upon buying your accessory. This is a different name from the store name. See for information on naming rules for selling items.

Add an item thumbnail - You are required to add a thumbnail if you intend to sell the item in the Sansar store. The thumbnail asset must follow the same cited in the

Avatar 2.0 - As of August 1, 2019, new male and female skeleton files replaced the older skeletons. These new files are based on the new avatar 2.0 skeleton which can be found on the page. You can also find details on

When creating accessories, model against the reference avatar meshes - Accessories should be modeled relative to the . It is important that the transform handle for your accessory coincides with the transform handle for the reference avatar mesh. Find and download the male and female reference avatar meshes in the article:

Have more questions? Join our

Materials Settings
Sansar Store
Managing your avatar items
editing a listing
Selling items in the Sansar Store.
Item Name
image guidelines
Store listing guidelines.
Avatar reference files
Sansar skeleton and skinning details.
reference avatar meshes
Avatar reference files.
Discord!
Sansar Store
Choose Style My Avatar from the Create menu.
While editing a look, click Import on the appropriate tab to begin the process of importing a clothing object.
Make sure you are on the right item tab before uploading your item.
Modeling a wristwatch relative to the female reference avatar model.