EasyHologram API
The definitive server-side hologram framework for Minecraft 1.21 (Fabric). Engineered to construct floating text, blocks, and items using highly-optimized vanilla Display Entities. Zero network interference; maximum programmatic control.
Technical Specifications
🔤 Rich Output Geometries — Robust layouting for scalable strings, structural blocks, and items. Customize RGB backgrounds, drop shadows, and line widths dynamically.
🖱️ HCI Interaction — Map native operational logic to left and right-click intercept listeners attached to holograms.
📊 Multi-Line Support — Rapidly array, space, and organize complex vertical string data without recalculating individual vectors.
🔄 Placeholder Integration — Natively interfaces with PlaceholderAPI to stream real-time mutable statistics cleanly directly to active displays.
👁️ Visibility Matrices — Programmatic logic controlling packet broadcasting, dictating pinpoint player visibility filters for any display entity.
🎬 Kinematic Interpolation — Buttery-smooth visual transition sequences mapping 1.21 translation interpolation bounds.
💾 Fault-Tolerant State — Guaranteed auto-serialization via the engine's PersistentState, seamlessly ensuring server restart survivability.
Command Interface
Live operational commands strictly require parameter validation and operator rank (level 2+).
| Command Syntax | Operation Context |
|---|---|
/hologram create text <x> <y> <z> <text> |
Spawns a heavily optimized text matrix |
/hologram create block <x> <y> <z> <block> |
Spawns block structural geometry |
/hologram create item <x> <y> <z> <item> |
Spawns isolated billboard items |
/hologram edit <id> settext <text> |
Updates text states directly in-flight |
/hologram list |
Emits active heap diagnostics |
/hologram remove <id> |
Triggers immediate structural deallocation |
/hologram save <id> / load <id> |
Commits layouts to persistent JSON schema |
API Integration
Extensibility module available for downstream developers. Inject logic easily.
Standard Build Initialization
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
modImplementation 'com.github.tabplus:easyhologram:1.1.0'
}
Usage Instantiation
TextHologram module = TextHologram.builder(new Vec3d(100, 65, 200))
.text("§6System Nominal")
.billboard(true)
.build(world);
EasyHologram.getManager().register(module);
Environment Constraints
- Java Virtual Machine: Java 21+
- Minecraft Engine: Target 1.21
- Primary Loader: Fabric ≥ 0.16.0
- Library Base: Fabric API
Open Source Licensing
MIT License - Execute securely in any commercial and private configuration.
