---
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! 🌈🎉