|
1 | | -# BBMG-EXPORTER |
| 1 | +# 🚀 BBMG EXPORTER |
| 2 | + |
| 3 | +**BBMG EXPORTER** is a fully interactive 3D web-based visualization project that showcases a custom-built mech vehicle designed using **Three.js**. It simulates a futuristic war machine equipped with high-tech parts, advanced tires, boosters, and weapons — all viewable in a smooth 3D interface. |
| 4 | + |
| 5 | +🔗 **Live Demo:** [https://nsstudio-html.github.io/BBMG-EXPORTER/](https://nsstudio-html.github.io/BBMG-EXPORTER/) |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## 🌟 Features |
| 10 | + |
| 11 | +- 🔄 Real-time 3D interaction (rotate, zoom) |
| 12 | +- ⚙️ Detailed sci-fi/mech vehicle components |
| 13 | +- 🎮 Game-ready design and layout |
| 14 | +- 📱 Mobile and desktop friendly |
| 15 | +- 🚀 WebGL powered using Three.js |
| 16 | + |
| 17 | +--- |
| 18 | + |
| 19 | +## 📸 Preview |
| 20 | + |
| 21 | + |
| 22 | +> *(Replace with the actual image path if your repo uses a different name.)* |
| 23 | +
|
| 24 | +--- |
| 25 | + |
| 26 | +## 🧰 Technologies Used |
| 27 | + |
| 28 | +- **HTML5** |
| 29 | +- **CSS3** |
| 30 | +- **JavaScript** |
| 31 | +- **Three.js** (WebGL 3D rendering) |
| 32 | + |
| 33 | +--- |
| 34 | + |
| 35 | +## 📁 Folder Structure |
| 36 | + |
| 37 | +BBMG-EXPORTER/ ├── index.html # Main HTML file ├── style.css # Styling for layout/background ├── script.js # 3D logic using Three.js ├── assets/ │ ├── model.glb # 3D model (GLB/GLTF format) │ └── preview.jpg # Image preview used in README |
| 38 | + |
| 39 | +--- |
| 40 | + |
| 41 | +## 🚀 How to Run |
| 42 | + |
| 43 | +### Option 1: View Online |
| 44 | +Just open the [Live Demo](https://nsstudio-html.github.io/BBMG-EXPORTER/) in any browser. |
| 45 | + |
| 46 | +### Option 2: Run Locally |
| 47 | + |
| 48 | +1. Clone the repo: |
| 49 | + ```bash |
| 50 | + git clone https://github.com/NSSTUDIO-html/BBMG-EXPORTER.git |
| 51 | + cd BBMG-EXPORTER |
| 52 | + |
| 53 | +2. Open index.html in any modern browser (Chrome, Firefox, Edge). |
| 54 | + |
| 55 | + |
| 56 | + |
| 57 | + |
| 58 | +--- |
| 59 | + |
| 60 | +🔧 Controls |
| 61 | + |
| 62 | +🖱️ Mouse Drag / Touch Move – Rotate the model |
| 63 | + |
| 64 | +🔍 Scroll / Pinch – Zoom in/out |
| 65 | + |
| 66 | + |
| 67 | + |
| 68 | +--- |
| 69 | + |
| 70 | +💡 Use Cases |
| 71 | + |
| 72 | +Game asset previews |
| 73 | + |
| 74 | +Portfolio 3D model viewer |
| 75 | + |
| 76 | +AR/VR concept showcase |
| 77 | + |
| 78 | +Interactive storytelling interface |
| 79 | + |
| 80 | + |
| 81 | + |
| 82 | +--- |
| 83 | + |
| 84 | +👤 Author |
| 85 | + |
| 86 | +Naga Sasank (NSSTUDIO-html) |
| 87 | +🔗 GitHub Profile |
| 88 | + |
| 89 | + |
| 90 | +--- |
| 91 | + |
| 92 | +📜 License |
| 93 | + |
| 94 | +This project is licensed under the MIT License. You are free to use, modify, and share it for personal and commercial purposes. |
| 95 | + |
| 96 | + |
| 97 | +--- |
| 98 | + |
| 99 | +📝 Notes |
| 100 | + |
| 101 | +To replace the model, upload your .glb or .gltf file to the assets/ folder and update script.js accordingly. |
| 102 | + |
| 103 | +For better performance, compress models using tools like gltf-transform. |
| 104 | + |
| 105 | + |
| 106 | + |
| 107 | +--- |
0 commit comments