3D-AFrame-VR / README.md
awacke1's picture
Update README.md
9e7cb97 verified
---
title: ๐ŸŒ3D-AFrame๐ŸŽฎVR
emoji: ๐ŸŒ๐ŸŽฎ
colorFrom: indigo
colorTo: yellow
sdk: streamlit
sdk_version: 1.45.0
app_file: app.py
pinned: false
license: mit
---
# ๐ŸŒ3D-AFrame๐ŸŽฎVR: Your Ultimate Virtual Reality Playground! ๐Ÿš€
Welcome, future VR explorers! Get ready to dive into a world where AI meets 3D in an epic virtual reality adventure.
This app, powered by Aframe, is your ticket to creating, manipulating, and exploring 3D objects in a dynamic, sunlit environment.
Let's break down how this magic happens!
## ๐ŸŽฎ Game Instructions
### Level 1: Entering the VR World
1. ๐Ÿ“ Choose your starting point: Enter the directory path in the sidebar.
2. โฌ†๏ธ Summon your 3D objects: Use the uploader to add files (obj, glb, webp, png, mp4).
3. ๐ŸŒŸ Watch as your objects come to life, bouncing and rotating in the 3D space!
### Level 2: Mastering the Controls
- ๐Ÿ–ฑ๏ธ Left-click and drag: Move objects around like a VR wizard!
- ๐ŸŽฎ WASD keys: Navigate the 3D space like a pro gamer.
- ๐Ÿ–ฒ๏ธ Mouse wheel: Zoom in and out for epic close-ups or panoramic views.
- ๐Ÿ–ฑ๏ธ Right-click and drag: Rotate the view and discover new angles.
### Level 3: Illuminating Your World
- ๐ŸŒž Three magical light sources move around, creating a dynamic sunny environment.
- ๐ŸŽจ Golden, coral, and turquoise lights dance around, bringing your objects to life!
## ๐Ÿง  Behind the Scenes: How It All Works
1. **File Upload and Processing:**
- The app scans your chosen directory for 3D files.
- New files are encoded and added to the A-Frame scene.
2. **3D Object Creation:**
- Each file becomes a 3D entity with random initial position and rotation.
- Objects are given bouncing behavior for extra coolness!
3. **Dynamic Lighting:**
- Three moving light sources are created using the `moving-light` component.
- They move within bounds, creating a realistic, ever-changing illumination.
4. **User Interaction:**
- The `draggable` component allows you to click and move objects.
- Camera controls (both UI buttons and WASD keys) let you explore the space.
5. **Scene Rendering:**
- All elements are combined into an A-Frame scene.
- The scene is embedded in the Streamlit app for seamless integration.
## ๐Ÿš€ Power-Ups and Special Features
- **AI Integration:** Claude 3.5 Sonnet is your AI companion, ready to assist with 3D creation and manipulation.
- **Real-time Updates:** The scene updates in real-time as you add or move objects.
- **Cross-Platform:** Works on various devices, bringing VR to everyone!
## ๐Ÿ† Challenge Mode
Can you create a complex 3D scene with multiple objects, perfectly lit and arranged? Show off your VR design skills and share your creations!
Ready to start your 3D-VR-AI adventure? Jump in and let your imagination run wild in this AI-powered virtual playground! ๐ŸŒˆ๐ŸŽ‰