区域场景编辑器

基于 tvt.js 与 OpenSpec 规范的区域场景编辑器,严格遵循软件项目宪法/设计准则,让 AI 能快速理解工程结构并辅助个性化二次开发,且同步 skill:tvt-js-plugin-builder

区域场景编辑器

基于 tvt.js 与 OpenSpec 规范的区域场景编辑器,严格遵循软件项目宪法/设计准则,让 AI 能快速理解工程结构并辅助个性化二次开发,且同步 skill:tvt-js-plugin-builder

预览截图

扫码小程序演示

预览页ID:1
预览页ID:2
预览页ID:3
预览页ID:4
预览页ID:5

插件安装

本插件为TVT.js平台深度定制开发的源码包,如需在其他平台集成使用,建议进行适配性调整以实现最佳兼容效果。

1、点击右侧插件包下载,得到: 'zone3Deditor.zip' , 并放在 `icegl-three-vue-tres/pluginMaker/install/`

2、请使用命令终端,自行定位到您电脑的目录

cd /icegl-three-vue-tres/

3、输入命里,安装插件

yarn plugin.marker install zone3Deditor

4、启动预览模式即可:

yarn pre.dev

插件介绍

首先当时是在线使用地址:

zone3deditor.icegl.cn


区域场景编辑器配套文档:

docs.icegl.cn/docs/three-vue-tres/zoneeditor/introduction.html


编辑器行业分析预览:

清晰版跳转 B站查看详情

编辑器简单概要:

清晰版跳转 B站查看详情

免费使用、免费预览、免费导入导出配置,以及按照自己得需求设计,引入自己得模型服务,编辑好后,免费导出插件源码进行二次开发。此编辑器的本体的源码是收费的,会不断更新,加入更多组件和落地更多场景。

有问题请联系我们,最好反馈到社区:https://www.icegl.cn/ask 我们会第一时间修复

此插件依赖 ViewportGizmo免费插件,提前安装好即可使用

QA:

1、在线使用导出插件包后,安装前也要检查是否存在 ViewportGizmo 插件,没有也请安装

2、1.6.2版本后,全面使用 localforage 替代 localStorage 【配置大小的原因】,所以请通过命令行安装 localforage 库

yarn add localforage



关于模型服务设置:


首先下载模型服务源码:

https://pan.quark.cn/s/eb755abf0f9c

此程序用于发布自己本地或远程模型的服务,是tvt区域编辑器[后续也支持其他编辑器]的配套。
目录参照如下:

models/  放置资源的根目录
      ----0游乐场  => 此为实例分类名,
            ----models   => 分类下的模型存放目录,目前只支持glb格式,后续增加其他格式
            ----previews => 分类下的预览图存放目录,和模型名称一一对应
启动命令:
# 安装依赖
yarn

# 生成配置文件.json
node generateModeServe.js -p ./models

# 发布服务
node generateModeServe.js -serve -p ./models -port 4000

此服务的最新源码都开源了,更新在:

https://gitee.com/ice-gl/tvt-model-manager-serve

使用方法一样,详见项目说明页


区域场景编辑器功能包含:

1、自有模型管理、以及自建模型服务

2、配置化引入tvt生态内的扩展物体

3、地面类型设设置

4、物体的拖拉拽、大小/位置/旋转,吸附碰撞、落地处理、复制/删除当前物体、模型动画

5、场景内物体和高级组件列表管理,属性管理

6、后期处理

7、天气以及日照设置

8、跟踪操作历史,上一步/下一步,以及快捷键 状态管理以及持久化

9、导入导出配置,同步编辑器状态

10、包含物体绑定事件交互代码编辑

11、根据自己得当前设计,导出自己得插件源码(包含插件源码包和场景中的模型压缩),方便您的二次开发

12、增加数据源的管理,以及绑定物体根据接口实现逻辑属性修改


区域场景编辑器配套文档:

https://docs.icegl.cn/docs/three-vue-tres/zoneeditor/introduction.html

