RaguOS: Module Based SpaceServer Frontend for OpenSimulator

“Ragu” is the code name for a SpaceServer that makes an OpenSimulator grid/region available to a Basil Viewer. This document describes the implementation of RaguOS which is a set of OpenSimulator region modules that convert and presents region contents so it fits into the Herbal System.

Because of the limitations of the OpenSimulator region content format, the region must be converted before use. This conversion provides:

This conversion is done by the Loden region module.

Once the region contents have been converted, RaguOS acts as a SpaceServer to a Basil Viewer to display and interact with the region’s contents.

Choice of Region Modules

These routines (RaguOS, Loden, etc.) were created as OpenSimulator region modules because:

Two options for making them separate programs would be to either:

The major advantage of separate programs is not requiring the rebuilding of the regions simulator with the Loden and RaguOS modules. This is a great advantage for acceptance of the Basil Viewer by the OpenSimulator community.


[Loden] 1 converts an OpenSimulator’s region’s contents into formats useful to a Basil viewer (GLTF, JPEG, …) organized into a hiearchical spacial structure of increasing displayable detail. This does not replace the OpenSimulator’s asset store but is a displayable version of the region assets.

Loden organizes the region assets into four different “layers”. These are displayed together by a Basil Viewer to present a complete view of the region. Each of the layers is organized into a tree of spacial areas with increasing level-of-detail. The tree representation is modeled after the CesiumJS project’s 3DTiles. 3DTiles defines bounding boxes of objects of some level-of-detail that also has “children” of sub-bounding boxes that define objects of increased detail. The process is for a viewer to start at the top of the tree and work down the tree to find the appropriate level-of-detail for the viewer resolution, view distance, and camera location.

To that end, it is envisioned that Loden will convert a region into a tree that includes a top level of the whole OpenSimulator region as one mesh (for distance viewing) and then sub-areas of the region containing ever increasing level-of-detail of the assets. The construction of the tree will depend on the type of scene objects.

Region Content Layers

As mentioned above, Loden separates the region scene objects into four classes that make up layers for the Basil Viewer. These layers are:

Static Layer

The initial implementation will replace the whole region, single mesh with a single GLTF that describes the whole region’s contents. The second level will be a quad division of the region. Initially, the divisions will be of equal size but future versions will split the region until there is an equal number of scene objects in each division.

The quad divisions will each be increasing level-of-detail until the lowest level will have scene object versions that are visually nearly identical to the underlying OpenSimulator primitives. Depending on ease of implementation, each level may split into other quad divisions.

Top level: region as one GLTF with reduced mesh detail and texture Top-1: region split into four sub-regions each as one GLTF Top-2: quads with linksets merged into one mesh with texture atlases Top-3: quads with meshes with reduced complexity and textures reduced to 100ppm Top-4: quads with meshes at full prim detail and textures full size

Each level and quad will have a unique, content-based hash supplied with the GLTF file that is used to decide whether to build that level/quad after any content changes.

Dynamic Layer

Actors Layer

Editing Layer

Level of Detail Computation

As stated in the 3DTiles documentation:

A tile’s geometric error defines the selection metric for that tile. Its value is a nonnegative number that specifies the error, in meters, of the tile’s simplified representation of its source geometry. The root tile, being the most simplified version of the source geometry, will have the greatest geometric error. Then each successive level of children will have a lower geometric error than its parent, with leaf tiles having a geometric error of or close to 0.

((Description of the level-of-detail specification.))

Division Hash

((SHA256 hash of object characteristics and location of all objects in ?? order))

Texture Simplification

((Textures reduced in resolution based on in-world size))

((Texture types being JPEG (compression factor??) or PNG if texture contains transparancy))

((Texture atlas??))

Editing Mode

Asset Storage and Access

((How assets are stored and how the HTTP server is set up to allow access to them))

((Access control))

Region Description Assets

((Description of the JSON files created for region root information))


Editing Mode

Description of RaguOS operation

Revision History

Legal Stuff

This document is covered by Creative Commons Attribution-NonCommercial 4.0 International.

Since every idea in the world is covered by a patent somewhere, I make no claims as to the ownership or availability of any design or concept described above.

[^1] LLLP: “Linden Lab Legacy Protocol”. The combination of TCP and UDP communications used by all OpenSimulator grids and Third Party Viewers.

  1. The “loden” name is a play on “LOD” or level-of-detail as to level-of-detail’en a region.