{"id":46336267,"url":"https://github.com/dreamin-mc/dreamhud","last_synced_at":"2026-03-04T19:01:28.507Z","repository":{"id":321685573,"uuid":"1086829770","full_name":"Dreamin-MC/DreamHud","owner":"Dreamin-MC","description":"HudLib for manage and create hud in minecraft server","archived":false,"fork":false,"pushed_at":"2025-11-20T22:04:01.000Z","size":24840,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-20T23:32:53.529Z","etag":null,"topics":["dreamin","hud","hud-api","hud-lib","java","lib","minecraft","minecraft-plugin"],"latest_commit_sha":null,"homepage":"","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/Dreamin-MC.png","metadata":{"files":{"readme":"README.md","changelog":"changelog/1.0.0.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-31T01:03:35.000Z","updated_at":"2025-11-20T22:04:05.000Z","dependencies_parsed_at":"2025-10-31T01:28:28.781Z","dependency_job_id":null,"html_url":"https://github.com/Dreamin-MC/DreamHud","commit_stats":null,"previous_names":["dreamin-mc/dreamhud"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Dreamin-MC/DreamHud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dreamin-MC%2FDreamHud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dreamin-MC%2FDreamHud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dreamin-MC%2FDreamHud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dreamin-MC%2FDreamHud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dreamin-MC","download_url":"https://codeload.github.com/Dreamin-MC/DreamHud/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dreamin-MC%2FDreamHud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30090037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T18:31:08.343Z","status":"ssl_error","status_checked_at":"2026-03-04T18:31:07.708Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["dreamin","hud","hud-api","hud-lib","java","lib","minecraft","minecraft-plugin"],"created_at":"2026-03-04T19:01:27.543Z","updated_at":"2026-03-04T19:01:28.479Z","avatar_url":"https://github.com/Dreamin-MC.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✨ DreamHud\n\n[![Version](https://img.shields.io/badge/version-1.0.2-blue.svg)](https://github.com/dreamin/dreamintablist)\n[![](https://jitpack.io/v/Dreamin-MC/DreamHud.svg)](https://jitpack.io/#Dreamin-MC/DreamHud)\n[![Java](https://img.shields.io/badge/java-21-orange.svg)](https://www.oracle.com/java/)\n[![Minecraft](https://img.shields.io/badge/minecraft-1.21.8-green.svg)](https://www.minecraft.net/)\n[![License](https://img.shields.io/badge/license-GPL-lightgrey.svg)](LICENSE)\n\n---\n\n### 🧠 Overview\n\n**DreamHud** is a modern and high-performance library for **displaying dynamic HUDs** on **Minecraft Paper 1.21+** servers using the **bossbar** system.\nDesigned for **customization**, **smoothness**, and **creativity**, it allows developers to create immersive and completely **custom-made** interfaces.\n\n---\n\n### ⚡ Key Features\n\n- 🎨 **Dynamic Components** — Build your HUDs from `Layout`, `Hud`, and `Element`.\n- 🧩 **Seamless Integration** — Compatible with all plugins and APIs of the Dreamin Ecosystem.\n- 🧠 **Intelligent Rendering** — Automatically manages offsets, spacing, and display priorities.\n- 🔤 **Full support for custom fonts** (via resource pack).\n- 🪶 **Ultra-lightweight and optimized** — Zero lag, instant rendering via bossbars.\n- 🛠️ **Intuitive API** — Uses the latest features of Adventure \u0026 Kyori Components.\n\n---\n\n### 🧭 Project Goal\n\nThe idea behind DreamHud is to **replace the basic Minecraft HUDs** with a **flexible and modular** system capable of:\n- displaying **contextual information** (health, score, objectives, timers, etc.),\n- animating **visual scenes** or event transitions,\n- allowing servers to have a **unique visual identity**.\n\nDreamHud is **used in production** on projects within the **Dreamin'** ecosystem, particularly for dynamic HUDs, cinematics, and immersive interfaces. ---\n\n### 🧱 Project Structure\n\n```\n📦 DreamHud\n┣ 📁 changelog/\n┃ ┗ … (file changelog.)\n┣ 📁 assets/\n┃ ┗ … (visual resources, images, etc.)\n┣ 📁 examples/\n┃ ┗ … (usage examples, practical cases)\n┣ 📁 src/\n┃ ┣ 📁 api/\n┃ ┃ ┗ … (public interfaces, builders, etc.)\n┃ ┣ 📁 internal/\n┃ ┃ ┗ … (internal implementations, rendering logic, etc.)\n┣ 📄 API_USAGE_GUIDE.md\n┗ 📄 README.md\n```\n\n---\n\n### 🧩 Developer Integration\n\n#### 💻 Adding as a Dependency\n\n**Maven**\n```xml\n\u003crepositories\u003e\n\u003crepository\u003e\n\u003cid\u003ejitpack.io\u003c/id\u003e\n\u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n\u003c/repository\u003e\n\u003c/repositories\u003e\n\n\u003cdependency\u003e\n\u003cgroupId\u003ecom.github.Dreamin-MC\u003c/groupId\u003e\n\u003cartifactId\u003eDreamHud\u003c/artifactId\u003e\n\u003cversion\u003eTag\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n**Gradle**\n```groovy\nrepositories {\nmaven { url \"https://jitpack.io\" }\n}\ndependencies {\ncompileOnly 'com.github.Dreamin-MC:DreamHud:Tag'\n}\n```\n\n---\n\n### 🚀 Quick Overview\n\n![Banner](/assets/image.png)\n\n➡️ Each block is generated **dynamically** via the player's bossbar.\nTexts, colors, fonts, and positions are **100% configurable** via code or a JSON file.\n\n---\n\n### 🧃 Dreamin’ Ecosystem\n\nDreamHud is part of the **Dreamin Ecosystem**, a set of modular projects designed to enrich the server-side Minecraft experience:\n\n| Project | Description |\n|--------|--------------|\n| 🧠 **DreamAPI** | Central and abstract API common to all modules. |\n| 🌈 **DreamHud** | Dynamic display of HUDs and overlays. |\n\n---\n\n### 🛠️ Project Status\n\n| État | Version         | Compatibilité             |\n|------|-----------------|---------------------------|\n| 🧪 Under active development | `v1.0.2`        | Paper 1.21.8              |\n| 🔜 Final migration | `DreamHud` (v2) | Stable and public API planned |\n\n\u003e ⚠️ *The current version (DreamHud v1) serves as the technical foundation for DreamHud v2.\nMajor API changes are to be expected.*\n\n---\n\n### 📚 Documentation\n\n📘 **[→ API Usage Guide](API_USAGE_GUIDE.md)**\nContains:\n- detailed code examples;\n- complete documentation of public classes;\n- integration examples with other modules of the Dreamin Ecosystem.\n\n---\n\n### 🤝 Contributing\n\nContributions are welcome!\nBefore any PR, please check:\n- that the code follows the general project style;\n- that the added features are tested and documented;\n- that Minecraft/Paper 1.20+ compatibility is maintained.\n\n---\n\n### 📄 License\n\nThis project is distributed under the **GPL-3.0** license.\n➡️ [See the LICENSE file](LICENSE)\n\n---\n\n## 📞 Support\n\n- **Documentation**: [API Usage Guide](API_USAGE_GUIDE.md)\n- **Examples**: [examples/](examples/)\n- **Issues**: [GitHub Issues](https://github.com/dreamin/dreamhud/issues)\n- **Discord**: [Join our Discord](https://discord.gg/dreamin)\n\n---\n\n![Banner](/assets/banner.png)\n\n**Made with ❤️ by the Dreamin Studio**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamin-mc%2Fdreamhud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdreamin-mc%2Fdreamhud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamin-mc%2Fdreamhud/lists"}