ColorPicker in Godot – Complete Guide

Welcome to our exploration of the ColorPicker class in Godot 4, an essential tool for game developers and designers looking to incorporate color selection and modification features in their projects. Through this powerful widget, creators have the capability to revamp the aesthetics of their games and make interactive elements come to life. Intrigued? Let’s delve into the world of colors and see how mastering the ColorPicker can elevate your game development skills.

What is ColorPicker?

The ColorPicker in Godot is a versatile widget that facilitates the process of selecting and modifying colors within a game’s user interface. It’s an integral component that developers can employ to enable users to customize color settings in real-time. Whether it’s for choosing the tint of a player’s armor, the palette of a landscape, or creating dynamic themes, the ColorPicker is your go-to tool.

What is it for?

Imagine having the freedom to dynamically change the colors of your game elements, from characters to backgrounds to UI components. That’s exactly what the ColorPicker is designed for. With functionalities like color sampling, different color modes, and even customizable presets, this class is instrumental in making your game more interactive and personalized for your players.

Why Should I Learn It?

Learning to wield the ColorPicker tool effectively opens up a realm of possibilities for your game development journey. Not only does it allow for greater artistic expression and customization, but it also enhances user experience by giving players control over the game’s visual elements. Whether you are at the start of your coding adventure or are a seasoned coder looking to refine your skillset, mastering the ColorPicker will undoubtedly add a vibrant layer of depth to your creations.

CTA Small Image

Instantiating the ColorPicker

To begin using the ColorPicker in Godot 4, you first need to instantiate it as part of your scene or via code. Here’s the simplest way to create a ColorPicker node:

var color_picker =

Or if you’re using the Godot editor, you can add a ColorPicker node directly from the ‘Add Node’ menu.

Customizing the ColorPicker Appearance

Customization is key to ensuring the ColorPicker blends well with the rest of your game’s UI. You can adjust its size, visibility, and initial color using the following example:

color_picker.rect_min_size = Vector2(400, 300) # Sets the size of the ColorPicker
color_picker.visible = true # Makes the ColorPicker visible
color_picker.color = Color(1, 0, 0) # Sets the initial color to red

This ensures your ColorPicker not only functions well but also looks like a seamless part of your game.

Connecting to the Color Changed Signal

One of the powerful features of the ColorPicker is its ability to emit signals when the color changes. Here is how to connect to the color_changed signal:

color_picker.connect("color_changed", self, "_on_ColorPicker_color_changed")

func _on_ColorPicker_color_changed(new_color):
    print("The selected color is: ", new_color)

This will print the new color to the console every time the user selects a new color, allowing you to debug and understand how the color changes during interactions.

Saving and Loading Presets

The ColorPicker allows users to save colors as presets for later use. Let’s look at how to save a color preset:

color_picker.add_preset(Color(0.4, 0.5, 0.6)) # Adds a custom preset color

And here’s how you can remove a preset:

color_picker.erase_preset(Color(0.4, 0.5, 0.6)) # Removes the custom preset color

By utilizing presets, you can offer a more streamlined and user-friendly interface that aids users in maintaining color consistency throughout their experience.

Adjusting Color Modes

The ColorPicker offers different color modes, such as RGB, HSV, and the RGB Hexadecimal code. Here’s how you can switch the mode programmatically:

color_picker.edit_alpha = true # Allows editing the alpha channel
color_picker.hsv_mode = true # Changes the mode to HSV instead of RGB

This gives users more control over the selection of colors, catering to a wide variety of preferences and needs.

Remember, these examples are just scratching the surface of what’s possible with Godot’s ColorPicker. As you integrate these examples into your projects, feel free to explore and experiment to fully appreciate the flexibility of this tool. Keep in mind that practical implementation combined with creativity can lead to truly engaging and dynamic gaming experiences.

In the next part of our tutorial, we’ll delve even deeper into the functionalities of the ColorPicker and explore advanced techniques. Stay tuned to learn more about how to enhance the user’s interaction with colors in your game.

