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
  • Creating your own quests
  • Creating a new quest
  • Adding objectives
  • Adding rewards
  • Setting up quest givers and objectives in a world
  • Quest giver
  • Quest objectives
  • Testing your quest
  • Resetting quest progress
  1. Creating In Sansar
  2. Creator Tools

Creating Quests

PreviousCreating a WorldNextDiagnostics Toolbar

Last updated 8 months ago

Creating your own quests

You can create your own in Sansar, allowing others to track and complete a set of objectives you define.

Creating a new quest

To create a new quest:

  1. Choose Create > Create Quests from the main menu to open the Quest Creator panel.

  2. On the Quest Creator panel, click New Quest.

  3. Enter a Quest name, up to 100 characters.

  4. (Optional) Click Browse to select and upload a 400x192 thumbnail image for the quest. You can easily create an image by choosing Socialize > Take a photo from the main menu and choosing For a Quest from the dropdown menu in the screenshot tool.

  5. (Optional) Enter a brief Description (up to 350 characters). This message is displayed to visitors when the quest is offered to them.

  6. (Optional) Enter a brief Summary (up to 250 characters), to be displayed on the main tab of the Quests panel when you move your mouse cursor over the quest's thumbnail.

  7. Enter a brief Completion message (up to 250 characters). This message is displayed to visitors who complete the quest.

  8. Click Save.

After saving the new quest, you may edit the name, image, description, and completion message at any time by clicking the Edit (pencil) button next to the quest's name.

Adding objectives

Immediately after creating a new quest, the quest's Objectives tab appears. You can use this tab to create and edit objectives within your quest:

  • Click new to create a new objective.

  • Enter an Objective Name (up to 200 characters). Try to make a short command such as: "Walk 50 meters"

  • (Optional) Enter a brief Description of the objective (up to 250 characters). This is a good place to add helpful hints or details about the quest.

  • (Optional) Enter a Number of times this objective must be collected. This is the number of times the objective must be collected before it is completed. Set to '0' for objectives that do not need to be collected multiple times.

  • Set an Initial State:

    • Active - The objective is able to be completed.

    • Locked - The objective cannot be completed until it becomes unlocked (active). Usually, unlocking an objective requires the completion of prerequisite objectives.

  • Click Save to save the objective.

  • Continue adding new objectives until you have as many as you want for your request.


Adding rewards

You are not required to add rewards when setting up your quest; it is completely optional. To add a reward, click the Rewards tab of your quest to access the Rewards Menu. In order for an item to be eligible as a quest reward, it must meet the following conditions:

  • It must be an Accessory, Custom Avatar, or item of Clothing.

  • It must be in your avatar inventory. You can see your avatar inventory in the Character Editor. (You can open the Character Editor by choosing Create > Style my avatar from the main menu, then clicking Customize.)

  • You must own the proper license to distribute the item. If you can list the item in the Store, you can use it as a reward. (Note that you are not required to list your item on the Sansar Store.)

There are Mandatory and Choosable rewards. You can create a quest with just one type, both types or neither:

  • Mandatory Rewards ("Assign a reward"): These rewards will be given to the player upon quest completion. You can assign up to three mandatory rewards.

  • Choosable Rewards ("Let the player choose a reward"): The player is presented with two rewards and they must choose which one to receive. When setting up choosable rewards, you must assign two rewards as choosable options. If you only assign one reward, the choosable reward option will not be shown to the player.

With up to three mandatory rewards and one choosable reward (out of a set of two), a quest can give out a maximum of four rewards.

To add a reward to your quest:

  1. Select one of the eligible items shown in the Add reward dropdown in one of the rows in the Rewards tab of the Quest Creator panel. The dropdown displays a list of all the items you own that are eligible.

  2. On the next page, enter the Name and Image you want to use for the reward; by default, these fields are filled by the item's existing name and image. If you remove the image, the reward uses a default icon as its image.

To delete a reward from a quest, select that reward and click the Delete, or click the trash icon for that reward from the Rewards tab of the Quest Creator panel.

Setting up quest givers and objectives in a world

Quest giver

There are multiple ways to offer a quest to a visitor. In this example, we will create a clickable object that offers the quest when clicked:

  • Add an object to the scene to act as your quest giver.

  • Add a new script to the quest giver object by selecting it in the Scene Objects panel and choosing Add > Script

  • In the object's Properties, under the script section (usually "Script 1" for new objects), choose Quest Script Library from the Script dropdown menu.

  • Choose Quest Giver Interaction from the dropdown that appears below Quest Script Library.

  • From the Quest dropdown, select the quest you have created.


Quest objectives

Quest objectives can be completed in various ways. In this example, we will allow visitors to complete an objective by interacting an object in your world. To add an interactive quest objective object to your scene:

  1. Add an object to the scene to act as the quest objective.

  2. Add a new script to the object by selecting it in the Scene Objects panel and choosing Add > Script

  1. In the object's Properties, under the script section (usually "Script 1" for new objects), choose Quest Script Library from the Script dropdown menu.

  2. Select Quest Objective Interaction from the dropdown that appears below Quest Script Library.

  3. From the first Objective dropdown, select the quest you have created.

  4. From the second Objective dropdown, select the objective you would like visitors to complete with this interaction.


Testing your quest

To test a quest you have created:

  • Save and build the scene containing your quest giver and objectives.

  • Visit the scene.

  • Interact with the quest giver object, which should offer you the quest.

  • Accept the quest by clicking Start the quest.

  • Interact with a quest objective object to complete the objective.

  • Upon completing the quest, accept the completion confirmation.



Resetting quest progress

You can reset progress on quests that you own by using the Quest Creator panel:

  • Choose Create > Create Quests to open the Quest Creator panel.

  • Click the name of the quest you would like to reset.

  • On the quest's Objectives tab, click Reset Quest to reset your progression through the quest objectives.


Have more questions? Ask in our

Discord!
quests
You can drag and drop quest objectives to re-order them on the Objectives tab.
Parameters of the Quest Giver Interaction script in the Quest Script Library. Select your quest from the dropdown under the Quest parameter.
Parameters of the Quest Objective Interaction script in the Quest Script Library. Select your quest from the first dropdown under Objective, then, in the second dropdown, select the objective to be completed.
When the quest giver offers you a quest click Start the quest to accept.
When you complete the quest, click Complete Quest to confirm the quest's completion.
Click Reset Quest on the Objectives tab of the Quest Creator panel to reset your current progress on the quest.