TextureButton in Godot – Complete Guide

Welcome to this in-depth tutorial where we’ll unravel the intricacies of the TextureButton class in the highly acclaimed Godot 4 game engine. If you’re looking to create interactive and visually appealing buttons for your game interfaces, diving into TextureButton is a perfect choice. Whether you are just starting out or have some experience under your belt, there’s something here for everyone. We’ll explore not only the ‘how-tos’ but also the ‘whys’ of using this nifty control node, making your journey into game development that much more rewarding. So buckle up and get ready to learn how to make your game interfaces both beautiful and functional with TextureButton!

What is TextureButton?

TextureButton is a flexible and essential node in Godot’s UI system, belonging to the UI Control node family. It allows for the creation of buttons with custom textures that respond to different states such as: Pressed, Hover, Disabled, and Focused. This provides more freedom to game designers and developers to define the look and feel of their button elements without being restricted to the default stylings of Godot’s themes.

What is it for?

TextureButton is typically utilized for creating visually rich, custom button elements in a game’s user interface. This can range from simple action buttons, like ‘Play’ or ‘Exit’, to more intricate control schemes that require a high level of detail and customizability. With TextureButton, the creative possibilities are wide open, as you can tailor the design to fit the aesthetic of your game.

Why Should I Learn It?

Understanding how to use the TextureButton node will immensely benefit your game development process as it:

– Enables the creation of engaging and visually consistent UI elements.
– Offers performance benefits by utilizing sprites directly.
– Supports customization for various game states, elevating the user experience.
– Serves as a building block for learning more advanced UI concepts in Godot.

By grasping the TextureButton, you will have a strong tool at your disposal for making interactive experiences that captivate your players through every button press. Let’s get ready to turn your static UI designs into interactive elements that resonate with your users.

CTA Small Image

Creating the TextureButton in Godot 4

To start using a TextureButton, you need to create an instance in your scene. This can be done by simply adding a TextureButton node from the Control nodes section.

var texture_button = TextureButton.new()

Once added, you can begin assigning textures for the various states of the button. You can do this through the Godot editor or via code:

texture_button.normal_texture = preload("res://path_to_your_normal_texture.png")
texture_button.pressed_texture = preload("res://path_to_your_pressed_texture.png")
texture_button.hover_texture = preload("res://path_to_your_hover_texture.png")
texture_button.disabled_texture = preload("res://path_to_your_disabled_texture.png")

Now your button will respond visually when you interact with it.

Responding to User Interaction

With the visual aspect of the button set up, let’s make it respond to user actions. Connect the ‘button_up’ signal to your code to detect when the button is released after being pressed:

texture_button.connect("button_up", self, "_on_TextureButton_up")

Then, implement the callback function to define what happens when the button is released:

func _on_TextureButton_up():
    print("Button is released!")

You can replace the print statement with any other function call to perform the actual action required by your game.

Customizing Button Appearance

Sometimes you might want to further customize the appearance of the button. This can be done by modifying the ‘expand’ and ‘stretch_mode’ properties. For example, if you want the button to maintain its aspect ratio:

texture_button.expand = true
texture_button.stretch_mode = TextureButton.STRETCH_KEEP_ASPECT_CENTERED

On the other hand, if you want your button to scale freely with loss of aspect ratio you can do:

texture_button.expand = true
texture_button.stretch_mode = TextureButton.STRETCH_SCALE

This will ensure that your button looks good at any size according to your chosen stretching strategy.

Implementing Toggle Mode

TextureButton can also be easily turned into a toggle button. This means that the button maintains its pressed state until pressed again. Enable toggle mode by setting the ‘toggle_mode’ property:

texture_button.toggle_mode = true

You can then check the ‘pressed’ state of the button to determine its status:

if texture_button.pressed:
    print("Button is in the pressed state.")
    print("Button is not pressed.")

Leveraging the toggle mode feature will come in handy for creating settings buttons or any other button that needs to retain state information between interactions.