Building on the fundamentals of the ColorPicker tool in Godot, let’s explore additional features and code examples that will help you further customize and control color interaction within your games. By harnessing these advanced capabilities, you’ll be able to craft an even more refined and engaging gaming experience.

One of the first advanced features you might want to utilize is detecting when a user has finished selecting a color. This can be useful for applying color changes only when a selection is confirmed, rather than every time a color changes, which can be numerous times during the selection process. The relevant signal is “color_changed” for real-time changes and “popup_closed” for final selection:

color_picker.connect("popup_closed", self, "_on_ColorPicker_popup_closed")

func _on_ColorPicker_popup_closed():
    var final_color = color_picker.color
    # Apply the color where needed, e.g., update a character's outfit color

Another handy functionality is adjusting the visibility of the different parts of the ColorPicker. This is especially useful when you want to simplify the user interface or guide the user’s attention to specific functionalities. For instance, if you don’t want the user to deal with raw color values or hex, you may hide those elements:

color_picker.hide_slider("raw") # Hides the raw value slider
color_picker.hide_slider("hex") # Hides the hexadecimal value field

With Godot, you also have the flexibility to integrate the ColorPicker within other UI components, like a Popup or a custom dialog window. This is an excellent way to provide context to the ColorPicker or to integrate it within a settings menu:

var popup =
var color_picker =
popup.popup_centered(Vector2(400, 400)) # Display the popup with a specific size

Furthermore, if you wish to store the selected colors persistently — for instance, saving a player’s favorite color — you can easily do so by saving the ColorPicker’s color value to a config file or utilizing Godot’s built-in saving system:

func save_selected_color():
    var selected_color = color_picker.color
    var save_game ="user://saved_color.cfg", File.WRITE)

func load_selected_color():
    var save_game =
    if save_game.file_exists("user://saved_color.cfg"):"user://saved_color.cfg", File.READ)
        var color_string = save_game.get_line()
        color_picker.color = Color(color_string)

Through storing and retrieving the color value like this, players can have a personalized touch every time they start your game.

Last but not least, consider using the ColorPicker alongside Godot’s scripting to automate color-related tasks. For instance, you could use Lerp with the ColorPicker to smoothly transition between colors over time:

func transition_to_new_color():
    var start_color = current_object.color
    var end_color = color_picker.color
    var duration = 2.0 # Duration in seconds
    var elapsed_time = 0.0

    while elapsed_time < duration:
        elapsed_time += get_process_delta_time()
        var t = elapsed_time / duration
        current_object.color = start_color.linear_interpolate(end_color, t)
        yield(get_tree().create_timer(0.01), "timeout")
# Call transition_to_new_color() when you need to change to the new color

In the example above, ‘current_object’ refers to any object that you want to change color over time, such as a character or background.

By mastering these advanced techniques, you’ll tap into the true potential of the ColorPicker, laying the foundations for a user experience that is not only visually appealing but also interactive and customizable. Whether it’s for a strategic game, a creative tool, or a personalized menu system, the ColorPicker is an invaluable addition to your Godot toolkit.

We encourage you to experiment with these code examples and see how they can fit into your game. Each new line of code helps you not only understand the mechanics of the ColorPicker better but also offers insights into the powerful customization options that Godot provides.

Enhancing the user experience of your game often entails giving users a smooth and efficient way to select colors. Let’s look further into some examples of how you can fine-tune the ColorPicker experience in Godot to make it intuitive and responsive to user input.

Firstly, you might want to set the ColorPicker to always stay on top of other UI elements. This can be essential in complex interfaces where the ColorPicker needs to be accessed frequently:

color_picker.always_on_top = true

Next, consider there might be instances where you want to restrict the user’s ability to pick only from a predefined set of colors. In such cases, you can manually add the allowed colors and then disable the rest of the ColorPicker’s UI, leaving only the presets visible:

color_picker.add_preset(Color(1, 0, 0)) # Red
color_picker.add_preset(Color(0, 1, 0)) # Green
color_picker.add_preset(Color(0, 0, 1)) # Blue

