Instant GUI Customize!
Plugin Instructions
1. Introduction
Here you’ll find step-by-step guides on how to customize your menu screens using the Instant GUI Customize Plugin. This document will not feature details or explanations and it’s instead suggested as a reference or quick guide for those who already understand how the Plugin works. It is recommended you check the Walkthrough here for any doubts you may have as to how everything works.
2. Importing the Plugin
- Download the .zip and .rpy files available on the itch.io page
- Extract asset_template.zip file into a folder
- Open the project’s “game” folder
- Copy the contents of the asset_template folder and the provided .rpy files into the project's “game” folder
- Override any files if asked
3. Exporting images for use with focus_mask
- Create a new image of the size of the project’s screen
- Create your own menu designs
- Isolate an element (background, overlay, button, etc.)
- Export said element as an image file the size of your canvas
- Replace the respective image in the project’s gui folder
- Repeat for each element in a given screen
4. Main Menu button file names
Action | Idle file name | Hover file name |
Start | mm_start_idle.png | mm_start_hover.png |
Load | mm_load_idle.png | mm_load_hover.png |
Options | mm_pref_idle.png | mm_pref_hover.png |
About | mm_about_idle.png | mm_about_hover.png |
Help | mm_help_idle.png | mm_help_hover.png |
Quit | mm_quit_idle.png | mm_quit_hover.png |
5. Quick Menu button file names
Action | Idle file name | Hover file name |
Back | qm_back_idle.png | qm_back_hover.png |
History | qm_history_idle.png | qm_history_hover.png |
Skip (w/ selected) | qm_skip_idle.png qm_skip_selected_idle.png | qm_skip_hover.png qm_skip_selected_hover.png |
Auto (w/ selected) | qm_auto_idle.png qm_auto_selected_idle.png | qm_auto_hover.png qm_auto_selected_hover.png |
Save | qm_save_idle.png | qm_save_hover.png |
Options | qm_pref_idle.png | qm_pref_hover.png |
6. Game Menu button file names
Action | Idle file name | Selected Idle file name | Hover file name |
Options | gm_pref_idle.png | gm_pref_selected_idle.png | gm_pref_hover.png |
Save | gm_save_idle.png | gm_save_selected_idle.png | gm_save_hover.png |
Load | gm_load_idle.png | gm_load_selected_idle.png | gm_load_hover.png |
History | gm_history_idle.png | gm_history_selected_idle.png | gm_history_hover.png |
About | gm_about_idle.png | gm_about_selected_idle.png | gm_about_hover.png |
Help | gm_help_idle.png | gm_help_selected_idle.png | gm_help_hover.png |
Exit | gm_exit_idle.png | gm_exit_selected_idle.png | gm_exit_hover.png |
7. Game Menu overlay file names
Screen / Tab | Overlay file name |
Options | overlay_pref.png |
Save | overlay_save.png |
Load | overlay_load.png |
History | overlay_history.png |
About | overlay_about.png |
Help | overlay_help.png |
Get Instant GUI Customize!
Instant GUI Customize!
A Ren'py GUI overhaul plugin. Bypass the tedious coding, quickly implement your custom design now!
| Status | Released |
| Category | Assets |
| Authors | ErebusWulfe, Cardigan |
| Genre | Visual Novel |
| Tags | Asset Pack, Graphical User Interface (GUI), Ren'Py |
More posts
- Mobile Script - Out Now!47 days ago
- Plugin WalkthroughFeb 16, 2025
Comments
Log in with itch.io to leave a comment.
I was intitially excited about this due to it being promoted as a no/low code option, but I get the following error when adding the images and codes to the game folder, yes I unzipped and copied the contents to the game folder.
While running game code:
File "renpy/common/00start.rpy", line 214, in script call
call _gl_test
File "renpy/common/00gltest.rpy", line 390, in script
$ __gl_test()
File "renpy/common/00start.rpy", line 214, in script call
call _gl_test
File "renpy/common/00gltest.rpy", line 390, in script
$ __gl_test()
File "renpy/common/00gltest.rpy", line 390, in <module>
$ __gl_test()
File "renpy/common/00gltest.rpy", line 319, in _m1_00gltest__gl_test
_gl_performance_test()
File "renpy/common/00gltest.rpy", line 342, in _gl_performance_test
ui.interact(suppress_underlay=True, suppress_overlay=True)
OSError: Couldn't find file 'gui/window_icon.png'.
It seems like for some reason the file "window_icon.png" is gone from your game directory. Can you explain step by step what exactly did you do?
I will try this once more with a clear head. If it still doesn’t work I’ll update and delete my comments