From 1067cbe825e18274b541ecc42317f8f6c20dd4d3 Mon Sep 17 00:00:00 2001
From: MayaTheShy <MayaTheShy@gmail.com>
Date: Sun, 9 Nov 2025 00:27:09 -0500
Subject: [PATCH] docs: clarify domain discovery usage and add note on public
 server queries

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 193c5f6..59a8f41 100644
--- a/README.md
+++ b/README.md
@@ -56,12 +56,14 @@ export STARWORLD_BRIDGE_PATH=./bridge/target/release
 ./build/starworld ws://domain.example.com:40102
 ```
 
-Or use domain discovery:
+Or use domain discovery to find public servers:
 ```bash
 export STARWORLD_BRIDGE_PATH=./bridge/target/release
 ./build/starworld --discover
 ```
 
+**Note:** Discovery queries https://mv.overte.org/server/api/v1/places and finds 500+ public Overte domains. However, the protocol handshake with live servers is still under development. Use simulation mode for testing features.
+
 ## Architecture
 
 ```