# Hide unnecessary UI components

# Disable the color wheel or RGB/HSV bars

For games that feature color-based puzzles or decoration features, you might need to give feedback to players based on their color selection. Utilizing the ‘color_changed’ signal, you can update game logic or other UI elements dynamically:

color_picker.connect("color_changed", self, "_on_ColorPicker_color_changed")

func _on_ColorPicker_color_changed(new_color):
    # Let's say we need to turn a light on if the color is bright enough
    if new_color.v > 0.7: # 'v' is for value in HSV color model

There might also be scenarios where you’d want to trigger an action once the user has picked a color. For example, applying the color to a character and closing the ColorPicker right after the user makes a selection can be done as follows:

color_picker.connect("color_changed", self, "_on_ColorPicker_color_finalized")

func _on_ColorPicker_color_finalized(new_color):

If you are developing a tool within your game for designing or customizing game assets, like creating custom level themes or character skins, you might also want to let your users copy and paste colors. Godot’s ColorPicker has built-in methods for this:

func copy_color_to_clipboard():

func paste_color_from_clipboard():
    var clipboard = OS.get_clipboard()
    if clipboard != null:
        color_picker.color = Color8(clipboard)

Finally, for educational games or applications meant to teach color theory or art, you might want to display more detailed information about the current color. You can do so through extending your UI with labels that update as the color changes:

var color_label =

color_picker.connect("color_changed", self, "_on_ColorPicker_color_changed_with_label")

func _on_ColorPicker_color_changed_with_label(new_color):
    color_label.text = "R: %d, G: %d, B: %d" % [new_color.r8, new_color.g8, new_color.b8]

These code snippets illustrate just a handful of the versatile interactions you can script for the ColorPicker. With each line of code, you tune the player’s experience, fostering an environment where they can unleash their creativity or immerse themselves deeper into the gameplay. As you build and expand on these examples, you’ll find even more ways to integrate the ColorPicker seamlessly into your project, no matter what type of game or application you’re developing.

Remember, the power of Godot’s ColorPicker lies in its versatility and the freedom it offers for customization. Embrace these opportunities, and watch as your game world becomes a canvas for players’ expression, or your tools empower users in ways that are both functional and delightful.

Continue Your Game Development Journey

With the fundamentals of the ColorPicker in Godot 4 explored, your journey in game development is just getting started. The world of game creation is vast and there’s always more to learn, more to create, and more to explore. To keep advancing your skills and diving deeper into game development with Godot 4, we invite you to check out our Godot Game Development Mini-Degree. This comprehensive program will guide you through building cross-platform games and cover a wide array of topics that are crucial for any aspiring game developer.

Our collection of Godot courses is specifically designed to take you from beginner to professional, equipping you with the knowledge to create stunning games in a flexible and powerful environment. The courses are structured to ensure you can learn at your own pace, tackle interactive lessons, and undertake coding challenges that solidify your understanding. Plus, you’ll earn certificates to validate your achievements along the way.

Whether you are just starting out or looking to refine existing skills, our curriculum has something for everyone. By joining Zenva Academy, you gain access to a wide selection of content that not only educates but also empowers you to start publishing your own games, pursue new job opportunities, or even launch your indie game studio. Take the next step in your game development career with us, and let’s create something incredible together!


Mastering the ColorPicker in Godot 4 is just one fragment of the vast mosaic of game development. By following the pathways we have laid out, you should now have a solid grasp of how to integrate dynamic color selection into your games, which is essential for crafting personalized and immersive gaming experiences. Game development is an ever-evolving field, and staying up to date with the latest tools and techniques is key to success.

As you continue to build your expertise, remember that every game you create is a reflection of your unique vision and skills. We at Zenva believe in the potential of every individual to make a mark on the gaming world, and we are here to support you on that quest. If you’re ready to take your game development to the next level, explore our Godot Game Development Mini-Degree and join a vibrant community of creators who share your passion. Together, let’s turn your game development dreams into reality!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.