HoloPrint

HoloPrint uses minimal analytics to track usage statistics.

Data Collection:

• The only data recorded is the first 4 bytes of the SHA-256 hashes of structure files used during pack creation. This acts as a unique identifier that cannot be used to reconstruct the original file.
• No cookies are used.

Browser Storage:

• The only data stored in your browser is a cache of resource pack resources used to speed up the pack creation process.

Managing Cache:

• You can clear the stored resource pack cache using the Resource packs -> Clear resource pack cache button within the application.

All packs created using HoloPrint are licensed under the CC BY-NC-SA 4.0 license.

Key restrictions:

• You may not sell packs created with HoloPrint.
• You may not put packs behind advertisements or monetized barriers.

Allowed uses include:

• Writing tutorials or blog posts about HoloPrint.
• Showing HoloPrint-created packs in videos (e.g., YouTube).

Prohibited uses include:

• Limiting access to packs via monetized link shorteners (e.g., Linkvertise).
• Forcing users to wait for downloads or purchase subscriptions to access the packs.

HoloPrint converts Minecraft Bedrock Edition (.mcstructure) files into resource packs that display holograms of your builds. Follow these steps to create a pack:

1. Export your structure: Use a Structure Block in Minecraft to export a .mcstructure file. You can obtain a structure block by running the command /give @s structure_block.
   • Note for Android users: The Structure Block export button is hidden by default. Use this pack to restore it.
2. Generate the pack: Visit https://holoprint-mc.github.io, upload your .mcstructure file, and adjust the generation settings.
3. Download: Generate and download the resulting .mcpack file.
4. Apply in Minecraft: Install the resource pack in your world and place an armour stand to initialize the hologram.

The HoloPrintConfig type defines the global configuration for the HoloPrint system. It controls visual properties (scale, opacity, tint), animation settings, UI/control behavior, and pack metadata.

Key configuration groups include:

• Visuals: SCALE, OPACITY, MULTIPLE_OPACITIES, TINT_COLOR, TINT_OPACITY, and TEXTURE_OUTLINE_* settings.
• Animations: SPAWN_ANIMATION_ENABLED and SPAWN_ANIMATION_LENGTH.
• Controls: PLAYER_CONTROLS_ENABLED, UI_CONTROLS_ENABLED, and the CONTROLS object.
• Validation: VALIDATE_AIR_BLOCKS and WRONG_BLOCK_OVERLAY_COLOR.
• Pack Metadata: PACK_NAME, AUTHORS, DESCRIPTION, and PACK_ICON_BLOB.
• Preview Settings: PREVIEW_BLOCK_LIMIT, SHOW_PREVIEW_SKYBOX, and SHOW_PREVIEW_WIDGETS.

The HoloPrintControlsConfig type allows you to map specific in-game actions to ItemCriteria. This defines which items will trigger specific hologram behaviors.

Available control actions include:

• TOGGLE_RENDERING
• CHANGE_OPACITY
• TOGGLE_TINT
• TOGGLE_VALIDATING
• CHANGE_LAYER / DECREASE_LAYER / CHANGE_LAYER_MODE
• MOVE_HOLOGRAM / ROTATE_HOLOGRAM
• CHANGE_STRUCTURE (Players only)
• DISABLE_PLAYER_CONTROLS (Players only)
• BACKUP_HOLOGRAM (Forces armour stands to backup state for 30s)

When working with multiple IStructure objects, you can use mergeStructurePalettes(structures) to combine their individual block palettes into a single, shared palette.

This function:

1. Creates a unique set of all blocks present across all provided structures.
2. Updates the block indices for each structure so they all point to the new, unified palette.
3. Returns the resulting merged palette array.

This is useful for ensuring that multiple structures can be rendered or processed using a single consistent block lookup table.

import { mergeStructurePalettes } from './path/to/structureHelpers.js';

// structures is an array of IStructure objects
const sharedPalette = mergeStructurePalettes(structures);

The BlockShapes interface manages how block names map to specific geometric definitions.

• individualBlocks: A direct mapping where the key is the block name and the value is the block shape name.
• patterns: A mapping of regular expression strings to block shape names. These patterns are tested if no individual block match is found.

const shapes: BlockShapes = {
  individualBlocks: {
    "minecraft:stone": "stone_shape",
    "minecraft:dirt": "dirt_shape"
  },
  patterns: {
    "/minecraft:grass_*/": "grass_shape"
  }
};

The concatenateFiles function creates a new File object by concatenating the contents of an array of File objects. You can optionally provide a custom name for the resulting file; otherwise, it defaults to a comma-separated string of the original filenames.

import { concatenateFiles } from './utils/files.js';

const combinedFile = concatenateFiles([file1, file2], 'merged.txt');