From e8770b5e7e9a563adbbf80fea20f9ab577db8a62 Mon Sep 17 00:00:00 2001
From: MayaTheShy <MayaTheShy@gmail.com>
Date: Sun, 9 Nov 2025 02:51:06 -0500
Subject: [PATCH] docs: enhance troubleshooting section with additional
 connection verification steps

---
 README.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 4479abd..15f4c45 100644
--- a/README.md
+++ b/README.md
@@ -319,10 +319,13 @@ This allows you to:
 - Verify RPATH: `ldd build/starworld`
 
 ### "Could not connect to Overte"
-- Verify server URL/port
-- Check network connectivity
-- Try `--discover` to find public domains
+- Verify domain server is running: `ps aux | grep domain-server`
+- Check UDP port: `sudo ss -ulnp | grep 40104`
+- Verify network connectivity: `ping <domain-host>`
+- For remote domains, check firewall/NAT port forwarding
+- Try local domain first: `--overte=127.0.0.1:40104`
 - Use simulation mode: `export STARWORLD_SIMULATE=1`
+- Check domain server logs for connection attempts
 
 ### Nothing renders in VR
 - Check Stardust server logs for errors