Rosetta

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.

- A unified notification inbox. 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. - A unified notification inbox. 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. - A unified notification inbox. 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. - A unified notification inbox. 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

- Cards are categorized for filtering. 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. - Cards are categorized for filtering. 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. - Cards are categorized for filtering. 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.

Doc: Fabric, NeoForge Doc: 1.21.1 through 26.1.2 Doc: 21 (1.21.x) / 25 (26.x) Doc: Doc: