Back to mods
CustomButton project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which CustomButton release matches 26.2-rc-2?

Updated 3 months ago
beta file 0.99-beta
Game version 26.2-pre-1, 26.2-pre-2, 26.2-pre-3
Loader Fabric

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.

Client Required
Dedicated server Not supported
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

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

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

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

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

  1. Install the mod and Fabric API in your mods folder.
  2. Launch Minecraft and press P in the game menu to open the CustomButton configuration screen.
  3. 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.

17 available setups

Showing 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

1 of 18 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.