EasyHologram API

The Definitive Server-Side Hologram Framework for Minecraft 1.21 (Fabric)

EasyHologram leverages vanilla Display Entities to deliver a robust, strictly packet-free, and highly performant API for rendering holograms. Zero network hacks, purely modern Minecraft architecture.

✨ Core Architecture & Features

Rich Typography & Objects — Full native support for scaled text geometries, background RGB coloring, dynamic drop shadows, and 3D floating blocks/items.
Interactive & Dynamic — Attach functional left/right click listeners. Full integration with PlaceholderAPI for live-updating data streams.
Multi-Line Topologies — Native wrapper for generating vertically stacked, perfectly aligned multi-line structures with configurable Y-axis spacing.
Granular Visibility — Utilize programmatic per-player visibility matrices. Selectively render or hide specific holograms to targeted player sessions.
Fluid Interpolation — Unleash native 1.21 matrix interpolation for buttery-smooth scaling, translation, and rotational transition physics.
Persistence Engine — Built-in auto-saving via Minecraft’s robust PersistentState. Holograms seamlessly survive server execution cycles and restarts without database overhead.
Developer CI/CD — Comprehensive API toolkit with extensive lifecycle event hooks (Create, Tick, Remove) and standard JSON I/O capabilities for static layout manipulation.

🔧 Operational Commands

Rapidly test and manage holograms in-game. (Requires OP Level 2 Configuration)

Syntax	Operation
`/hologram create text <pos> <text>`	Initializes an optimized textual hologram.
`/hologram create block <pos> <block>`	Renders a 3D block geometry.
`/hologram create item <pos> <item>`	Renders an item using billboard vectors.
`/hologram edit <id> settext <text>`	Mutates textual configurations live in memory.
`/hologram list`	Audits all active holograms currently tracked in heap.
`/hologram remove <id>`	Safely deallocates a specific hologram instance.
`/hologram save <name>` / `load <name>`	Serializes/Deserializes JSON layout schemas.

📦 Technical Integration

Easily hook into the EasyHologram API via JitPack to empower your own projects. Refer to the GitHub Documentation for advanced Dependency specifications and code examples.

TextHologram target = TextHologram.builder(pos)
    .text("Hello World!")
    .scale(1.5f)
    .build(world);
EasyHologram.getManager().register(target);

System Requirements: Minecraft 1.21 target instance, Fabric Loader ≥ 0.16.0, Fabric API.

EasyHologram API

介绍