Dreamcraft Networks 公告 API

Dreamcraft 网络公告 API

一个轻量级、即插即用的 Minecraft NeoForge 模组公告系统。

---

📋 概述

Dreamcraft 网络公告 API 是一个模块化库，旨在允许 Minecraft 模组直接向玩家显示动态的、由服务器驱动的公告。非常适合全网络活动、维护通知、更新或社区亮点——无需更新模组即可实现。

此 API 负责处理：

• ✅ 基于远程 JSON 的公告获取
• ✅ 异步加载（无主线程卡顿）
• ✅ 优雅、可自定义的游戏内 UI
• ✅ 可点击链接并带有悬停效果
• ✅ 会话管理（每次启动仅显示一次）
• ✅ 完全兼容 NeoForge 1.21.1+ / 1.21.x

---

✨ 特性

特性	描述
🌐 远程配置	从任何 HTTPS 端点获取公告。无需重新构建模组即可即时更新消息。
🎨 精致 UI	精美的渐变边框、发光效果、样式化的页眉/页脚以及响应式布局。
🔗 交互式链接	嵌入可点击的按钮或页脚链接，可直接从游戏中打开浏览器。
⚡ 非阻塞	使用 CompletableFuture 进行异步 HTTP 请求——对游戏性能零影响。
🔄 会话控制	公告在每个游戏会话中仅显示一次。可通过 AnnouncementManager.resetSession() 重置。
🧩 易于集成	只需将 JAR 添加到你的 libs/ 文件夹，并在标题画面处理器中调用一个方法即可。

---

📦 安装

Gradle (NeoForge)

dependencies {
    // 将 API JAR 添加到你的 libs 文件夹，然后：
    implementation files('libs/dreamcraftnetworksannouncementsapi-1.0.jar')
}