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)

📦 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

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+).

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.