Rosetta

模组

· 作者 jhughes-dev

一个用于引导玩家使用你模组的库模组。

0 本站下载 0 关注 更新于 2 个月前

最新 v0.1.1-neoforge-26.3 · 26.3 · NeoForge

一键开服(送7天)

Rosetta

Rosetta 是一个客户端库模组,用于以统一且精致的方式呈现新手引导教程、提示和更新日志。

如果你是因为惊讶地发现它被安装而阅读此内容,那很可能是因为你安装了其他依赖它来提供新手引导功能的模组(例如 build-better、drop-highlighter 等)。

Rosetta 为你带来的功能

当安装了基于 Rosetta 的模组时,你会获得一个统一的新手引导系统(一次性弹窗),帮助你了解该模组的功能、获取提示、警报以及作者希望你知道的其他信息。对于作者而言,最大的优势在于这些引导卡片不会互相冲突。如果每个模组都实现自己的系统,它们会同时渲染。Rosetta 会对内容进行排队并管理显示顺序、版本追踪,以及记录用户是否已查看过任何卡片或指示器。

  • 首次启动卡片。 模组可以在你安装后第一次加载世界时显示全屏欢迎卡片,解释模组的作用及其主要功能的使用方法。每张卡片有一个“确认”按钮。已关闭的卡片不会再出现,除非作者发布了新内容。
  • HUD 弹出提示。 采用原版风格的提示气泡,在你执行模组希望教导的操作时出现在物品栏上方;例如拾取新物品类型、打开新 GUI 界面或首次触发某项功能。可选音效提示。
  • 多页幻灯片教程。 逐步引导流程,每页幻灯片会调暗背景并高亮特定的 UI 区域。模组利用这种方式深入教授某项功能,避免堆砌大量文字。
  • 重播已看过的卡片。 随时打开 Rosetta 重播界面,重新阅读你之前关闭的教程,浏览模组留下的更新日志备注,或复习你遗忘的功能。
  • 统一的提示收件箱。 当你忙于其他事务(如与生物战斗、滑翔、睡觉)时,如果模组试图向你展示某些内容,Rosetta 会将提示排队而不是打断你。HUD 上的一个小指示器让你可以在准备好时打开收件箱。

它如何改变你的体验

  • 教程永远不会中断战斗。 Rosetta 会自动抑制在你受到伤害、睡觉、滑翔、死亡或处于旁观者模式时的卡片显示。你不会在战斗中途看到“欢迎来到这个模组!”之类的屏幕。
  • 所有模组共用一套 UI。 与其让每个模组发明拥有不同快捷键、布局和关闭机制的欢迎界面,基于 Rosetta 的模组共享相同的外观和交互风格,并且避免了多个模组争夺顶层渲染的问题。
  • 你的关闭操作会生效。 你已确认的卡片会在游戏会话之间保持已确认状态。状态数据保存在你的 Minecraft 安装中。无需云端同步,也不进行跨服务器追踪。
  • 卡片分类以便筛选。 教程、提示、警告、“新功能”说明和致谢等内容会被打上相应标签,因此重播界面会以合理的方式对它们进行分组。

Rosetta 不做什么

  • Rosetta 不会添加任何游戏内内容(没有方块、物品、生物、维度或配方)。
  • Rosetta 仅限客户端。 服务器无需安装它,服务器也无法通过它推送消息。
  • 单独安装 Rosetta 不会产生任何可见效果。它需要一个使用 Rosetta 来提供内容的模组才能发挥作用。

面向模组作者

Rosetta 为常见情况提供了基于 JSON5 的卡片注册格式(位于模组资源中的 rosetta-onboard.json5),并为高级情况提供了 Java Builder API(支持自定义触发器、游戏内指针、多页幻灯片教程和自定义组件)。如果你修改了某张卡片,可以通过修改卡片的版本号使其在内容变更后重新显示,或者为每个主要版本注册新的 ID 以展示“新功能”备注。分类(tutorial、tip、warning、news、credits)驱动着重播界面的分组逻辑。

AI 声明

所有游戏内素材:图像、文本和声音均为手工制作。AI 编程助手仅用于生成 Java 代码。所有代码均经过人工审核验证。

支持的加载器: Fabric, NeoForge
支持的 Minecraft 版本: 1.21.1 至 26.1.2
Java 版本要求: 21 (1.21.x) / 25 (26.x)
文档:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源