From OpenSimulator

Revision as of 13:22, 4 December 2021 by Ubit (Talk | contribs)

Jump to: navigation, search


See last code changes at Dev (git master)

Note: Due to the development work, this may be in bad state. Use with care



Also see Release Notes

Known Issues

Region handling of region environment changed to a unified system.
Previous versions had LightShare and WindLight running side by side, each with own data store and communication protocols, occasionally with conflicting results.
New viewers introduce extended environment features, so now uses a internal representation more suitable for those new features. This new representation is automatically converted to and from LightShare or Windlight as needed.
Region code will inform older viewers about parcels environment but not per altitude environment.

  • LightShare no longer has its own communications protocol. This was already obsolete, so no point on asking viewer developers to keep supporting it. As consequence of this, some viewers may no longer detect region side changes either done by other users or scripts. This also includes changes on entering or leaving a parcel with own environment. (Firestorm or Dayturn will see changes, singularity will not, for example). So LightShare is now a scripting feature only. It only supports its original subset of environment parameters. New replacement methods may be added in future, turning it definitely obsolete.

How the region environment will look on screen is still very dependent on the particular viewer model, version or graphics options and keeps changing, for the same set of parameters, But a major difference, that environment designers need to consider, is between viewers with the new features and previous versions versions with just Windlight.
Perfect conversion is of course not possible, and may give bad results.

  • New region environment should be created with the extended features editor, but tested with other viewers, in particular older versions, users may still use.
  • Asset 3a367d1c-bef1-6d43-7595-e88c1e3aadb3 must be checked if it is a true transparency texture, if not it must be replaced by the provided new one. Must also be removed from any retained current regions cache (at bin/assetcache/3a3)(or see console command fcache deletedefaultassets or even fcache cachedefaultassets) and viewers cache. Then make sure viewers login to an updated grid/region. The copy provided on previous versions was not a true transparency texture.
  • The default script engine is now YEngine. If you have problems with scripts, fix them. If you can not fix them then change opensim.ini default engine back to XEngine, set Enable to false on [YEngine] and Enable to true on [XEngine]


OpenSimulator requires:

  • At least .NET Framework 4.6 when running under Windows.
  • At least Mono 5.x when running under Mono (Linux or Mac).

Due to database migration renumbering which occurred at release, if you are upgrading from a version of OpenSimulator prior to, then you MUST first upgrade to ** and then proceed to upgrade directly to See for more advice.

.NET Framework 4.8 (and Visual Studio 2019) experimental support is provided via runprebuild19.exe or runprebuild19.sh.

Changes and Fixes


Many, many thanks to all the developers (and their cats), testers and community members who contributed to this release and who help out with OpenSimulator generally. Your hard work makes this all possible.

Personal tools
About This Wiki