Editing OpenSimulator Internals/Connector Architecture/UserAgent Connector (section)

=== XML-RPC Methods ===

{| class="wikitable"
! Method !! XmlRpc method !! Returns !! Notes
|-
| GetHomeRegion(userID, out position, out lookAt) || "get_home_region" || GridRegion || Parses full GridRegion from Hashtable; returns null on failure
|-
| IsAgentComingHome(sessionID, thisGridExternalName) || "agent_is_coming_home" || bool || Via GetBoolResponse()
|-
| VerifyAgent(sessionID, token) || "verify_agent" || bool || Via GetBoolResponse()
|-
| VerifyClient(sessionID, token) || "verify_client" || bool || Via GetBoolResponse()
|-
| LogoutAgent(userID, sessionID) || "logout_agent" || void || Calls GetBoolResponse() but discards result
|-
| GetUserInfo(userID) || "get_user_info" || Dictionary<string,object> || All non-null Hashtable entries returned
|-
| GetServerURLs(userID) || "get_server_urls" || Dictionary<string,object> || Only SRV_-prefixed keys returned; "SRV_" prefix stripped
|-
| LocateUser(userID) || "locate_user" || string || Returns hash["URL"] or empty string
|-
| GetUUI(userID, targetUserID) || "get_uui" || string || Returns hash["UUI"] or empty string
|-
| GetUUID(first, last) || "get_uuid" || UUID || Throws on missing or unparseable UUID response
|-
| StatusNotification(friends, userID, online) || "status_notification" || List<UUID> || [Obsolete]; friends sent as friend_0, friend_1...; returns online UUIDs
|-
| GetOnlineFriends(userID, friends) || "get_online_friends" || List<UUID> || [Obsolete]; same encoding as StatusNotification
|}

GetHomeRegion() field parsing: uuid, x, y, size_x, size_y, region_name, hostname, http_port, server_uri, internal_port, position, lookAt. All fields checked for null before parsing. Missing fields silently use zero/default values.

GetServerURLs() strips the "SRV_" prefix from keys, returning just the service type name.

GetUUID() throws on failure -- the only method in this connector that throws instead of returning a sentinel value.

----