OpenSimulator · EN

Regions.ini and region tables

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.

RegionUUID: the persistent identity

RegionInfo reads RegionUUID from Regions.ini. Scene storage uses it to find objects, terrain, parcels and RegionStore settings. Editing it without migrating records can make a region appear empty.

Location and GridStore

Location places a region on the grid map. Registration with ROBUST's Grid service stores a region descriptor in GridStore, but does not store all scene prims there.

InternalAddress, InternalPort and ExternalHostName

These settings describe simulator network connectivity and its advertised address. They differ from ConnectionString, which points to scene data. Wrong ports or addresses can block access without losing SQL records.

Key RegionStore tables

MySQL RegionStore migrations create tables including prims, primshapes, primitems, terrain, land, landaccesslist, regionsettings, regionenvironment and spawn_points. Multiple regions can share those tables and be distinguished by UUID.

TargetEstate: creation-time only

Regions.ini.example says TargetEstate can select an estate during initial creation and is ignored afterwards. The actual mapping is stored in estate_map in the estate database. Editing TargetEstate alone does not move an existing region between estates.

An INI is not a region backup

Regions.ini contains startup and networking definitions, not full persistent objects, terrain or permissions. Moving a region requires coordinated handling of RegionUUID, RegionStore, estate_map, GridStore, assets and configuration.

Fictional Regions.ini: RegionUUID identifies scene data; TargetEstate is used for initial assignment.

[Ma Region]
RegionUUID = 11111111-2222-3333-4444-555555555555
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
ExternalHostName = example.org
; TargetEstate = 0

Other guides in this section

OpenSimulator 0.9.3.1 source files