promotional bannermobile promotional banner

Proteus by Olympus

The UI library behind Olympus mods: a Modern or Classic look, an accent color and better toasts, shared by every mod that uses it.

Proteus

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.


What you can do


  • 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.


Resource packs


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

For mod authors


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.


Supported versions


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.

Proteus by Olympus Team

profile avatar
  • 4
    Projects
  • 1.8K
    Downloads

More from YeahAkis

  • FastChest Revived project image

    FastChest Revived

    Renders chests as normal blocks instead of block entities, so big storage rooms stop eating your FPS

    • 1.0K
    • October 20, 2026
  • Orpheus by Olympus project image

    Orpheus by Olympus

    Precise control over vanilla Minecraft music: per-situation track lists, frequency, weights, playback keys and presets.

    • 337
    • October 19, 2026
  • BetterCopycats project image

    BetterCopycats

    Lets flowers and other plants be placed on copycat blocks and slabs, including half a block lower on bottom slabs.

    • 217
    • October 19, 2026
  • FastChest Revived project image

    FastChest Revived

    Renders chests as normal blocks instead of block entities, so big storage rooms stop eating your FPS

    • 1.0K
    • October 20, 2026
  • Orpheus by Olympus project image

    Orpheus by Olympus

    Precise control over vanilla Minecraft music: per-situation track lists, frequency, weights, playback keys and presets.

    • 337
    • October 19, 2026
  • BetterCopycats project image

    BetterCopycats

    Lets flowers and other plants be placed on copycat blocks and slabs, including half a block lower on bottom slabs.

    • 217
    • October 19, 2026