MapBlockRequest: Difference between revisions
Jump to navigation
Jump to search
Monty Linden (talk | contribs) Document request limits. |
|||
| (3 intermediate revisions by one other user not shown) | |||
| Line 3: | Line 3: | ||
<pre width=80> | <pre width=80> | ||
{ | { | ||
MapBlockRequest Low NotTrusted Unencoded | MapBlockRequest Low 407 NotTrusted Unencoded | ||
{ | { | ||
AgentData Single | AgentData Single | ||
| Line 23: | Line 23: | ||
</pre> | </pre> | ||
==Usage and Notes== | ==Usage and Notes== | ||
Used by | Used by the viewer to request region map data. The simulator responds with [[MapBlockReply]]. | ||
For simple requests, <code>Flags</code>, <code>EstateID</code>, and <code>Godlike</code> can be set to <code>0</code>. | |||
<code>MinX</code>, <code>MaxX</code>, <code>MinY</code>, <code>MaxY</code> are [https://wiki.secondlife.com/wiki/Coordinate#Grid_.28global.29_position grid coordinate] ranges. If you wanted to request a block of 4 regions near Da Boom, you might use: | |||
<pre> | |||
MinX = 1000 | |||
MaxX = 1001 | |||
MinY = 1000 | |||
MaxY = 1001 | |||
</pre> | |||
The resulting regions would be Da Boom, Freelon, Ritch, Minna. | |||
Requests are limited to a maximum of 300 grid positions and it is recommended to limit to 64 or fewer. Exceeding the maximum or supplying otherwise-invalid arguments results in the request being dropped. | |||
[[Category:Messages]] | [[Category:Messages]] | ||
Latest revision as of 08:52, 24 June 2026
Message Layout
{
MapBlockRequest Low 407 NotTrusted Unencoded
{
AgentData Single
{ AgentID LLUUID }
{ SessionID LLUUID }
{ Flags U32 }
{ EstateID U32 }
{ Godlike BOOL }
}
{
PositionData Single
{ MinX U16 }
{ MaxX U16 }
{ MinY U16 }
{ MaxY U16 }
}
}
Usage and Notes
Used by the viewer to request region map data. The simulator responds with MapBlockReply.
For simple requests, Flags, EstateID, and Godlike can be set to 0.
MinX, MaxX, MinY, MaxY are grid coordinate ranges. If you wanted to request a block of 4 regions near Da Boom, you might use:
MinX = 1000 MaxX = 1001 MinY = 1000 MaxY = 1001
The resulting regions would be Da Boom, Freelon, Ritch, Minna.
Requests are limited to a maximum of 300 grid positions and it is recommended to limit to 64 or fewer. Exceeding the maximum or supplying otherwise-invalid arguments results in the request being dropped.