Editing OpenSimulator Internals/Code Map/ROBUST/LoginService (section)

=== FindDestination() ===

 protected GridRegion FindDestination(...)

Resolves startLocation to a GridRegion. Returns null if no region can be found. Sets out parameters: gatekeeper, where ("home"/"last"/"url"/"safe"), position, lookAt, flags.

startLocation values:

"home":
* Uses guinfo.HomeRegionID -- returns home region if found
* Falls back to GridService.GetDefaultRegions()[0] (where = "safe")
* Falls back to FindAlternativeRegion() (where = "safe")
* Returns null if nothing found

"last":
* Uses guinfo.LastRegionID -- returns last region if found, clamps position within region bounds
* Falls back to default regions, then FindAlternativeRegion()

URI form (uri:RegionName&x&y&z):
* Parsed by compiled Regex: ^uri:(?<region>[^&]+)&(?<x>\d+[.]?\d*)&(?<y>\d+[.]?\d*)&(?<z>\d+[.]?\d*)$
* If region name contains '@': direct HG login -- explicitly rejected ("no longer supported"), returns null. The original implementation is present but commented out.
* Otherwise: GridService.GetRegionByName(), falls back to defaults, then FindAlternativeRegion()

FindAlternativeRegion():
* Tries GetFallbackRegions() near coordinate 1000,1000
* If AllowLoginFallbackToAnyRegion: tries GetOnlineRegions() near 1000,1000 (up to 10)
* Returns null if nothing found

----