Editing OpenSimulator Internals/Code Map/OpenSim (section)

=== Region Creation ===

 OpenSim/Region/Application/OpenSimBase.cs -- CreateRegion()

Called once per region on startup, and again on restart. Sequence:

# Gets IRegionModulesController from ApplicationRegistry -- fatal exit if missing
# Sets region ServerURI from ExternalHostName and HTTP port
# Calls SetupScene() -- creates AgentCircuitManager and Scene instance (see Scene below)
# Calls controller.AddRegionToModules(scene) -- loads all region modules
# Verifies required permissions modules are loaded if SecurePermissionsLoading = true -- fatal exit if missing
# Calls scene.SetModuleInterfaces() -- wires up module references
# Calls SetUpEstateOwner() if estate has no owner -- prompts console interactively
# Calls scene.loadAllLandObjectsFromStorage() -- loads parcels from region database
# Calls scene.LoadPrimsFromStorage() -- loads all objects from region database
# Adds RegionStatsSimpleHandler to MainServer
# Calls scene.RegisterRegionWithGrid() -- registers with ROBUST GridService -- fatal exit on failure
# Calls scene.CreateScriptInstances() -- starts script engine for loaded objects
# Adds scene to SceneManager
# Hooks scene.EventManager.OnShutdown

Estate owner setup (SetUpEstateOwner()):
* Checks [Estates] config for DefaultEstateOwnerName, UUID, email, password
* If not found, prompts console interactively
* If user does not exist and UserAccountService is a local service, creates the user account
* Stores estate settings with owner UUID

PopulateRegionEstateInfo():
* Loads estate settings for region from database
* If no estate assigned: checks TargetEstate in Regions.ini, then DefaultEstateName in [Estates] config, then prompts console interactively
* Can create a new estate or join an existing one

----