Welcome to the New Modification Club!

  

Table of Contents

• 📖 Overview
• 📋 Credit Requirements (Important)
• ✨ Features
• 🚀 Quick Start
• 📦 Building & Distribution
• 🎯 Platform-Specific Guides
• 📚 Additional Resources
• 👏 Credits

📖 Overview

The DDLC Mod Template 2.0 is a comprehensive mod template for Doki Doki Literature Club that fully adheres to Team Salvato's IP Guidelines.

Built for Ren'Py 8.X.X by Azariel Del Carmen (bronya_rand), this template provides everything you need to create fan-made, cross-platform DDLC mods with modern features and optimized code.

Perfect for:

• First-time mod creators looking for a solid foundation.
• Experienced modders wanting to upgrade to Ren'Py 8.
• Developers seeking cross-platform compatibility (Windows x64, macOS, Linux, Android).

Note

The DDLC Mod Template is not affiliated in any way with Team Salvato nor is it designed for the sequel "Doki Doki Literature Club Plus". Do not use the template nor its code for unofficial DDLC patches, fixes, etc.

Note

For legacy Ren'Py support (Ren'Py 6.99.12 - 7.8.7), see the deprecated Python 2 branch of the mod template.

---

✨ Features

Core Features

• ✅ Team Salvato Compliant - Includes required splashscreen (disclaimer) and follows all IP guidelines for fan mods.
• 🐍 Python 3 & Ren'Py 8 Optimized - Clean, modern code optimized for the latest Ren'Py.
• 📚 Original DDLC Scripts Included - Reference the original game scripts for learning purposes.
• 🌐 Cross-Platform Support - Build for Windows, macOS, Linux, and Android.
• 🎨 Automatic GUI Coloring - Customize GUI and menu button colors without editing assets.
• 🖼️ Dynamic Super Resolution (DSR/DSP) - Universal resolution template supporting custom resolutions.
• 📝 Player Name Change - Allow players to correct or change their name in-game.
• 💬 Enhanced Console & Poem Responses - Improved Monika console and cleaner poem response system.

Gameplay Features

• 🎮 Uncensored Mode - Option to show more sensitive content.
• 📹 Let's Play Mode - Protect personal information while streaming/recording.
• 📖 NVL Support - Full NVL (novel-style) dialogue support thanks to Yagamirai01.

Returned DDLC Features

Classic DDLC features restored and improved:

• 👻 Ghost Menu - Dan's spooky easter egg.
• 💔 Character Kill Scripts - Sayori and Monika deletion scripts.
• 📄 Special Poems - Act 2 random poems (now improved!).

Optional Extras

Important

Download DDLCModTemplate-X.X.X-Extras.zip to access these optional features.

• 💥 Better Blue Screens of Death - Create custom BSODs on all platforms.
• 🖼️ Gallery System - Showcase your artwork and CGs.
• 🏆 Achievements Menu - Reward players for completing milestones.
• 🎮 [BETA] Discord Rich Presence - Show mod activity on Discord.

---

🚀 Quick Start

Prerequisites

1. Ren'Py 8.X
2. DDLC (PC Version)
3. This DDLC Mod Template

Installation Steps

1. Extract Ren'Py to a folder of your choice.

Warning

Do not extract Ren'Py to a cloud storage folder (e.g. Google Drive, OneDrive, etc.) as it will cause issues when testing your mod.

2. Create a new folder in the renpy-8.X.X-sdk folder and extract the DDLC Mod Template ZIP into it.

3. Extract DDLC assets - Open DDLC-1.1.1-pc.zip and copy these RPA files into the mod template's game folder:

   • audio.rpa
   • fonts.rpa
   • images.rpa

4. Launch the template

   • Open the Ren'Py Launcher.
   • Select the DDLC Mod Template project.
   • Click Launch Project to test it.

🎉 You're ready to start modding!

---

📦 Building & Distribution

When you're ready to release your mod:

1. Open the Ren'Py Launcher.
2. Click on Build Distributions.
3. Uncheck all options in Build Packages and check Ren'Py 8 DDLC Compliant Mod.
4. Click Build.

This creates a cross-platform mod package ZIP file (marked with -Renpy8-DDLCMod in the filename) containing your mod files ready for distribution.

Tip

Always test your mod thoroughly before building and distributing!

---

🎯 Platform-Specific Guides

Android

Making your mod work on Android requires additional considerations, especially for complex features or non-mobile-friendly code.

📱 Read the full guide: Android Mod Guide

Note

For older templates, refer to the PDF included in your template's ZIP file as the latest guide may not match your version.

Linux

Linux users must run mods using the included launcher script (at least once):

./LinuxLauncher.sh

macOS

macOS support is included out of the box. Build distributions include macOS packages automatically.

---

📋 Credit Requirements

Important

You MUST credit this template in your mod. By default, a credits screen is enabled in-game (either in the Extras screen or as a standalone button). You can use the default implementation or choose one of the alternatives below.

Default Credit Text

Include this in your mod's credits screen and/or credits.txt file:

This mod was made possible by bronya_rand's DDLC Mod Template 2.0: https://github.com/Bronya-Rand/DDLCModTemplate2.0

Alternative Credit Methods

If you prefer a different approach, you may use one of these alternatives:

1. Custom Splash Screen - Feature the Team Salvato logo alongside a Bronya Rand logo (available here).
2. Disclaimer Mention - Add a line to your game's disclaimer: "This mod was made possible using bronya_rand's mod template".
3. Presplash Screen - Include a Bronya Rand logo (available here) in your presplash.
4. Custom Idea - Contact me via Discord or Reddit with your proposed credit method for approval.

---

📚 Additional Resources

Documentation

• 📱 Android Mod Guide - Complete guide for Android porting
• 🎮 Discord RPC Guide - Set up Discord Rich Presence
• 📝 New Poem Game Guide - In-depth poem game documentation

Community & Support

• 💬 DDMC Discord - Get help and share your mods with the community
• 🐛 Issues - Report bugs on GitHub Issues
• ☕ Support Development - Buy me a Ko-fi

---

👏 Credits

Thanks to the following people for their contributions to the DDLC Mod Template:

Note

This list goes from the past to present.

• Dan Salvato (DDLC)
• renpytom (Ren'Py)
• MAS Team (template base before revamping)
• alicerunsonfedora (Xcode)
• Terra (In-depth poem game)
• Yagamirai01 (NVL)
• Alexxonder (Auto Color Adjustments)
• Elckarow (Python 3 updates, New poem responses/effects)
• NekoLaiS (Cryllic compatibility)
• The DDMC Community (Feature suggestions and feedback)
• Pseurae (Donation/Act 3 GL2 Fix)
• Lezalith (New Console (4.1.1+))
• RS/6000 (New Mod Template Logo (4.2.1+))
• Tulkas (Android Gestures)
• FiT (Weiss Chibi Branding Icon Design)
• Retronika (Supplemental code for the Gallery system)

---

Copyright © 2019-2025 Azariel "Bronya Rand" Del Carmen (bronya_rand). All rights reserved. Doki Doki Literature Club, the Doki Doki Literature Club code, is the property of Team Salvato. Copyright © 2017 Team Salvato. All rights reserved.