🌠 Soothing pastel theme for Meteor Client and Asteroid.
Requires Meteor Client or Asteroid.
Asteroid issues
Crash with Minecraft 1.21.1 / 1.21.4 / 1.21.11
This version is incompatible with Asteroid. There is no fix.
Crash with Minecraft 26.1.2
Update to the latest Minecraft version or downgrade Catppuccin to 2.1.0.
✨ Features
-
🟣 Epic Rounded Corners™
(Powered by custom shaders and meshes. Perfectly smooth rounded corners with configurable radius) -
🌈 Epic Flavors and Colors from the Catppuccin Palette
(Latte, Frappé, Macchiato, Mocha and all the colors) -
🌀 Epic Smooth Animations™
(Configurable duration and easing, now even better and smoother after v2 update) -
🔤 Epic Font Rendering™
(Supports bold, italic, and dynamic font style switching) -
🧲 Epic Snap-to-Grid for Modules Screen™
(Keeps your GUI very epic looking and organized) -
🔎 Epic Search™
(Leveraging advanced query-parsing technology to help you find 'AutoCrystal' 0.4ms faster)
🛠️ For Developers
Want to add support for the Catppuccin Theme in your addon?
Gradle Setup
Add the JitPack repository and the API dependency to your build.gradle.kts.
repositories {
maven {
name = "jitpack"
url = uri("https://jitpack.io")
}
}
dependencies {
// Use the ':api' classifier to not include the whole theme in your addon
// Note: Make sure '${mc_version}' matches your target Minecraft version (e.g. "1.21.1"),
// also replace '${catppuccin_version}' with the latest Catppuccin version (e.g. "2.0.0")
include(modImplementation("com.github.X-C-0.catppuccin-addon:${mc_version}:${catppuccin_version}:api"))
// Optional: Add the full theme to your runtime environment
modLocalRuntime("com.github.X-C-0.catppuccin-addon:${mc_version}:${catppuccin_version}")
}
Registering Custom Icons
If your addon adds new categories, you can register custom icons for them to match the theme style.
// Check the javadocs for usage
CatppuccinIcons.registerCategoryIcon(categoryName, texture);
💬 Support
- Find me on Meteor's discord (
@Pindour) or join my silly Discord Server if you want to hang out. - Found a bug? Open an Issue (please include logs/screenshots).
How to Install Catppuccin Theme Addon (Mod)
Catppuccin Theme Addon by X-C-0 is verified for Fabric across Minecraft versions 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.4, 26.1.2, 26.2, 26.3 (latest release: 2.4.0+mc1.21.1, file size: 426 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.4, 26.1.2, 26.2, 26.3) and platform (Fabric).
- Make sure you have the compatible loader or environment installed for Fabric.
- Move the downloaded Catppuccin Theme Addon file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add VersionBig thanks to @DontBlameMeDev for the update and fixes!
## 🐛 Fixed
- Color Setting Screen:** The slider's value label stuck at 0 after pressing Reset, picking a palette color, or applying a link.
- Palette Grid:** The swatch now unchecks itself once the color has been modified.
- Color Links:** Resetting a setting now also removes its color link.
- Search Popup:** Capped the results view so the search popup stays inside the window bounds (#32).
- Fixed ConcurrentModificationException crash caused by Setting Watcher.**
## 🚀 New Features
- Shadows:** Rounded rectangles can now render soft shadows.
<summary>Click to view image</summary>
<img width=273 height=201 alt=image src=https://github.com/user-attachments/assets/61ce1bec-937e-4147-8120-5652ba604d83 />
</details>
- Color Links:** Color settings can now be linked to any Catppuccin palette color, so they always stay in sync with the theme.
<summary>Click to view image</summary>
<img width=271 height=650 alt=image src=https://github.com/user-attachments/assets/f608f9a3-a9d0-4e4e-b710-07dd27e5e57a />
</details>
- New Color Picker Screen:** A fully re-built color setting screen, complete with a Catppuccin color grid and color sliders.
<summary>Click to view image</summary>
<img width=275 height=614 alt=image src=https://github.com/user-attachments/assets/64836381-572a-472d-ae2f-17bb20d27a5b />
</details>
- Tab View:** The Top Bar now uses the brand new Tab View widget and comes with a cool switching animation.
<summary>Click to view image</summary>
<img width=851 height=66 alt=image src=https://github.com/user-attachments/assets/d87fa890-7be1-4778-adca-45057a6ca7cc />
</details>
- LongEdit Widget:** Added support for the new LongEdit setting widget.
- Watermark Toggle:** Added a setting to hide the Catppuccin Theme by Pindour watermark in the Modules Screen.
## ✨ Added & Tweaks
- Buttons:** Buttons can now display an icon and text at the same time.
- Labels:** Label widgets now support custom text alignment.
- Scrollbar:** The scrollbar handle now sits on a background track (with an outline) for better visibility.
- Material 3 Expressive Slider:** A brand new look for sliders!
<summary>Click to view image</summary>

</details>
- Top Bar Icons:** Added all-new icons for the top bar (can be turned off in settings) - with API for Addon devs.
<summary>Click to view image</summary>

</details>
- Setting Indents:** Settings with conditional visibility are now beautifully indented for better readability (can be turned off in settings).
<summary>Click to view image</summary>

</details>
- Back Animation:** Added a very epic new bounce effect animation for windows and sections.
## ✨ Added & Tweaks
- Minecraft 26.2 Support**
- Checkbox:** Added tick icon and now uses the new back in out animation.
- File Setting Widget:** Added support for the new File Setting widget (26.2+).
- Dropdowns:** Added a smooth hover effect for dropdown buttons.
## 🐛 Fixed
- Keybinds:** Restored the missing reset button for Keybinds (#26).
- Vector3D Widget:** Fixed the reset button being always visible and added indenting.
- Textboxes:** Fixed scaling issues for wide textboxes.
- Potion Widget:** Fixed a bug where the potion widget wasn't showing the potion's name.
- And some additional behind-the-scenes tweaks and fixes.*
Asteroid is missing some classes (File Setting) from Meteor, which the theme needs.
- Support for Minecraft 26.1.2
### Changed
- Migrated from yarn to Mojang mappings