Customizing Ren’Py: Part 5: Replacing Default GUI Images


Working with Ren’Py:

Advanced Ren’Py:

Customizing Ren’Py:

Ren’Py + Python:

Ren’Py is a engine for creating visual novels. It comes with a suite of tools for taking code and transforming it into programs that can be run on Windows, Mac, Linux, and even, with a little more work, mobile platforms like Android and iOS.

Beyond the showing of text and images, Ren’Py can also be extended through introducing new user interface elements, changing its defaults images, and combining Python with its own code to create even more interactive projects.


GUI Folder

Screenshot 2018-07-20 08.58.16

Within any project, there is a “gui” folder that contains all of the graphic user interface backgrounds and images. Clicking on the “gui” option in the Open Directory listing in the Ren’Py Launcher will open this folder.

Screenshot 2018-07-20 09.01.16
Example gui folder on MacOS X

Organized by type, the folders “bar”, “button”, “slider”, and “scrollbar” contain the actions and types associated with those elements as named files.

While changing the definitions in the options.rpy file can help in changing some of these, replacing the files in this folder directly is the best way to override the presentation of user interface elements in a project.


Example of Replacing the Main Menu

Screenshot 2018-07-20 09.11.09

Opening the “main_menu.png” file found in the “gui” folder in an image editor and changing its color, for example, will only change the background color.

Screenshot 2018-07-20 09.17.43

As a screen, to change the layout of the options and colors of the main menu, its definition and style must be changed programmatically in connection with also changing the user interface images.