DokiMod 开发文档
  • DDLC 中文 Mod 模板
  • 入门
imgradeone
2023-06-22

开始准备环境

# 开始准备环境

既然你准备好制作 Mod，那么，你可以开始准备您的开发环境了。

# 从中文 Mod 模板的选择开始

目前，DokiMod 已经推出了 3 种版本的 DDLC 中文 Mod 模板：

特别感谢 Monika After Story 团队 (opens new window) 和 GanstaKingofSA (opens new window)，没有你们，DDLC 中文 Mod 模板也不会出现。

目前，在两个分支里，你必须做出一些取舍：

  • 旧分支更加稳定，但不支持 Ren'Py 7，而且目前已停止维护。
  • Next 分支支持 Ren'Py 7，支持将您的 Mod 移植到 Android 平台，还有更多功能，但稳定性存疑。
  • Future分支支持 Ren'Py 8 和 Python 3 支持，相较于 Next 分支拥有更多功能，但稳定性存疑。

我们始终建议您使用 Future 分支的 Mod 模板以获得最新功能，但请依照自己的需求选择版本。

下载链接：

# Ren'Py SDK

您在前序选择的模板会影响这一步 SDK 版本的选择。

# SDK 8（仅 Future 分支）

Ren'Py 8 是 Ren'Py 目前的最新版本，次版本号已发布到 8.1 版本。Ren'Py 8 与 Ren'Py 7 最大的差异是 Python 版本。Ren'Py 支持目前流行的 Python 3，而 Ren'Py 7 只支持 Python 2 且 Python 2 已经停止支持。通常来说，Python 3 兼容 Python 2 的代码。

下载 Ren'Py 8.0.3 (opens new window)

# SDK 7（仅 Next 分支）

Ren'Py 7 是 Ren'Py 目前与 Ren'Py 8 平行的版本，目前已经推出到了 7.6 版本。Ren'Py 在功能性上已经大幅增强，甚至支持使用 Live2D 和构建 HTML5 版游戏（虽然本模板不会支持 Web 端构建）。如果您使用 Next 分支，那么您可以使用该版本 SDK，同时减少额外的学习成本。

注意

由于 Ren'Py 破坏性更新，目前 DDLC 中文 Mod 模板暂时不支持 Ren'Py SDK 7.4.6 及更高版本。

下载 Ren'Py SDK 7.4.5 (opens new window)

# SDK 6.99.12（均可用）

Ren'Py SDK 6.99.12 是最适合制作 DDLC Mod 的旧版 SDK。由于 DDLC 使用该版本的 Ren'Py，您不必担心兼容性问题，但您将无法使用 Ren'Py 7 中引入的新特性。

下载 Ren'Py SDK 6.99.12 (opens new window)

# 中文字体包

从 Mod 模板 v2.0.0-beta2 开始，您不需要下载任何字体即可开始开发，所有字体均内置于模板中。

如果您使用旧版本 Mod 模板，在制作 Mod 之前，您必须手动下载这些中文字体。

下载中文字体包（针对旧版 Mod 模板） (opens new window)

# 代码编辑器

基本环境搭建好后，您可以准备编辑代码了。但你必须使用一款合适的代码编辑器。此处推荐两个：

当然，您也可以使用其他文本 / 代码编辑器，但我们极度不推荐记事本。

# 摆在最后

由于 Mod 模板仅仅是代码模板，它并不包含任何 DDLC 资源，但为了调试和构建 DDLC Mod，你必须复制 DDLC 原版游戏的 images.rpa、fonts.rpa 和 audio.rpa 文件到模板的 /game 文件夹。得益于 Next 分支的优化，您同样可以将 scripts.rpa 一并复制过去，但是不建议这么做。

# 准备流程

