ShadowEditor开源三维场景编辑器:功能详解与使用指南

2024-11-30 李腾 392 次阅读 0 次点赞
ShadowEditor是一款基于Three.js、Go语言和MongoDB构建的免费开源三维场景编辑器,支持桌面版和Web版双平台运行。它封装了Three.js的核心功能,提供所见即所得的编辑体验,用户可直观搭建三维场景并导出静态文件,便于部署到各类HTTP容器。本文涵盖项目简介、下载编译步骤、用户界面说明、脚本使用方法、开发指南及常见问题解答,为开发者提供从入门到二次开发的完整技术文档。

ShadowEditor是基于Three.js、Go语言和MongoDB的免费开源的三维场景编辑器,支持桌面版和Web版。它封装了Three.js的很多功能,支持使用所见即所得的方式搭建三维场景,支持导出静态文件,部署到各种http容器上。

常用地址

ShadowEditor是完全免费开源的,可以在github、gitee等平台上找到它的所有源码。

github源码:https://github.com/tengge1/ShadowEditor

gitee源码:https://gitee.com/tengge1/ShadowEditor

在线演示:https://www.hylab.cn/shadoweditor/

相关文档

这是ShadowEditor的相关文档,你可以找到下载编译、基本使用和二次开发相关文档。

项目简介

下载编译

用户界面

脚本使用

开发指南

其他

软件截图

scene20200301.jpg

常见问题

这些是用户在使用过程中遇到的一些问题,如果你在使用过程中遇到了其他问题,欢迎留言反馈。

1、上传模型失败。

需要把模型贴图等资源压缩成一个zip包,而且入口文件不能嵌套文件夹。服务端会解压上传的zip包到./build/public/Upload/Model文件夹,并在MongoDB _Mesh表里添加一条记录。

2、如何将多个模型组合在一起?

基本几何体都支持多层嵌套。可以添加一个组(在几何体菜单中),然后在场景树状图上,将多个模型拖动到组上。

3、如何开启权限系统?

编辑config.toml文件,将authority.enabled设置为true。默认管理员用户名是admin,密码是123456。

4、前端报asm.js 已被禁用,因为脚本调试程序已连接。请断开调试程序的连接,以启用 asm.js。的错误。

完整错误:asm.js 已被禁用,因为脚本调试程序已连接。请断开调试程序的连接,以启用 asm.js。 ammo.js (1,1) SCRIPT1028: SCRIPT1028: Expected identifier, string or number ShadowEditor.js (3948,8) SCRIPT5009: 'Shadow' is not defined。

解决方法:腾讯浏览器不支持使用Emscripten编译的ammo.js(WebAssembly),建议换成谷歌浏览器或火狐浏览器。

5、怎么从C#版本升级到golang版本?

数据结构和客户端都没变,只需要把文件夹./ShadowEditor.Web/Upload/复制到build/public/Upload/即可。

6、桌面版打不开。

说明:Windows需要Visual C++ Redistributable for Visual Studio 2015。你可以从这安装:https://www.microsoft.com/en-us/download/details.aspx?id=48145

说明:如果桌面版打不开,可以查看logs.txt;如果端口冲突,可以修改resources/app/config.toml中的MongoDB和网站端口。

本文由人工编写,AI优化,转载请注明原文地址: ShadowEditor:基于Three.js的开源三维场景编辑器,支持Web与桌面版

评论 (3)

登录后发表评论
小雨滴2025-11-14 11:21:16
这个编辑器太棒了!正好在找一个能免费搭建3D场景的工具,感谢作者开源分享!请问Web版对性能要求高吗?
超腾开源2025-11-14 19:19:58
性能不高
夜空中最亮的星2025-11-13 16:24:19
这个三维场景编辑器太棒了!感谢作者开源,正好在找类似工具,准备试试Web版。