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.