By now, your TextureButton should be interactive and customized to your liking. Stick around for the next segment, where we’ll explore more advanced configurations and how to dynamically change your button’s properties during runtime. This will help make your UI even more dynamic and interactive!Great! Now that you’ve got the basics down, let’s delve into more advanced configurations and see how you can dynamically change the properties of your TextureButton during runtime to enhance your game’s UI interactivity.

Dynamically Changing Textures

You might want to change the button’s texture in response to a game event, such as upgrading a character or unlocking a new level. Here’s how you can dynamically set textures for different button states:

func update_button_texture():
    texture_button.normal_texture = preload("res://new_normal_texture.png")
    texture_button.pressed_texture = preload("res://new_pressed_texture.png")
    texture_button.hover_texture = preload("res://new_hover_texture.png")

# Call this function when you want to change the button textures

Remember that updating textures can be resource-intensive if done frequently; it’s usually a good idea to preload textures when possible.

Adjusting Button Scale and Position

Positioning and scaling are key to aligning UI elements. You can programmatically adjust the position and size of your TextureButton to respond to UI layout changes or animation:

# Set the button's position
texture_button.rect_position = Vector2(100, 100)

# Change the size of the button
texture_button.rect_size = Vector2(120, 50)

# Alternatively, scale the button
texture_button.rect_scale = Vector2(1.5, 1.5)

These properties can be animated to make your UI dynamic and engaging, or to respond to different screen resolutions and aspect ratios.

Enabling and Disabling the Button

In certain game scenarios, you might want to enable or disable a button. This can be easily achieved by modifying the ‘disabled’ property:

# Disable the button
texture_button.disabled = true

# To re-enable it
texture_button.disabled = false

While the button is disabled, it won’t receive any input events, and its appearance will change to reflect the disabled texture if one is provided.

Custom Signals and Interactivity

TextureButton can emit custom signals that allow for in-depth interaction. For instance, you could create a signal to be emitted when the button is double-clicked:

# First, define a new custom signal
signal texture_button_double_clicked

# You can then emit this signal under certain conditions, like a quick double press
func _process(delta):
    if is_double_click_condition_met():

func is_double_click_condition_met():
    # Your logic to detect a double click goes here
    return false

Custom signals give you the flexibility to define complex interactions that go beyond the standard button pressing.

Applying Styles for Different Game Themes

Finally, if your game has different themes, you might want to swap out the entire appearance of your buttons to match the active theme. Here’s a snippet to do just that:

# Assume you have a function that returns textures based on the current theme.
func get_theme_textures():
    match current_game_theme:
            return [preload("res://space_normal.png"), preload("res://space_pressed.png")]
            return [preload("res://jungle_normal.png"), preload("res://jungle_pressed.png")]
            return [preload("res://default_normal.png"), preload("res://default_pressed.png")]

# Apply the theme textures
func apply_theme():
    var textures = get_theme_textures()
    texture_button.normal_texture = textures[0]
    texture_button.pressed_texture = textures[1]

# Call this function whenever the game theme changes

By using these code examples, you’ll be able to make your TextureButton respond dynamically to the state of your game, adapt to different layouts and screen sizes, and enhance the overall user experience with a rich and interactive UI. Keep experimenting with these snippets and integrate them into your game to create a truly immersive environment for your players.

Animation with TextureButton

Animating your buttons adds a layer of polish to your UI. Let’s use the Tween node to animate the button’s scale when it’s pressed, giving it a bouncy effect:

var tween = Tween.new()

