Ren'Py Changelog

What's new in Ren'Py 6.99.11.1749

• New In-Game GUI:
• Ren'Py ships with a new default GUI. This system, used in-game to customize the main menu, game menu, and in-game screens, replaces the old themes and screens.rpy system with a new system that's intended to be an improvement for every creator:
• For new creators, the new GUI is intended to look attractive (if generic) out of the box. It is adaptable to a choice of sizes, and supports games with light and dark backgrounds.
• Intermediate creators will be able to more easily customize the new GUI, without having to to work with screens and styles directly. It's now possible to completely re-theme the GUI by changing variables in the gui namespace, and editing template images.
• Advanced creators will be able to replace the new gui entirely, either piece by piece or wholesale. The new gui infrastructure resets all styles to sensible defaults, making it easier to apply customization.
• There is also a gui customization guide, consisting of over 5,000 words of documentation and code, and 40 images, that explains how to change the look of the GUI.
• In addition, the new GUI adds support for a number of new features. These features are generally implemented in a way that custom GUIs can take advantage of.
• Highlights include:
• The GUI defaults to supporting 16:9 widescreen resolutions.
• The new GUI is intended to support PCs and mobile devices in landscape mode. Where appropriate, it conforms to iOS and Android interface guidelines.
• The new GUI includes native support for a history or readback screen.
• The new GUI includes support for assigning names to file pages, allowing a certain amount of organization to be applied to files.
• The NVL and choice screens are now given lists of objects as parameters, instead of tuples. (The objects also function as tuples, for compatibility with old code.)
• The yesno_prompt screen has been renamed to confirm.
• Ren'Py supports the use of a ctc screen to display the click-to-continue indicator.
• Improved Platform Support link
• There have been a number of fixes to Ren'Py's support for various platforms.
• Windows HighDPI mode is detected properly when displaying the presplash.
• Android The Android build system has undergone a rewrite, adding support for x86, while retaining and modernizing support for ARM devices. RAPT now included many dependencies, fixing Android build problems.
• Ren'Py now supports immersive mode on Android's 4.4+. Immersive mode hides the system UI, including the navigation bar, allowing Ren'Py to take up the entire screen.
• Chrome OS Ren'Py now support ChromeOS by running the Android APKs via the Android Runtime for Chrome tool.
• Style Prefix Support:
• Ren'Py now supports the use of a prefix_ substitution with style properties. Where previously, one was required to write:
• style button:
• insensitive_background "insensitive_button.png"
• idle_background "idle_button.png"
• hover_background "hover_button.png"
• selected_idle_background "selected_idle_button.png"
• selected_hover_background "selected_hover_button.png"
• one can now write:
• style button:
• background "[prefix_]button.png"
• This searches through prefixes in a manner similar to the way styles do. When looking for a selected_idle_background, Ren'Py will search for selected_idle_background.png, idle_background.png, and background.png
• Style Properties:
• Windows and buttons can take the padding and margin style properties. These properties can take a tuple that gives the margin and padding on all four sides.
• The new base_bar style property sets the left and right (or top and bottom) bars to the same value. It can be to set the background of a slider or scrollbar the uses a thumb image.
• The xfit and yfit style properties can be given to the fixed screen language statement and Fixed() displayable. When a fit property is true, the fixed shrinks in the given axis to fit all child displayables.
• Buttons and Windows now fully respect the xmaximum and ymaximum style properties.
• There is now a offset style property, which sets the xoffset and :propfref:`yoffset` properties to the first and second components of a tuple.
• Translate and Style Statement Order Changes:
• The config.defer_styles variable has been added to determine if style execution should be deferred, as described below. If config.defer_styles is true when style evaluation would have occurred, that style is put on a deferred list. The gui.init() function called by the new GUI sets this variable to true.
• To facilitate translations customizing the fonts of the new GUI, the order of execution of translate python, style and translate style statements has been changed. When the game starts (after all statements have run), or when the language changes, the following steps occur.
• The gui named store is cleaned to its state at the end if init. (This is the store that all variables defined with gui.`name` live in.)
• All translate language python statements are run, where language is the current language.
• All deferred style statements are run.
• All translate language style statement are run, where language is the current language. (If not None.)
• The callbacks in config.change_language_callbacks are called.
• Ren'Py can be made to return to the old behavior (in which only translate language style, translate language python, and callbacks are executed) by setti
• Local Labels:
• Ren'Py now supports labels scoped to inside another label. It's possible to write:
• label day1:
• menu:
• "Should I sleep in?"
• "Yes":
• jump .afternoon
• "No":
• jump .morning
• label .morning:
• "It's the morning."
• label .afternoon:
• "It's the afternoon."
• In this code, the .morning and .afternoon labels can be jumped to directly from code that is immediately after the day1 label, or by jumping to day1.morning or day1.afternoon from other code.
• Transforms:
• Transforms now support xtile and ytile transform properties. These properties allow the underlying displayable to be tiled multiple times.
• Transforms now support xpan and ypan transform properties. These properties take an angle (between 0 and 360 degrees, but angles outside that are clamped to that range). The angle is used to pan the image horizontally or vertically by that amount. This makes it possible to simulate a 360 degree panoramic image.
• Translations:
• When generating a new project, all of the strings in the new game are translated using translations taken from the launcher project.
• A Vietnamese translation of the launcher and tutorial have been added to Ren'Py. Thanks to Thuong Nguyen Huu for contributing it.
• A Indonesian translation of the launcher and default project has been added to Ren'Py. Thanks to Pratomo Asta Nugraha for contributing it.
• Ren'Py can now automatically generate a piglatin translation for test purposes.
• Other:
• The new nvl_narrator character can be used to as the narrator while in NVL-mode.
• The define statement can be used to define variables that are also Ren'Py keywords. For example, "define menu = nvl_menu" now works.
• A Frame() can now be given a Borders() object, that encapsulates the borders of a Frame into a single object. Borders objects also have a padding field that can be passed into the new :properf:`padding` style property.
• Buttons, textbuttons, imagebuttons, and hotspots now take selected and sensitive properties that directly control if the button is selected or sensitive.
• Buttons, textbuttons, imagebuttons, and hotspots take keysym and alternate_keysym bindings, that make it possible to assign keys to the buttons. When the given key is pressed, the action or alternate action is run.
• Ren'Py now supports extracting string translations from one project and applying them to another project. The translations can also be applied in reverse order, turning an English -> Russian interface translation into a Russian -> English translation.
• Viewports and vpgrids now support an arrowkeys property, that makes the viewport scrollable using arrow keys and a controller d-pad.
• Viewports and vpgrids now support horizontal scrolling via the mouse wheel, by setting their mousewheel parameter to "horizontal".
• InputValues now take a returnable property, that causes their value to be returned when enter is pressed.
• Ren'Py support a renpy.get_refresh_rate() function, which returns the referesh rate of the primary screen. This allows games using nearest neighbor mode to move at a whole-pixel rate - just like a Commodore 64 did.
• Ren'Py can now automatically upload your game to itch.io, if build.itch_project is set.
• The config.after_load_callbacks can be given callback functions to run once a load has been completed.
• The config.tts_voice variable has been added, to allow for a platform-specific choice of text-to-speech voice to use.
• config.quit_action now defaults to Quit(), which will display the quit prompt over the in-game interface.
• The progress indicator now can be accessed using the F2 key, in addition to the shift-alt-P binding. The latter binding has been fixed to work reliably on PC platforms.