Editing OpenSimulator Internals/Simulator Services (section)

== Land Service ==

'''Interface:''' <code>ILandService</code> (OpenSim.Services.Interfaces)<br>
'''Config key:''' <code>LandServices</code>

=== Purpose ===

Retrieves parcel land data by region handle and coordinates. Used when a simulator
needs land data for a region it does not itself host -- for example, to resolve
access rules at a region border before a crossing completes.

=== Interface ===

<code>ILandService</code> exposes a single method:

 LandData GetLandData(UUID scopeID, ulong regionHandle, uint x, uint y, out byte regionAccess)

=== Connectors ===

{| class="wikitable"
|-
! Connector !! Class !! Used when
|-
| Local || <code>LocalLandServicesConnector</code> || Destination region is hosted by this simulator. Walks the local scene list, matches by world coordinates, returns <code>LandData</code> plus access level and dwell count.
|-
| Remote || <code>RemoteLandServicesConnector</code> || Destination region is on another simulator. Tries local first; falls back to HTTP call via <code>LandServicesConnector</code> base class.
|}

=== Notes ===

* The local connector iterates <code>m_Scenes</code> and matches by world coordinate
  bounds, not by region UUID. This matters for varregions where a single scene
  covers a range of coordinates.
* Dwell count is retrieved via <code>IDwellModule</code> if present; not part of
  the core land data.
* Returns <code>null</code> if no local scene matches and no remote call is
  configured.

----