Starworld/OVERTE_AUTH.md

Overte Domain Authentication

Running with Authentication

The Stardust-Overte client now supports domain authentication. Use one of the following methods:

Method 1: Interactive Script

./run_with_auth.sh

This will prompt you for username and password.

Method 2: Environment Variables

OVERTE_USERNAME="your_username" OVERTE_PASSWORD="your_password" ./build/stardust-overte-client

Method 3: Export Variables

export OVERTE_USERNAME="your_username"
export OVERTE_PASSWORD="your_password"
./build/stardust-overte-client

Configuration

• OVERTE_USERNAME: Your Overte domain username
• OVERTE_PASSWORD: Your Overte domain password or access token
• OVERTE_UDP_PORT: Domain server UDP port (default: 40104)
• STARWORLD_SIMULATE: Set to "1" to enable simulation mode with demo entities

Troubleshooting

If you're not receiving entities:

1. Check authentication: Make sure you've set up a user account in the Overte domain web interface (http://localhost:40102/settings/)

2. Check domain server is running:

   ps aux | grep domain-server
   sudo ss -ulnp | grep domain-server
   

3. Test with simulation mode first:

   STARWORLD_SIMULATE=1 ./build/stardust-overte-client
   

4. Check for connection denied messages in the output

Protocol Implementation Status

✅ Domain connection handshake ✅ Authentication (username/password) ✅ DomainList request/response ✅ EntityServer discovery ✅ EntityQuery packets ✅ Entity Add/Edit/Erase parsing ⏳ Full property parsing (position, rotation, dimensions) ⏳ Octree-based spatial streaming ⏳ Avatar mixer integration ⏳ Audio mixer integration