> For the complete documentation index, see [llms.txt](https://docs.sansar.com/latest/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sansar.com/latest/patch-notes.md).

# Patch Notes

The latest patch notes are at the top of the page.

### 47.12.0 (11/20/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Four big things arrive in 47.12.0, and you'll run into the first two almost everywhere you go.

**Weather comes to Sansar.** Worlds can now storm. Volumetric clouds roll across the sky on the wind and throw shadows on the ground, rain comes down, lightning strikes and lights up the clouds and the ground, and thunder rolls in after each flash. You hear all of it: wind, thunder, and rain on roofs, metal, water, foliage and glass. Everyone in the world sees the same bolt at the same moment. Creators build it all in the new **Scene Weather** panel, with eight presets that run from Clear to Night storm. You can't fly up into the clouds yet; that's on our list for a future release.

**Attach objects to avatars, and carry your friends.** Scripts can now attach objects to avatar bones, so a world can put a hat on your head, a pack on your back or a prop in your hand, and it stays with you on desktop and in VR. Here's the fun part: attached objects can have seats, and that means avatars can carry other avatars. Pick someone up and walk off with them, or wear something other avatars can sit on. This is only the beginning, with more to come for attachments in future releases.

**Combat is built in.** Scripts now have native combat: hit volumes on objects and avatars, health and other attributes, effects and statuses, and fast projectiles that the world itself moves and hit-tests, streaking by as glowing tracers on desktop and in VR. Who knows what kind of chaos creators are going to build with this. It's going to be great.

**The toon shader is here.** Give surfaces a cartoon look with new toon materials: lighting that falls in cel-shaded bands, rim light and outlines. Use it on one object or style a whole world.

There's a lot more in the list below.

**New:**

* Sansar has a new speech animation system that moves the mouths of residents and Sansar AI characters as they speak. It will keep improving over time and opens up possibilities for future capabilities.
  * Custom avatars with face weights keep lip sync with no changes.
* Avatars with face weights now blink and move their eyes naturally, even when they aren't speaking.
* Choose how many nearby faces animate with **Animated faces** in Graphics settings. **Auto** follows your graphics quality.
* Watch volumetric clouds roll across the sky with wind and ground shadows, and storms with lightning strikes, in-cloud flashes and crawling bolts that light up the clouds and the ground. Every visitor sees the same bolts at the same moment.
  * Weather is chosen per scene. Worlds that don't use it look and perform as before.
  * You can't fly into the clouds yet. That's on our list for the future.
* Hear the weather: rain on roofs, metal, water, foliage and glass, wind, and thunder that rolls in after each lightning flash. Set its level with the new **Weather** volume in Audio settings, and turn on **Soften loud sounds** to lower thunder and round off sharp sounds.
* Turn clouds off for yourself with **Clouds** under Settings → Graphics → Environment. The world's sky, rain and wetness stay, and other visitors are unaffected.
* Author weather in edit mode with **Tools → Scene Weather**: sky, clouds, lightning, rain, wetness, weather volumes and sound in one panel, with undo and eight presets (Clear, Fair, Overcast, Storm, Night storm, Dawn, Twilight and Clear midnight). Weather is saved with the scene and published with the world.
* Light scenes with the new **Atmosphere** sky: a computed sky with sun, moon, stars, twilight and night that follows the scene's time of day. Skybox remains the default.
* Set your VR brightness separately from desktop. In VR, the brightness row reads **Adjust brightness (VR)**.
* Make the VR Settings panel larger with **Settings panel size (VR only)**, from 100% to 200%.
* Clear a world's Nearby chat for everyone as its owner, with the new **Chat Clear** button in the Moderation panel on desktop and in VR, or by typing `%%chat-clear`.
  * Chat Clear applies to the world instance you are in.
* Give surfaces a cartoon look with toon materials: **Toon: Standard**, **Toon: Emissive** and **Toon: Standard + Emissive**, with banded lighting, rim light and outlines.
* Mask dirt in grass with the blue channel of the **Grass Density Map**: at 0 the grass shows the surface's own **Grass Albedo Map** and **Grass Normal Map**, at 1 it shows dirt as before, and values in between blend the two.
* Reduce the triangle count of static meshes with the new **Decimation** property in edit mode, and generate Mesh collision from a mesh's render geometry with its own **Decimation** setting.
  * Not available for meshes with blend shapes.
* Show both eyes side by side, or either eye, in the desktop window while in VR with the `-vrMirrorMode` launch option (`LeftEye`, `BothEyes` or `RightEye`). Headsets still show the left eye by default.
* Keep private notes on each AI NPC in the NPC creator, up to 2,000 characters. Notes never change how the NPC talks.
* Attach objects to avatar bones from scripts with new `ObjectPrivate.AttachTo` overloads and `AvatarBone`, and inspect them with `AgentPrivate.HasBone`, `AgentPrivate.GetBoneTransform`, `AgentPrivate.GetAttachedObjects` and `AttachmentInfo.Bone`. Attached objects follow the avatar on desktop and in VR, and seats on attached objects can carry seated avatars.
  * Head attachments are hidden from the wearer's own first-person and VR view. Attached seats can be sat on but not grabbed, and don't collide. Avatars without the requested bone refuse the attachment; check with `HasBone` first.
* Build combat with `ScenePrivate.Combat`: create a `CombatArena`, register objects and avatars as targets with hit volumes, cast rays and spheres, test overlaps, define attributes, effects and statuses, and launch volleys with `CombatArena.LaunchProjectiles`. Projectiles are moved and hit-tested by the world, and drawn as glowing tracers on desktop and in VR in styles set with `CombatArena.DefineProjectileStyle`.
  * An arena belongs to the script that created it and is removed when that script stops.
* Script the sky with `ScenePrivate.SetClouds`, `ScenePrivate.ClearClouds` and `ScenePrivate.GetCloudsOverride`, and lightning with `ScenePrivate.SetLightning`, `ScenePrivate.ClearLightning`, `ScenePrivate.GetLightningOverride` and `ScenePrivate.AddLightningEvents`. Clearing an override returns to the scene's saved weather.
  * Each instance of a world runs its own weather.
  * A `LightningEventType.Strike` event's `Position` sets where the bolt starts in the clouds, so it can reach the ground up to 300 m from that point.
* Script weather sound with `ScenePrivate.SetWeatherSound`, `ScenePrivate.ClearWeatherSound` and `ScenePrivate.GetWeatherSoundOverride`.
* Choose how a megaphone is announced with `ScenePrivate.SetMegaphone` and `MegaphoneFeedback`: a chat line (`Chat`), a notification for other players instead (`Toast`), or nothing (`None`).
* Give desktop players a scene-camera view with a free cursor using `Client.SetActiveCamera` with `ScriptCameraOptions`, optionally following the player along chosen world axes with dead zones, smoothing and bounds. Players can still walk, run and jump in `AgentControlOnly` mode. Check whether a player is on desktop or in VR with `Client.InputMode` and `Client.SubscribeToInputModeChanged`.
* Show a Back button on scripted menus with new `UIMenu.Show` and `UIMenu.ShowStyled` overloads that take `showBackButton`. Back reports `SelectedIndex` -1 and `SelectedItem` "back", and the menu stays open. Passive menus never show Back.
* Keep an attached object at the visible end of a stretch-to-hit beam with `AttachOptions.FollowParentStretchEnd`, turn it to face the hit surface with `AttachOptions.OrientToHitNormal`, and hide it when nothing is hit with `AttachOptions.HideWhenNoHit`.
* Add up to 64 entries to script list parameters, up from 20.
  * Scripts already in a scene keep the 20-entry limit until you update them.
* Add solid or trigger collision volumes, and sit points, to existing objects through the Sansar Client API, without reimporting the model.
  * Each body takes one sit point.
* Create scene cameras and edit their field of view, set Atmosphere sky properties, and apply weather presets and weather volumes through the Sansar Client API.
* Replace a placed model through the Sansar Client API after a material preset renamed one of its parts, or when the replacement's mesh was renamed. Map old mesh names to new ones when they can't be matched automatically.
* Read object rotations in nearby-object listings, clear Nearby chat with a moderation command, and read frame-time statistics through the Sansar Client API.

**Changes:**

* Custom grass density maps now control dirt with their blue channel. Maps whose blue channel is 0, such as maps painted only in red and green, no longer show dirt; paint blue at full value to keep the previous look. This applies as soon as visitors update, without rebuilding the world. The default density map looks the same as before.
* World scripts can attach objects to any avatar in their world without asking the player first. Objects the script created are removed when the player leaves.
* Script resource lists now keep empty entries in place: an empty slot arrives as `null` at the same index as in the editor. Scripts that stop at the first `null` may now stop early.
* `Mover` commands on an object a player is holding now fail with "object is held", and grabbing an object cancels its queued moves. New commands work again after release.
* Dynamic objects whose collision is made of scaled parts now collide at their visible size once their collision is converted to hulls. If you compensated for the old size, check these objects after rebuilding.
* When recompiling scripts that pass bare `default` as the callback to `UIMenu.Show` or `UIMenu.ShowStyled`, use `handler: default` or `null` instead to avoid an ambiguous call.
* Turn every volume slider up without distortion: a limiter now keeps Sansar's combined output from clipping.
* Ray-Traced Lighting now shows reflections through and of glass panes, refracting glass, smooth transparent surfaces and grass in reflections, handles many lights and distant avatars more efficiently, and turns on without a hitch. **Ambient Occlusion** is disabled while it is on.
* In VR, **Ray-Traced Lighting** and **Frame Generation** show Off and can't be changed. Your desktop choices return when you leave VR.
* Sansar switches to desktop mode when your headset's system menu stays open for a few seconds, and returns to VR when you come back.
* VR renders at your chosen resolution on graphics cards with less video memory, and DLSS works on high-resolution headsets.
* Script hint text in VR now stays in view when you turn your head.
* See other players' held objects, VR hands and avatars carried on held seats move smoothly instead of in steps. Avatars sitting on a seat someone is carrying stay locked to it.
* When aiming a held object at your cursor on desktop, your hand now raises to the aim faster and no longer snaps to your hip and back.
* Settings are reorganized into **Graphics** and **Advanced/VR** tabs. VR options sit under a VR heading on Advanced/VR, and **Clouds** under a new Environment section on Graphics.
* Settings now tells you when VSync is limiting your frame rate below **Max foreground FPS**.
* Follow shader preparation on the startup screen with a percentage and progress bar, with no black window between startup and login.
* Frames take less time to prepare, for smoother frame rates.
* All Sansar program files are now digitally signed, so Sansar can run on PCs that only allow signed software.
* Hide and lock settings changed since your last save now survive editor resynchronization; only undo history resets.
* An open properties panel now updates when a script's list parameters are changed elsewhere, such as through the Sansar Client API.
* The AI NPC creator now shows a lasting warning when Test Conversation fails, and won't save a new or changed agent link that is known not to work.
* Sansar Client API scene saves and builds now say why an upload failed, and removing an object without children no longer requires including children.

**Bugs fixed:**

* Crashes when opening a script's properties in edit mode.
* Crashes when creating a world right after a "World already exists" error.
* Crashes when selecting an object that had just been removed in edit mode.
* Crashes when leaving edit mode while a web media surface was loading, and when a media surface appeared after web media had failed to start.
* Crashes when leaving a view while typing in a text field, such as Lookbook search, AI NPC fields or player search.
* Crashes when entering edit mode while in VR, and Sansar not closing cleanly when quit while in VR.
* Crashes while emote reaction thumbnails were loading.
* Crashes when quitting with unsaved Lookbook changes while an item transform tool was active, and when pressing a key as Sansar closed after a graphics error.
* Sansar hanging on quit after many inventory updates.
* Worlds freezing or crashing while loading their scripts.
* Passing a held object from one VR hand to the other dropping it.
* Errors when releasing a held object in VR without turning your hand.
* Sansar staying in desktop mode after SteamVR's first headset report, and a delay at startup when SteamVR is installed without a headset connected.
* Scripted moving objects briefly turning dark while their outlines stayed visible.
* Lookbook item transform controls being cut off at high display scaling.
* Pressing Ctrl+Z while a material editor Apply was still preparing undoing only part of it, and a canceled or applied material preview's texture reappearing.
* Very small rotation edits, under 0.01°, being ignored in edit mode.
* `List<ThumbnailedClusterResource>` script parameters receiving the wrong type.
* Adding a trigger volume through the Sansar Client API to an object that already had a collider crashing Sansar.
* Sansar Client API light edits failing with a revision conflict, and lights offering component removal they don't support.
* Sansar Client API view captures stalling the live view for up to a second.
* Sansar Client API nearby-object listings reporting Keyframed objects with **Can Grab** as not grabbable.

</details>

### 47.11.0 (11/08/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Use scripted world menus in VR and navigate a clearer Lookbook. Build worlds with rain, changing atmosphere, wet surfaces, custom HUDs and synchronized visual effects, with more world-building controls available to external applications through the Sansar Client API.

**New:**

* Use scripted world menus in VR: point and pull the trigger to choose, and hold the controller stick to scroll long lists.
* Show shared or player-specific text, progress bars and countdowns on desktop and in VR with `ScenePrivate.Hud` and `Client.UI.Hud`.
  * These displays do not take input. Images and interactive controls are not supported.
* Add rain with wind and smooth fades, and define up to 32 dry shelter boxes with `ScenePrivate.SetPrecipitation` and `ScenePrivate.SetPrecipitationExclusions`.
  * Rain and shelter settings must be restored by startup scripts.
* Make opaque surfaces and avatars wet and dry inside up to eight scripted regions with `ScenePrivate.SetSurfaceWetness` and `ScenePrivate.SetSurfaceWetnessRegions`; rain shelters stay dry.
  * Wetness is opt-in. Animated ripples are not available.
* Blend fog, exposure and bloom for everyone or for one player with `ScenePrivate.SetAtmosphere`, `AgentPrivate.SetAtmosphere` and their clearing methods. Clearing an override blends back to the underlying scene settings.
* Start and stop synchronized vertex animation texture (VAT) and flipbook effects with `RenderMaterial.PlayAnimation` and `RenderMaterial.StopAnimation`, including effects already in progress when a player joins.
* Scroll, offset, scale and mirror supported material textures from scripts with `MaterialProperties.UvMode`, `MaterialProperties.ScrollSpeed`, `MaterialProperties.UvOffset` and `MaterialProperties.UvScale`; check support with `RenderMaterial.SupportsUvTransform`.
* Animate the proportions of scriptable meshes, including billboard and lollipop materials, with `MeshComponent.SetRenderScale`.
  * This changes appearance only; collision, child placement and positions read by scripts do not change.
* Stretch visual beams to the nearest eligible collision hit with `MeshComponent.SetRenderStretchToHit`, with options for length limits, ignored objects and what happens when nothing is hit.
  * Supports up to 32 enabled, unrigged scriptable meshes per client. For camera-facing materials, only lollipops that inherit orientation, stretch along local Z and have an origin on that axis are supported.
* Attach runtime objects to other objects, including held parents, with `ObjectPrivate.AttachTo`, `ObjectPrivate.Detach` and `ObjectPrivate.GetAttachment`, with optional timed transitions.
  * Attached children cannot collide or be grabbed. Children must have a single body or be script-movable objects without colliders; held children and avatar-bone attachments are not supported.
* Let the desktop third-person camera turn toward the player's heading automatically from scripts with `Client.SetCameraAutoCenter`. It starts after one second without camera input and leaves pitch under manual control.
  * First person and VR ignore this mode. Leaving a seat, switching directly to another seat or leaving the world turns it off; sideways and backward movement while standing pause recentering.
* Test VR views and controls without a headset using simulated VR in the Windows client. External applications, automation tools and AI-controlled players can drive its head, hands and controls through the Sansar Client API.
  * Sansar Client API access requires **Allow local API access** and is local to your Windows account and sign-in session.
  * Simulated VR is off by default; launch with `-simulateVR true` to enable it. API entry, exit, pose and input controls apply only to the simulator; reading VR state also works with a real headset.
* Import bone-animated and rigged GLB props through the Sansar Client API, inspect their clips and play them with the in-world `AnimationComponent` API.
  * Supports one shared skin, up to 255 joints and named bone clips using LINEAR or STEP interpolation. Apply bone, armature and ancestor scale before export; moving unskinned nodes, morph animation, CUBICSPLINE channels, extra joint/weight sets and separate collision files are unsupported.
* Bake VAT assets with the bundled Blender tools and import signed OpenEXR maps through the Sansar Client API for VAT and displacement materials.
  * OpenEXR support is limited to VAT and displacement maps; other texture processing types still require PNG. Deep and multipart EXR files are unsupported.
* Create spawn points and audio components through the Sansar Client API, and check for a missing spawn point before building a scene.
  * Audio uses sounds from the signed-in account's inventory, subject to ownership and content permissions. Removing audio components and moving or removing embedded spawn components are unsupported; a spawn point can be moved or removed through its owning object.
* Set static-mesh scriptability, initial visibility, draw distances and scale, and configure atmosphere, time of day, skyboxes and color grading textures through the Sansar Client API.
  * Skybox and color grading textures must come from inventory the account owns, with the appropriate texture type.
* Bind `ClusterResource` and `TextureResource` script inputs, and lists of supported values and resources, through the Sansar Client API with inventory ownership and content permission checks.
  * List writes replace the whole list and follow the script parameter's limits, up to 20 entries. Resource lists support `SoundResource`, `ClusterResource` and `TextureResource`.
* Replace the visual source of Dynamic and Keyframed objects through the Sansar Client API while keeping their scripts, settings, transforms and identities.
  * Collision must match unless the application explicitly chooses to keep the existing collider; the replacement's appearance may then differ from its collision. Imports with joints, multiple shapes per entity or imported meshless entities remain unsupported.
* Find scenes more quickly through the Sansar Client API: list names first, then resolve only the selected scene's saved source.

**Changes:**

* Navigate Lookbook with larger category tabs, a direct Accessories shortcut, item-source controls beside the items, and clearer preview labels and camera hints. **BROWSE STORE** opens all categories; **SHOP THIS CATEGORY** opens the current category beside your avatar.
* Hold Shift while dragging a ring with the desktop editor's Rotate tool to rotate in 15-degree steps from the starting pose; release Shift for smooth rotation.
* Choose the highlighted or first matching result with Enter in searchable editor property pickers, or press Escape to close the picker and keep the current value. With no matches, Enter leaves the picker open.
* Undo and redo resource-picker choices, skybox and color grading choices, and **Add > Script** in edit mode.
* Update Sansar and reopen edit sessions started before this release before editing materials. Material editing requires matching, updated clients and edit sessions.
* Open scenes with complex hidden static collision shapes sooner: their display meshes are prepared when shown instead of on every scene open.
  * Showing **Physics shapes** can still pause while a complex shape's display is prepared.
* Bake lighting even when available graphics memory is insufficient: light bakes use the CPU. A stalled GPU bake now reports failure, and quitting after it no longer waits indefinitely for that bake.
* When objects approach the world boundary, scene objects now return to their original placement and objects created by scripts are deleted; avatars return to the nearest spawn point.
* Eye adaptation now follows the underexposure and overexposure correction rates saved with the scene.
  * A saved rate of zero stops adaptation in that direction except on camera cuts.
* Static meshes now appear according to their saved minimum draw distance after the world is rebuilt.
* Read the last held pose for `ControlPointType.DesktopGrab` after a desktop grab ends with `AgentPrivate.GetControlPointPosition` and `AgentPrivate.GetControlPointOrientation`; `AgentPrivate.GetControlPointEnabled` continues to indicate whether that control point is enabled.

**Bugs fixed:**

* Crashes in worlds containing interactive screens on objects that are not static.
* Crashes in Lookbook.
* Worlds crashing while their scripts load.
* Freezes while opening edit mode on accounts with many material presets.
* Crashes when switching a material's shader, combining objects or closing a scene while material loads are pending.
* Crashes when item source or permission information fails to load during material-preset permission changes or listing creation.
* Crashes when entering VR with a scene open in edit mode.
* Crashes after quitting, including after copying materials, and shutdown hangs while a network address lookup is pending.
* Startup hangs when another application launches Sansar with an input pipe left open.
  * Launch tools that send startup configuration through standard input must now opt in with `-configPipe true`.
* Ray-Traced Lighting being enabled below High graphics quality.
  * It remains limited to supported DirectX 12 hardware at High quality on desktop and is unavailable in VR. Returning to High restores the saved setting.
* Fine reflective details on metallic surfaces being blurred by Ray-Traced Lighting.
* Thin dark lines along the horizon at the sides of the VR view.
* Returning from VR in first person after previously choosing third person on desktop.
* Scripted menus disappearing after switching between desktop and VR, long titles hiding their choices, and passive menus blocking clicks through to the world.
* VR buttons activating when a press was released away from the panel.
* Scoreboard, hint and progress-bar updates interrupting desktop mouse-look or blocking world clicks.
* Quest error dialogs and the VR login Terms of Service dialog appearing without buttons.
* Settings controls, including Apply and Cancel, falling off the bottom of the window at 150% display scale.
* Misplaced or invalid panels when starting minimized or switching workspaces while minimized.
* Escape opening the main menu instead of dismissing an editor context menu.
* Shift, Ctrl or Alt appearing released when one side of the keyboard was released while the other remained held.
* Lookbook Randomize removing clothing when a complete compatible outfit was unavailable.
* Canceling an unchanged Lookbook Transform discarding redo history or adding an empty undo step.
* The first tutorial slide appearing blank.
* Dismissing a failed world-visit message closing edit mode and discarding unsaved changes, or leaving Lookbook stuck trying to depart.
* Repeated close requests showing overlapping warnings while the Item Material Editor was open.
* Searchable editor pickers showing empty lists, failing to apply None or Generic to mixed selections, or crashing during rapid selection and confirmation.
* Quest, objective and quest-character property labels showing incorrect names.
* Undo and redo losing script parameter edits after undoing a script attachment, including during collaborative editing.
* Pending material edits overriding a later Undo, older copy operations replacing newer clipboard contents, and Cancel failing to restore a material preview correctly.
* Scenes appearing saved even though newer edits were made while a Save was finishing, and collaborators seeing an unsaved scene as saved after joining or after skybox and color grading changes.
* Collaborators receiving different skybox or color grading selections when downloads finished in a different order, and refused saves leaving the editor stuck in Saving.
  * Selected textures and their permissions must finish loading before Save can succeed. Texture loading has a two-minute limit; use Save to retry a failed load, then save again after it succeeds, or replace or reset the selection.
* Builds and cubemap exports capturing partially applied edits while editing continued.
* Authored texture scrolling, flipbooks and displacement animations starting at a different phase for late joiners.
* Scripted material and `Mover` transitions falling behind after a late join or a frame hitch, and repeated relative `Mover` rotations accumulating errors.
* Seat scripts retaining a phantom occupant when a player sat directly on another seat without standing; the old seat now receives `SitEventType.End`.
  * A script listening to both seats can still receive the new seat's start event before the old seat's end event.
* Held objects visibly jumping for other players when released on desktop.
* Gaussian splats disappearing exactly at their minimum or maximum draw distance.
* Imported glTF midtones appearing too dark, transparent base colors being applied twice, and emissive colors or strength importing incorrectly.
  * Reimport assets to receive these corrections; existing imports keep their saved appearance. Imported emissive intensity is capped at 32, with a notice when capped.
* Rendering resources accumulating during repeated window resizes, and graphics memory growing each time scripted rain was switched on or off.
* Sansar Client API camera aiming missing its target in first or third person; aiming still respects the camera's pitch limits.
* Human edits and Sansar Client API edits to different objects leaving the editor stuck requiring resynchronization. Recovery also waits for an active drag or tool to finish.
  * Recovery preserves confirmed unsaved scene contents and the camera, but resets undo history and local hide and lock state. If final edits cannot be confirmed, API writes stay paused and a warning advises preserving the affected values before reopening.
* Sansar Client API material application reporting failure after the edit had applied, and failed material-save jobs remaining unfinished.
  * Materials without their original texture imports cannot be saved as presets; failures now explain which maps are unavailable.
* Long Sansar Client API building sessions refusing further work after completed snapshots had filled their request history.
* Sansar Client API template copies failing on saved scenes, older group formats, large templates or templates that were still loading.
* The first ground-fog density change through the Sansar Client API being refused after opening a scene.
* Sansar Client API close requests that timed out before closing started preventing later attempts to leave the editor.
* Sansar Client API tools reporting a busy or not-yet-ready client as stopped or as a bad request, and reporting a temporary account-connection failure as a generic authentication failure.

</details>

### 47.10.0 (11/01/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Dictate text in the Windows client, switch between saved accounts, and choose where your next visit begins. Bring your worlds through day and night with changing lighting, then shape the action with scripted flight and camera effects. Connect external applications, automation tools and AI-controlled players to more of Sansar through the general-purpose Sansar Client API.

**Make your next visit your own:**

* Dictate text in the Windows client: hold **Ctrl + backtick** on desktop, toggle the chat microphone button, or use **Hold to dictate** on the VR keyboard.
  * Control it with **Enable voice dictation**. Audio stays on your device, and your voice is not broadcast while dictating.
  * Password dictation inserts lowercase words with punctuation removed and single spaces between words.
* Keep up to eight accounts ready with **Remember me**, then sign in with one click from the desktop login screen.
  * Use **Switch account** to keep an account saved; **Log out** removes it. Saving a ninth account replaces the oldest saved account.
* Start in a world you choose after login or leaving Lookbook: select **Custom world** under Settings → General → Starting World and paste a world link.
  * Missing or inaccessible worlds fall back to Home. First-time setup and explicit launch destinations still take precedence.
* Check what you entered in a password field: hold the eye button to reveal the text, then release to hide it. Mouse and VR controller input are supported.
* Reach the login screen sooner, with login artwork shown during startup and fewer flashes from brief shader compilation. You can also start Sansar and log in without waiting for Windows crash reports: they now upload in the background on the next start.

**Watch your worlds change with the light:**

* Take your worlds through day/night cycles with changing sunlight and sky lighting. Read and control the time and mode from scripts with `ScenePrivate.GetTimeOfDay`, `ScenePrivate.SetTimeOfDay`, `ScenePrivate.GetTimeOfDayMode` and `ScenePrivate.SetTimeOfDayMode`.
  * In dark scenes using time-of-day lighting, colors gradually shift toward blue-gray.
  * For changing bounced sunlight, rebuild the scene with **Fixed time** or **Day-night cycle** enabled. Scenes built with **Off** retain their baked sunlight when scripts enable time-of-day lighting.
* Watch light bounce from changing lights and emissive objects with **Real-time probe lighting**, with separate desktop and VR controls.
* Add ray-traced lighting, shadows and reflections with **Ray-Traced Lighting** in advanced graphics settings.
  * Off by default; requires High graphics quality and supported DirectX 12 ray-tracing hardware. It is unavailable in VR.
* Set the mood world-wide or per player by overriding color grading with `ScenePrivate.SetColorLut` and `AgentPrivate.SetColorLut`.
  * Overrides apply to the current world instance; post-processing volumes with their own color LUT still take precedence.
* Using Bindless Rendering now requires Shader Model 6.6 support.

**Flight, camera effects and finer creator control:**

* Choose whether flight is allowed world-wide or per player with `ScenePrivate.SetAllowFlight`, `AgentPrivate.SetAllowFlight` and their override-clearing methods.
  * Manage flight in worlds you own, or as staff, with `%%flight-on`, `%%flight-off`, `%%flight-clear` and their `-all` variants.
* Add rumble, jitter, sway and impacts with scripted camera effects using `Client.ShakeCamera` and `ScenePrivate.ShakeCameraAtPosition`.
  * Choose Off, Reduced or Full under Settings → Social → Camera comfort → Camera shake. VR uses smaller position-only movement with no rotation.
* Tune timed movement and rotation with different smoothing using new `Mover.AddMove` and `Mover.AddMoveOffset` overloads, while keeping one duration and completion event.
  * When recompiling scripts that pass bare `default` as the fifth argument to these methods, use `handler: default`, `null` or an explicitly typed callback instead to avoid an ambiguous call.
* Shape fur and grass from scripts: adjust colors, length, density and thickness with `RenderMaterial` and `MaterialProperties`.
* Add your own **Grass Dirt Map** to grass materials.
* Bring wind animation to your Velvet Fur materials.
* Find what you need in editor property dropdowns by searching scripts, script classes, sounds, objects, animations and emotes, skyboxes and audio materials.
* Read the texture-size visualization with help from a new color legend in the diagnostics toolbox.
* The `/scale` chat command is now reserved for staff. World scripts can still change avatar scale with `AgentPrivate.SetScaleFactor` and `AgentPrivate.SetScaleFactorAnimated`.

**Connect through the Sansar Client API:** The Sansar Client API provides general-purpose functionality for external applications, automation tools and AI-controlled players.

* Launch Sansar, log in or out, and switch accounts through logout and login.
  * Access is local to your Windows account and sign-in session, with **Allow local API access** enabled. Login and logout work from Home or a world; logout is unavailable in the editor or during first-avatar selection.
* Choose a starter look and complete first-time avatar setup through the Sansar Client API, then continue to Home.
* List scene templates and create a world from a built template through the Sansar Client API, with an option to open the copied scene in the editor.
  * Use built library templates or your own built scenes; new worlds default to private and unlisted. If world creation fails after the scene is copied, the copy is kept.
* Capture your current Avatar Editor view or body and face presets through the Sansar Client API without changing the live view or saving the look.

**Your avatar, from Lookbook to VR:**

* Return to saved looks in Lookbook: fixed some looks failing to open with "problem downloading the avatar".
* Jump and land as a small avatar: fixed the sliding after running jumps in worlds with **Scale Movement With Avatar** enabled.
* Hold grab while seated in VR without your hands pushing the seat or vehicle you're sitting in.
  * Other physical parts of a seat and objects you hold can still push it.
* Your VR hand reach now matches your avatar's height.

**Stay in touch and see where you're going:**

* Hear a notification for unread direct messages, with an on/off option in Audio settings.
* Hear a positional whoosh with avatar arrival and departure effects in worlds, controlled by Scene and Master volume.
* World-loading text is crisper in desktop mode.
* See destination previews more clearly: portal glow now dims during the preview.
* Keep up with friends through more reliable location updates.

**Fixes:**

* Logging out during world travel now returns you to the login screen.
* Fixed empty Welcome and Verify Email boxes appearing while the login screens were busy.
* Keep your script debug console output after VR switches or interface theme reloads, and reopen the console when you return to desktop.
* Fixed hangs or crashes when quitting Sansar, including a hidden process that prevented it from reopening.
* After a graphics-device reset, Sansar now shows an error and closes instead of freezing.
  * Unsaved editor changes are discarded when the graphics device stops responding.
* Fixed the Parallels virtual machine shutting down when you entered a world on Apple Silicon Macs.
* Fixed a crash when opening a scene in edit mode.
* Fixed instability in worlds with moving or resizing lights.
* Fixed corrupted Gaussian splat details while loading.
* Fixed post-processing volumes failing to activate reliably when your camera entered them.
* Fixed positional sounds changing their wall muffling when another sound started, including loops played with `PlaySoundAtPosition`.
* The event delete dialog in My Worlds now includes the missing explanations: it names the event and scene and tells you whether the scene will be kept.
* Fixed bottom-anchored windows overlapping reserved interface areas.
* Fixed imports appearing to succeed when asset files could not be saved locally.
* Valid nearby scripted interactions through the Sansar Client API are no longer refused on objects with offset pivots. Normal reach, line-of-sight and permission checks still apply.
* Access inventory metadata and permission operations, and attach scenes to worlds, through the Sansar Client API on new accounts; these operations were previously unavailable.
* Fixed cropped, black-padded or washed-out avatar previews and camera-override screenshots requested through the Sansar Client API at sizes larger than the desktop window.
  * Offscreen rendering is capped at 8,294,400 pixels (4K UHD), or the window's pixel count if larger; each capture operation's size limits still apply.

</details>

### 47.9.0 (10/18/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Find Gaussian splats in their own Store category, and create editable scenes through the Sansar Client API.

**New:**

* Find Gaussian splats in the Store's new Splats category. Existing splat listings have moved there, and new splat listings go there automatically.
* Inspect Gaussian splat statistics in the editor and in worlds through the Sansar Client API.
* Create editable scenes through the Client API, from scratch or from saved templates the signed-in account has permission to use.
* Pick up, carry, drop and throw physical objects through the Client API in desktop mode, following normal reach and interaction rules.
* Receive nearby players' voice audio separately for each speaker through the Client API, respecting existing mute, volume and distance settings.
* List direct-message conversations, read message history and control read status through the Client API.
* Receive notifications for incoming friend requests through the Client API.
* Retrieve a world's current thumbnail image through the Client API.

**Changes:**

* Import Gaussian splat PLY files from more World Labs export layouts, with clearer errors for unsupported or invalid files.
* Keep submitting automated building tasks through the Client API when task history fills up; the oldest completed tasks are cleared automatically.
* Keep your diagnostics panels' open or closed state when you travel between worlds or restart, subject to each world's diagnostics permissions.
* You can no longer use the media panel in edit mode.

**Bugs fixed:**

* Small Gaussian splats appearing black, and splats leaving ghost images or streaks on older graphics cards.
* Gaussian splats losing saved draw distances when recreated or loaded into a world, and hidden splats becoming visible when recreated in the editor.
* `DataStore` version conflicts returning the value the script tried to write instead of the value actually stored, and store and delete calls ignoring `RetrieveData`.
* Grab and release script events reporting the avatar in `HeldObjectData.ObjectId` instead of the held object.
  * Scripts that relied on the old value can find the holder through `HeldObjectInfo.SessionId`.
* Client API editor screenshots failing while checking whether visible textures were ready.
* Imported sounds being rejected when assigned to script inputs through the Client API.
* Compilation failures in the shipped rotation, open/close, pedestal spawning and collision sound sample scripts.

</details>

### 47.8.3 (10/12/26)

<details>

<summary>Click to reveal patch notes</summary>

**Bugs fixed:**

* Crashes or freezes when entering or moving around worlds with mirrors.
* Crashes when saving your avatar after simulating clothing in the Avatar Editor.
* Crashes while idle in a world.

</details>

### 47.8.2 (10/12/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Expanded Sansar Client API capabilities let external applications, including AI-controlled players, travel, chat, shop and interact in Sansar.

**New:**

* Travel between worlds, move avatars, control the camera and take screenshots through the Client API.
* Use the Client API for text chat and direct messages, scripted menus and offers, and nearby interactions within normal reach and line-of-sight limits.
* Search the Store, buy items, send gifts and tips, and spawn or remove supported inventory items in worlds through the Client API.
* Manage friends, mute or block people, favorite worlds, and change supported settings and saved looks through the Client API.
* Browse and manage events, RSVP and interact with quests through the Client API.

**Changes:**

* Your avatar’s hand reach now adjusts as you move your headset in VR.
* Move to Folder is no longer available in the editor inventory.

**Bugs fixed:**

* The interface becoming unresponsive on Steam Deck.
* Incorrect display brightness and contrast on Steam Deck.

</details>

### 47.8.1 (10/11/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Find your way around My Worlds with separate tabs and a badge for pending invitations.

**New:**

* Browse My Worlds using separate My worlds, Shared with me and Scenes without worlds tabs, and spot pending invitations with a badge.

**Bugs fixed:**

* Freezes when adding a Gaussian splat to a scene.
* Voice, volume controls and Nearby chat being unavailable when opening a collaborative editing session before anyone else joined.
* Collaborators missing from the Nearby people list during collaborative editing.
* Unnecessary scene reloads and long pauses when another collaborator deleted an unrelated object.
* Instability when My Worlds refreshed while thumbnails were still loading.
* Leave and Decline buttons in Shared with me having clipped labels and missing backgrounds.

</details>

### 47.8.0 (10/11/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Edit your world together with guest builders, with voice and text chat during live edit sessions.

**New:**

* Invite guest builders to a live edit session for a world you own, with voice and text chat. Manage invitations in the Collaborators panel and find shared scenes under "Shared with me" in My Worlds.
  * The owner must be present. Only the owner can save, build or publish.
  * Guests can move, duplicate, configure and delete objects already in the scene, but cannot add items from the owner's inventory or their own.
  * Each builder can undo and redo only their own edits.

**Bugs fixed:**

* Scene fog color changing slightly each time a scene was loaded.

</details>

### 47.7.0 (10/07/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Organize your inventory with folders, and use expanded Sansar Client API features to customize avatars, configure interactions and import Gaussian splats.

**New:**

* Organize your inventory into folders up to eight levels deep, and keep multiple folder windows open at once.
* Drive scripted vehicles (scripts using `AgentPrivate.Client.SubscribeToCommand`) with WASD, the left VR controller stick or the gamepad left stick while seated; physical numberpad keys also work while standing.
* Control new rendering optimizations on supported graphics cards with the Bindless Rendering option in Advanced Settings.
  * Restart Sansar after changing this setting.
* Use the Client API in the Avatar Editor to import bodies and wearables, fit clothing, adjust appearance and materials, preview outfits, and save and wear looks.
* Configure grab points for each hand through the Client API, including grip position, rotation, Stays in Hand and Aim at Cursor.
* Import audio into inventory and assign or clear sounds on script inputs through the Client API.
* Import Gaussian splats from PLY files, place and duplicate them, and inspect and edit their properties through the Client API.

**Changes:**

* Gaussian splats can no longer be added to the Scene Library.
* Upload Gaussian splats from PLY files up to just under 2 GiB through the Client API.
* Check whether visible Gaussian splats have finished loading before taking editor screenshots through the Client API.
* Get clearer errors for invalid property values during Client API editing, including valid values and limits.

**Bugs fixed:**

* Crashes when travelling between worlds with media, and when closing Sansar.
* Memory use increasing when re-entering VR.
* Editor selection highlights and transform controls disappearing or showing the wrong tint behind glass and water.
* Client API saves and builds of large scenes failing while data was still transferring.
* Gaussian splat selection boxes and Client API camera framing not matching the visible splat.
* Scripted vehicle controls staying active after leaving a seat or losing focus.
* Scripted vehicle commands held on one input device being canceled by another device.
* Missed `AgentPrivate.Client.SubscribeToCommand` events when scripts had overlapping command subscriptions.

</details>

### 47.6.1 (10/01/26)

<details>

<summary>Click to reveal patch notes</summary>

**Bugs fixed:**

* Some purchased scenes not reopening in the editor.
* Edit sessions failing to close cleanly when leaving the editor.
  * Both fixes also shipped in a later 47.6.0 build. This update makes sure everyone who installed 47.6.0 early receives them.

</details>

### 47.6.0 (10/01/26)

<details>

<summary>Click to reveal patch notes</summary>

**Highlights:** Automate world building on Windows with the new Sansar Client API, from importing Blender assets to publishing worlds.

**New:**

* The new Sansar Client API on Windows lets external applications import Blender assets, place and edit objects, adjust materials and lighting, add C# scripts, capture screenshots, and save, build and publish worlds. This also enables AI-powered world building.
  * Sign in normally and enable **Allow local API access** in Settings > Social > Privacy to allow local applications to use the API.
* Update compatible static assets you own through the Client API while preserving their placement, scripts and material edits.
* Import textures and replace material textures through the Client API without reimporting geometry.
* Upload and replace world listing images through the Client API.
* Set position, rotation and scale in the avatar item editor with numeric controls; use the toggle to show or hide the values.
* Use two-sided options for wind-animated opaque materials, Fur Shell and Velvet Fur.
* Use Cubemap Window materials on rigged meshes.

**Changes:**

* Wear Wind/Cloth garments with updated cloth simulation and collision that better follows avatar leg shapes and seated poses.
* Wind animation pauses in the avatar editor.
* Textures stream better on opaque and cutout materials.

**Bugs fixed:**

* Transparent surfaces rendering incorrectly in mirrors.
* Avatar arrival effects not matching the avatar's full scale.
* Unreliable controller connections and control bindings in OpenXR.
* Incompatible materials being pasted into mirror material slots.

</details>

### 47.05.00 (09/26/26)

<details>

<summary>Click to reveal patch notes</summary>

**New:**

* Toggle for eye-tracking added to settings panel.
* Calibration function for eye-tracking. Found in the settings panel.

**Changes:**

* Individual sliders for shell and blade length added to the grass shader.

**Bugs fixed:**

* Assets not unloaded from VRAM when leaving the HomeSpace
* Speaking indicators not activating when a user has the megaphone.
* Individual volume controls cease to function when the user has the megaphone.
* Mirrors missing their mask in worlds.
  * Worlds will have to be re-baked if affected. and in some cases the mirror recreated
* Atmospheric march collapses when a mirror is currently rendering.
* User imported objects not retaining their icon when added to the scene backpack.
  * Some cases custom items need to be reapplied to the scene inventory.
* Transparency being lost on custom icons applied to inventory objects.
  * Icons that have been previously uploaded won't gain their transparency from just re-uploading, they have to be changed even if it's one pixel.
* Media doesn't initialize when using the Media interaction panel when setting an URL if media isn't already playing.
* Lookbook UI disappears when minimising the game window.
* Accessories detaching when switching from accessories to clothing view in the lookbook.
* Mis-aligned 'teleport to' icon.
* Mirrors can not be selected by clicking in the editor.
* Mirrors as components lacking transform gizmos.
* Mirror fallbacks only rendering in the left eye.
* Virtual keyboard spawning behind the social panel.
* VR projection issue when drawing grass fins.
* Grass shell/fin/blade drawing in diagnostic modes.
* Inconsistent normal direction applied to grass blades in stereo.
* Avatar dissolve-in effect becoming stuck when entering VR mode during scene load.
* Underwater distortion effect wasn't stereo correct.
* Virtual Texturing downgrading textures prematurely of meshes in 'fading' state.
* Caret disappearing at reduced UI scale values.

</details>

### 47.3.00 (09/21/26)

<details>

<summary>Click to reveal patch notes</summary>

**New things:**

* Teleport effect when teleporting in or out of a world.
* V1 work in progress NPC creation tool

**Changes:**

* Asset import log is less spammy.
* Grass shader default grass normals changed to uniform up to avoid confusion.
* Add 'Teleport to friend' button to social UI rows rather then nested in the three-dot menu.
* Gaussian splats may now render on very old GPUs.
  * They may not perform well as older GPUs don't support some of the optimizations.

**Bugs fixed:**

* Depth biasing issue when cubemap windows intersect mirrors.
* Grass always trampled at 0,0,0
* Missing gizmos in Lookbook transform mode.
* Missing option to filter PostFX volumes in the Scene Objects panel.
* Sky contribution missing from diffracted water.
* Splats not included in cubemap captures.

</details>

### 47.2.00 (09/15/26)

<details>

<summary>Click to reveal patch notes</summary>

* Streamline load skipped entirely on AMD GPUs.
* More robust texture streaming support checks to also gate on feedback shader support.
* Correction to view space projection in history calcs of several shader vertex stages.
* Cubemap generation now captures all render passes, not just the opaque bin.
* Remember correct size of social panel when closed with the nearby draw opened.
* Lookbook UI scaling issue when using 4K / High DPI and ultrawide monitors.
* Two-sided materials now draw both sides correctly.
* Aberant transparent overdraw across mirror surfaces.
* Image corruption in VR when looking at transparent surfaces.
* Social panel Nearby drawer open status now persists between worlds and client sessions.
* Client deadlock when loading gaussian splat containing worlds.
* Black screen issue on older cards including Pascal.
* Visible wobble across transparent surfaces when DLSS enabled.
* UI becoming unresponsive after travelling through a portal.
* UI scaling issue in edit mode.
* Crash when leaving a scene that contains a mirror when in VR mode.
* Freeze when typing \ into the Media panel URL.

Changes:

* Input smoothing now only applied to hand-tracking mode only, not controllers.
* Mirror fallback cubemap image size increased from 128 to 512.

</details>

### 47.1.0 (09/11/26)

<details>

<summary>Click to reveal patch notes</summary>

Patch Notes V47.1.0

**General Updates**

* Ghost-lights have been exorcised.
* The graphics backend has been upgraded from DX11 to DX12, unlocking a major wave of rendering, performance, and feature upgrades.
* MIRRORS have arrived in Sansar, including VR support and scripting support.
* OpenXR runtime support has been added and is now the default VR runtime.
* Major networking improvements across the client and services.
* Fly speed is now adjustable.
  * While flying, the scroll wheel adjusts fly speed when moving and reverts to camera distance when stationary.
* Loading Hints have been added to load screens, with a settings toggle to turn them off.
* Added desktop avatar look-in-camera-direction mode.
* Added avatar ragdoll support, plus script API
* Portals can now show a preview of the scene they lead to.
  * Worlds must be re-saved / re-baked before portal previews will appear.
* In World Clickable Media Added.
  * Only a certain type of screen are clickable and is local to you, World owners will need to use existing system to make changes for everyone
* Added built in local Media Screen Browser to the UI

**Creator Updates**

* Large asset uploads should no longer fail on the first attempt.
* The import window now shows more upload progress information and supports larger uploads.
* Gaussian Splats have been added, with PLY import and in-world support.
* glTF / GLB support has been added for model imports and in-world workflows.
* Added a per-scene creator-managed backpack.
  * Any item from your inventory can now be added to the scene backpack by right clicking them and clicking add to library.
  * New backpack management UI added to edit
* Added Interactive Media Screens for in-world web and media interaction.
  * New placeable mirror system object for clickable screens
* Added LUT support as a new uploadable asset type.
  * Unreal and HaldCLUT LUT formats are supported, and LUTs can be assigned in the Scene Settings UI.
* Added PostFX volumes for localized visual effects and LUT overrides.
  * New PostFX volume system object added
  * PostFX volumes can override the scene LUT and select an effect type. The first effect is underwater, with more potentially to come later.
* Material pasting now supports multiple selected objects at once.
* Added collision volume diagnostics for Static, Dynamic, Keyframed, Avatar, Trigger, and Audio volumes, with visibility toggles and disabled-by-default behavior in edit mode.
  * This mode only works in runtime, you must use edit modes existing tools
* Added cubemap capture / export from the current camera position in edit mode, with EXR support for HDRI / HDR color capture.
* Fixed an edit-mode camera regression caused by previous input smoothing changes.

**Shader Updates**

* Added Global Wind
  * Wind direction and speed can be configured in Scene Settings, and wind-enabled shaders now respond to procedural wind.
* Flow-maps can be used to define per-texel wind response and anisotropic stiffness on wind-enabled surfaces.
* Added new shaders: Fur: Long, Fur: Velvet, Wind: Standard, Wind: Standard + UV Animation, Grass, Glitter/Sparkle and Wind/Cloth: Skirt.
* Grass density and distribution can be controlled with Density and Noise maps.
* Wind/Cloth: Skirt makes imported skirts react to both wind and movement.
* Added the Cubemap Window shader for outside-in cubemap window effects on flat surfaces using door projection.
  * Button added to make these from in edit mode.
* Reworked alpha rendering to remove the smearing that afflicted transparent surfaces in motion.

**Avatar / Lookbook Updates**

* You can now apply up to five accessories to a Look instead of being limited to one accessory from each category.
* Accessories can now be attached to any bone, new dropdown box for selecting the attachment point.
  * Uploading is still connected to the accessory type and store ignores the new selected bone.
* Scaling limits for accessory items have been increased.
* Avatar morph sliders can now be bidirectional.
* Improved inventory loading reliability.

**VR Updates**

* OpenXR enables eye, finger, and hand tracking where supported by your headset and software environment.
  * Move / run: hold a left thumb-to-middle-finger pinch, then move your left hand from its starting position. The displacement drives the normal virtual left stick, head-relative. There is no separate run gesture; speed comes from the normal stick magnitude.
  * Turn: hold a right thumb-to-middle-finger pinch, then move your right hand horizontally. It respects the existing snap/smooth turn setting.
  * Grab: close either hand into a fist to grab; open it to release.
  * Mute: left thumb-to-ring-finger pinch toggles voice mute.
  * Jump: right thumb-to-ring-finger pinch.
  * UI click: point at UI and perform an index pinch.
  * Open application menu: hold a left index pinch for 0.5 seconds while not pointing at a UI panel.
* Dynamic Foveated / Variable Rate Shading is supported on eye-tracked headsets.
* The VR runtime can be changed in Advanced Settings if you run into problems.
* Full-body tracking has been improved.
* VR UI now renders with correct depth culling again when render resolution is below 100%.
* Improved OpenXR headset re-entry reliability, including a second-headset black-screen / session wedge fix.
* Fixed a VR per-eye shadow darkening artifact during head movement.
* Social panel scaling in fixed-size mode and VR beams rendering correctly over UI.
* Improved VR UI interaction with cursor snapping for small controls, haptic and audio click feedback, and a thinner hand-tracked pointer beam.
* Wrist menu resized

**Graphics / Performance Updates**

* Scene lighting now bakes on the GPU for DXR-compatible GPUs, reducing bake times from minutes to seconds.
  * Mitigate black patches in baked GI caused by NaN and negative specular.
  * Systems without hardware ray tracing will continue to use the existing CPU baker.
* HDR has been reworked and is now out of beta.
* Added Virtual Texture Streaming to reduce VRAM usage in heavier scenes at the cost of some performance.
  * Virtual Texture Streaming can be toggled in Advanced Settings.
* Added DLSS upscaling and Frame Generation.
  * Upscaling method can be selected in the Graphics settings panel.
  * DLSS is the default upscaler on supported Nvidia hardware.
  * On non-Nvidia cards, the original Built-In upscaling method remains the available option.
  * Frame Generation is currently supported in desktop mode only, not VR.
* Added optional NRD denoising for reflections. It offers higher quality, but is disabled by default because it is more expensive.
* Comprehensive graphics pipeline performance work has reduced waste and improved overall efficiency.
* Umbra Occlusion culling system has been replaced with custom Hi-Z culling.
* Fixed a periodic camera rotation / hitch issue.

**Script API Additions**

* Added scripting API support to add and remove scene backpack items for everyone or for specific users.
* Added `UI.Menu` / `UIMenu` for script-driven menu panels.
* Added avatar ragdoll scripting, including enable / disable, bounce, and impulse controls.
* Added `RagdollRegion` enum values for targeting specific body regions.
* Added `ScenePrivate` methods to add, remove, and clear Scene Backpack Library items globally or per-agent.
* Mirrors are now scriptable through `MirrorComponent`.

**Scene Library**

`ScenePrivate` can now add, remove, and clear Scene Library items for everyone or for an individual user's current session: `AddToSceneLibrary`, `RemoveFromSceneLibrary`, `ClearSceneLibrary`, and their `ForAgent` equivalents.

```csharp
ScenePrivate.AddToSceneLibrary(resource, "Rubber Ducky");
```

**Ragdolls**

`AgentPrivate` now provides `SetRagdollEnabled`, `GetRagdollEnabled`, `ApplyRagdollImpulse`, `ApplyRagdollImpulseToRegions`, `SetRagdollBounce`, and `GetRagdollBounce`. Use `RagdollRegion` values such as `LeftArm`, `RightLeg`, `Torso`, `Head`, or `AllRegions` to target an impulse.

```csharp
agent.SetRagdollEnabled(true, 3.0f);
agent.ApplyRagdollImpulseToRegions(
    new Vector(-250.0f, 0.0f, 0.0f),
    RagdollRegion.LeftArm | RagdollRegion.LeftLeg);
```

**Scriptable Menus**

`Agent.Client.UI.Menu` adds `Show`, `ShowStyled`, and `Hide` for script-controlled screen menus. Read `SelectedItem` or `SelectedIndex` after a selection; menus support 1-32 items, custom colors, placement, and click-through display mode.

```csharp
agent.Client.UI.Menu.Show("Choose a team", "", "",
    new object[] { "Red", "Blue" }, 50.0f, 50.0f, true, true);
```

**Mirrors**

Scriptable `MirrorComponent` can now be enabled or disabled globally with `SetIsEnabled`, or for one user's current session with `SetIsEnabledForAgent`.

**Social / Voice / UI Updates / Settings**

* Chat, Nearby, Friends, and Messaging have been reworked into a unified Social UI.
* Region chat is now integrated directly into Social.
* Added moderation tools to the Social UI.
* Chat session rows now show unread badges.
* Voice volume preferences are now remembered more reliably.
* New Social settings include Recording indicators visibility.
* General settings now include loading hints, chat-open-by-default, avatar look-at, and desktop field-of-view options.
* Graphics and VR settings now include Upscaling, VR upscaling, Reflection denoising, Desktop Frame Generation, Mirrors toggle, Mirror distance,
* Advanced settings now include VR runtime selection and Virtual Texturing.
* UI panels are now easier to grab for resizing.
* Microphone crackling has been resolved.
* Voice attenuation when using the secondary voice output device has been corrected.
* Volume level indicators for other speaking avatars have returned.
* Fixed voice indicators not scaling with avatars.
* UI panels can no longer become stuck behind the edit or diagnostic ribbons.
* Transparent tool-tips have been corrected.
* Several UI panel ordering issues have been fixed, including panels drawing in reverse order below the world origin.
* Private chat read handling fixed so DMs should no longer get stuck or stop updating correctly.
* UI sounds should no longer continue playing after changing volume settings.
* Color emoji now render correctly in the UI and chat.
* Fixed closed UI-panel ghosting after panels are dismissed.
* Fixed Hovertext bug while in F10 camera suit.

</details>

### 46.6.2 (03/03/26)

<details>

<summary>Click to reveal patch notes</summary>

Patch Notes V46.6.2 "Body and Mind Update"

**Highlight Updates**

**Body and Face Sliders**

* Custom avatars can now support blend shapes/shape keys on import; defaults have not been updated to include these yet.
* Creators will need to upload avatars with blend shapes, and they will appear 1:1 in-game. A naming convention is available to organize them, but if it is not used, a custom category will appear. (Docs to follow soon)
* If an avatar was uploaded with these in the past, it may appear in Lookbook but may not function correctly.
* Improved body and face slider responsiveness.
* Face presets are now hidden for custom avatars where presets do not apply.

**Material Asset**

* You may now save materials from any object to your inventory. Saved materials may be applied to other objects either from context menus or by dragging and dropping them onto your target item.
* Ownership is respected, so you can only list materials in the store if you uploaded them yourself or if the item was previously bought with resale allowed.
* Legacy objects you own or bought from the store will pass down permissions and licenses to any materials saved from them, such as whether they can be sold, resale cost, or edited state.
* We have tried to provide maximum freedom within your own edit mode while also keeping permissions and license rights fair to the original owner. A material should track a license wherever it goes.
* Material asset icons feature one of three circle indicators in the top-right corner.
  * 'Full Use': A filled circle indicates a full-permission asset you can list for sale or apply to an object you later list for sale.
  * 'Partial Use': A partially filled circle indicates partial permission states.
  * 'Restricted Use': An empty circle denotes restricted items that cannot be listed.
* New context menu added for material-based actions: saving, copying, and pasting.
* Copy/paste materials between objects. Copying all materials or only a single slot is supported, both from context menus and within the materials editor UI.
* Material clipboard is maintained between scenes to allow copy/pasting materials between objects in different scenes.

**General Updates**

* Runtime avatar scaling via Script API (you can change the size of visitors on the fly).
* Moderation panel added to allow world owners better control.
* Added Discord Rich Presence integration and settings panel.
* Diagnostics mode is always available to world owners and admins, even if off for visitors.
* Streaming detection modal added: a red recording dot appears above a player who is using streaming software.
* Web updates for the streaming media system to improve stability; additional codecs added.
* Voice chat echo cancellation improved.
* You can now set a different audio device to handle voices vs. other in-game sounds.
* Added 3 new backpack items: Audio Beats Heart, Soccar Ball, Basketball.
* Improved culling behavior when exiting the scene AABB.

**Store Updates**

* Store search improvements to allow fair display of items; it now tries to prioritize a result from each possible creator before showing repeats/color variations.
* In-game and web store fixes: results should display better and use title, description, and tags much better.
* Web store main page changed from Recently Added to a daily rotating random pick of assets. (Recently Added is still a filter.)
* Categories should be displaying better now.

**Quality of Life Updates**

* Custom Properties support and naming for Blender exports. This will allow you to set Sansar shader and material properties as part of the model before exporting from Blender.
* Renamable material slots in edit mode.
* Per-object Occluder/Occlude toggles in edit mode to selectively exclude individual objects from culling.
* Text in the script debug panel is now selectable and copyable.
* Copy/paste of materials also works between Lookbook and edit mode.
* Improved import feedback when an invalid shader is requested when using custom Blender settings.

**Bug Fixes**

* Crash fix for when you closed the materials window with another object selected.
* Material duplication trick removed (replaced with actual workflow).
* Fixed voice chat issues that could cause fading, crackling and instability under jitter/packet loss conditions.
* Fixed a full-volume "pop" that could occur when starting a new media stream.
* Fixed VR Lookbook camera upward drift.
* Lookbook freecam freakout removed.
* Fixed incorrect camera pitch direction behavior when loading into edit.
* Fixed incorrect camera pitch direction behavior on zooming in and out.
* Fixed culling-related visibility issues and corrected occluder/occludee reflection property names.
* Fixed media GI corruption cases caused by invalid light transport/emission data.
* Fixed GI 'black square' corruption when multiple media surface channels are sharing light probes.
* Crash when attempting to load the avatar carousel on first start.

**Script API Additions**

* **AgentPrivate.SetScaleFactor(float scaleFactor)**\
  Sets the runtime scale factor instantly. The scale is clamped to \[0.01, 100.0].\
  `// Scale avatar to 2x size`\
  `AgentPrivate agent = ScenePrivate.FindAgent(agentInfo);`\
  `agent.SetScaleFactor(2.0f);`
* **AgentPrivate.SetScaleFactorAnimated(float scaleFactor, float seconds)**\
  Sets the runtime scale factor with a smooth transition over the given duration.\
  Uses a smoothstep (ease in/out) curve for natural-looking growth/shrink.\
  `// Grow to 3x over 2 seconds`\
  `agent.SetScaleFactorAnimated(3.0f, 2.0f);`\
  `// Shrink to half size over 1 second`\
  `agent.SetScaleFactorAnimated(0.5f, 1.0f);`
* **AgentPrivate.GetScaleFactor()**\
  Returns the current runtime scale factor (1.0 = normal).

</details>

### 46.5.1 (01/21/26)

<details>

<summary>Click to reveal patch notes</summary>

Patch Notes V46.5.1

**General Updates**

* Added player camera smoothing with settings toggle
* Added debug visualisation mode to show texture sizes.
  * mini guide found here: <https://docs.sansar.com/latest/creating-in-sansar/creatortools/diagnostics-toolbar#texture-size>
* Added Max Client Texture Size selector to the settings panel, This forces textures to only go up to your selected size in any world, works in VR. (only affects you)
  * Auto mode will adjust this setting in real time to balance texture sizes against your systems VRAM availability
  * It's on for default for everybody at the point the update dropped. No difference between desktop and VR mode in behaviour,
* There are some caveats,
  * It won't work on an Intel GPU (AMD or Nvidia only), but Intel GPUs don't support VR anyway.
  * If you do start it on an Intel GPU regardless, it will look at total VRAM, more than 8GB limits to 4k, otherwise limits to 2k.
  * It won't work on Linux if anyone tries it there.
  * It will detect if it's running on a gamestream instance and textures will always be set to 4k.
  * Ff you start it on a SteamDeck it will limit textures to 1k.
* Added UI Scale slider to the settings panel.
  * Added toggle to use the Windows Settings scale value when calculating UI scale. (Use with the other UI scale to achieve desired results)
* Added additional Editor settings to allow customizing Culling bake parameters. (helps stop objects from being culled even when seen)

**Bug Fixes**

* Issue with Uv Rotate value being saved incorrect on objects with multiple material slots.
* Issue where Uv Rotate was jumping between two points with camera distance.
* Fixed Mouse becoming unusable when force teleported.
* Crash fix for disconnecting headsets.
* Crash fix for old returning users with outdated avatars or missing assets, prompted to make new avi instead.

**Script API Additions**

* Exposed the following shader properties to user scripting:

`Sansar.Simulation.MaterialProperties`

* Scroll Albedo.
* Scroll Normal/Roughness.
* Scroll Metalness.
* Scroll Ambient Occlusion.
* Scroll Displacement.
* Scroll Displacement Factor.
* Receive reflections.
* VAT Loop Animation.
* VAT Ping-Pong Animation.
* VAT Blend Animation Loop.
* Blend Displacement Flipbook.
* Blend On Displacement Loop.
* Loop Displacement Flipbook.
* Ping-Pong Displacement Flipbook.
* Loop Flipbook.
* Apply UV Offset to Diffuse layers.
* Apply UV Offset to Ambient Occlusion.
* Apply UV Offset to Emissive.
* Draw Afterimages.
* Audio React - Emissive Color.
* Audio React - Emissive Brightness.
* Audio React - Adaptive Displacement.
* Audio React - Displacement on Low.
* Audio React - Displacement on Mid.
* Audio React - Displacement on High.
* Audio React - Flipbook Frame.
* Audio React - Adaptive Flash Emissive.
* Audio React - Flash Emissive on Low.
* Audio React - Flash Emissive on Mid.
* Audio React - Flash Emissive on High.

</details>

### 46.3.4 (12/06/25)

<details>

<summary>Click to reveal patch notes</summary>

**Fixes**

* Multiple crash/freeze issues when changing worlds with media loaded.
* Crash when toggling the media disablement toggle in the settings panel
* Multiple issues involving the in-world quick-buy UI panels and flow for both VR and Desktop mode.
* Missing UI color picker panel when in VR mode.
* PlaySound lifecycle management issue that caused further sounds to cease to play when many events fired at once resulted in an excess of events waiting to be cleaned up in the STOPPING state.
* UI scaling now ignores the Windows desktop scaling setting value when looking up the current display DPI.

**Changes**

* Media disablement in the main settings menu toggle now immediately closes streams when set to disabled rather than requiring a world change to take effect.

</details>

### 46.3.2 (12/01/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* 4 different Media streams can now be supported in the same world and objects displaying them
  * Settings for these streams are found in the media shader settings as the 'stream index' and also in the audio components settings menu.
  * New settings added to the scene settings panel added to support the new media channels.
* Chromium updated to v142.

**Shader Updates**

* Improved performance for diffraction shaders.
* Stream selection added to Audio reactive
* Additional displacement mode toggles for audio reactive shaders.
  * LOW MID HIGH Freq ranges and 'Adaptive' for displacement effects.
* Added the additional loop behaviour controls previously added to the regular flipbook shaders to the Billboard shader to bring it's functionality up to parity.

**Script API Changes**

Sansar.Simulation.StreamChannel (Enum)

* `StreamChannel.MediaChannel2` - Media Surface 2
* `StreamChannel.MediaChannel3` - Media Surface 3
* `StreamChannel.MediaChannel4` - Media Surface 4

Sansar.Simulation.ScenePrivate (Class)

* `ScenePrivate.OverrideIndexedMediaSource`
* `ScenePrivate.PerformIndexedMediaAction`

Sansar.Simulation.AgentPrivate (Class)

* `AgentPrivate.OverrideIndexedMediaSource`
* `AgentPrivate.PerformIndexedMediaAction`

Search your Client ScriptAPI folder for more info

**Bug Fixes**

* Reworked UI scaling to fix several UI scaling and positional issues. Now scales by DPI for consistent element sizes across different displays.
  * This should solve a lot of scaling UI issues including the Hair color picker and info on interactable items.
* UI being locked out of further interactions when attempting to open a store panel in VR mode.
* Crash when interacting with the properties of a script that is the grandchild of the object currently being inspected.
* 'Pop' sounds when abruptly stopping playback of an audio track.
* Load screen music not smoothly fading out when loaded.
* Audio crash when removing a DSP, seen as a random crash for some.
* Reflections not rendering.

</details>

### 46.02.02 (11/01/25)

<details>

<summary>Click to reveal patch notes</summary>

**Bug Fixes**

* Audio now works correctly with 4 channel microphones.,
* Leak issue that caused frame-rate to tank after playing many impact sound events.
* An issue where VATs imported since the update have their displacement scales set to zero.,
* Avatar VATs should now scale correctly in both lookbook and in the world.,
* VAT animations set to play once would loop back to the first frame when stopping now stops on last frame.

**Shader updates**

* Audio reactive shader (Emissive + UV Animation) More variants in future. Toggle to apply volume to brightness. Toggle to apply volume to displacement strength. Toggle to apply RGB colors based on audio analysis. Toggle to advance flipbook frame to the beat of the music. (You can leave step-rate on 0 for this to work right). Toggle to flash on the beat (plus individual low/med/high band toggles) You can mix and match options for varying effects.

</details>

### 46.01.11 (10/24/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* New launcher created you must redownload from the website and it should handle everything, recommended to do a clean install but not necessary.
* Echo Cancellation of media and mics added and Automatic Gain Control for voice chat, should drastically help with people who use speakers
* Increased strength and quality of UI blur effect for a more pleasing result
* Floating UI elements are now anti-aliased
* Audio backend (FMOD) has been updated to the latest version.

**Shader Updates**

* 'Indexed' flipbook shaders that allow switching between 4 individual flipbooks using the scripting API named **"Index: Standard + UV Animation"** and **"Index: Standard Two Sided + UV Animation"**
* New VAT shader variant **"VAT: Standard + Alpha Mask"**
* Added properties to enable looping subsets of larger VATs
* Added script API function to set these at runtime
* VAT and Displacement animations now behave correctly when worn on an avatar\
  There is a visual issue in lookbook when scaled to the large and small extremes but is fine once you save and join a world.

**Bug Fixes**

* Automatically update advanced color management properties when dragging the client window between monitors with differing capabilities
* Fix for bottom/right of game window glowing orange in high-bloom worlds
* UI opacity now behaves more predictably when reducing the alpha value
* Z-fighting issue between UI panels when far from the world origin point resolved
* Fixed UI scaling issue when switching from VR to desktop and back
* Crash fix when minimizing the client window (thank beans)
* Removed erroneous scrollbar from VR mode profile UI
* Fixed Giant scaling issue for the hair color picker but still may present a issue on some screen resolutions missing the HUE slider (scaling your window can make it show)
* Corrected desktop snapshot behaviour
* Fixed audio issues with some objects occluding sound when the camera was behind them.

</details>

### 46.01.05 (09/02/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Diffractive glass effect for transparent UI panels.
* Added support for setting individual audio emitters to emit either Left/Right/Both channel audio.
* Added 'ICC Color Correction' to the advanced settings panel.
  * If you are a professional artist with a calibrated display, this will cause Sansar to apply your currently installed ICC profile for color correct rendering. If not using a calibrated display it is best to leave this setting off, but will try to do it's best using your monitors reported EDID data if you do enable it.
* (VR Only) Dichromatic colour-blindness adaption mode added to the advanced settings panel. RGB sliders in advanced settings set your individual sensitivity to the RGB primaries. An adjustment period for a minimum of a few hours is required for your brain to make sense of the delta colour simulation.

**Script Updates**

MAYJOR increase to scripting memory from 32mb to 256mb per scene

**Bug Fixes**

* The majority of UI panels now render correctly in HDR mode. Some UI elements remain in the wrong colourspace and will be corrected later.
* Fix for an issue where disconnecting an audio device while Sansar is open results in the client no-longer outputting any audio. The client will attempt to select another output device if the current one is removed. For brief disconnections that are reconnected soon after the client will attempt to switch back to the original device automatically.
* Fix for a resource rebinding issue within the reflection passes. (Reduction in spurious log spam)

</details>

### 46.01.02 (07/24/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Server upgrades and backend inventory work. (no visible changes)
* Reduced max culling AABB from 4096 to 4095 to prevent rounding errors from crashing the scene bake.
* Increased size of icons in Emote UI.
* Fix for an issue where new users with higher-end hardware and certain other common software installed are presented with the lowest possible graphics settings on first launch.
* Fix for an issue that can make HDR mode appear too dark when using OLED monitors in TrueBlack400 mode.
* Fix for RegionServer crashes caused by the Backpack chair.
* Fix for the desktop FPS limit being erroneously applied in VR mode.
* Fix for an import failure that can be caused by FBX scenes containing multiple skeleton containing meshes.
* Minimum draw distance now fades in when approaching to match the maximum draw distance fade out effect.
* Removed some old links and wording from client and launcher.
* Left menu icon for volume changed.

**Shader Updates**

* Screenspace UV effect from the Screenspace shaders now additionally work in VR mode.
* Improved performance for diffracted transparent+multibump shader.
* Added four new shaders to allow non-shadow-casting objects:
  * No Shadow: Standard
  * No Shadow: Standard + Emissive
  * No Shadow: Standard + Alpha Mask
  * No Shadow: Standard Two Sided + Alpha Mask

</details>

### 46.1.1 (05/24/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Final major update to reflections. They have now reached their final form.
  * Significant improvement to quality.
  * VR reflections now similar to desktop reflections in quality.
* Fix for an issue where reflections are inappropriately applied to rough surfaces; Plus some aberrations that can appear in close angled fine details.
* Fix for an issue that can cause erroneous culling behaviour if the scene AABB doesn't encompass the world origin.
  * Rebake your world if it was affected.
* Fix for an issue where scenes may appear washed out when HDR is enabled within Windows but not within Sansar.

**Settings Updates**

* Added a Volume settings quickbar menu to main UI buttons.
* Added 'Display Gamma' gamma selection to the graphics settings panel. If you wish to retain the previous 'look', you can achieve that by setting the box to 'Reference 2.4'. If you have HDR enabled in Windows, the gamma selector will be replaced by the HDR toggle, as Windows HDR uses a different colour process. Setting this to the same gamma level as your monitor will enable those accustomed to professional workflows to create more colour correct art.
  * Many consumer monitors default to 2.2, so setting Sansar to 2.2 in those cases will improve both contrast and black-levels in world. Some professional monitors offer a choice between sRGB or Display P3 modes. These correspond to a gamma of 2.2 or 2.4 respectively.
  * There are two modes, Reference and Enhanced: Reference is the preferred if you wish to perform colour accurate work within Sansar. Enhanced provides more precision so will achieve the best look and low-level contrast using current OLED monitors set to 10bpc (Deep Colour) mode.

**Shader Updates**

* Fix for a precision issue that can cause slow VAT animations to stutter and appear less smooth.
* Fix for an issue that causes the ambient occlusion map to not show when opaque materials are in depth fading mode.
* Fix for a UV scaling issue with the Transparent shader.
* Fix for an issue with Pixelize UV Anim shaders where the scroll layer boxes produced incorrect behaviour.
* Fix for an issue with the VAT Standard+Emissive skinned shader that can cause flickering while in motion.

</details>

### 46.0.10 (04/24/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Respawn button added to Desktop and VR in the 'Go' Panel

**VR Updates**

* Added Flying mode to VR
  * Left controller X button to toggle flymode
  * Left controller tilt controls vertical movement
    * Left click stick to toggle the tilt control for up and down allowing use of hand
  * Left stick controls directional movement

**Shader Updates**

* New shader "Standard + Environment + Alpha Mask"
* Added checkbox to VAT shaders to toggle shadow casting.
* Added checkbox to VAT, Alpha Mask and Transparent shaders to enable/disable the material to receive reflections.
* Added checkbox for two compatibility modes to skip either the motion vectors or temporal accumulation during shadow rendering on Transparent shaders.
  * Reflections will now be disabled by default for Transparent shaders. They do not output motion vectors so can cause reflections to flicker and become noisy.
  * The provided compatibility checkboxes can mitigate the issues in specific instances, the creator can now choose which works best for their creation.
* Fix for an issue that caused the 'UV Rotate' and 'Flipbook - Loop' properties to behave as if they contained default values for existing objects.
* Fix for an issue where VAT shaders could send incorrect roughness values to the reflections.
* Further enhancements for reflections.

**Bugfix**

* Fix for an issue where the min culling distance feature can cause objects to become invisible if you stand inside them.
* Temporary fix for an issue that can cause the VR UI to inappropriately cull when running at a reduced render resolution. A better solution will follow.
* Fix for UI PVP Scoreboard not re-appearing in world after leaving and re-entering a world
* MaterialEditor in edit mode and the character editor for importing items UI color now syncs and works properly
* Default color button functionality changed to send out a 1-time event that changes the colors to default
* Multiple transparent panels now display proper colors
* Fixed an issue with the character camera spinning around the character on WASD input after exiting a script camera when certain circumstances were met.
* Updated UI handling for interaction prompts on objects with sit points.

</details>

### 46.0.00 (03/21/25)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Significantly improved quality of screen-space reflections along with improved performance.
* Reflections have been changed to ON by default due to significant performance increase, option to turn them off in settings remains.
* Mesh weighted to the head\_attach bone will now be visible in first person and VR.
  * Requires changes be saved to existing avatars to take effect.
* Deep color support. If you have a monitor capable of 10bpc color depth, Sansar is now able to display those extra colors.
  * This is complementary to the existing HDR support, but HDR is not required.
* Payment processing implemented fully, Withdrawals are now functional.
  * Commission rate dropped from 62% to 0% you now get everything earned minus a small withdraw fee
* Adjusted size of inventory and emote icons.
* Updated Early Access Badge to better fit the style.
* Add V-Sync toggle to the advanced settings panel. (It now also defaults to On. If you use G-Sync make sure it's forced to On in the Nvidia control panel and set to Off in Sansar for optimal performance)
* Improved HDR tonemapping.
* Added UI customisation options for things like color and transparency to most windows to Settings / UI
* General render pipeline optimizations
* Occlusion culling optimizations and fixes.
* V1 of the customizable UI colors implemented in settings, you can now change the main color and opacity of your UI panels

**Edit Mode Updates**

* Added editor property for minimum draw distance on a per object basis.
* 'Surface Snap' Hotkey changed to ALT+S.
* Moved Surface Snap and Local/World transforms selection to the main object transforms panel.

**Shader Updates**

* Added VAT Standard Shader. ''Vertex Animated Textures'' (See documentation for the Blender export tool).
  * [VAT Shader Basics](https://docs.sansar.com/latest/creating-in-sansar/shaders-and-materials/vat-shader-guides/vat-shader-basics.md)
* Added Skybox reflection shader (Standard + Environment).
* Added Skybox reflection shader: (Diffractive: Transparent + Multibump + Environment).
* New VAT shader variant "VAT: Standard + Emissive"
* Expose VAT properties 'VAT - Frame' and 'VAT - Step Rate' to the scripting system.
* Shadows now work correctly for the remaining displacement textures.
* Added toggle to blend/snap displacement animations when looping back from the last frame to first.
* Added option to flipbook shaders to either 'ping-pong', loop or play once.
* Added option to displacement shaders to either loop or play once.
* Increase range for Displacement scale.
* Added UV Offset property for the basic Media shader.
* Update the UV Rotate shader property to now use degrees instead of radians.

**Bug Fixes**

* Fixed banding issue within metallic gradients
* Fixed guest and ban list not showing the names in world creation settings.
* Fixed GI bake, all scenes should now bake correctly again. If you have scenes affected by this bug, re-baking is required.
* Fix for inappropriate reflections on the skin and faces of default avatars.
* Fix for misaligned add pass rendering for Transparent+Multibump shader variants.
* Shadows now work correctly for the remaining displacement textures.
* Surface Snap and world-space adjustment Icons now correctly sync with hotkey use.
* Color picker UI snapping behind other panels when clicked fixed.
* Avatar Scale slider being unresponsive fixed.
* Featured Events on codex not working fixed.
* Fixed a crash when pressing F7 while using the '-enableVR false' start parameter.

**VR Changes**

* Increases the render resolution of the VR UI
* Fix for VR hands rendering behind the UI.
* Fixed the UI jitter than sometimes occurs when playing in VR.

**Misc Changes**

* Rewording of some phrases on website.
* Payment pages and some Account settings added to website, inc.
  * setup of payment method for stripe, delete account button for removing stripe details.
  * Account deletion and Email change buttons added.
  * Able to now convert USD's back to Sansar$ from the Process Payment wallet.
* Many broken docs links fixed, Still more to go to update missing images and pages.

</details>

### 45.0.30 (07/31/24)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Scroll wheel now changes camera speed in edit mode.
* New diagnostic mode for viewing the resolved radiance. (shows GI and bounced lighting effects clearer)
* Added hotkeys in edit mode for the world-space adjustment (TAB) and the surface snap gizmos (ALT).

**Script API updates**

* Adjust lighting range and intensity script API limits to match in editor limits.

**Shader Updates**

* Add UV offset property to several shaders. (With toggles for AO and diffuse layers) completing the texture adjustment trio scale rotate and move!
* Added an additional uv offset toggle for the Emissive pass on relevant shaders.
* Fix non-functional 'Fluid Distortion' effect on the Transparent Multibump shader.
* Fix 'fluid distortion' effect not applying to the shadow pass of alpha masked + uv anim shaders.
* Fix for non-functional uv scale slider in screenspace shaders.

**General Bug Fixes**

* Questing system back online, may require some testing.
* Fix backpack spawn lifetime increased to infinite not working.
* Small spelling error in UI.
* Fix web listings losing the main picture when editing.

**VR Bug Fixes**

* Now correctly selects the Oculus controller scheme when connecting a Quest via SteamVR Link.
* Now selects the Oculus controller schema when connecting a Pico via Pico Connect.
* Attempt to fix the UI jitter reported by some VR users.

</details>

### 45.0.28 (03/30/24)

<details>

<summary>Click to reveal patch notes</summary>

**Bug Fixes**

* Fixed some broken links in game
* Fix multiple issues with reflections being too shiny
* Sansar Park should appear on codex correctly

**Shader Updates**

* Multiple bug fixes for 'Fluid Distortion' effect.
* Add Scale and Amplitude properties for the 'Fluid Distortion' effect.
* Add Luma and Gamma mode toggles to Displacement Media shader.
* Add UVScale property to the Billboard and Pixel Billboard shaders.
* Sampler change for displacement textures.

**General Updates**

* Increased backpack item lifetime to unlimited, items will clear on player leaving world or with buttons in backpack.
* Discovery of Red and Green channel in roughness maps allowing creation of Anistrophic maps
* New world template list now in alphabetical order with your own worlds appearing towards the top
* Bundle purchases now directed to the web store

</details>

### 45.0.25 (02/19/24)

<details>

<summary>Click to reveal patch notes</summary>

HotFixes for last patch

* Fix of flying mode not activating
* Fix for glowing vignette when reflections are enabled in scenes with strong bloom.
* Fix for asset importer error when fbx scenes contain more than a single mesh.
* Addition of Clamp setting in new Media: Displacement shaders.
* Asset importer bug for rigged items fix.

</details>

### 45.0.22 (02/16/24)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

**REFLECTIONS ADDED!** Must be enabled in settings 'Graphics/VR' as this is considered resource-intensive. The reflectivity of objects is controlled by the existing Roughness maps; some objects may need adjustment if using maps that are too shiny.

**FLYING MODE ADDED!** Must be enabled by the world owner. Controls: Z to toggle, WASD or arrows for directional movement, C for down, E for up. Flight speed is controlled by avatars' run speed, so scripts can adjust.

**Bug Fixes**

* VR BugFix: 3rd person camera control now enabled when in a sit point 'driving mode'.
* Import BugFix: for the 'spin of death' asset importer crash when the fbx scene is too large.

**Shader Updates**

* New Shaders: Media: Displacement+UV Animation shader and Two sided variant. This enables the option to use a media stream video for vertex displacement. Screens will need to be high poly for this to work, use sparingly!
* Additional Side-by-Side UV split option added to this shader to use the same stream for separate color and displacement information; this must be set up in your video's stream and is a 50/50 side by side split.

**Settings Updates**

* Reflections toggle added to Graphics/VR options menu.
* Flymode toggle added to edit mode scene settings to allow control over flight per world. Defaults to off.
* Disable diagnostics toggle added to edit mode.

</details>

### 45.0.20 (02/09/24)

<details>

<summary>Click to reveal patch notes</summary>

**General updates**

* Driving mode created: you must now jump, crouch, or teleport to exit any sitpoint to allow scripts to use regular movement controls for vehicles. WASD mimics numpad inputs of 8,4,5,6 also combining 2 and 5 into S.
* A new look has been added to the first time user avatar carousel.
* Default gifting amount changed to zero to avoid accidents.
* More descriptive error messages along with user advice when FBX import fails due to problems with the node names.

**Bug Fixes**

* Umbra issue fixed.
* Fixed crash caused by long bio names.

**Shader updates**

* Displacement objects now cast shadows based on displaced verts.

**Settings Updates**

* Option to disable all media streams added to Advanced Settings.
* GPU acceleration enabled for media streams reducing CPU load, This can be disabled in Advanced settings if it causes any side-effects.

</details>

### 45.0.19 (01/29/24)

<details>

<summary>Click to reveal patch notes</summary>

**general updates**

* Added advanced settings panel.
* Finished implementation of multi-jump.
* UI now draws at native resolution when running with reduced render resolution.
* Moved a few settings into the new Advanced menu.

**Additions to settings panel**

* FSR Adaptive Sharpening when running with reduced render resolution.
* Clear cache button in the Advanced Settings.
* Max/Min cache size is now configurable from the Advanced Settings.
* Force Single instance toggle added (ability to open more than one gameclient) **VR updates**
* Resized + relocated VR diagnostics button.
* Bugfix: VR keyboard double typing fixed.

</details>

### 45.0.17 (01/25/24)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* T Teleport Defaulted to OFF
* Multi-jump created defaulted at 1 jump
* Improved network packet handling for v4 packets
* New diagnostic modes added: Unlit, Normals and Scale view

**World Build updates**

* Added T teleport setting: \[T key] teleport to freecam now defaults to off and needs to be enabled by owner.
* Added Multi-jump setting: amount of jumps is controlled by world owner.
* extra diagnostics views added to build mode also.

**VR Updates**

* Bugfix: Chat panel appearance
* Bugfix: VR keyboard being cutoff on login and ingame
* Addition of 'Home' button to wrist
* VR diagnostic view enabled and mode cycle button added to wrist

</details>

### 45.0.16 (1/16/24)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Improved avatar LOD 0 range to be further out. Note: Avatar requires a change to be saved in lookbook to take effect

**Backpack updates**

* Shop button added (just opens store for now)
* added sorting to desktop
* Added buttons to clear spawned backpack items to VR.
* added floating UI panel to VR mode

**Shader Updates**

* Shader list reordered for new shaders Fresnal, Diffract, Pixelize, Screenspace. to be grouped together as 'specialized shaders'
* Small shader updates and tweaks
* New Pixel + UV Anim shader.
* New Pixel + Alpha Mask shader.
* New Screenspace + UV Anim shader. Note: Screenspace shaders are in testing expect changes to be made and any items made with them to need tweaks.

</details>

### 45.0.14 (1/10/24)

<details>

<summary>Click to reveal patch notes</summary>

**Bugfix**

* Minor shader fixes.

**Shader changes**

* 'Fluid Distortion' wobble effect now also contributes to the diffraction in the 'Multibump + Diffraction' shader.
* New color blending checkbox on 'transparent' shaders adds better color blending from the albedo slot and provides richer color in darker areas

</details>

### 45.0.12 (1/9/24)

<details>

<summary>Click to reveal patch notes</summary>

**Bugfix**

* Fix for diffracted water not diffracting

**New Shaders Added**

* Standard+Emissive+Screenspace Shader added screenspace shader has the UV images remain aligned with the camera regardlessly of models movement

</details>

### 45.0.11 (1/9/24)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Added a media screen to backpack, will only show existing media in world does not contain a media script of its own

**Bugfix**

* Fix for "Standard + Emissive + Stereographic" shaders appearing blacked out.
* Small fixes and tweaks to the Pixelize and Fresnel shaders.

**New Shaders Added**

* New "Billboard + Pixelize" shader.
* New "Multibump + Diffraction" shader. (To create diffractive waves on water you need only upload a normal map with the waves or ripples you require)

</details>

### 45.0.9 (01/03/24)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Basejump from freecam location with 'T'
* Controller keybinds updates and fixes
* Diagnostics enabled in homespace

**Shader Updates**

* AO texture slots added to Opaque base shaders.
* Displacement added to "Billboard" shader.
* Bugfix for displacement texture accounting.

**New Shaders added**

* Fresnel ("Standard + Emissive + Fresnel" & "Standard Two Sided + Emissive + Fresnel")
* Pixelize ("Standard + Emissive + Pixelize" & "Standard Two Sided + Emissive + Pixelize") **Diffraction shaders:**
* "Standard + Diffraction + Alpha Mask"
* "Standard Two Sided + Diffraction + Alpha Mask"
* "Standard + Diffraction + Alpha Mask + UV Animation"
* "Standard Two Sided + Diffraction + Alpha Mask + UV Animation"

**Bugs Fixed**

* New bugs created enjoy finding them

</details>

### 45.0.8 (12/22/23)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Added new backpack items and item removal controls
* Increased intensity and range for point lights. They can now cover a 4km distance when maxed out.
* Added fire 🔥 to the chat emoticons
* HDR toggle without restarting the client
* No chat panel auto popup
* Enabled hand and head aiming when holding any object

**Shader Updates**

* 'After-images' effect is available for the "Emissive" and "Emissive + UV Animation" shaders. (Togglable effect per material with tuneable decay-rate)
* 'Fluid-distortion' affect added to the "Transparent + Multibump" shader.

**Bugs Fixed**

* Fix for arms rotating inappropriately when sitting in VR
* Increased server connection timeouts - affected some users with challenging builds

</details>

### 45.0.5 (10/10/23)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* A fix for the snapshot function creating SDR images that were too washed out when HDR is enabled.
* Fix for the harmless 'invalid format' error that showed up when importing new assets.
* Displacement aware depth shader for static and opaque+emissive shaders this fixes the shadowed versions of objects being left behind when displaced.
* bugfix for blank textures on two of the new shaders when going from edit mode to runtime

**Shader Updates**

* Fixes for some displacement bugs. It should also interact more accurately with some post and lighting effects.
* Add UV Scrolling function to the transmissive+multibump shader. Good for water.
* You can now specify negative values for the displacement scale numbers.
* Added 'Fix Shimmering' toggle to the alpha UV shaders.
* Added 'ClampUVs' toggle to the alpha UV shaders.
* Fix for an issue that caused coloured lines to erroneously appear around the edges of many existing alpha emissive materials.

</details>

### 45.0.1 (09/29/23)

<details>

<summary>Click to reveal patch notes</summary>

* Improved handling of HDR should only be visible with it enabled in pc settings
* Added many new emojis to in game chat
* Improved script debug logging
* Whitelist TupleElementNamesAttribute for scripting
* Minor bug fixes

</details>

### 45.0.0 (9/20/23)

<details>

<summary>Click to reveal patch notes</summary>

The Displacement Shader Update is here!

**General Updates**

* Added sorting to the scene list in 'deploy' menu
* FPS Max raised to 200 (settable)
* Greatly Increased AABB

**Shader Updates**

* Displacement shaders, and Vertex Animation system!
* UV rotation for texture maps
* Addition of 3 more two-sided shaders
* 'ClampUVs' option for flipbook shaders that fixes the problem of flip book frames repeating erroneously
* Fluid distortion effect added to UV anim shaders (wiggly textures)

**Settings Updates**

* Default mic mute state on launch (mute/unmute).
* Split render quality and render resolution into separate options.
* Allow setting render quality separately for VR and non-VR.
* FPS limiter controls (for both foreground and background).
* Selectable max texture VRAM usage per avatar. For crisper avatars, or reduced VRAM usage.
* Experimental HDR support. Togglable in settings. You must own an HDR monitor, and HDR must be enabled in Windows

**Bugs Fixed**

* Bugfix Thumbnails sometimes fail to load first time when viewing personal worlds list
* Crash fix when changing desktop audio device with VR disabled
* Crash fix for viewing the desktop controls overlay with VR disabled on launch
* BugFix Tiny avatar Ik sticking to over hanging surfaces
* A fix for the audio crackling and distortion that still occurs when minimizing on some machines
* Many other small crash fixes many removed gremlins.

</details>

### 44.3.0 (6/12/23)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* IJKL keyboard control for the camera. Helps players with no mouse
* Client directory file organization. Moved Dullahan to subfolders
* Add launch parameters to force specific VR runtime - OpenVR/Oculus
* Scriptable scoreboard alpha version
* Improved finger tracking for knuckles controllers
* Added two new emissive shaders
* New Tiny avatars!!!

**Bugs Fixed**

* Crash triggered by sitting in first person with VR disabled
* Crash triggered by accessing haptics when VR is disabled
* Memory leaks within JSON packed web service packets
* Fix for several build errors when targeting Linux
* Remove keyboard shortcut for diag panel in production builds
* Speech graphics scaling fixed at smaller avatar scales
* Crash when displaying a large amount of personal worlds
* Crash when de-serializing an invalid object
* Updated logo for spinning perfection
* Prevent media screen connections to \[try.sansar.com]
* Force v4 sockets by default

</details>

### 44.2.2 (2/12/23)

<details>

<summary>Click to reveal patch notes</summary>

Small fixit patch

* Fix for launching with VR mode disabled
* Fix for the border on the avatar info box volume control
* Fixed crash when using grip and trigger in VR

</details>

### 44.2.0 (2/19/23)

<details>

<summary>Click to reveal patch notes</summary>

**General update**

* Added TV Mode, Game Streaming Mode, and Guest Mode
* New TV Mode character control scheme
* VR keyboard typing improvements

**Bug Fixes**

* Reticle fix for the new UI scaling
* Avatar info panel UI scaling fix
* Login issue related to steam logins fixed

</details>

### 44.1.0 (2/3/23)

<details>

<summary>Click to reveal patch notes</summary>

**General Updates**

* Individual volume controls V1
* Doubled the maximum 3rd person camera distance
* Full body VR tracking improvements
* Added the ability to base64 encode launch parameters
* Updated the default worlds to the all-new Sansar Park!

**Bug Fixes**

* Avatar names displayed on top of UI panels
* Blocked people are visible when they use dual login
* Reduced the maximum grab distance in VR

</details>

### 44.0.0 (1/17/23)

<details>

<summary>Click to reveal patch notes</summary>

**Bug Fixes**

* Edit mode list type crash
* Edit mode Trigger Volume crash
* DST bug when editing existing events
* Prevent blocked users from unmuting each other
* Sansar crashes when renaming an object
* Recall searches in the Marketplace when going back
* Non-English system language fails to load Sansar
* Head deformation while dancing

**General Updates**

* New users should teleport to social hub
* Remove login Twitch + Steam registration (Client)
* Use the starting world chosen in settings when leaving the lookbook
* Disable keyboard shortcuts for simulation in the lookbook
* Prevent usage of F1 shortcut while in Cinema Mode
* Improve Xbox controller functionality
* Support for non-parallel projection VR lenses
* Create a keyboard shortcut to hide UI
* CTRL+H hides/unhides UI
* UI Scaling for large resolutions

</details>

### 43.5.5 (6/16/22)

<details>

<summary>Click to reveal patch notes</summary>

Small update for VR arm bug

</details>

### 43.5.0 (6/7/22)

<details>

<summary>Click to reveal patch notes</summary>

Small Update for re-enable Auto-Occlusion in Edit Mode

</details>

### 00.00.00 (00/00/00)

<details>

<summary>Click to reveal patch notes</summary>

**Bug Fixes**

**General Updates**

</details>

***
