63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
# Overte Domain Authentication
|
|
|
|
## Running with Authentication
|
|
|
|
The Stardust-Overte client now supports domain authentication. Use one of the following methods:
|
|
|
|
### Method 1: Interactive Script
|
|
```bash
|
|
./run_with_auth.sh
|
|
```
|
|
This will prompt you for username and password.
|
|
|
|
### Method 2: Environment Variables
|
|
```bash
|
|
OVERTE_USERNAME="your_username" OVERTE_PASSWORD="your_password" ./build/stardust-overte-client
|
|
```
|
|
|
|
### Method 3: Export Variables
|
|
```bash
|
|
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**:
|
|
```bash
|
|
ps aux | grep domain-server
|
|
sudo ss -ulnp | grep domain-server
|
|
```
|
|
|
|
3. **Test with simulation mode first**:
|
|
```bash
|
|
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
|