# 使用 Ren'Py SDK 6 进行 Mod 开发

  1. 下载并运行 Ren'Py SDK 6.99.12 (opens new window)。

    请注意：DDLC 不兼容新版 Ren'Py，除非游戏后续更新，当然这并不意味着您不能使用 Ren'Py SDK 7 进行 Mod 制作。

  2. 前往 Releases 页面获取 模板的最新版本 (opens new window)。（目前 Mod 模板暂无稳定版本，您可以使用 GitHub 的 Use this template 创建新工程）

  3. 从 DDLC.moe (opens new window) 或者 Steam (opens new window) 下载 DDLC 游戏，然后将 DDLC-1.1.1-pc 文件夹（对于 macOS 用户则为 ddlc-mac，对于 Steam 版本则为 Doki Doki Literature Club）复制到 Ren'Py SDK（renpy-6.99.12.4-sdk）文件夹（或者您在 Ren'Py SDK 中自定义的文件夹）。将文件夹重命名为您的 Mod 名称。

  4. 将 Mod 模板 ZIP 包内的内容复制到您刚刚粘贴的 DDLC 文件夹内。如有提示，请允许替换所有文件。

    对于 macOS，请右键单击 ddlc-mac 文件夹内的 DDLC.app，点击 显示包内容，然后将 Contents/Resources/autorun 文件夹内的文件复制过去。如有提示，请允许替换所有文件。

  5. 在 Ren'Py SDK 里启动项目。它应正常编译并启动游戏。

    有时候，启动项目可能不会发生任何事情，或者报错。您可以再次单击 Launch Project / 运行工程 ，此时工程应该可以正常启动。

  6. 当你完成脚本编写后，转到 Ren'Py SDK 主界面，选择 Build Distributions / 生成分发版。将 Build Packages / 生成分发包 中的其他选项全部取消，仅选中 Ren'Py 6 DDLC Compliant Mod，然后点击 Build / 生成。这个操作会生成跨平台的 ZIP 文件，这就是你的 Mod 文件。

# 使用 Ren'Py SDK 7 进行 Mod 开发

  1. 下载并运行 Ren'Py SDK 7.4.5 (opens new window)。

    请注意：使用 Ren'Py 7 构建的 Mod 不兼容 Ren'Py 6。我们也会跟进上游的变动，以完美适配最新的 Ren'Py SDK。目前 Ren'Py SDK 7.4.6-7.4.7 有破坏性改动，会导致 DDLC 转场失效，请暂时不要更新 SDK！！！更多详情请参考 此 Issue (opens new window)。

  2. 前往 Releases 页面获取 模板的最新版本 (opens new window)。（目前 Mod 模板暂无稳定版本，您可以使用 GitHub 的 Use this template 创建新工程）

  3. 从 DDLC.moe (opens new window) 或者 Steam (opens new window) 下载 DDLC 游戏，然后将 DDLC-1.1.1-pc 文件夹（对于 macOS 用户则为 ddlc-mac，对于 Steam 版本则为 Doki Doki Literature Club）复制到 Ren'Py SDK（renpy-<version>-sdk）文件夹（或者您在 Ren'Py SDK 中自定义的文件夹）。将文件夹重命名为你的 Mod 名称。

  4. 将 Mod 模板 ZIP 包内的内容复制到您刚刚粘贴的 DDLC 文件夹内。如有提示，请允许替换所有文件。

    对于 macOS，请右键单击 ddlc-mac 文件夹内的 DDLC.app，点击 显示包内容，然后将 Contents/Resources/autorun 文件夹内的文件复制过去。如有提示，请允许替换所有文件。
    在 Ren'Py SDK 7 中，如果遇到意外启动失败，可能是因为 game/scripts.rpa 的冲突，您可以尝试删除该文件。

  5. 在 Ren'Py SDK 里启动项目。它应正常编译并启动游戏。

    有时候，启动项目可能不会发生任何事情，或者报错。您可以再次单击 Launch Project / 运行工程 ，此时工程应该可以正常启动。

  6. 当你完成脚本编写后，转到 Ren'Py SDK 主界面，选择 Build Distributions / 生成分发版。将 Build Packages / 生成分发包 中的其他选项全部取消，仅选中 Ren'Py 7 DDLC Compliant Mod，然后点击 Build / 生成。这个操作会生成跨平台的 ZIP 文件，这就是你的 Mod 文件。

