<img src="https://editor.astraljs.com/static/images/logo/logo.png" width="30" height="30"> Astral 3D Editor

🌍 简体中文 | English

直达：

基于 Vue3 + Three.js 的现代 Web 3D 编辑器

<div align="center"> <img src="http://editor-doc.astraljs.com/images/home/thumbnailDark.png?t=20250518" width="800" alt="Editor City Preview"> <img src="http://editor-doc.astraljs.com/images/home/industryDark.png?t=20250318" width="800" alt="Editor Preview"> </div>

💬 加入社区

通过以下方式获取最新动态和技术支持：

| |
|---------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | <img src="https://fs.mhbdng.cn/temp/4851677b-661d-4e60-884d-414316290425.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=6TE7OKPZN15R380TGT1V%2F20260111%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260111T135452Z&X-Amz-Expires=3600&X-Amz-Security-Token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJwYXJlbnQiOiJtbHQxMzEyMjAiLCJleHAiOjE3NjgxODExNTV9.RAvlAnLKtG-9rNIZMrO5lrSJc_N1VqHf3yF3-slD59b-miNqdorqsI9Zmaz6_imBe_uw1u5KMt_OGE7No-vxfA&X-Amz-Signature=4868484133727ab3881d0f7eb65a52db07ee91bc154b4bf4b88d19a91446188e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" width="200"> | <img src="https://fs.mhbdng.cn/temp/c1c7ecef-d655-4bb3-97e8-54402e3a48ef.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=6TE7OKPZN15R380TGT1V%2F20260111%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260111T135514Z&X-Amz-Expires=3600&X-Amz-Security-Token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJwYXJlbnQiOiJtbHQxMzEyMjAiLCJleHAiOjE3NjgxODExNTV9.RAvlAnLKtG-9rNIZMrO5lrSJc_N1VqHf3yF3-slD59b-miNqdorqsI9Zmaz6_imBe_uw1u5KMt_OGE7No-vxfA&X-Amz-Signature=7005038e2ded3dbad425f6a23341002bf79c3ffe9f2166af18348dcaeb61dca0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" width="200">

🚀 核心能力

核心功能

• ✅ 多格式支持：30+ 模型格式（GLTF/OBJ/FBX/GLB/RVT/IFC等）
• ✅ BIM模型轻量化展示（RVT/IFC）
• ✅ CAD图纸解析（DWG/DXF）
• ✅ 场景分包存储与加载
• ✅ 动画编辑器

扩展能力

• 🧩 插件系统
• 📜 脚本运行时
• 💫 粒子系统
• ❄️ 天气系统
• ☁️ 云存储集成（又拍云 USS）
• 🎠 资源中心

即将到来

• 🚧 物理引擎支持
• 🚧 WebGPU 支持
• 🚧 数据组件（API/WebSocket）
• 🚧 低代码数据大屏
• 🚧 WebSocket 多人协作

🛠️ 技术栈

⚡ 快速开始

前置需求

• Node.js ≥ 23.11.x
• PNPM

本地运行

    git clone https://github.com/mlt131220/Astral3D.git

    cd Astral3D
    pnpm install
    pnpm run sdk:build
    pnpm run editor:dev

生产构建

    pnpm run editor:build

📚 生态相关

后端实现

文档中心

☕ 支持项目

如果本项目对您有帮助，欢迎：

1. 在 用户案例墙 留下您的使用场景
2. 扫码支持开发者：

| 支付宝 | 微信 | |---------------------------------------------------------------------------|------------------------------------------------------------------------------| | <img src="https://editor-doc.astraljs.com/images/AliPay.png" width="200"> | <img src="https://editor-doc.astraljs.com/images/WeChatPay.png" width="200"> |

⚖️ 许可协议

本项目采用 开源协议，使用时请遵守协议条款及以下补充条款：

• ✅ 允许：个人学习/二次开发
• ⚠️ 需要版权声明
• ⚠️ 商业用途需要授权
• ❌ 禁止：将本项目用于与杭州星孪数字科技有竞争性的业务或非法用途

完整法律声明 | 贡献指南

🌟 Star 趋势