{"id":23279265,"url":"https://github.com/HologramLib/HologramLib","last_synced_at":"2025-08-21T11:31:55.846Z","repository":{"id":184034838,"uuid":"671180509","full_name":"HologramLib/HologramLib","owner":"HologramLib","description":"Minecraft hologram library / api with text, item \u0026 block displays, leaderboards, and extensive customization. packet-based, modern \u0026 easy to use. ","archived":false,"fork":false,"pushed_at":"2025-08-07T18:21:00.000Z","size":3434,"stargazers_count":40,"open_issues_count":10,"forks_count":14,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-07T18:30:40.487Z","etag":null,"topics":["entitylib","hologram","java","minecraft","minimessage","packetevents","papermc","plugin","spigot"],"latest_commit_sha":null,"homepage":"https://github.com/HologramLib/HologramLib/wiki","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HologramLib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-26T18:15:07.000Z","updated_at":"2025-08-07T18:21:04.000Z","dependencies_parsed_at":"2024-12-22T12:18:37.057Z","dependency_job_id":"9c289c5e-8c28-41eb-892d-5b08e3d2d033","html_url":"https://github.com/HologramLib/HologramLib","commit_stats":{"total_commits":97,"total_committers":3,"mean_commits":"32.333333333333336","dds":"0.31958762886597936","last_synced_commit":"728934364649acf7f49e064fad73aae77a10f7c1"},"previous_names":["maximfiedler/hologramapi","max1mde/hologramapi","max1mde/hologramlib","maximjsx/hologramlib","hologramlib/hologramlib"],"tags_count":49,"template":false,"template_full_name":null,"purl":"pkg:github/HologramLib/HologramLib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HologramLib%2FHologramLib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HologramLib%2FHologramLib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HologramLib%2FHologramLib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HologramLib%2FHologramLib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HologramLib","download_url":"https://codeload.github.com/HologramLib/HologramLib/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HologramLib%2FHologramLib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271470165,"owners_count":24765333,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["entitylib","hologram","java","minecraft","minimessage","packetevents","papermc","plugin","spigot"],"created_at":"2024-12-19T22:40:57.398Z","updated_at":"2025-08-21T11:31:55.840Z","avatar_url":"https://github.com/HologramLib.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"650px\" src=\"assets/banner.png\" alt=\"HologramLib Banner\"\u003e\n  \n  [![Discord](https://img.shields.io/badge/Discord_Server-7289DA?style=flat\u0026logo=discord\u0026logoColor=white)](https://discord.gg/2UTkYj26B4)\n  [![Wiki](https://img.shields.io/badge/Documentation-Wiki-2dad10)](https://github.com/HologramLib/HologramLib/wiki)\n  [![JitPack](https://jitpack.io/v/HologramLib/HologramLib.svg)](https://jitpack.io/#HologramLib/HologramLib)\n  [![JavaDocs](https://img.shields.io/badge/API-Docs-2ECC71)](https://HologramLib.github.io/HologramLib/)\n  [![GitHub Downloads](https://img.shields.io/github/downloads/HologramLib/HologramLib/total?color=2ECC71)](https://github.com/HologramLib/HologramLib/releases)\n\n\n  \u003cp\u003eLeave a :star: if you like this library :octocat:\u003c/p\u003e\n  \u003ch3\u003eDisplay Entity Based Hologram Library for Modern Minecraft Servers\u003c/h3\u003e\n  \u003cp\u003ePacket-based • Feature-rich • Developer-friendly\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n1. [Installation](https://github.com/HologramLib/HologramLib/wiki/1.-Installation)  \n2. [Getting Started](https://github.com/HologramLib/HologramLib/wiki/2.-Getting-Started)  \n   - [Creating Holograms](https://github.com/HologramLib/HologramLib/wiki/3.-Creating-Holograms)  \n   - [Hologram Management](https://github.com/HologramLib/HologramLib/wiki/4.-Hologram-Management)  \n   - [Leaderboards](https://github.com/HologramLib/HologramLib/wiki/5.-Leaderboards)  \n   - [Animations](https://github.com/HologramLib/HologramLib/wiki/6.-Animations)  \n\n\u003ca href=\"https://github.com/HologramLib/HologramLib/releases/download/1.8.0/HologramLib-1.8.0.jar\"\u003e\n  \u003cimg width=\"200px\" src=\"https://github.com/HologramLib/Addons/blob/main/download_jar.svg\" alt=\"Download\"/\u003e\n\u003c/a\u003e\n\n\n## 🫨 Features\n- **Multi-Type Holograms**    \nText • Blocks • Items • Leaderboards • Paginated Leaderboards  \n\n- **Dynamic Content**  \nLive animations • MiniMessage formatting • ItemsAdder emojis • PlaceholderAPI\n\n- **Advanced Mechanics**  \nEntity attachment • Per-player visibility • View distance control    \n\n---\n\n## ⚙️ Technical Specifications\n\n**Compatibility**  \n| Server Software | Minecraft Versions       | \n|-----------------|--------------------------|\n| **Paper**       | 1.19.4 → 1.21.5 ✔️       |\n| **Purpur**      | 1.19.4 → 1.21.5 ✔️       | \n| **Folia**       | 1.19.4 → 1.21.5 ✔️       | \n| **Spigot**      | ❌ Not supported         | \n| **Bedrock**     | ❌ Not supported         | \n| **Legacy**      | ❌ (1.8 - 1.19.3)        | \n\n**Dependencies**  \n- [PacketEvents](https://www.spigotmc.org/resources/80279/) (Required)\n\nIf you want to learn how to use HologramLib in your plugin, check out the detailed guide here:  \n👉 [HologramLib Wiki](https://github.com/HologramLib/HologramLib/wiki)\n\n---\n\n## ✈️ Quick Integration\n\n**Step 1: Add Dependency**\n```gradle\nrepositories {\n    maven { url 'https://jitpack.io' }\n}\n\ndependencies {\n    implementation 'com.github.maximjsx:HologramLib:1.8.0'\n}\n```\n\n**Step 2: Basic Implementation**\n```java\nHologramManager manager = HologramAPI.getManager().get();\n\nTextHologram hologram = new TextHologram(\"unique_id\")\n    .setMiniMessageText(\"\u003caqua\u003eHello world!\")\n    .setSeeThroughBlocks(false)\n    .setShadow(true)\n    .setScale(1.5F, 1.5F, 1.5F)\n    .setTextOpacity((byte) 200)\n    .setBackgroundColor(Color.fromARGB(60, 255, 236, 222).asARGB())\n    .setMaxLineWidth(200);\n\nmanager.spawn(hologram);\n```\n\n---\n\n## 📕 Learning Resources\n\n\u003cimg width=\"536px\" src=\"https://github.com/user-attachments/assets/e4d108d3-e6cb-4d33-b91b-aa989e5e4475\" alt=\"HologramLib Banner\"\u003e\n\n| Resource | Description | \n|----------|-------------|\n| [📖 Complete Wiki](https://github.com/HologramLib/HologramLib/wiki) | Setup guides • Detailed examples • Best practices |\n| [💡 Example Plugin](https://github.com/HologramLib/ExamplePlugin) | Production-ready implementations |\n| [🎥 Tutorial Series](https://github.com/HologramLib/HologramLib) | Video walkthroughs (Coming Soon) |\n\n---\n\n## 😎 Featured Implementations\n- **TypingInChat** ([Modrinth](https://modrinth.com/plugin/typinginchat-plugin)) - Real-time typing visualization\n\n*[Your Project Here 🫵]* - Submit via PR or \u003ca href=\"https://discord.gg/2UTkYj26B4\"\u003eDiscord\u003c/a\u003e!\n\n---\n\n## 👁️ Roadmap \u0026 Vision\n**2025**  \n- Particle-effect holograms\n- ~~Interactive holograms~~\n- Improved animation system\n- ~~Persistant holograms~~\n- ~~PlaceholderAPI~~\n\n\u003e [!WARNING]\n\u003e Persistant holograms \u0026 the addon system are still experimental features\n\n## Contributors\nContributions to this repo or the example plugin are welcome!\n\n\u003c!-- CONTRIBUTORS:START --\u003e\n\n| Avatar | Username |\n|--------|----------|\n| [![](https://avatars.githubusercontent.com/u/114857048?v=4\u0026s=50)](https://github.com/maximjsx) | [maximjsx]( https://github.com/maximjsx ) |\n| [![](https://avatars.githubusercontent.com/u/67076970?v=4\u0026s=50)](https://github.com/Fedox-die-Ente) | [Fedox-die-Ente]( https://github.com/Fedox-die-Ente ) |\n| \u003cimg src=\"https://avatars.githubusercontent.com/u/153451816?v=4\" width=\"50\" /\u003e | [misieur]( https://github.com/misieur ) |\n| [![](https://avatars.githubusercontent.com/u/116300577?v=4\u0026s=50)](https://github.com/WhyZerVellasskx) | [WhyZerVellasskx]( https://github.com/WhyZerVellasskx ) |\n| [![](https://avatars.githubusercontent.com/u/46348263?v=4\u0026s=50)](https://github.com/RootException) | [RootException]( https://github.com/RootException ) |\n| [![](https://avatars.githubusercontent.com/u/13736324?v=4\u0026s=50)](https://github.com/matt11matthew) | [matt11matthew]( https://github.com/matt11matthew ) |\n\n\u003c!-- CONTRIBUTORS:END --\u003e\n\n**Used by:**\n| Server |   |\n|--------|----------|\n| [rangemc]( https://www.rangemc.net/ ) | \u003cimg src=\"https://github.com/user-attachments/assets/c65bc715-02da-4c69-94f7-7c3b96ab9d14\" width=\"50\" /\u003e | \n\n\u003cdiv align=\"center\"\u003e\u003csup\u003eLive Statistics\u003c/sup\u003e\u003c/div\u003e\n\n[![img](https://bstats.org/signatures/bukkit/HologramAPI.svg)](https://bstats.org/plugin/bukkit/HologramAPI/19375)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eUsed by 80+ servers | 6,000+ downloads across platforms\u003c/sub\u003e\u003cbr\u003e\n  \u003ca href=\"https://www.spigotmc.org/resources/111746/\"\u003eSpigotMC\u003c/a\u003e •\n  \u003ca href=\"https://hangar.papermc.io/maximjsx/HologramLib\"\u003eHangar\u003c/a\u003e •\n  \u003ca href=\"https://modrinth.com/plugin/hologramlib\"\u003eModrinth\u003c/a\u003e •\n  \u003ca href=\"https://github.com/HologramLib/HologramLib/releases/latest\"\u003eLatest Release\u003c/a\u003e •\n  \u003ca href=\"https://discord.gg/2UTkYj26B4\"\u003eSupport\u003c/a\u003e\u003cbr\u003e\n  \u003csub\u003eLicense: GPL-3.0 | © 2025 \u003ca href=\"https://github.com/maximjsx/\"\u003eMaxim\u003c/a\u003e\u003c/sub\u003e\n\u003c/div\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHologramLib%2FHologramLib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHologramLib%2FHologramLib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHologramLib%2FHologramLib/lists"}