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)
文档:
Rosetta
Rosetta is a client-side library mod used to deliver onboarding tutorials, tips, and changelogs in a consistent, polished way.
If you're reading this because you're surprised to find it installed, it's probably because some other mod (build-better, drop-highlighter, etc.) depends on it for onboarding features.
What Rosetta does for you
When a Rosetta-powered mod is installed, you get a unified onboarding system (one-time popups) that help you navigate that mods features, get hints, alerts, and other information that the mod author wants you to see. For authors, the biggest advantage is that the onboarding cards don't step on each other. If every mod implemented its own system, they'd all render at the same time. Rosetta enqueues and manages the order, version tracking, and whether a user has seen any card or indicator.
- First-launch cards. Mods can show a full-screen welcome card the first time you load a world after installing them, explaining what the mod does and how to use its main features. One "Acknowledge" button per card. Dismissed cards don't come back unless the mod author has new content for you.
- HUD pop-up hints. Vanilla-styled hint toasts that appear above your hotbar when you do something a mod wants to teach you about ; picking up a new item type, opening a new GUI, triggering a feature for the first time. Optional sound cue.
- Multi-slide tutorials. Step-by-step walkthroughs that dim the background and highlight specific UI regions per slide. Used by mods to teach a feature in depth without dumping a wall of text.
- Replay any card you've seen. Open the Rosetta replay screen at any time to re-read a tutorial you dismissed, browse changelog notes a mod left behind, or refresh yourself on a feature you forgot.
- A unified notification inbox. When a mod tries to teach you something while you're busy (fighting a mob, gliding, sleeping) Rosetta queues the hint instead of interrupting. A small indicator on the HUD lets you open the inbox when you're ready.
How it changes your experience
- Tutorials never interrupt combat. Rosetta automatically suppresses cards while you're taking damage, sleeping, gliding, dead, or in spectator mode. You won't get a "welcome to this mod!" screen mid-fight.
- One UI for every mod. Instead of each mod inventing its own welcome screen with different keybinds, layouts, and dismiss behavior, Rosetta-powered mods share the same look and feel and let's the mods not have to fight for rendering on top.
- Your dismissals stick. Cards you've acknowledged stay acknowledged across game sessions. State lives with your Minecraft install. No cloud, no per-server tracking.
- Cards are categorized for filtering. Tutorials, tips, warnings, what's-new notes, and credits are tagged as such, so the replay screen groups them sensibly.
What Rosetta does NOT do
- Rosetta does not add any in-world content (no blocks, items, mobs, dimensions, recipes).
- Rosetta is client-only. Servers don't need it installed, and servers cannot push messages through it.
- Installing Rosetta on its own will do nothing visible. It requires a mod that uses Rosetta to deliver content.
For mod authors
Rosetta provides a JSON5-based card registration format for common cases (rosetta-onboard.json5 in your mod's resources) plus a Java builder API for advanced cases (custom triggers, in-world pointers, multi-slide tutorials, custom widgets). If you change a card, you can reshow it by modifying the card's version number to re-show it after content changes, or register a new ID per major release for "what's new" notes. Categories (tutorial, tip, warning, news, credits) drive the replay UI grouping.
AI Statement
All in-game assets: image, text, and sounds are made by hand. AI Coding Assistants are used to generate java code. All code is verified by human eyes.
Supported loaders: Fabric, NeoForge Supported Minecraft versions: 1.21.1 through 26.1.2 Java level: 21 (1.21.x) / 25 (26.x) Doc:
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rosetta
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