Skip to content

Latest commit

 

History

History
147 lines (103 loc) · 13.7 KB

README.md

File metadata and controls

147 lines (103 loc) · 13.7 KB

DDLC 中文 Mod 模板现已推出 4.0 版本,汉化更规范,功能更丰富,且完美兼容 Ren'Py SDK 7.5 及 8.0。您可以前往 DokiMod/DDLCModTemplate-Chinese-future 仓库获取 DDLC 中文 Mod 模板 4.0(预览版)。目前 4.0 版本不适合生产环境,因此您可以(或者说,最好)继续使用 Mod 模板 2.0 版本进行开发。

使用此模板之前请注意!本项目包含对 DDLC 的剧透。我们希望您能在通关 DDLC 原作后使用该模板进行模组开发,以避免影响游戏体验。

您仍需为自己的心理健康做周全的考虑。DDLC 本质上为心理恐怖游戏,并不适合所有玩家,且游戏内已经做了充足的提醒。心理健康比一切都重要。


DDLC 中文 Mod 模板 2.0

嘿,你想用中文写 DDLC Mod?那你来对地方了!

这是全新的 DDLC 中文 Mod 模板!本模板基于 GanstaKingofSA 的 DDLC Mod Template 2.0,并得到了旧版已经进行的一系列汉化。使用本模板制作 Mod 时,请遵循 Team Salvato 的 IP Guidelines

当前版本的模板支持 Ren'Py SDK 6.99.12 及 7.4.5 / 7.4.9 / 7.4.11。

本模板是为使用原版 DDLC 素材的饭制游戏和 Mod(而并非不使用原版素材的作品)设计的,提供源代码也并非以便将其复制粘贴到和 DDLC 没有关系的工程。此模板内大部分代码属于 Team Salvato 的知识产物,请遵循 Team Salvato 的 IP Guidelines 使用,否则后果自负。

如果你是 Mod 作者,请不要将 DDLC 游戏本体包含在你分发的 ZIP 里,这是违反 IP Guidelines 的行为。

同时,你不应该将本模板用于非 Mod 领域的补丁。

目前 Ren'Py SDK 7.4.6-7.4.8 有破坏性改动,会导致 DDLC 转场失效,但 7.4.9 - 7.4.10 已经修复该问题,您现在可以安全地更新 Ren'Py SDK 至 7.4.10 版本并继续开发 Mod。

本 Mod 模板不支持 Doki Doki Literature Club Plus。

请注意:本模板可能尚不完善,且尚缺乏繁体中文支持。部分 GUI 元素暂未被汉化。

此模板自带 Android 支持,详情请看原版 DDLC Mod Template 2.0 所附带的 guide.pdf,或在稍晚时候访问 DokiMod 开发文档 了解 Android Mod 制作方式。

提示:本模板仅在 GitHubGitee(只要还能活着)提供下载,完全免费。你可能在 CSDN 看到了这个模板,不要去那边花冤枉钱下载!!!(目前已知的 CSDN 盗传版是 1.x 版本,已经不受维护。)
此后本模板不再考虑托管于 SourceForge。(鉴于托管于 SourceForge 会加大恶意爬虫与盗传的概率) Gitee 镜像源的版本更新不及时,但可作为中国大陆加速源。

您可以查看 更新日志

小请求

如果 DDLC 中文 Mod 模板有帮到你,希望您可以在游戏(或介绍页)内为中文 Mod 模板做个标注。

开始制作 Mod

中文字体

DDLC 中文 Mod 模板使用了一些免费商用的中文字体,在此致谢。 从 Mod 模板 v2.0.0-beta2 开始,您不需要下载任何字体即可开始开发,所有字体均内置于模板中。 字体版权及引用文件可在 attributions.txt 中查看。

如有需要,您也可以自行修改配置文件,以自定义字体,但请自主承担版权风险


使用 Ren'Py SDK 6 进行 Mod 开发(不建议)

  1. 下载并运行 Ren'Py SDK 6.99.12

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

  2. 前往 Releases 页面获取 模板的最新版本。(目前 Mod 模板暂无稳定版本,您可以使用 GitHub 的 Use this template 创建新工程)
  3. DDLC.moe 或者 Steam 下载 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.57.4.117.6.1

    请注意:使用 Ren'Py 7 构建的 Mod 不兼容 Ren'Py 6。我们也会跟进上游的变动,以完美适配最新的 Ren'Py SDK。目前 Ren'Py SDK 7.4.6-7.4.8 有破坏性改动,会导致 DDLC 转场失效,但 7.4.9 - 7.4.11 已经修复该问题,您现在可以安全地更新 Ren'Py SDK 至 7.4.11 版本并继续开发 Mod。

  2. 前往 Releases 页面获取 模板的最新版本。(目前 Mod 模板暂无稳定版本,您可以使用 GitHub 的 Use this template 创建新工程)
  3. DDLC.moe 或者 Steam 下载 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 文件。