func animate_button_press():
    tween.interpolate_property(texture_button, "rect_scale",
                                Vector2(0.9, 0.9),

texture_button.connect("button_down", self, "animate_button_press")

When the button is pressed down, the scale is interpolated to give a quick ‘shrink’ effect. You can connect an additional animation for when the button returns to its normal state:

func animate_button_release():
    tween.interpolate_property(texture_button, "rect_scale",
                                Vector2(1.0, 1.0),

texture_button.connect("button_up", self, "animate_button_release")

By combining these two animations, your button will have a smooth and responsive interaction effect.

Changing TextureButton Properties based on Game Logic

You can also change the TextureButton’s appearance based on game logic. For example, if you have a power-up that can only be used once, you can change the button’s texture to indicate its usage:

func on_power_up_used():
    if power_up_available:
        texture_button.normal_texture = preload("res://power_up_active.png")
        power_up_available = false
        texture_button.normal_texture = preload("res://power_up_used.png")

# Hook this function to the event when the power-up is used.

Control Visibility with Show and Hide

Sometimes you might want to dynamically show or hide your button. For example, you may have a pause button that should only be visible during gameplay:

# To hide the pause button

# To show the pause button once the game is unpaused

Using `show()` and `hide()` allows you to quickly toggle the visibility of your TextureButton based on certain conditions within your game.

TextureButton as Part of a UI Group

TextureButtons often work as part of a group of buttons, such as a set of options in a menu. You can handle their state collectively:

# Assuming you have a group of buttons
var buttons = [button1, button2, button3]

# Disable all buttons except the one that is currently active
func disable_except_active(active_button):
    for button in buttons:
        button.disabled = button != active_button

In this example, every button except the one that is actively selected gets disabled. This is particularly useful for creating menu navigation where only the currently highlighted option is selectable.

Integrating TextureButton with Signals and External Scripts

A powerful feature of Godot is the ability to connect nodes’ signals to any script. Consider you have separate scripts for game logic and UI. You can connect your TextureButton’s `pressed` signal to a method in the game logic script:

# Inside your UI script
var game_logic_script = preload("res://scripts/game_logic.gd").new()

texture_button.connect("pressed", game_logic_script, "on_texture_button_pressed")

# Inside game_logic.gd
func on_texture_button_pressed():
    print("TextureButton was pressed! Perform game logic here.")

Connecting signals across scripts keeps your code modular and easy to maintain.

By exploring these advanced configurations and dynamic changes to your TextureButton instances in Godot, you’ll be able to craft a highly interactive and responsive user interface. Remember, experimentation is key to finding what works best for your game. Dive in, try out these code snippets, and see how you can bring your TextureButtons and UI to life with a touch of creativity and programming prowess!

Continuing Your Game Development Journey

Embarking on the path to mastering game development with Godot is an exciting endeavor, and we are thrilled to be part of your journey. As you continue to explore and harness the power of the Godot 4 engine, know that your adventure doesn’t need to end here. Our Godot Game Development Mini-Degree is a treasure trove of knowledge that will further sharpen your skills, whether you’re a seasoned developer or just starting out.

This comprehensive collection will take you through the A to Z of Godot, diving deep into 2D and 3D game creation, UI systems, advanced gameplay mechanics, and much more – all at your own pace. It’s designed to give you hands-on experience, with projects that contribute to a practical portfolio. Join our vibrant community of learners and take your game development capabilities to new heights.

For a broader exploration of what we offer, check out our full range of Godot courses. With Zenva, your learning experience scales with you, from the basics right through to professional-level skills. Game development is a journey, and we at Zenva are excited to be with you every step of the way.


In the realm of game development, every new skill acquired and every tool mastered opens up a universe of creative possibilities. Through this tutorial, you’ve gained invaluable insights into the capabilities of the TextureButton in Godot 4, setting a firm foundation for crafting engaging and responsive UIs in your games. Remember, the knowledge you’ve absorbed today is just the beginning—there’s an entire expanse of game development concepts and techniques awaiting your discovery.

Our Godot Game Development Mini-Degree is your next step to deepening your expertise and bringing your dream games to life. You have the vision; now, it’s time to build the experience. Join us at Zenva, where your potential meets our passion for game development education, and together, let’s take your skills to unprecedented heights. The story doesn’t end here—let’s continue to write it together.

Python Blog Image

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