README.md

About

HoloPrint is a web app that converts MCBE structure files into resource packs showing holograms of builds. It builds off the work of Structura, a similar project. Both Structura and HoloPrint aim to recreate the experience of Java Edition mods like Litematica and Schematica for Bedrock Edition users through resource packs.

Usage

Note

On Android the Structure Block export button is hidden; please use this pack to add it back.

1. Use a Structure Block to export a .mcstructure file. To get a structure block, run the command /give @s structure_block.
   
   
2. Go to https://superllama88888.github.io/holoprint, select your .mcstructure file, and tweak settings.
   
3. Generate and download your resource pack (.mcpack).
   
4. Apply your resource pack and place an armour stand in your world.
   

Hologram controls

• Toggle rendering: Stone
  
• Change transparency: Glass (sneak to decrease, stand to increase)
  
• Change layer: Planks (sneak to decrease, stand to increase), or changing the pose on the armour stand
  
• Move hologram (third person only): Stick
  
• Block validation: Iron ingot
  
• Material list: Tab button (keyboard), book icon (touch)
  
• Toggle tint: White dye
  
• Change layer mode: Wooden slab
  
• Change structure: Arrow, or hit armour stand that's holding nothing
  
• Save hologram settings: Paper
  
• Armour stand controls: Give item or hit
  
• Disable player controls: Bone
  

Warning

Player controls may be unreliable, but armour stand controls will always work.

Special thanks to kizoku246 for the house in these images!

---

Credit

• Structura: Inspiration, laying the foundation for this project. Without the work of RavinMaddHatter and others, this project would've taken tens of hours more to get started.
• Tab Key Playerlist UI by YuuhaLand: Foundation for the material list UI
• Indyfficient: The idea of changing structure by hitting the armour stand
• Documentation:
  • Bedrock Wiki: Best resource for learning about resource/behaviour packs!
  • Minecraft Wiki: Block entity list, block states and data values, and so much more!
  • Bedrock .mcstructure. files: Explanation of the NBT structure of structure files, by tryashtar
  • Magic Method Docs: Documentation of Chainsketch's technique to pass data between entities in resource packs, written by White and chyves
  • Microsoft BE reference docs: Official schemas for addons/resource packs
• JavaScript libraries:
  • NBTify: Minecraft NBT reader
  • tga.js: TGA to PNG image conversion
  • potpack: Texture atlas packing
  • JSZip: Pack zipping
  • bridge-model-viewer and three.js: Preview rendering
  • strip-json-comments: Removes comments from JSON files
  • deepmerge: Merges JSON files