Main Page

OpenSimulator Internals

This wiki documents the internal architecture of OpenSimulator for developers and contributors. It covers the database schema, service architecture, connector design, and code structure. Written from code and verified against developer discussion -- where the wiki and the code disagree, the code takes priority.

Maintained by Jagga Meredith. Contributions welcome.

---

Source Repository

https://github.com/opensim/opensim

Only the master branch is active. All other branches are dead.

---

Overview

OpenSimulator has two main components:

ROBUST.exe -- handles grid-wide services: user accounts, inventory, assets, presence, and region registration. Multiple simulators connect to a single ROBUST instance.

OpenSim.exe -- runs one or more regions. Handles objects, avatars, physics, scripting, and terrain. In standalone mode both processes are combined into OpenSim.exe.

The database layer is split to match: ROBUST owns the grid database, each simulator owns its own region database. Both live in the same database server instance as separate databases.

In standalone mode the connector calls the service directly in-process. In grid mode it makes an HTTP call to ROBUST. Same interface either way.

---

Contents

• OpenSimulator Internals/Architecture Overview
• OpenSimulator Internals/Reading the Code
• OpenSimulator Internals/ROBUST Services
• OpenSimulator Internals/Connector Architecture
• OpenSimulator Internals/Code Map
• OpenSimulator Internals/Databases
• OpenSimulator Internals/Data Dictionaries
• OpenSimulator Internals/Useful Queries
• OpenSimulator Internals/Walkthroughs

---

Status

This document is a work in progress developed from code review and developer meeting notes. Where the existing wiki disagrees with the source code, the source code takes priority. Discrepancies are noted.

Contributors: Jagga Meredith Contributors: Jagga Meredith