Choice Kwargs For Ren’py

More easily customize the display of Ren'Py choice menus!

Features:

• Customize idle and hover text colors per choice
  Don’t want all your choices to use the same GUI default? You’re covered! This lets you style individual choices with ease.
• Conditionally disable or remove choices
  You're no longer stuck choosing between config.menu_include_disabled = True or manually removing options. Do both, whenever you want!
• Add tooltips to specific choices
  Display tooltip messages when hovering over individual choice buttons. Great for giving the player a warning before a risky selection! You can also add an alternative tooltip message for cases where the choice becomes disabled.

• Strikethrough disabled choices
  If conditions aren't met for choices, optionally make them appear with a strikethrough.
• Add custom image backgrounds for specific choice menus (or don't)
  This lets you emphasize important decisions or just give each menu its own personality.
• Use these features only when you need them
  You can use kwargs for extra customization, or keep choices default.

How It Works

This tool uses kwargs (key-word arguments) in the parentheses of your menu choices. Here’s what it looks like in action:

# You can pass arguments to the choice(items) screen inside
# parentheses after 'menu' and before the colon.
# This can be used to show a unique background image for a specific choice screen.
# If you don’t need a background, just write 'menu:' as usual.
menu(background="morning_choice_bg"):
    
    "It's time to wake up."

    # This is an ordinary choice with no kwargs.
    "Go back to sleep":
        "I'm so tired..."
    
    # This choice appears in a bright yellow, with a lighter hover, but only if energy_level > 3.
    # Otherwise, it's grayed out and disabled.
    "Wake up" (color="#FAFF39", hover="#f8fd6f", sensitive=energy_level>3):
        "Fine, I'll get up."
    
    # This one only shows up if cranky is True.
    # When shown, it's styled in red with a black hover and displays a tooltip warning when hovered.
    "Curse the universe" (color="#ff0000", hover="#000", condition=cranky, tooltip_text="Don't click this option"):
        "You know what, this universe sucks!"
    
    # This one has no condition, it always shows up.
    # It's here to demonstrate how to style a normal choice with a color + hover.
    "I need coffee..." (color="#a07d69", hover="#382015"):
        "Coffee will fix this."

    # This one displays a different tooltip message dependent on whether it's disabled or not.
    "Be productive" (sensitive=energy_level>5, tooltip_text="Sounds like a good idea...", disabled_tooltip_text="Your energy is too low."):
        "Okay, guess I'd better start!"

When you set a custom color/hover for a sensitive choice, it will use those when clickable, and switch to gui.choice_button_text_insensitive_color when unclickable.

That’s it! You now have full control over the look and logic of your menu choices.

I may update this project to include additional features in the future. If you have any ideas, let me know what would be useful!