2026-08-26 11:55:51
本次更新聚焦 编辑体验:模型与扩展物的旋转属性统一以角度显示、高级物体滑块支持数值框精调,并修复了预览模式下点击事件的延迟问题。

1旋转统一为角度制

  • 场景中选中模型 / 扩展物的旋转属性统一以 角度(°) 显示与编辑,范围 -180 ~ 180,直观易懂;
  • 内部自动完成角度 ↔ 弧度转换并归一化,与 TransformControls 变换手柄保持一致,历史记录、快照同步无误。

2、 滑块粗调 + 数值框精调

  • 高级物体的扩展属性滑块旁新增数值输入框:拖动滑块快速粗调,输入数值精确到小数;
  • 小数位数根据滑块 min/max/step 自动适配,编辑完成后正确写入历史快照,支持撤销。

▲ 物体属性面板:旋转以角度(°)显示,高级物体支持滑块 + 数值精调

3、 修复:预览模式点击延迟

  • 修复预览模式下模型 click 事件被一律延迟的问题:现在仅当该模型同时启用了双击事件时才延迟单击(用于区分双击),否则点击立即响应,交互更跟手。
2026-08-26 11:54:30
本次更新围绕 光影表现相机操控 两大方向:阴影设置全面升级为独立面板、相机支持速度调节与高精度目标点编辑、环境贴图新增天空盒显示与模糊度设置,让场景氛围与操控手感再上一个台阶。

▲ 区域场景编辑器整体界面

☀️ 阴影系统全面升级

新增独立的「阴影」设置面板,阴影相关参数从天气面板中拆出,集中管理:

  • 阴影强度:新增 0–1 强度滑块,一键调节明暗对比;
  • 阴影类型:支持 基础 / PCF / PCF 柔和 / VSM 四种阴影模式;
  • 精细参数:贴图分辨率(512–4096)、柔化半径、阴影偏移、法线偏移、投影范围、近/远裁剪面全部可调;
  • 地面接收器:统一由透明接收器显示投影,支持自定义颜色、透明度、尺寸与高度;
  • 旧配置兼容:历史阴影配置自动补齐缺省参数,升级后无需重新配置。

2、相机操控增强

  • 目标位置可编辑:相机属性面板中目标点支持 UI 展示与直接修改,并实时同步 OrbitControls;内部采用渲染后同步 + 变化检测 + 相机/目标点重合保护,消除响应式回写抖动;
  • 操控速度设置:新增平移、旋转、缩放三项速度参数,范围 0.01–10,手感随心调;
  • 高精度保存:相机位置、目标点及正交缩放提升至 8 位小数精度,小尺度场景操作不再丢失细节;
  • 近裁剪面突破:透视相机近裁剪面最低支持 0.000001,微观尺度观察无压力;
  • 完整接入管线:速度参数已纳入历史记录、配置导入与导出插件,旧配置自动采用原默认值。

3、 天空盒与环境同步

  • 新增「显示为天空盒」开关,环境贴图可一键切换为天空盒背景;
  • 新增天空盒模糊度设置(0–1),营造柔和氛围感;
  • 环境贴图与天空盒类型统一选择、双向同步,配置一并纳入历史记录。
2026-08-06 09:56:51
  1. 2026-05-06—05-13配置与扩展组件兼容基线

    补充扩展属性文本组件适配,完善双击添加提示,归并 v3.0.1 配置、依赖和预览入口。

  2. 2026-07-13素材服务上线

    区域场景编辑器获得素材读取、搜索、分类、预览和上传能力。

  3. 2026-07-14—07-16材质工作台首次接入

    建立独立材质页面、插件集成桥、多模型节点树、贴图资源、环境贴图和格式兼容能力。

  4. 2026-07-23—07-24保存、导入和历史链路重构

    加入保存回执、失败回滚、导入问题处理、材质专用历史、双击选择和节点槽位兼容。

  5. 2026-07-27—07-30复制删除一致性与源码交付

    复制和删除模型同步维护材质绑定,首次加载更稳定,并支持携带材质运行时和资源导出源码插件包。

  6. 2026-08-02—08-05贴图能力收尾并升级 v4.0.0

    增加 Alpha 与 Mipmap 控制,补齐授权说明、生态入口和界面细节。


