Proteus by Olympus

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, chat, menus, effects and tooltips.

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. Liquid Glass bends the background at the edges like real glass, with a bright rim and springy motion. Aero looks like Windows 7 with frosted frames in your accent color and glossy buttons. Windows 98 has gray bevelled surfaces, a blue title bar and no animation.
• Use themes from resource packs. Every style is a theme, and a pack or a mod can add its own or change an existing one: colors, borders, corners, shadows, textures, sizes and every 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 stack, with a new one pushing the others out of the corner. They 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.
• Restyle more of the game. The Vanilla UI tab has a switch for the game's menus, chat, effects and tooltips. Menus get the theme's buttons, sliders, lists and backdrop. Chat messages become floating bubbles. Active effects get a plate with a pulse before they run out. Tooltips get the theme's box. Only toasts are on by default.
• Pick which mods it draws. Proteus can also draw the menus of Simple Voice Chat, MaLiLib (and Litematica, MiniHUD and Tweakeroo) and Ji AFK Cinematic. The Mods tab has a switch for each one you have installed.
• 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.

A theme is a JSON file in a resource pack at assets/<namespace>/proteus/themes/<name>.json. It shows up in the Style list, and F3+T reloads it. The format is explained on GitHub.

The Classic style is also 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. Every upload on Modrinth's Maven has its own version number, like 1.1.0+fabric-1.21-1.21.1, and how to set it up is on GitHub.

Minecraft 1.20 to 26.3 on Fabric, Forge and NeoForge.

Pick the file that matches your loader and game version. Fabric needs Fabric API.

Licensed under GPL-3.0.

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.

Pick the file that matches your loader and game version. Fabric needs Fabric API.

Licensed under GPL-3.0.