OpenSimulator · EN

Hypergrid troubleshooting: symptoms and diagnostics

Teleport immediately refused · Teleport begins but avatar gets stuck

General OpenSimulator documentation: exact behavior depends on versions and grid configuration. Never modify production databases or services without backups and diagnosis.

Teleport immediately refused

Check destination URI, DNS, travel policies, Gatekeeper and service availability. Read home and destination logs before changing INI settings.

Teleport begins but avatar gets stuck

If negotiation succeeds but arrival fails, check the region's advertised address, UDP port, firewalls and NAT. A successful TCP test does not prove UDP connectivity.

Unable to return home

Examine HomeURI, UserAgentService, DNS and the home destination region. If home services are unavailable, the account is not necessarily lost. Check logs on both sides.

Missing textures and inventory

Distinguish a missing inventory reference, unavailable remote asset, denied permission and slow local rendering. Check AssetServerURI and logs before clearing Firestorm cache.

Pending friendship or offline status

Extra confirmation upon returning home can be normal. Check HGFriends services on both grids, URIs, reciprocal records and logs. Foreign online status has limitations; do not force FriendsStore records with SQL.

Prepare a useful incident report

Record date, time, home grid, destination grid, region names, versions and exact viewer error. Share selected log excerpts after redacting passwords, tokens and other sensitive data.

Explore more Hypergrid guides

Source code and documentation