🎀 Doki Doki Mod Manager 🎀

✨ The ultimate mod manager for Doki Doki Literature Club! ✨

🌟 Modern, feature-rich mod management with integrated Sayonika store support 🌟

👨‍💻 Maintainer: Dynamicaaa

✨ Features

🌟 Core Features

🎯 Integrated Sayonika Store - Browse and download mods directly
📦 Smart Mod Management - Install, organize, and launch with ease
🔐 Multiple Authentication - GitHub or email/password login
🖥️ Cross-Platform Support - Windows, macOS, and Linux
🎨 Modern Interface - Clean, responsive DDLC-themed design

🚀 Advanced Features

🔍 Powerful Search - Find mods quickly with filters
⭐ Ratings & Reviews - Community-driven mod discovery
🏷️ Category Filtering - Browse by genre and tags
📱 One-Click Install - Seamless mod installation
👤 User Profiles - Personalized mod collections

🤔 Why This Mod Manager?

📉 The State of DDLC Mod Management

The original Doki Doki Mod Manager was once the go-to solution for managing DDLC mods. However, it has been abandoned and is no longer maintained. Over time, the original DDMM has developed several critical issues:

❌ Issues with Original DDMM
Broken functionality due to outdated dependencies and security vulnerabilities
No support for modern DDLC mods and newer mod formats
Compatibility issues with current operating systems
Lack of updates since the project was abandoned by its maintainer
Security risks from unpatched vulnerabilities in its outdated codebase

🆚 Why Not Doki Doki Mod Docker?

While Doki Doki Mod Docker exists as an alternative, this Doki Doki Mod Manager offers significant advantages:

🏆 This Mod Manager	🐳 Docker Version
✅ Native Performance Runs directly on your system	❌ Containerization Overhead Slower due to Docker layers
✅ Simple Installation Download and run executable	❌ Complex Setup Requires Docker knowledge
✅ OS Integration File associations & shortcuts	❌ Limited Integration Isolated container environment
✅ Low Resource Usage Minimal system impact	❌ High Overhead Docker daemon always running
✅ Sayonika Store Built-in Integrated mod browsing	❌ No Store Integration Manual mod sourcing
✅ Active Development Regular updates & features	❌ Limited Updates Slower development cycle

💡 This version combines the best aspects of the original DDMM concept with modern development practices, active maintenance, and enhanced features that make mod management effortless.

📥 Download

🚀 Get Started Now!

📦 View All Releases

🌐 Sayonika Integration

This version of DDMM includes full integration with the Sayonika mod store at sayonika.dynamicaaa.me

🎯 Discovery Features

🔍 Browse & Search - Thousands of DDLC mods at your fingertips
📊 Trending Mods - Discover what's popular in the community
🏷️ Smart Filtering - Find mods by category, tags, and popularity

⚡ User Features

⚡ One-Click Downloads - Instant mod installation
👤 User Authentication - Personalized profiles and collections
⭐ Community Reviews - Ratings and feedback from players

🛠️ Development

Run from Source

We strongly recommend using Bun as your JavaScript runtime for development.

🚀 Why Bun?

⚡ Superior Performance Up to 3x faster than Node.js	📦 Built-in Package Manager No need for separate npm
🔷 TypeScript Support First-class support out of the box	🔥 Enhanced Development Hot reloading & better performance

While Node.js is still supported, Bun provides the best development experience.

# Clone the repository
git clone https://github.com/Dynamicaaa/Mod-Manager
cd Mod-Manager

# Install dependencies
bun install

# Start development server
bun run start

CSS Development

DDMM uses SCSS for modern styling with automatic compilation:

# 🔨 Build Commands
bun run build-css        # Build once (development)
bun run build-css-prod   # Build for production (compressed)
bun run build-css-watch  # Watch for changes and auto-rebuild

# 🎛️ Direct Utility Usage
bun rebuild-css.js                # Standard build
bun rebuild-css.js --production   # Production build
bun rebuild-css.js --watch        # Watch mode

🛠️ Migration/Update Steps

Note: Please follow these steps to ensure a smooth upgrade from previous versions to the latest versions.

Backup your mods and saves:
Before upgrading, back up your existing mods and save files from your DDLC directory.
Uninstall previous versions:
Remove any older installations of Doki Doki Mod Manager to prevent conflicts.
Install updated version:
Download the latest release from GitHub Releases and install the appropriate version for your platform.
Restore your mods and saves:
Copy your backed-up mods and save files into the new installation's DDLC directory if needed.
Review new settings:
Open the application and review new configuration options or permissions.
Check for deprecated features:
Some legacy features may be removed or replaced. Refer to the release notes for details.
Report issues:
If you encounter problems, please open an issue.

📁 CSS File Structure:

app.scss
Main application styles fonts.scss
Font definitions sayonika-store.scss
Sayonika integration styles

🐛 Debug Tools

Set these environment variables to enable debugging features:

🔧 Variable	📋 Purpose
`DDMM_LANG_PROOF`	🔤 Adds prefixes to all localized strings
`DDMM_DEVTOOLS`	🔧 Opens developer tools on launch
`DDMM_INCOGNITO`	🕶️ Removes app name from title bar
`DDMM_LANG`	🌍 Sets language (see `lang/` folder)

🤝 Contributing

We welcome contributions! Here's how you can help:

🐛 Bug Reports 🔍 Find Issues - Help us identify problems 📝 Create Reports - Detailed bug descriptions	💡 Feature Requests 🚀 Suggest Features - Share your creative ideas 🎯 Improve UX - Help make the app better
🔧 Code Contributions 📄 Submit Pull Requests - Help improve the codebase 🧪 Write Tests - Ensure code quality	📖 Documentation ✍️ Improve Docs - Make things clearer for everyone 🌍 Translations - Help localize the app

⚖️ IP Guidelines

Doki Doki Mod Manager is a fan work of Doki Doki Literature Club, created in accordance with Team Salvato's IP Guidelines.

📄 Licenses and Acknowledgements

📜 Doki Doki Mod Manager is licensed under the MIT License

✨ Made with 💖 for the DDLC modding community ✨

Dynamicaaa/Mod-Manager