OpenSimulator · EN

OpenSim.ini, Estates.ini and estate storage

Detailed OpenSimulator 0.9.3.1 explanations based on INI templates and source code.

Your deployment may organize schemas and files differently. Always inspect actual loaded settings. Never edit SQL data directly without a backup.

DefaultEstateName

In OpenSim.ini, [Estates] DefaultEstateName is consulted by OpenSimBase during initial setup when a region lacks a usable estate relationship. The resulting estate name is stored in estate_settings. Editing the file does not automatically rename an existing estate.

DefaultEstateOwnerName and DefaultEstateOwnerUUID

These settings are used when SetUpEstateOwner resolves or creates the owner account. The account and authentication data belong to user services, usually ROBUST in Grid mode; the owner's UUID is stored in estate_settings.EstateOwner.

DefaultEstateOwnerEMail and DefaultEstateOwnerPassword

These values can supply details for creating the owner account. They are not two matching columns in estate_settings. Account and login information belongs to user services. Never publish real passwords.

DefaultEstate settings do not overwrite existing estates

A region already linked to an estate reads persistent settings through EstateDataService. DefaultEstate* values mainly support initial setup or necessary creation. To change existing owners or mappings, use supported administration mechanisms.

TargetEstate and estate_map

OpenSimBase can read TargetEstate from Regions.ini and call EstateDataService.LinkRegion during association. MySQLEstateData persists the mapping in estate_map with RegionID and EstateID. It does not rewrite RegionStore objects.

Estates.ini and EstateID

EstateLoaderFileSystem reads Estates.ini definitions, checks existing estates and can create them via EstateDataService. Example EstateID=0 requests an automatically allocated identifier; explicit IDs must meet version constraints.

EstateStore tables

EstateStore migrations create estate_settings, estate_map, estate_managers, estate_users, estate_groups and estateban. estate_settings includes EstateID, EstateName and EstateOwner. These tables may live in a dedicated schema or be remotely served.

Shared estates across simulators

GridCommon.ini.example offers EstateConnectionString to share storage directly, or remote EstateDataRemoteConnector with EstateServerURI. On ROBUST, EstateDataRobustConnector must be enabled for the second approach. The SQL schema name alone does not identify the setup.

Intentionally commented lines. These values support initial setup and do not replace estate_settings or the owner's account records.

; OpenSim.ini : valeurs d'initialisation
[Estates]
; DefaultEstateName = Mon estate
; DefaultEstateOwnerName = Prenom Nom
; DefaultEstateOwnerUUID = 00000000-0000-0000-0000-000000000000
; DefaultEstateOwnerEMail = owner@example.org
; DefaultEstateOwnerPassword = EXEMPLE

Other guides in this section

OpenSimulator 0.9.3.1 source files