Repolode
Submit
regomne

regomne/magic-snake

A browser-based 3D editor and player for designing and sharing Rubik's Snake shapes with 24, 36, 48, or 72 pieces.

View on GitHub
Stars
69
Forks
9
Open issues
0
Last commit
3 months ago

What is it?

Magic Snake Workbench is a browser-based 3D editor and player for Rubik's Snake shapes. It supports 24, 36, 48, and 72-piece snakes and runs entirely on the client side, so no server is needed to use it.

Users can select pieces in the 3D view, rotate their joints, and enter or convert between 0123 pose encoding, speed-solving notation, and parenthesized formulas. Built-in shapes can be browsed and their folding sequences played back step by step, with classic or rainbow colors or a custom cyclic palette. Overlapping pieces in the final pose are detected using exact geometry.

The current shape can be shared through the URL hash, and the interface is available in Chinese and English. The project is built with TypeScript and Three.js and can be run locally with npm.

Key features

  • 01Select and rotate pieces of a Rubik's Snake in a 3D view
  • 02Convert between 0123 pose encoding, speed-solving notation, and formulas
  • 03Play built-in folding sequences step by step
  • 04Choose classic or rainbow colors, or define a custom cyclic palette
  • 05Detect overlapping pieces in the final pose

Use cases

  • Designing new Rubik's Snake shapes before building them physically
  • Learning folding sequences by watching built-in shapes play back
  • Sharing a specific shape with others through a link

Quick start

  1. 1

    Install dependencies

    npm install
  2. 2

    Start the development server

    npm run dev
  3. 3

    Open the local address shown in the terminal

Things to know

  • No license is specified, so usage and redistribution rights are unclear.
  • Requires Node.js and npm to run locally; the live demo is available without setup.

Topics

#puzzle#rubiks-snake#threejs#3d-editor#typescript#webgl#magic-snake

FAQ

What is magic-snake?
A browser-based 3D editor and player for designing and sharing Rubik's Snake shapes with 24, 36, 48, or 72 pieces. Magic Snake Workbench is a browser-based 3D editor and player for Rubik's Snake shapes. It supports 24, 36, 48, and 72-piece snakes and runs entirely on the client side, so no server is needed to use it.
Is magic-snake free to use? What license does it have?
magic-snake has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is magic-snake still maintained?
Updated within 6 months. The last commit to magic-snake was on Aug 4, 2026.
What can I use magic-snake for?
Designing new Rubik's Snake shapes before building them physically Learning folding sequences by watching built-in shapes play back Sharing a specific shape with others through a link
How do I install magic-snake?
Install dependencies: npm install Start the development server: npm run dev Open the local address shown in the terminal
Where can I get magic-snake?
The source code and installation instructions are on GitHub: https://github.com/regomne/magic-snake

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects