# vis-three

**Repository Path**: Shiotsukikaedesari/vis-three

## Basic Information

- **Project Name**: vis-three
- **Description**: A web 3D development framework for assembled based on three.js
- **Primary Language**: TypeScript
- **License**: MPL-2.0
- **Default Branch**: main
- **Homepage**: https://shiotsukikaedesari.gitee.io/vis-three
- **GVP Project**: No

## Statistics

- **Stars**: 244
- **Forks**: 100
- **Created**: 2021-11-10
- **Last Updated**: 2025-09-04

## Categories & Tags

**Categories**: 3d-engine

**Tags**: webgl, TypeScript, Pnpm, Threejs, Vue

## README

<p align="center">
  <a href="https://vis-three.github.io" target="_blank" rel="noopener noreferrer">
    <img width="180" src="/rm/logo.png" alt="vis-three logo">
  </a>
  <p align="center">A web 3D development framework for assembled based on three.js</p>

</p>
<br/>
<p align="center">
   <img alt="NPM" src="https://img.shields.io/npm/l/vis-three?color=blue">
   <img alt="version" src="https://img.shields.io/badge/version-0.7.X-g.svg">
   <img alt="three" src="https://img.shields.io/badge/three.js-0.167.1-g.svg">
   <br/>
    <a target="_black" href="https://space.bilibili.com/3048588">
      <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.bilibili.com%2Fx%2Frelation%2Fstat%3Fvmid%3D3048588&query=%24.data.follower&suffix=%20Follower&logo=bilibili&logoColor=%23fff&label=%20&labelColor=%23FB7299&color=%233F454F
      " alt="bilibili-follower" />
    </a>
    <a target="_black" href="https://gitee.com/Shiotsukikaedesari/vis-three">
      <img src="https://gitee.com/Shiotsukikaedesari/vis-three/badge/star.svg?theme=dark" alt="gitee-starts" />
    </a>
    <a target="_black" href="https://github.com/Shiotsukikaedesari/vis-three">
      <img alt="github-starts" src="https://img.shields.io/github/stars/Shiotsukikaedesari/vis-three?style=social">
    </a>
    <a target="_black" href="https://github.com/Shiotsukikaedesari/vis-three">
      <img alt="github-fork" src="https://img.shields.io/github/forks/Shiotsukikaedesari/vis-three?style=social">
    </a>
</p>
<br/>

## VIS-THREE

基于 three.js 的组装式前端 3D 开发框架。

> 夫物速成则疾亡，晚就则善终。朝华之草，夕而零落；松柏之茂，隆寒不衰。是以大雅君子恶速成。——《群书治要》

## 主页、文档、案例在线地址

github 入口：[https://vis-three.github.io](https://vis-three.github.io)

> 文档内容不一定是最新版本内容，持续更新。当前的文档版为：`0.7.x`

## 核心版本速览

| 包名                  | 最新版本                                                                     |
| :-------------------- | :--------------------------------------------------------------------------- |
| @vis-three/core       | <img alt="version" src="https://img.shields.io/npm/v/@vis-three/core">       |
| @vis-three/tdcm       | <img alt="version" src="https://img.shields.io/npm/v/@vis-three/tdcm">       |
| @vis-three/widget     | <img alt="version" src="https://img.shields.io/npm/v/@vis-three/widget">     |
| @vis-three/utils      | <img alt="version" src="https://img.shields.io/npm/v/@vis-three/utils">      |
| @vis-three/convenient | <img alt="version" src="https://img.shields.io/npm/v/@vis-three/convenient"> |

## 贡献者

<a href="https://github.com/vis-three/vis-three/graphs/contributors">
  <img src="https://stg.contrib.rocks/image?repo=vis-three/vis-three" />
</a>

## 赞助者

| 赞助者                                                                                                                                                        |                                                                                                                                                                |                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| <a href="https://space.bilibili.com/672852044"><img src="https://i0.hdslb.com/bfs/face/member/noface.jpg@60w_60h_1c_1s.webp" /></a>                           | <a href="https://space.bilibili.com/318870619"><img src="https://i1.hdslb.com/bfs/face/5820ce47b61cc7f1ea4e383139b9030a98d81dc6.jpg@60w_60h_1c_1s.webp" /></a> | <a href="https://space.bilibili.com/255956035"><img src="https://i0.hdslb.com/bfs/face/member/noface.jpg@60w_60h_1c_1s.webp" /></a> |
| <a href="https://space.bilibili.com/18899105"><img src="https://i2.hdslb.com/bfs/face/a809a3b8407840ae00032360108261fcf503d38a.jpg@60w_60h_1c_1s.webp" /></a> | <a href="https://space.bilibili.com/184913597"><img src="https://i2.hdslb.com/bfs/face/500b0b3bf04cd89d2264ac75e4109afb83d0bc87.jpg@60w_60h_1c_1s.webp" /></a> |                                                                                                                                     |

## 赞助商



## 关于 issue

### issue 的使用

issue 不只是用来提问讨论，也是一个文档，如果您有相关的问题，不妨先去历史 issue 中开启全部查找，分为 2 个平台:

- [github](https://github.com/vis-three/vis-three/issues)
- [gitee](https://gitee.com/Shiotsukikaedesari/vis-three/issues)

这样可以避免重复提问与重复的回答，节省大家的时间与精力。

### 新建 issue

当前的新建 issue 有不同的 issue 分类模板，选择相应的 issue 模板根据模板指引进行 issue 新增。

## 贡献者与开发组

可以阅读[贡献指南](/CONTRIBUTING.md)，对本项目进行熟悉。

### 如何快速上手入门？

issue 部分会进行相关的开发任务分类：

- 任务：入门
- 任务：初级
- 任务：中级
- 任务：高级

如果您不知道如何开始，或者想通过实践熟悉项目，可以采取解决相应的**任务**issue 进行。

### 成为贡献者

提交您的代码 pr，并通过管理员的代码审核。

### 贡献开发鸣谢

只要提交并通过代码审核，您就会自动成为贡献者并记录于上方的贡献者名单中。

## 备注

- gitee 仓库为 github 的同步备份仓库，pr 提交请以 github 为基准
- github 地址：[https://github.com/vis-three/vis-three](https://github.com/vis-three/vis-three)