Welcome to the DDLC Mod Template

What's Changed

• Added the ability to override CPS and Console Delay to Monika's console on a temporary basis.
• Adjusted code to get poem appeal values and read poem variables.
• Adjusted restore_character code to restore and remove character files in the characters folder.
• Made characters folder initialization happen on mod startup.

Fixes

• Fixed a bug where alt mode in the Gallery does not reset.
• Fixed a bug where the wrong function was called in the Gallery.
• Removed singleton.py from python-packages due to confusion.
• Fixed a bug where Android builds of mods hang on Ren'Py loading...
• Fixed a bug where the process list and user account name code crashes on Android.

Download

For general modding download the DDLCModTemplate-5.0.1.zip ZIP file. If you are interested in downloading additional features that comes with the mod template, download the DDLCModTemplate-5.0.1-Extras.zip ZIP file.

Read the README file before installing anything and backup your mod periodically.

Welcome to the DDLC Mod Template

It's been a while since anything new has happened to the template and DDLC modding this good last year. However I decided out of my current free time of working in other places that it was time to revisit what was done and make improvements.

What's Changed

• Deprecation of Python 2 as of July 2025.

• Migrated most Ren'Py code over to _ren.py files for easy IDE management and Python tool support.
• Reworked most of DDLC's code from the ground up from Team Salvato's code.
• Deprecated poemwords.txt for Poem Words being added to poemwords_ren.py.
• Deprecated the old Singleton code for a mod template specific Singleton file.
• Reworked Monika's console logic
• Added support for more glitch text variety.
• Reworked the poem game as well as the appeal code.
• Added unlisted SFX's to definitions.rpy (Thanks Merc!)
• Made Let's Play Mode automatic and migrated stream checks to is_user_streaming and currentuser checks as get_user_account_name.
• Added and expanded BSOD code for Windows 11, macOS High Sierra -> Tahoe, and updated QR code for new template link
• Reworked Discord RPC code.
• Reworked Gallery System (Thanks Retro!)

Fixes

• Fixed a bug where the volume level was incorrect #87
• Fixed a bug related to VPGrids being underfilled (Thanks Merc!)
• Fixed original scripts up to Act 3 for current code logic.

There's probably a bit more done but I can't remember from the top of my head but that should be most of it! This version update is not compatible with older guides from 2023 and some Python code from modern templates may be located in Python files inside of a py folder. If unsure, search the function name in Visual Studio Code.

Download

For general modding download the DDLCModTemplate-5.0.0.zip ZIP file. If you are interested in downloading additional features that comes with the mod template, download the DDLCModTemplate-5.0.0-Extras.zip ZIP file.

Read the README file before installing anything and backup your mod periodically.

Welcome to the DDLC Mod Template

This minor update for the mod template does the following.

Changes

• Replace obsolete appeal variable code after past template code upgrades.
• (Python 3) Decrease init state of gallery
• Changed screenshot code to fix a tear/invert bug in recent Ren'Py.

Selecting the right mod template

• If you are modding DDLC for the first time, download the DDLCModTemplate-4.2.4.zip file.

  It is recommended to mod DDLC on Ren'Py 7 if you use this version of the mod template. Do NOT mod on Ren'Py 6.

• If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.2.4-Py3.zip file.

Installation of both mod template versions are the same as all template installation steps.

If you are interested in downloading the Extra tools for the mod template, download either DDLCModTemplate-4.2.4-Extras.zip for normal versions of the mod template or DDLCModTemplate-4.2.4-Py3Extras.zip for Ren'Py 8 versions of the mod template.

Read the README file before installing anything and backup your mod.

Full Changelog: 4.2.3...4.2.4

Welcome to the DDLC Mod Template

This minor update for the mod template does the following.

Fixes

