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

=== Constructor and Config Loading ===

 UserAgentServiceBase(IConfigSource config)

Config is read in two layers; [UserAgentService] overrides [DatabaseService]:

{| class="wikitable"
! Section !! Key !! Default !! Notes
|-
| [DatabaseService] || StorageProvider || (none) || DLL name -- fallback
|-
| [DatabaseService] || ConnectionString || (none) || DB connection string -- fallback
|-
| [UserAgentService] || StorageProvider || (inherited) || Overrides [DatabaseService]
|-
| [UserAgentService] || ConnectionString || (inherited) || Overrides [DatabaseService]
|-
| [UserAgentService] || Realm || hg_traveling_data || Table name
|}

Throws if StorageProvider is empty or plugin cannot be loaded. Loaded plugin stored as m_Database (IHGTravelingData).

 UserAgentService(IConfigSource config, IFriendsSimConnector friendsConnector)

[UserAgentService] section is required -- throws if absent. All static fields initialized once (m_Initialized flag).

friendsConnector argument is always assigned to m_FriendsLocalSimConnector if non-null, even on subsequent instantiations (bypasses the m_Initialized guard).

Services loaded from [UserAgentService]:

{| class="wikitable"
! Key !! Interface !! Required
|-
| GridService || IGridService || Yes -- throws if empty
|-
| GridUserService || IGridUserService || Yes -- throws if empty
|-
| GatekeeperService || IGatekeeperService || Yes -- throws if empty
|-
| FriendsService || IFriendsService || No
|-
| PresenceService || IPresenceService || No
|-
| UserAccountService || IUserAccountService || No
|}

Additional config:

{| class="wikitable"
! Section !! Key !! Default !! Notes
|-
| [UserAgentService] || BypassClientVerification || false || If true, VerifyClient() always returns true
|-
| [UserAgentService] || LevelOutsideContacts || 0 || Minimum UserLevel to be visible to foreign grids via GetUUID()
|-
| [UserAgentService] || ShowUserDetailsInHGProfile || true || If false, user_flags/user_created/user_title return zeros in GetUserInfo()
|-
| [UserAgentService] || ForeignTripsAllowed_Level_N || (none) || Per-level bool: whether users at that level may visit foreign grids
|-
| [UserAgentService] || AllowExcept_Level_N || (none) || Per-level comma-separated grid URLs exempt from ForeignTripsAllowed=true
|-
| [UserAgentService] || DisallowExcept_Level_N || (none) || Per-level comma-separated grid URLs exempt from ForeignTripsAllowed=false
|-
| [Startup]/[Hypergrid]/[UserAgentService] || GatekeeperURI || (none) || This grid's external URL; also tries ExternalName in [UserAgentService] then [GatekeeperService]
|}

GatekeeperURI is resolved via DNS at startup. m_MyExternalIP stores the resolved IP for NAT detection in VerifyClient(). Throws if URI cannot be parsed or hostname cannot be resolved.

m_Database.DeleteOld() is called at the end of constructor to purge stale travel records.

----