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.