Repolode
regomne

regomne/magic-snake

一个基于浏览器的 3D 编辑器与播放器,用于设计和分享魔术蛇(Rubik's Snake)造型。

Star
69
Fork
9
未关闭 Issue
0
最近提交
3个月前

这是什么?

Magic Snake Workbench 是一个基于浏览器的 3D 魔术蛇造型编辑与播放工具,支持 24、36、48 和 72 块的蛇形结构,完全在客户端运行,无需服务器。

用户可以在 3D 视图中选中块体并转动关节,也可以在 0123 位姿编码、速拧记号和带括号的公式之间输入和互相转换。内置造型可以浏览,并能逐步播放折叠过程,颜色可选经典或彩虹模式,也可自定义循环调色板。最终姿态中的重叠块会通过精确几何计算进行检测。

当前造型可通过 URL 哈希分享,界面支持中文和英文切换。项目使用 TypeScript 和 Three.js 开发,可通过 npm 在本地运行。

核心功能

  • 01在 3D 视图中选择并转动魔术蛇的块体
  • 02在 0123 位姿编码、速拧记号和公式之间互相转换
  • 03逐步播放内置的折叠序列
  • 04可选经典或彩虹配色,也可自定义循环调色板
  • 05检测最终姿态中的重叠块体

适用场景

  • 在实物制作前设计新的魔术蛇造型
  • 通过播放内置造型学习折叠序列
  • 用链接与他人分享特定造型

快速上手

  1. 1

    安装依赖

    npm install
  2. 2

    启动开发服务器

    npm run dev
  3. 3

    打开终端中显示的本地地址

使用前须知

  • 未指定许可证,使用和再分发的权限不明确。
  • 本地运行需要 Node.js 和 npm;在线演示无需安装即可使用。

标签

常见问题

magic-snake 是什么?
一个基于浏览器的 3D 编辑器与播放器,用于设计和分享魔术蛇(Rubik's Snake)造型。 Magic Snake Workbench 是一个基于浏览器的 3D 魔术蛇造型编辑与播放工具,支持 24、36、48 和 72 块的蛇形结构,完全在客户端运行,无需服务器。
magic-snake 可以免费使用吗?用的什么许可证?
magic-snake 没有声明许可证。代码虽然公开,但没有许可证就没有明确的使用授权,正式使用前建议先联系作者。
magic-snake 还在维护吗?
半年内有更新。magic-snake 最近一次提交是在 2026年8月4日。
magic-snake 适合用来做什么?
在实物制作前设计新的魔术蛇造型 通过播放内置造型学习折叠序列 用链接与他人分享特定造型
magic-snake 怎么安装和运行?
安装依赖: npm install 启动开发服务器: npm run dev 打开终端中显示的本地地址
在哪里获取 magic-snake?
源代码和安装说明在 GitHub 上:https://github.com/regomne/magic-snake

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目