Skip to content

Commit 482db13

Browse files
Update README.md
1 parent 092cede commit 482db13

1 file changed

Lines changed: 107 additions & 1 deletion

File tree

README.md

Lines changed: 107 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,107 @@
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+
![BBMG Preview](https://nsstudio-html.github.io/BBMG-EXPORTER/assets/preview.jpg)
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

Comments
 (0)