使用 GitHub 生成新工程

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

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

包含所有分支(Include all branches)为可选项。

  1. 借助您的 Git 客户端,克隆刚刚创建的仓库到电脑的相应文件夹(renpy-<version>-sdk 文件夹,或者您在 Ren'Py SDK 中自定义的文件夹)。
  2. DDLC.moe 或者 Steam 下载 DDLC 游戏,然后将 DDLC-1.1.1-pc 文件夹(对于 macOS 用户则为 ddlc-mac,对于 Steam 版本则为 Doki Doki Literature Club)中的 3 个文件(game/images.rpagame/fonts.rpagame/audio.rpa)复制到 <Mod 工程文件夹>/game 文件夹。

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

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

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

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

开始 Android Mod 移植 / 开发

您可以查阅原版 DDLC Mod Template 2.0 所附带的 guide.pdf,或在稍晚时候访问 DokiMod 开发文档 了解 Android Mod 制作方式,但请遵循以下几点:

  1. 对于 Ren'Py SDK 启动器内的包名,您应该以 com.<作者>.<项目名> 的格式命名并遵循 Android 包名规范。

例如:如果您的昵称为 Yuri,项目名(build.name)为 Storm,那么您在 Ren'Py SDK 启动器的 Android -> Configure / 配置 内的包名应该为 com.yuri.storm

更多内容请前往 原版 DDLC Mod Template 2.0 所附带的 guide.pdf 了解。

模板特色功能

DDLC Mod Template 2.0

  1. 同时支持 Ren'Py SDK 6 和 7 的 Mod 构建
  2. DDLC 的原版 RPY 文件,内含注释
  3. 高度可定制!这个模板只是起点,借助你的创意,做你想做
  4. macOS .app 及 Linux .sh 启动文件制作支持
  5. Android 支持!

    请前往 原版 DDLC Mod Template 2.0 所附带的 guide.pdf 了解 Android Mod 移植 / 开发。

  6. Xcode 支持!您可以在 Xcode 中直接编辑、构建、测试您的 DDLC Mod,无需打开 Ren'Py 启动器。

    提示:您需要更改 RENPY_TOOL 变量,将其定位到您的 Ren'Py SDK 应用程序位置。了解更多 ›

  7. Terra 的深度诗词游戏教程(WIP)
  8. NVL 模式支持 - 特别感谢 Yagamirai01
  9. [BETA] 人称支持!现在用户可以自行选择符合自己的人称了!

    This works best with He/Him, She/Her, and They/Them pronouns but this can be expanded on as much as you like. Make sure to call finishPronouns() in your script after a pronoun is selected! See pronoun_example.rpy for a example on how to use this feature.

  10. 全新蓝屏(BSOD)功能,现在来吓唬一下全平台的玩家吧!(完美支持 Windows 7 / 8 / 10 / 11,乃至 macOS / Linux!)

DDLC 中文 Mod 模板

  1. 绝赞中文化(目前只支持简体中文)
  2. 绝赞字体优化
  3. 绝赞咕咕咕
  4. 内置汉化剧本(贡献者详见特别感谢)

特别感谢

开源许可

本 Mod 模板需要使用 Ren'Py。
Ren'Py 的许可,请参照 https://www.renpy.cn/doc/license.html (简体中文)或 https://www.renpy.org/doc/html/license.html (英文)。

本模板基于 GanstaKingofSA 的 DDLCModTemplate2.0

本模板属于粉丝作品,遵循 Team Salvato IP Guidelines。

加入社区

Telegram 频道
Odysee 频道
Twitter


Copyright © 2019-2021 GanstaKingofSA. All rights reserved.

Modified and translated by imgradeone.

Doki Doki Literature Club, the Doki Doki Literature Club code, is the property of Team Salvato (Dan Salvato LLC). Copyright © 2017 Team Salvato. All rights reserved.