整体打通了材质编辑器 的协同同步,让整体场景的渲染表达拉高了一个档次。

材质编辑器相关说明详见:docs.icegl.cn/docs/three-vue-tres/material-editor/introduction.html

2026-04-23 16:13:56

1、fix: 优化了 导出 基于外层canvas的 雨、闪电、雪的组件

2、feat: 增加 基于开源混元高斯导出的SPZ 高级组件(优化效率和参数)

3、feat: 预览部分:增加了 底部按钮组的功能: 显示帧率、显示视口助手(viewportGizmo)、导入goview配置

4、feat: 预览部分:增加了 人物漫游弹窗设置并实现和场景内物体的碰撞

5、update: 预览部分:实现了人物漫游和场景内物体的碰撞(以及高斯溅射物体的碰撞)

2026-04-14 19:26:54
1、优化了高斯溅射的高级组件以及剔除范围
2、针对 3d-tiles-renderer 增加了 KTX2Loader 压缩材质的库 、 lod裁切的设置
3、增加了 检测到旧版 glTF 1.0 b3dm 数据,当前运行时不支持直接加 提示 is3DTilesetJson 地址的检查
4、左侧动态组件服务 默认让它进页面就载入https://dcser.icegl.cn服务
5、优化 高级组件物体的 渲染顺序的逻辑
6、重新实现 下雨和下雪的实现闪电的效果
7、优化 波纹地板 、冰面、橡胶地板、圆板
2026-04-03 10:33:12
✅1、高级物体增加 可被选中的设置
✅2、增加了动态组件的 按钮触发事件的功能
✅3、符合 tvt.js 基于openspec的软件项目宪法、设计、准则、规范,让AI快速理解源码,迭代自己个性化需求二次开发
✅4、同步了 skill : tvt-js-plugin-builder
✅5、增加了 液态金属 材质
✅6、双击右侧场景内物体列表,跳转到物体视角

2026-03-04 16:40:09

1、增加了所有高级组件加载完毕的入口

2、基础版环境贴图组件、本地化贴图,导出插件后部署更灵活

3、增加了 数据源功能,可绑定物体,随接口更改物体属性

2026-01-28 10:31:50

1、优化动态组件的展示UI
2、优化了描述以及增加了国产化支持说明
3、新增了 动态组件的树的高级封装、以及三种火焰的组件

2026-01-20 12:20:30
1、fix: 调整 默认相机 远近 的属性 ,防止近距离显示有缺失
2、fix: 默认 不开启环境纹理光

3、feat: 增加全套组件化后期处理:桶模糊、发光、亮度对比度、色像差、颜色平均、颜色深度、景深、点状、鱼眼、网格、色相饱和度、油画、镜头畸变、油毡浮雕、噪声、像素化、扫描线、棕褐色、移轴、暗角

2026-01-09 16:51:26

1、fix: 修复摄像头target的目标指向未保存同步的问题

2、动态组件服务是tvt生态下的一套组件发布与调试方案
支持将自研或第三方组件动态接入在线编辑器,自动获得编辑器能力
并可导出源码用于离线部署和二次开发。

3、其余小部分优化

2025-12-23 08:15:45

1、增加 高级组件:动态旋转基座 

2、增加 高级组件:雷达样式A和雷达样式B

3、增加 高级组件:自定义水材质组件

4、增加 材质组件中:溶解材质类型 

5、增加 高级组件:卡通能量圈

6、增加 高级组件:花纹圈动画

2025-12-08 18:16:37

1、增加 海洋波浪 高级组件


2、fix :默认 环境贴图 开关 和 0.6的强度设置
3、增加免费开源场景:编辑器直出海洋船运可视化



2025-12-02 14:53:23
1、fix: 优化摄像头的设置的默认值,减少模型材质闪烁问题

2、feat: 增加了 滚动箭头高级组件

