{"id":46070562,"url":"https://github.com/zackbrooks84/virtual","last_synced_at":"2026-03-01T13:13:48.626Z","repository":{"id":325193692,"uuid":"1093889119","full_name":"zackbrooks84/virtual","owner":"zackbrooks84","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-20T04:00:43.000Z","size":79,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"claude/continue-work-01SWJjG4woJQquvNgVtM598f","last_synced_at":"2025-11-20T04:08:59.114Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zackbrooks84.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-11T01:21:29.000Z","updated_at":"2025-11-20T04:00:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zackbrooks84/virtual","commit_stats":null,"previous_names":["zackbrooks84/virtual"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/zackbrooks84/virtual","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackbrooks84%2Fvirtual","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackbrooks84%2Fvirtual/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackbrooks84%2Fvirtual/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackbrooks84%2Fvirtual/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zackbrooks84","download_url":"https://codeload.github.com/zackbrooks84/virtual/tar.gz/refs/heads/claude/continue-work-01SWJjG4woJQquvNgVtM598f","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zackbrooks84%2Fvirtual/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29969898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T12:56:10.327Z","status":"ssl_error","status_checked_at":"2026-03-01T12:55:24.744Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-01T13:13:48.021Z","updated_at":"2026-03-01T13:13:48.620Z","avatar_url":"https://github.com/zackbrooks84.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖖 Holodeck VR Experience\n\nA Star Trek-inspired virtual reality world built with WebXR and Three.js. Experience the magic of a holodeck with immersive 3D environments you can explore in VR or on your desktop.\n\n## Features\n\n### Core Holodeck Experience\n- **Authentic Holodeck Grid**: Classic Star Trek holodeck wireframe environment with glowing cyan grid lines\n- **Ambient Particles**: Floating holographic particles that give the space an otherworldly feel\n- **Multiple Simulated Environments**: Switch between 5 different holodeck programs\n\n### Environments (Programs)\n\n1. **Forest** 🌲 - A peaceful woodland with trees and natural ground\n2. **Space Station** 🚀 - Experience the void of space with stars and a distant planet\n3. **Ocean Beach** 🏖️ - Relaxing beach scene with water and sand\n4. **Ancient Temple** 🏛️ - Mysterious temple with columns and an altar\n5. **Futuristic City** 🌆 - Cyberpunk-style cityscape with metallic buildings\n\n### Controls\n\n#### Desktop Mode\n- **Click screen**: Lock pointer to enable controls\n- **Mouse**: Look around (while pointer is locked)\n- **W/A/S/D**: Move forward/left/backward/right\n- **1-5**: Load holodeck programs (Forest, Space, Beach, Temple, City)\n- **0 or ESC**: Return to empty grid room\n\n#### VR Mode\n- **Trigger**: Teleport/Select\n- **Grip**: Grab objects\n- **Thumbstick**: Move around\n- **Head Movement**: Look naturally around the environment\n\n## Getting Started\n\n### Quick Start (No Installation Required)\n\n1. Simply open `index.html` in a web browser\n2. You'll start in the empty holodeck grid room\n3. **Click the screen** to lock your pointer, then use WASD to move and mouse to look around\n4. Press **1-5** to load different holodeck programs\n5. Press **0 or ESC** to return to the empty grid room\n6. Or click \"ENTER VR\" for VR mode\n\n### For VR Experience\n\n**Requirements:**\n- VR headset (Meta Quest, Valve Index, HTC Vive, etc.)\n- WebXR-compatible browser:\n  - **Meta Quest**: Built-in browser\n  - **Desktop**: Chrome, Edge, or Firefox with WebXR support\n\n**Steps:**\n1. Open `index.html` in your VR headset's browser or on desktop\n2. Click the \"ENTER VR\" button\n3. Put on your headset and start exploring!\n\n### Local Development Server\n\nFor best results, serve the files through a local web server:\n\n```bash\n# Using Python 3\npython -m http.server 8000\n\n# Using Node.js (http-server)\nnpx http-server -p 8000\n\n# Using PHP\nphp -S localhost:8000\n```\n\nThen visit: `http://localhost:8000`\n\n## Technology Stack\n\n- **Three.js** - 3D graphics library\n- **WebXR** - Virtual reality API for the web\n- **Vanilla JavaScript** - No framework dependencies\n- **ES6 Modules** - Modern JavaScript module system\n\n## Browser Compatibility\n\n| Browser | Desktop Support | VR Support |\n|---------|----------------|------------|\n| Chrome | ✅ | ✅ |\n| Edge | ✅ | ✅ |\n| Firefox | ✅ | ⚠️ (Limited) |\n| Safari | ⚠️ (No WebXR) | ❌ |\n| Meta Quest Browser | N/A | ✅ |\n\n## Architecture\n\n### Main Components\n\n- `index.html` - Entry point with UI and WebXR setup\n- `holodeck.js` - Main application logic\n  - `Holodeck` class - Core VR experience manager\n  - Scene management - Dynamic environment loading\n  - Controller handling - VR controller and desktop input\n  - Animation loop - Render and update cycle\n\n### Key Features Implementation\n\n**Holodeck Grid Environment:**\n```javascript\n- Floor and ceiling grids using THREE.GridHelper\n- Wireframe walls with cyan accent lighting\n- Floating holographic particles\n```\n\n**Scene System:**\n```javascript\n- Modular scene creation functions\n- Dynamic loading/unloading\n- Easy to add new environments\n```\n\n**VR Controller Support:**\n```javascript\n- Dual controller tracking\n- Visual feedback rays\n- Select and grip interactions\n```\n\n## Customization\n\n### Adding New Scenes\n\nAdd a new scene to the `createScenes()` method in `holodeck.js`:\n\n```javascript\nthis.scenes.push(() =\u003e {\n    const group = new THREE.Group();\n\n    // Add your 3D objects here\n    const myObject = new THREE.Mesh(\n        new THREE.BoxGeometry(1, 1, 1),\n        new THREE.MeshStandardMaterial({ color: 0xff0000 })\n    );\n    group.add(myObject);\n\n    return group;\n});\n```\n\n### Customizing the Grid\n\nModify the `createHolodeckGrid()` method to change:\n- Grid size and divisions\n- Grid colors\n- Particle count and behavior\n- Wall opacity and patterns\n\n## Performance Optimization\n\n- Shadows are enabled but can be disabled for better performance\n- Particle count can be reduced in `createHolodeckGrid()`\n- Scene complexity can be adjusted per environment\n- Automatic LOD (Level of Detail) can be added for complex models\n\n## Troubleshooting\n\n**VR Button Not Appearing:**\n- Ensure you're using HTTPS or localhost\n- Check if your browser supports WebXR\n- Verify VR headset is connected\n\n**Poor Performance:**\n- Reduce particle count\n- Disable shadows in renderer setup\n- Lower grid divisions\n- Simplify scene geometry\n\n**Desktop Controls Not Working:**\n- Click on the canvas to enable pointer lock\n- Check browser console for errors\n- Ensure JavaScript is enabled\n\n## Future Enhancements\n\nPotential features to add:\n- [ ] Voice commands for program selection\n- [ ] Object interaction and physics\n- [ ] Multiplayer support\n- [ ] Save/load custom programs\n- [ ] Advanced teleportation system\n- [ ] Hand tracking support\n- [ ] Spatial audio\n- [ ] Custom model loading (GLTF/FBX)\n- [ ] Program randomization\n- [ ] Time of day controls\n\n## Credits\n\nInspired by Star Trek's iconic holodeck technology. Built as a demonstration of modern WebXR capabilities.\n\n## License\n\nMIT License - Feel free to use and modify for your own projects!\n\n---\n\n**\"Computer, run program holodeck-1\"** 🖖\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzackbrooks84%2Fvirtual","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzackbrooks84%2Fvirtual","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzackbrooks84%2Fvirtual/lists"}