@crapthings/run3d

中文文档
0.2.19发布于 2026/11/08MITES Module零依赖近 30 天下载 2199

从想法到交互式3D原型在一个指令中. 一个带有Vite的JavaScript启动器,React Three Fiber,以及创造性实验的工具.

中文使用文档
文档目录9 节
  1. 使用量
  2. 语文
  3. 包含的工具
  4. 应用基础
  5. 3D 场景
  6. 数据和状态
  7. 接口
  8. 世界和运动
  9. 媒体

运行3d

在一个命令中创建 3D 工程 。 起动场景以绿色立方体和快行重现了run3d图标,准备编辑.

随着GPT-6 Astra等模型在构建3D体验方面能力增强,从一个想法到工作原型的距离不断缩小. 我每天都有新的想法 我想花精力创造 run3d将我的集思广益和实验工具 带入一个随时可以使用的启动器, 所以我可以直接跳入建筑, 测试想法, 发现什么是可行的.

使用量

需要节点.js >=24 还有pnpm.

npx @crapthings/run3d my-project
cd my-project
pnpm dev

编辑组件在 src/scenes 来让启动者成为你自己的场景。 以后安装依赖关系,请添加 --skip-install 到第一个命令.

拖入场景轨道,滚动到缩放,右拖至平板. 编辑 src/scenes/index.jsx 用于场景及其设置.

语文

模板初始化 反应- i18next 内 src/i18n.js中英文资源 src/locales. 它检测到浏览器语言,倒回英语,并记得本地存储中的语言变化. 该文件 lang 属性遵循活动语言.

使用 const { t, i18n } = useTranslation() 从 react-i18next 在组件中,将文本修改为 t('scene.label'),并切换语言 i18n.changeLanguage('zh') 或者说 i18n.changeLanguage('en')。为 JSON 文件添加新的翻译密钥; 在其中注册额外的语言 src/i18n.js。 。 。 .

包含的工具

按对起步器和典型用法的重要性排序,先用核心工具,后用专用工具.

应用基础

3D 场景

数据和状态

  • 苏斯坦德 ——管理React应用状态.
  • 库塔 ——以实体和组件管理游戏状态.
  • D3级 ——提供数据尺度,布局,可视化.
  • 页:1 ——创建互动图形和创意编码草图.

接口

世界和运动

媒体

  • (原始内容存档于2018-09-26). Howler.js ——用音量控制来播放音频,声音图案,以及3D空间声音.
  • 媒体朋尼 ——阅读,撰写,并转换浏览器中的音频和视频文件.
  • 小学 - 创建声明式音频 DSP 图表 @elemaudio/core 在浏览器中运行 @elemaudio/web-renderer。 。 。 .

版本与发布记录

@crapthings/run3d 共发布 21 个版本,首次发布于 2026/09/15;过去 12 个月发布了 21 个版本。

版本发布日期距今
0.2.19latest2026/11/082 天前
0.2.182026/11/037 天前
0.2.172026/11/0110 天前
0.2.162026/10/2715 天前
0.2.142026/10/2715 天前
0.2.132026/10/2715 天前

关于 @crapthings/run3d 的常见问题

@crapthings/run3d 是什么?

从想法到交互式3D原型在一个指令中. 一个带有Vite的JavaScript启动器,React Three Fiber,以及创造性实验的工具.

如何安装 @crapthings/run3d?

在项目目录运行 npm install @crapthings/run3d,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 run3d,可以用 npx run3d 直接运行。

@crapthings/run3d 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/crapthings__run3d 是否存在。

@crapthings/run3d 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@crapthings/run3d 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@crapthings/run3d 可以商用吗?

@crapthings/run3d 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@crapthings/run3d 的下载量有多少?

根据 npm 官方下载统计,@crapthings/run3d 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,199 次,日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@crapthings/run3d 还在维护吗?

最新版本 0.2.19 发布于 2026/11/08(2 天前);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/09/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。