64 lines
3.4 KiB
Markdown
64 lines
3.4 KiB
Markdown
# MetaCrate compatibility deviations
|
|
|
|
This file records intentional differences from the C# LibreMetaverse source. Preserve or
|
|
re-evaluate these changes when importing a newer upstream version.
|
|
|
|
## Bounded login appearance recovery
|
|
|
|
- A successful login now consumes `AgentSettings.send_appearance`, initializes the shared
|
|
`AppearanceManager`, and starts one generation-fenced appearance request after the simulator is
|
|
ready.
|
|
- Self `AvatarAppearance` acknowledgements are accepted as complete only when required baked
|
|
texture IDs, visual parameters, and the expected COF version are present. Transient failures use
|
|
bounded delayed forced rebakes; disconnects and simulator changes cancel stale work.
|
|
- COF attachments are compared with simulator child prims by `AttachItemID`; only missing items are
|
|
restored through the existing attachment API. Non-secret structured recovery events expose the
|
|
bake path, counts, serial, retries, acknowledgement, and elapsed time.
|
|
- Baked-texture capability responses are decoded as LLSD, as required by the simulator protocol,
|
|
instead of incorrectly treating their uploader and completion maps as JSON.
|
|
|
|
Files: `src/network_manager.rs`, `src/appearance_manager.rs`, `src/asset_manager.rs`.
|
|
|
|
## OpenSim varregion dimensions
|
|
|
|
- `GridRegion` retains the optional `MapBlockReply.Size` dimensions. Missing or zero dimensions
|
|
fall back to 256 x 256 metres.
|
|
- `Simulator::region_size()` exposes dimensions resolved after login and is marked `must_use`,
|
|
while the mapped public `size_x` and `size_y` fields remain unchanged for API compatibility.
|
|
- A matching map-region event updates the current simulator's resolved dimensions. Movement,
|
|
border prediction, terrain lookup, and terrain archive export use the resolved dimensions.
|
|
- The cache distinguishes explicit `Size` blocks from the 256 x 256 fallback. Startup waits for
|
|
an explicit size until timeout, and a later fallback reply cannot downgrade a resolved size.
|
|
- Region lookup no longer synthesizes the current simulator as a 256 x 256 `GridRegion`; it
|
|
requests the authoritative map block.
|
|
|
|
Files: `src/grid_manager.rs`, `src/network_manager.rs`, `src/agent_movement.rs`,
|
|
`src/asset_archive.rs`.
|
|
|
|
## Asynchronous region-reply correlation
|
|
|
|
- Name and handle lookups subscribe to the continuously dispatched `GridRegion` event stream
|
|
before sending a request.
|
|
- Each lookup accepts only the matching name or handle. Unrelated grid, object, avatar, or map
|
|
traffic cannot complete the request early.
|
|
- Cancellation and the mapped map-request timeout still bound the one-shot waiter.
|
|
- The default map-request timeout is 15 seconds rather than 5 seconds because OpenSim map
|
|
replies on the live varregion can arrive after 7-8 seconds during login.
|
|
|
|
Files: `src/grid_manager.rs`, `src/client_core.rs`.
|
|
|
|
## OpenSim asset transport fallback
|
|
|
|
- When the OpenSim asset capability returns no payload for an asset, the request falls back to
|
|
the existing UDP asset transfer path instead of reporting a missing asset immediately.
|
|
|
|
File: `src/asset_manager.rs`.
|
|
|
|
## Deterministic persistent-asset LRU
|
|
|
|
- Successful immutable asset-cache reads explicitly refresh the file modification timestamp.
|
|
Pruning uses that timestamp as its cross-platform LRU order instead of filesystem access time,
|
|
which can be disabled or coarsened by `noatime` and `relatime` mounts.
|
|
|
|
Files: `src/asset_cache.rs`, `src/asset_pipeline_semantics.rs`.
|