http://osimdev.org/wiki/index.php?action=history&feed=atom&title=OpenSimulator_Internals%2FCode_Map%2FROBUST%2FGridService_RegisterRegion 2026-08-04T16:56:06Z Revision history for this page on the wiki MediaWiki 1.45.3 http://osimdev.org/wiki/index.php?title=OpenSimulator_Internals/Code_Map/ROBUST/GridService_RegisterRegion&diff=57&oldid=prev 2026-07-07T11:44:27Z

<p>first</p> <p><b>New page</b></p><div>= OpenSimulator Internals/Code Map/ROBUST/GridService RegisterRegion =<br /> <br /> == RegisterRegion ==<br /> <br /> Source: OpenSim/Services/GridService/GridService.cs<br /> <br /> Validation sequence:<br /> <br /> # RegionID must not be zero UUID<br /> # RegionLocY must be above Constants.MaximumRegionSize (coordinates below this are reserved for HG links)<br /> # Overlap check: queries m_Database.Get() for the bounding box. Fails if more than one overlap, or one overlap with a different RegionID<br /> # Reservation check: existing record with Reservation flag rejects if PrincipalID is zero UUID, otherwise treated as an authentication request<br /> # Authenticate flag check: verifies token via m_AuthenticationService.Verify(), 30-second window<br /> # Duplicate name check (if AllowDuplicateNames = false): rejects if another region has the same name with a different RegionID<br /> # Move check: if the region was previously registered at different coordinates, checks NoMove and LockedOut flags before deleting the old entry<br /> # Applies DefaultRegionFlags from config, then per-region overrides by name or UUID (ParseFlags, supports +/- syntax)<br /> # Sets RegionOnline flag unconditionally<br /> # Stores via m_Database.Store() with last_seen timestamp<br /> <br /> Returns empty string on success, an error message string on failure. Scene.RegisterRegionWithGrid() throws an Exception if the returned string is non-empty -- this is a fatal startup error in OpenSimBase.CreateRegion().<br /> <br /> ----<br /> <br /> == DeregisterRegion ==<br /> <br /> ```<br /> public bool DeregisterRegion(UUID regionID)<br /> {<br /> RegionData region = m_Database.Get(regionID, UUID.Zero);<br /> if (region == null)<br /> return false;<br /> ```<br /> <br /> # Looks up the region by UUID, scope zero. Returns false if not found.<br /> # Reads current flags.<br /> # If !m_DeleteOnUnregister OR the region has the Persistent flag set: clears the RegionOnline flag, updates last_seen, calls Store(). Returns true.<br /> # Otherwise: calls m_Database.Delete(regionID) and returns the result.<br /> <br /> Called from Scene.Close() during simulator shutdown, and from the deregister region id console command on ROBUST.<br /> <br /> ----<br /> <br /> == See Also ==<br /> <br /> * [[OpenSimulator Internals/GridService]]<br /> * [[OpenSimulator Internals/Code Map/ROBUST]]<br /> * [[OpenSimulator Internals/Databases]]</div>

Jwbshaw