Files
Starworld/third_party/README.md

36 lines
1.1 KiB
Markdown

# Third-Party Crates
To enable deeper integration and inspection of StardustXR client behavior, place local clones of the following repositories here:
- `asteroids/` (https://github.com/StardustXR/asteroids)
- `core/` (https://github.com/StardustXR/core) — provides fusion client elements
Recommended structure:
```
third_party/
asteroids/
core/
```
After cloning, you can update `bridge/Cargo.toml` to use `path` dependencies instead of `git` to ensure reproducible builds and easier iteration:
```
[dependencies.stardust-xr-asteroids]
path = "../third_party/asteroids"
[dependencies.stardust-xr-fusion]
path = "../third_party/core"
```
Then run:
```bash
cargo update
cargo build -p stardust_bridge
```
This lets us:
- Inspect and modify client crate code during debugging
- Pin exact revisions without relying on remote branches
- Potentially implement custom elements or expose more C ABI hooks
If you prefer not to vendor the crates, please confirm the exact commit SHAs you want pinned and we can lock them in `Cargo.toml` instead of the moving `dev` branch.