• (Python 3) Allow Tearing to be Saved [PR #73]

Changes

• Changed init timings for Achievements

Selecting the right mod template

• If you are modding DDLC for the first time, download the DDLCModTemplate-4.2.3.zip file.

  It is recommended to mod DDLC on Ren'Py 7 if you use this version of the mod template. Ren'Py 6 is NOT recommended to make your DDLC mods anymore. more info

• If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.2.3-Py3.zip file.

Installation of both mod template versions are the same as all template installation steps.

If you are interested in downloading the Extra tools for the mod template, download either DDLCModTemplate-4.2.3-Extras.zip for normal versions of the mod template or DDLCModTemplate-4.2.3-Py3Extras.zip for Ren'Py 8 versions of the mod template.

Read the README file before installing anything and backup your mod.

Welcome to the DDLC Mod Template

This update for the mod template does the following.

Features

• Added swipe support for Android devices (thanks to Tulkas)
• Reworked (to the best of my ability of keeping DDLC in tact) Poemgame system. (thanks to Elckarow and Psurae for some feedback)

For a guide on how to use the new poem game system, refer to Documentation/New Poemgame Guide.pdf or the DDMC Discord for more information.

Fixes

• Fixed a bug in the Python 2 branch due to Python 3 code existing over Python 2.
• Fixed a bug where mod extras features cause a ImportError by default due to different exception errors in Python 2.

Changes

• Added documentation for the new poem game in Documentation.
• Updated DDLC original script files to use new feature syntax.

Selecting the right mod template

If you are modding DDLC for the first time, download the DDLCModTemplate-4.2.2.zip file.

It is recommended to mod DDLC on Ren'Py 7 if you use this version of the mod template. Ren'Py 6 is NOT recommended to make your DDLC mods anymore. more info

If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.2.2-Py3.zip file.

Installation of both mod template versions are the same as all template installation steps.
If you are interested in downloading the Extra tools for the mod template such as Better BSODs, Better Tear Effect, Achievements, etc., download either DDLCModTemplate-4.2.1-Extras.zip for normal versions of the mod template or DDLCModTemplate-4.2.1-Py3Extras.zip for Ren'Py 8 versions of the mod template.

Read the README file before installing anything and backup your mod.

Welcome to the DDLC Mod Template!

This update brings semi-big changes to the mod template from the Heavensward update (4.2.0).

Features

• New Tear screen by @Elckarow (included under the new Extras and Py3Extras ZIP file)!
• New poem responses by @Elckarow!
• New mod template logo by RS/6000!

Changes

• Revert compact settings from Heavensward to Classic DDLC with setting tabs.
• Moved every mod extra out of the mod template.

  All mod extras can be re-added by downloading the Extras ZIP file for each respective build.

• Updated documentation of past legacy code that wasn't up-to-date.
• Added depreciation.rpy.

  This file is temporary and serves only as warnings to use newer features' code. This file may be removed at any time in a later update.

• Disabled Extras Menu and Translations by default.
• Add mod logo by default to the credits screen.
• Upgraded DSR/DSP.

Fixes

• Fixed an issue where the original credits file crashed due to the new console.
• Fixed an issue where window tabs errored out on some R6/R7 builds.

Hotfixes

• (Python 2) Fixed a bug relating to f-strings
• (Python 2) Fixed a bug relating to mod extra modules.

Full Changelog: 4.2.0...4.2.1

Selecting the right mod template

If you are modding DDLC for the first time or are modding solely on Ren'Py 6 (not recommended) or 7 (recommended), download the DDLCModTemplate-4.2.1.zip file.
If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.2.1-Py3.zip file.

Installation of either mod templates are the same as usual.

If you are interested in downloading the Extra tools (Better BSOD, Better Tear Effect, Achievements, Gallery, etc.), download either DDLCModTemplate-4.2.1-Extras.zip (Python 2) or DDLCModTemplate-4.2.1-Py3Extras.zip (Python 3) respectively.

Read the README file before installing anything and backup your mod.

Welcome to the new DDLC Mod Template!

This new update brings semi-major changes, and features to the mod template.

Depreciation Warning

Ren'Py 6 support of the DDLC Mod Template is being put into question due to the lack of demand of Ren'Py 6 mods and to keep with the current Ren'Py development lifecycle. In the near future, new features and code will be focused on Ren'Py 7/8 then Ren'Py 6. It is recommended that you mod on Ren'Py 7 for future update. For more information, see this post.

Features

• New Gallery/Achievement System. Achievements hide their descriptions (optional), and both systems require less arguments than before!

  Old users of the Gallery/Achievement system will need to update their Achievement/Gallery classes if planning to upgrade.

• Vertical/Compact Framed Settings! More spacious settings screen with less bulk.
• (Python 3) New Discord RPC System! Use RPC even easily and more efficiently now with Enable/Disable. Thanks Lezalith!
• New Monika Console! Call in code more easily and efficiently with this new console system! Thanks Lezalith as well!
• Removed obsolete Help button.
• Fixed Act 3 Monika's Spaceroom. Thanks Psurae!
• Dynamic Super Resolution - Upscale your characters and art higher for higher resolutions.
• Dynamic Super Positions - Upscale your positions for higher resolutions.
• Player Name Change - You misspelt your name? Easy. Go to Settings, Extras and Change your name there!
• Custom Resolutions - Scale DDLC easily with preset resolution markers.

  Disabled by default. Comment out the code in screens.rpy to update it.

Changes

• Added depreciation warning to Ren'Py 6.

Fixes

• Fixed for loop for process list. - Elckarow Patch
• Fixed special poems listing. - Elckarow Patch

Reminders

Since 4.1.0, the mod template has changed how DDLC files are located which means that old guides, tutorials and such from 2017-Nov 22, 2022 will no longer apply to template versions 4.1.0 and higher. Please refer to the DDMC Discord or new guides/tutorials that state that they are compatible with the new mod template layout.

For mod guides/tutorials, please state whether the guide/tutorial is for the old template layout from 2017-Nov 22, 2022 or the new one that applies to the current 4.1.0 and beyond template

Selecting the right mod template

If you are modding DDLC for the first time or are modding solely on Ren'Py 6 (not recommended) or 7 (recommended), download the DDLCModTemplate-4.2.0.zip file.
If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.2.0-Py3.zip file.

Installation of either mod templates are the same as usual.

Welcome to the new DDLC Mod Template!

This new update brings major changes, and features to the mod template.

Features

• Added wiperight and wiperight_scene to DDLC
• Add dialog warning to users if they attempt to run the mod template as a mod by pressing the New Game button.

Changes

• Reorganized the mod template in full for a new modding experience

  This change will mean old guides, tutorials and such from 2017-Nov 22, 2022 will no longer apply to the template beyond 4.1.0. Please refer to the DDMC Discord or new guides/tutorials that state that they are compatible with the new mod template layout.
  For mod guides/tutorials, please state whether the guide/tutorial is for the old template layout from 2017-Nov 22, 2022 or the new one that applies to the current 4.1.0 and beyond template

• Changed how restore_all_characters(), delete_character(), and the poem game works for new layout compatibility.
• Re-added the old poem special labels for backwards compatibility with new poem special label calls.
• Updated Windows 11 BSOD to revert black to blue after a Windows Update.

Github Changelog

Full Changelog for Python 2: 4.0.2...4.1.0
Full Changelog for Python 3: 4.0.2...954b795

Selecting the right mod template

If you are modding DDLC for the first time or are modding solely on Ren'Py 6-7, download the DDLCModTemplate-4.1.0.zip file.
If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.1.0-Py3.zip file.

Installation of either mod templates are the same as usual.

Welcome to the DDLC Mod Template

This update addresses the following issues

Fixes

• Fixed a bug where LinuxLauncher.sh crashes if a screenshot file is present.
• [Python 3] Fixed a bug in effects.rpy due to Python 3 division.
• [Python 2] Fixed a bug with the process list on Mac/Linux.

Changes

• Fixed a possible line bug due to Composite vs im.Composite.
• [Python 3] Added a try except for Discord RPC if Discord is not present.
• Bump Lockdown to 8.0.3/7.5.3.

See the upgrade notes for this release before downloading/upgrading.

Selecting the right mod template

If you are modding DDLC for the first time or are modding solely on Ren'Py 6-7, download the DDLCModTemplate-4.0.2.zip file.
If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.0.2-Py3.zip file.

Installation of either mod templates are the same as usual.

Welcome to the DDLC Mod Template

This update addresses the following issues

Fixes

• [Python 3] Fixed a bug in relation to the Py 3 lockdown file
• [Python 2] Fixed a few things in relation to lockdown file
• [Python 2] Fixed a error in R6 relating to Composite.

See the upgrade notes for this release before downloading/upgrading.

Selecting the right mod template

If you are modding DDLC for the first time or are modding solely on Ren'Py 6-7, download the DDLCModTemplate-4.0.1.zip file.
If you are modding DDLC on Ren'Py 8, download the DDLCModTemplate-4.0.1-Py3.zip file.

Installation of either mod templates are the same as usual.