
Proteus is the UI library behind Olympus mods like Orpheus and Mneme. You pick how things look once, and every mod that uses it follows. It also works on its own and can restyle the game's own toasts.
It's client-side only, so it works on any server and nobody else needs to install it.

- Pick a style. Modern has rounded widgets, background blur and smooth animations. Classic brings back the old Minecraft look with the dirt background, bevelled gray buttons and no animation.
- Choose an accent color. Use a preset, set your own hue, or turn on chroma and let it cycle through the rainbow.
- Get better toasts. Proteus toasts ease in and out, show an item icon, grow to fit their text, show up over menus as well as in game, and can sit in any corner.
- Restyle the game's toasts. Advancements, recipes, tutorial hints and system notices can be drawn by Proteus too. Each kind can be set back to vanilla.
- Move between mods in one menu. Every mod built on Proteus gets a card at the top of its menu, so you can go from Orpheus to Mneme to the Proteus settings without closing anything.
Open the settings with the Proteus key (unbound by default, under Controls, Miscellaneous), the config button in Mod Menu or the mods list, or the Proteus card in any Olympus mod's menu.

The Classic style is drawn from GUI sprites under proteus:classic, so a resource pack can restyle it.
assets/proteus/textures/gui/sprites/classic
├── icon
│ ├── cross.png
│ ├── left.png
│ └── right.png
├── button.png
├── button.png.mcmeta
├── button_disabled.png
├── button_disabled.png.mcmeta
├── button_hover.png
├── button_hover.png.mcmeta
├── button_selected.png
├── button_selected.png.mcmeta
├── checkbox.png
├── checkbox_checked.png
├── checkbox_checked_hover.png
├── checkbox_hover.png
├── field.png
├── field.png.mcmeta
├── field_focused.png
├── field_focused.png.mcmeta
├── inset.png
├── inset.png.mcmeta
├── panel.png
├── panel.png.mcmeta
├── progress.png
├── progress.png.mcmeta
├── progress_fill.png
├── progress_fill.png.mcmeta
├── row_hover.png
├── row_hover.png.mcmeta
├── row_selected.png
├── row_selected.png.mcmeta
├── scroller.png
├── scroller.png.mcmeta
├── scroller_track.png
├── tooltip.png
└── tooltip.png.mcmeta

Proteus gives you animated, themed widgets, toasts, HUD overlays and a card in the shared menu, and it keeps working the same across every supported Minecraft version. How to set it up is on GitHub.

Minecraft 1.20 to 26.3 on Fabric, Forge and NeoForge.
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.20-1.20.2 | ✅ | ✅ | |
| 1.20.3-1.20.4 | ✅ | ✅ | ✅ |
| 1.20.5-1.20.6 | ✅ | ✅ | ✅ |
| 1.21-1.21.1 | ✅ | ✅ | ✅ |
| 1.21.2-1.21.3 | ✅ | 1.21.3 | 1.21.3 |
| 1.21.4-1.21.5 | ✅ | ✅ | ✅ |
| 1.21.6-1.21.8 | ✅ | ✅ | ✅ |
| 1.21.9-1.21.10 | ✅ | ✅ | ✅ |
| 1.21.11 | ✅ | ✅ | ✅ |
| 26.1-26.1.2 | ✅ | ✅ | ✅ |
| 26.2-26.3 | ✅ | ✅ | ✅ |
Pick the file that matches your loader and game version. Fabric needs Fabric API.
Licensed under GPL-3.0.

