https://github.com/equbuxu/braillebooks

A tool to convert any image into Minecraft written book
https://github.com/equbuxu/braillebooks

ascii-art game-tool minecraft minecraft-command minecraft-tool unicode-characters

Last synced: 3 months ago
JSON representation

A tool to convert any image into Minecraft written book

• Host: GitHub
• URL: https://github.com/equbuxu/braillebooks
• Owner: Equbuxu
• Created: 2019-01-20T19:58:29.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2019-08-13T18:15:42.000Z (over 5 years ago)
• Last Synced: 2024-10-11T14:28:19.066Z (3 months ago)
• Topics: ascii-art, game-tool, minecraft, minecraft-command, minecraft-tool, unicode-characters
• Language: C#
• Homepage:
• Size: 300 KB
• Stars: 32
• Watchers: 1
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# BrailleBooks

A tool to convert any image into Minecraft written book. It uses braille Unicode characters to achieve better resolution. Works with Minecraft 1.14

## Examples

Give commands and original images can be found in Examples folder

![Cube](https://raw.githubusercontent.com/BYSTACK/BrailleBooks/master/Cube.png)

![Mario](https://raw.githubusercontent.com/BYSTACK/BrailleBooks/master/Mario.png)

## Usage

.NET Framework 4.6.1 is required to run the application.

To convert an image into a book, drag an image file onto the program. Supported formats are PNG, JPEG, and GIF. Each frame of a gif file will be placed on a separate page. 

Another way to make a multi-page book is to drag a folder onto the program. The folder should contain PNG or JPEG files named as "01.png", "02.png" etc. (with trailing zeros).

To achieve best results, use 76x56 images (or smaller). Larger images will be downscaled.

The resulting command will be saved in command.mcfunction file near the original image/folder. You can either open it with a text editor and copypaste the command into a command block or add the file to a datapack. Be aware that there is a limit of 32200 characters when using a commands block, any commands longer than this can only be run through a datapack.

## Usage again if above isn't clear enough

![Usage](https://raw.githubusercontent.com/BYSTACK/BrailleBooks/master/Usage.png)