3、fix: 修改默认可拖动模型的范围
2025-11-19 16:29:55
1、fix: 高级物体的阴影同步问题

2、feat: 增加了 环境贴图 的设置功能

2025-11-11 17:36:33
fix: 复制高级组件后,当前选中还是原来的组件
fix: 粒子底座更改参数后,不能积极的同步更改属性
feat:导出项目后,自动截图预览
2025-11-04 14:57:43

1、新增图形合集组件:

2、新增3D字体高级组件:

3、修复普通物体的事件绑定兼容性问题

2025-10-22 10:55:34

1、新增物体的事件绑定功能,直接绑定函数,进行交互,可预览交互、导出配置、以及导出源码再次开发


2、增加色彩映射方式和映射强度的管理

2025-10-16 11:19:41
1、升级到tvt.js新版本V5
2、优化代码逻辑以及提高运行效率
2025-09-22 15:35:23

1、增加两个地面效果高级组件

2、增加splat 高斯溅射高级组件

3、fix 替换 domUI的 组件 ,crypto.randomUUID() 方法,增强兼容性

4、fix 优化高级组件 统一配置文件:extendMeshListConfig.js

5、fix: 解决 Naive UI 的异步waring问题 在NDialogProvider 组件中

2025-09-16 10:08:43
1、feat 全面使用 localforage 替代 localStorage 【配置大小的原因】
2、fix 透明材质的透明度检测问题
3、fix 相机实时同步双向绑定的卡顿
4、feat 增加高级组件: 拓扑底座、svg组件、精灵图片、矩形线边框、箭头线组件

5、fix 没有模型在场景中 那么默认首页加载完毕

6、新增免费源码案例:

https://opensource.icegl.cn/#/#zoneFreeScene

2025-09-11 12:41:53

1、增加免费案例:

https://opensource.icegl.cn/#/#zoneFreeScene

2、优化高级组件:RoundedBox镜面

3、新增和优化了伸缩管线的组件

4、优化左侧模型服务配置的tab滚动提示

5、增加了摄像头类型的切换,正交和透视摄像头

6、增加键盘监听删除 del按键

7、优化了精灵图文字组件



2025-09-05 10:39:50

1、feat 增加了倾斜摄影的组件

2、feat 更新了goview组件大版本,且支持了vchart

3、fix 优化了精灵图文字组件

2025-08-29 10:53:15

1、高级组件 增加了白膜组件

2、优化配置 高级组件管理

2025-08-20 09:45:16

1、增加了移动端的简单展示编辑器的案例

2、增加了模型配置检查的界面提示

3、解藕 standardizationMeshCopy 函数到基座公共函数,解决导出插件缺失的bug

4、优化了dom的组件功能

2025-08-11 16:58:15

1、增加关于版本号的显示 

2、增加高级围栏组件 

3、增加粒子底座 

4、增加dom面板的代码组件 

5、增加网格底座的配置 

6、增加快速导入例子配置的功能

2025-08-05 16:37:26

1、更新了模型管理器、增加了自动模型尺寸的配置

2、重构了模型模型管理导入导出等,保留了动画效果,配置动画播放和速度

3、更新了演示模版,增加动画的展示


2025-07-23 11:25:56

增加了地板样式:冰面

2025-07-04 15:45:34
fix: 光照强度 和 阴影的参数 导出在插件配置中
fix:导出模型过多后,命名重复的问题
feat: 增加了 矩形的渐变色 组件
fix: 优化模型在标准化时 节点为mesh且还带child的问题

fix: 优化左侧模型管理菜单,模型过多,滚动条的展示

2025-06-07 20:31:26

1、修复模型转化后的 基本坐标参数丢失问题 

2、增加了光照强度 以及 阴影模糊的选项 

3、增加了 伸缩管线 组件 

4、静态水,方块地板,弧度边的长方体 

5、增加了 RoundedBox镜面 赶紧 免费 体验吧

2025-05-19 16:37:17

测试完毕,并上架插件

优化物体选择和拖动的逻辑

版本正持续更新和优化,期待更多功能吧