# 使用 Ren'Py SDK 8 进行 Mod 开发

  1. 下载并运行 Ren'Py SDK 8.0.3 (opens new window)。

    请注意：使用 Ren'Py 8 构建的 Mod 不兼容 Ren'Py 6 / 7。我们也会跟进上游的变动，以完美适配最新的 Ren'Py SDK。

  2. 前往 模板的仓库页面 (opens new window)，点击 “Code”，点击 “Download ZIP” 将仓库下载下来并解压。（目前 Mod 模板暂无稳定版本，您可以使用 GitHub 的 Use this template 创建新工程）

  3. 从 DDLC.moe (opens new window) 或者 Steam (opens new window) 下载 DDLC 游戏，然后将 DDLC-1.1.1-pc 文件夹（对于 macOS 用户则为 ddlc-mac，对于 Steam 版本则为 Doki Doki Literature Club）复制到 Ren'Py SDK（renpy-<version>-sdk）文件夹（或者您在 Ren'Py SDK 中自定义的文件夹）。将文件夹重命名为你的 Mod 名称。

  4. 将 Mod 模板 ZIP 包内的内容复制到您刚刚粘贴的 DDLC 文件夹内。如有提示，请允许替换所有文件。

    对于 macOS，请右键单击 ddlc-mac 文件夹内的 DDLC.app，点击 显示包内容，然后将 Contents/Resources/autorun 文件夹内的文件复制过去。如有提示，请允许替换所有文件。

  5. 删除 "scirpt.rpa"。

  6. 在 Ren'Py SDK 里启动项目。它应正常编译并启动游戏。

    有时候，启动项目可能不会发生任何事情，或者报错。您可以再次单击 Launch Project / 运行工程 ，此时工程应该可以正常启动。

  7. 当你完成脚本编写后，转到 Ren'Py SDK 主界面，选择 Build Distributions / 生成分发版。将 Build Packages / 生成分发包 中的其他选项全部取消，仅选中 Ren'Py 8 DDLC Compliant Mod，然后点击 Build / 生成。这个操作会生成跨平台的 ZIP 文件，这就是你的 Mod 文件。

# 使用 GitHub 生成新工程

您可能偏好使用 GitHub 托管 Mod 代码，或者希望更快创建工程，接下来您可以借助 GitHub 模板功能来创建您的 Mod 工程。

  1. 下载并运行前序您希望使用的 Ren'Py SDK。(6.99.12 (opens new window) | 7.4.5 (opens new window) | 8.0.3 (opens new window)）
  2. 转到 模板的 GitHub 仓库 (opens new window)，点击页面上的 Use this template（或者使用 此链接 (opens new window)），按照指引命名 Mod 仓库，选择公开 / 私密仓库，点击 Create repository from template。

包含所有分支（Include all branches）为可选项。

  1. 借助您的 Git 客户端，克隆刚刚创建的仓库到电脑的相应文件夹（renpy-<version>-sdk 文件夹，或者您在 Ren'Py SDK 中自定义的文件夹）。

  2. 从 DDLC.moe (opens new window) 或者 Steam (opens new window) 下载 DDLC 游戏，然后将 DDLC-1.1.1-pc 文件夹（对于 macOS 用户则为 ddlc-mac，对于 Steam 版本则为 Doki Doki Literature Club）中的 3 个文件（game/images.rpa，game/fonts.rpa，game/audio.rpa）复制到 <Mod 工程文件夹>/game 文件夹。

    对于 macOS，请右键单击 ddlc-mac 文件夹内的 DDLC.app，点击 显示包内容，然后将 Contents/Resources/autorun 文件夹内的文件复制过去。如有提示，请允许替换所有文件。
    在 Ren'Py SDK 7 / 8 中，如果遇到意外启动失败，可能是因为 game/scripts.rpa 的冲突，您可以尝试删除该文件。

  3. 在 Ren'Py SDK 里启动项目。它应正常编译并启动游戏。

    有时候，启动项目可能不会发生任何事情，或者报错。您可以再次单击 Launch Project / 运行工程 ，此时工程应该可以正常启动。

  4. 当你完成脚本编写后，转到 Ren'Py SDK 主界面，选择 Build Distributions / 生成分发版。将 Build Packages / 生成分发包 中的其他选项全部取消，仅选中 Ren'Py 6 / 7 / 8 DDLC Compliant Mod，然后点击 Build / 生成。这个操作会生成跨平台的 ZIP 文件，这就是你的 Mod 文件。

完成上述所有工作后，您可以开始从一个简单的脚本入手。

# 贡献者

上次更新于: 6/22/2023, 2:46:55 PM
序
第一个简单的脚本

← 第一个简单的脚本→

Theme by Vdoing | Copyright © 2021-2023 DokiMod Team | 本网站是粉丝作品，与 Team Salvato 无关 | hosted by ▲ Vercel | powered by VuePress
访问统计信息