Hypergrid troubleshooting: symptoms and diagnostics
Teleport immediately refused · Teleport begins but avatar gets stuck
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
- Hypergrid installation and configuration
- Principles and architecture
- Visitor identity
- Cross-grid teleports
- Networking and ports
- Inventory and assets
- Hypergrid friends
- Security