Skip to content

Repository files navigation

Colorify 7

English | 简体中文

Colorify 7 is an open-source tool for Minecraft: Bedrock Edition that converts images and three-dimensional models into in-game content. It supports particle art, pixel art, and object voxelisation, and can export the results as mcfunction, mcstructure, or mcaddon files, or stream them directly into a running game session through a local WebSocket server.

The application is built with Tauri 2 and React, and is available on Windows and Android.

Table of Contents

Features

Particle Art

Converts an image into an in-game particle display. Colours are either matched against a configurable set of particle mappings or emitted as per-pixel coloured particles (the latter requires Minecraft 1.20.80 or later and is bundled as a resource pack automatically). The result can be packaged as an .mcaddon file or streamed to the game over WebSocket.

Pixel Art

Flattens an image into a block layout on a single plane, or as stepped staircase art. Supports configurable colour-distance metrics, ordered dithering, palette restrictions (carpet-only, wool-only), and exclusions for glass, sand, and powder blocks. Exports as mcfunction or .mcstructure files.

Obj to Voxel

Voxelises OBJ, GLB, and GLTF models into solid or hollow Minecraft builds. The pipeline relies on a custom BVH-accelerated ray-casting voxeliser with configurable resolution, rotation, dithering, and multisample colouring. Exports as .mcstructure files.

WebSocket Streaming

Runs a local WebSocket server that pushes generated block commands to a connected Bedrock client in real time, allowing the build to be observed as it is placed. The server reports task progress and forwards game messages back into the application.

Platform Support

Platform Status
Windows Supported
Android Supported

Getting Started

Prerequisites

  • Node.js 20 or later
  • pnpm
  • Rust (stable toolchain)
  • Platform prerequisites for Tauri 2 — on Windows, the Microsoft Visual C++ Build Tools and the WebView2 runtime

Run from Source

pnpm install
pnpm tauri dev

Build a Release

pnpm build        # compile the frontend (TypeScript + Vite)
pnpm tauri build  # produce the platform bundle

Usage

  1. Choose a mode: Particle Art, Pixel Art, Obj to Voxel, or WebSocket.
  2. Load an image or a 3D model.
  3. Adjust the generation parameters (resolution, rotation, palette, dithering, and so on).
  4. Export the result as files, or send it to the game through the WebSocket server.

To stream into the game:

  • Enable "Enable WebSocket" and disable "WebSocket Requires Encryption" in the Minecraft settings.
  • On Windows, enable the UWP loopback exemption first so that the game can reach a local server.
  • Connect with /connect 127.0.0.1:<port>.

Gallery

"Hornet - Hollow Knight - Handpainted" by TonXx
示例图片 示例图片
"Broken Steampunk Clock" by VassKacsoHunor
示例图片 示例图片
"Fast-food" by Korneev Nikita Kirillovich
示例图片 示例图片
"Frank" by misterdevious
示例图片 示例图片

Acknowledgements

  • SlopeCraft — map pixel art generator for Minecraft; source of inspiration for the pixel-art pipeline.
  • ObjToSchematic — voxelisation algorithm and block assets (BSD-3-Clause, (c) Lucas Dower 2021).
  • Minecraft block textures (c) Mojang Studios, used in accordance with the Minecraft Brand Guidelines.
  • All testers and contributors listed in the application's About page.

Colorify 7 is an unofficial fan project and is not affiliated with or endorsed by Mojang Studios or Microsoft.

License

This project is licensed under a custom permissive license for non-commercial use only. The full text is provided in the LICENSE file.

In short: you may freely use, copy, modify, and distribute the software for any non-commercial purpose. Commercial use is not permitted.

Third-party components included in this repository remain under their respective licenses; see THIRD_PARTY_NOTICES.md.

About

Particle / Pixel / Voxel art generator for Minecraft Bedrock Edition

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages