Ren'Py 8.2 Upgrade Path: Managing configuration file compatibility across stable releases

Configuration Migration Between Ren'Py Stable Versions

Ren'Py 8.2 does not include automated configuration validation or migration warnings when loading projects from previous minor versions. Silent failures in screen definitions or option handling can occur without explicit errors, particularly when deprecated parameters in options.rpy or screens.rpy are used.

Modified Parameters in Ren'Py 8.2

Key configuration parameters that require manual review during upgrades from 8.1.x include:

• config.screen_width and config.screen_height default values
• config.language_babel settings and translation catalog handling
• Screen language syntax for imagebutton components, particularly focus_mask and hover parameters
• Deprecated parameters in config.window_icon and config.game_title handling

Recommended Upgrade Workflow

1. Backup your project before making any changes
2. Compare configuration files against the new version's defaults in renpy/common/
3. Test screen definitions by launching the project with verbose logging enabled
4. Verify language settings by checking translation catalog loading and display

Manual Verification Required

Ren'Py provides no built-in diagnostic tools for configuration validation. Developers must manually compare their project's options.rpy against renpy/common/options.rpy from the 8.2 distribution and test screen definitions individually. The changelog for version 8.2 should be reviewed to identify specific parameter modifications.

Question: Have you encountered specific errors or unexpected behavior after upgrading a project to Ren'Py 8.2, or are you planning a future upgrade and seeking to prevent issues?