
Modrinth · Minecraft mod
CustomButton
The mod adds a configuration screen to Minecraft, allowing users to customize the colors, opacity, and sizes of interface elements such as buttons, checkboxes, and sliders using palettes and sliders. It supports personalization through hue selection in an
Quick answer
Which CustomButton release matches 26.2-rc-2?
CustomButton 0.99-beta targets 26.2-pre-1, 26.2-pre-2, 26.2-pre-3 with Fabric. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.
Where it goes
Is CustomButton required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does CustomButton 0.99-beta need?
0.99-beta on 26.2-rc-2. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add CustomButton without breaking your instance.
Built for CustomButton 0.99-beta on 26.2-rc-2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 0.99-beta. It targets 26.2-pre-1, 26.2-pre-2, 26.2-pre-3 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 0.99-beta. It opens that exact file at the source.
About this project
What does CustomButton add?
CustomButton
Environment: Client-side
Loader: Fabric
The ultimate GUI customization mod for Fabric — now with crosshair, hotbar, and item name customization, support for multiple languages, and various visual tweaks.
📖 What is this mod?
Does Minecraft’s default interface feel a bit dull? Want to tweak buttons, checkboxes, sliders, crosshairs, hotbars, or item names to match your personal style—perhaps a sleek modern vibe or bold, vibrant colors? CustomButton makes it possible!
This client-side Fabric mod offers a powerful in-game configuration screen, allowing full customization of Minecraft’s GUI elements. With intuitive controls, you can create a unique interface that feels truly yours.
✅ Features
🎨 Deep GUI Customization
- Customize background and text colors for buttons, checkboxes, sliders, hotbars, and item names using an intuitive HSV color picker.
- Adjust transparency (opacity) for backgrounds, slider handles, and active hotbar slots.
- Modify corner radius for rounded or sharp designs across buttons, checkboxes, sliders, and hotbars.
- Fine-tune slider settings like handle size and text offset.
- Design your own crosshair with a pixel-based editor, including size and color customization.
- Adjust item name rendering with fade time and vertical offset settings.
- Configure hotbar appearance, including background and active slot styling.
🛠 In-Game Configuration Screen
- Access the configuration menu via the game menu (default key:
P) to customize elements in real-time. - Organized tabs for buttons, highlighted buttons, checkboxes, sliders, highlighted sliders, crosshairs, hotbars, and item names.
- All changes are saved automatically to a JSON config file for seamless session persistence.
👁️ Visual Feedback
- Instantly preview color choices with a live preview box.
- Real-time crosshair editing with grid-based pixel editor and eraser mode for precision.
🌍 Localization Support
- Supports multiple languages in the configuration screen to accommodate a global audience.
⚡ Lightweight and Efficient
- Optimized for Fabric with minimal performance impact.
- No server-side installation required — ideal for both singleplayer and multiplayer.
🧩 Usage Examples
- Customizing a Button: Create a sleek, modern look by adjusting background color and corner radius.
- Tuning a Slider: Fine-tune the handle size and text offset for precise GUI control.
- Designing a Crosshair: Use the pixel editor to craft a custom crosshair with your preferred colors and shape.
- Styling the Hotbar: Personalize the hotbar’s background and active slot styling.
- Customizing Item Names: Adjust tooltip fade time and vertical position for item names.
📖 How to Use
- Install the mod and Fabric API in your
modsfolder. - Launch Minecraft and press
Pin the game menu to open the CustomButton configuration screen. - Use the tabbed interface to customize any GUI element with real-time previews.
⚙️ How It Works Internally
CustomButton uses Mixin to hook into Minecraft’s GUI rendering system, overriding the default rendering for buttons, checkboxes, sliders, crosshairs, hotbars, and item names. It uses Minecraft’s widget system to provide a custom config screen and stores settings in a JSON file (config/custombutton.json). The crosshair customization is powered by a pixel-based editor for maximum flexibility.
✅ Compatibility
- Requires: Fabric API
- Fully Compatible: Sodium
- Supports: ModMenu (for easy config access)
- Note: Avoid using multiple GUI-rendering mods simultaneously to prevent conflicts.
Project description from Modrinth.
Pick your setup
CustomButton by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2-rc-1
1 loader build26.2-pre-6
1 loader build26.2-pre-5
1 loader build26.2-pre-4
1 loader build26.2-pre-3
1 loader build26.2-pre-2
1 loader build26.2-pre-1
1 loader build26.2
1 loader build26.1.2
1 loader build1.21.11
1 loader build1.21.6
1 loader buildShowing the newest 12 of 17 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
CustomButton versions and loaders
0.99-beta
CustomButton-0.99-beta.jar
8 Jun 2026
Looking for an older file? The official Modrinth project page is in Resources.