1 简介#

第一次接触这个游戏是在 2019 年，当时对 meta 的实现方式很感兴趣，但是当时并不会编程，而且写日记环节的各种生僻英文词也是给我劝退了。后来买了 plus 版一直在吃灰，直到昨天花费一整天时间拿下 plus 版全成就后，又想再来看看 meta 的实现机制，现在有了编程基础和豆姐的加持就很容易实现了。

2 预备知识#

2.1 什么是 Ren’Py#

Ren'Py (Renai + Python) 是基于 Python 和 Pygame 的制作视觉小说和恋爱模拟类游戏的开源游戏引擎，常见的文件格式有：

.rpy: 源代码
.rpyc: .rpy 文件会被 Ren'Py 编译成 .rpyc 格式的二进制文件
.rpa: Ren'Py 专用的压缩包格式，用于打包资源

2.2 文件结构与解包#

未解包前的目录结构：

1
DDLC/
2
├── DDLC.exe         # 游戏主启动程序
3
├── lib/             # 运行库
4
├── renpy/           # Ren'Py 引擎核心
5
└── game/            # 游戏核心资源文件夹
6
  ├── scripts.rpa  # 脚本包：rpyc编译脚本、poemword.txt诗歌词表、特效代码
7
  ├── images.rpa   # 所有立绘、CG、背景图、UI图片
8
  ├── audio.rpa    # BGM、音效
9
  ├── fonts.rpa    # 字体文件
10
  ├── firstrun/    # 首次启动警告页面
11
  └── characters/  # 四个角色的 .chr 文件

进入游戏目录，通过 pip 安装 unrpa 后进入 game 目录下解压 scripts.rpa 和 images.rpa：

1
# 将当前目录下的 scripts.rpa 解压到上级目录下的 ddlc_out 中
2
unrpa -mp ../ddlc_out ../scripts.rpa
3
# 同理将图片解压到 ddlc_image_out 中
4
unrpa -mp ../ddlc_image_out ../iamges.rpa

此时解压出的源代码是编译后的 .rpyc 文件，需要通过 unrpyc 工具反编译：

1
# 下载 unrpyc 工具
2
git clone https://github.com/CensoredUsername/unrpyc.git
3
# 进入 unrpyc 目录
4
cd unrpyc
5
# 反编译
6
python unrpyc.py path/to/your/.rpyc

最终效果类似下图：

3 代码逻辑#

meta 元素涉及到游戏启动动画，主菜单，立绘等，因此对整个流程进行分析，只基于目前周目下会触发的逻辑，而非整体全部的逻辑

3.1 启动动画#

Ren'Py 启动后，会扫描并执行所有的 init 块，例如启动动画对应的脚本 splash.rpy 中定义了启动时显示的文字：

1
init python:
2
    menu_trans_time = 1
3
    splash_message_default = "This game is not suitable for children\nor those who are easily disturbed."
4

5
    splash_messages = [
6
  "You are my sunshine,\nMy only sunshine",
7
    "I missed you.",
8
  ...]

同时也会初始化 image, transform 等：

1
image tos = "bg/warning.png"
2
image tos2 = "bg/warning2.png"

当游戏启动后，会自动执行 label splashscreen 中的语句 (类似函数)，第一次运行时会显示警告：

1
label splashscreen:
2
  # 第一次运行时 persistent.first_run 返回 False
3
  if not persistent.first_run:
4
        python:
5
      # 检查 chr 文件是否存在，不存在则恢复 (definitions.rpy 下)
6
      restore_all_characters()
7
        $ quick_menu = False
8
    # 纯白界面 0.5s 后切换到 tos
9
        scene white
10
        pause 0.5
11
    # 上面定义的图片
12
        scene tos
13
    # 1s 的淡入
14
        with Dissolve(1.0)
15
        pause 1.0
16
    # 警告语句
17
        "This game is not suitable for children or those who are easily disturbed."
18
        "Individuals suffering from anxiety or depression may not have a safe experience playing this game. For content warnings, please visit: http://ddlc.moe/warning.html"
19
        menu:
20
            "By playing Doki Doki Literature Club, you agree that you are at least 13 years of age, and you consent to your exposure of highly disturbing content."
21
      # "我同意" 的按钮
22
            "I agree.":
23
                pass
24
    # 将 persistent.first_run 设置为 True，下次运行就不会显示了
25
        $ persistent.first_run = True
26
        scene tos2
27
        with Dissolve(1.5)
28
        pause 1.0
29
        scene white

进入游戏，我们会看到厂商的 logo (对应 intro 动画) 和 “此游戏不适宜儿童 …” 的警告 (对应 splash_warning)：

图 3.2 logo

1
label splashscreen:
2
  ...
3
  show white
4
  # 不显示二周目彩蛋菜单
5
    $ persistent.ghost_menu = False
6
  # 定义 splash_message：之前定义的默认语句，而不是随机诗句
7
    $ splash_message = splash_message_default
8
  # 播放 bgm
9
    $ config.main_menu_music = audio.t1
10
    $ renpy.music.play(config.main_menu_music)
11

12
    $ starttime = datetime.datetime.now()
13
  # 展示 intro 动画
14
  '''
15
  image intro:
16
      truecenter
17
      "white"
18
      0.5
19
      "bg/splash.png" with Dissolve(0.5, alpha=True)
20
      2.5
21
      "white" with Dissolve(0.5, alpha=True)
22
      0.5
23
  '''
24
    show intro with Dissolve(0.5, alpha=True)
25
  # 只有在三周目才会从 splash_messages 中随机一个诗句
26
    if persistent.playthrough == 2 and renpy.random.randint(0, 3) == 0:
27
        $ splash_message = renpy.random.choice(splash_messages)
28
  # 默认警告文本
29
    show splash_warning "[splash_message]" with Dissolve(max(0, 4.0 - (datetime.datetime.now() - starttime).total_seconds()), alpha=True)
30
    $ pause(6.0 - (datetime.datetime.now() - starttime).total_seconds())
31
    hide splash_warning with Dissolve(max(0, 6.5 - (datetime.datetime.now() - starttime).total_seconds()), alpha=True)
32
    $ pause(6.5 - (datetime.datetime.now() - starttime).total_seconds())
33
    $ config.allow_skipping = True
34
  # 返回后显示开始菜单
35
    return

3.2 开始菜单#

来到开始菜单，它的定义在 screen.rpy 中，人物立绘的定义在之前的 splash.rpy 中：

1
# 立绘位置，动画效果以及缩放等
2
image menu_bg:
3
    topleft
4
    "gui/menu_bg.png"
5
    menu_bg_move
6

7
image menu_art_y:
8
    subpixel True
9
    "gui/menu_art_y.png"
10
    xcenter 600
11
    ycenter 335
12
    zoom 0.60
13
    menu_art_move(0.54, 600, 0.60)
14

15
image menu_art_n:
16
    subpixel True
17
    "gui/menu_art_n.png"
18
    xcenter 750
19
    ycenter 385
20
    zoom 0.58
21
    menu_art_move(0.58, 750, 0.58)

1
screen main_menu():
2
    tag menu
3
    style_prefix "main_menu"
4
  # 是否为二周目彩蛋界面
5
    if persistent.ghost_menu:
6
        add "white"
7
        add "menu_art_y_ghost"
8
        add "menu_art_n_ghost"
9
    else:
10
    # 第一次走这里
11
        add "menu_bg"
12
    # yuri 和 natsuki 的立绘
13
        add "menu_art_y"
14
        add "menu_art_n"
15
    # 开始游戏等按钮的背景框
16
        frame
17
    # use 在当前 screen 中插入另一个 screen：
18
        use navigation
19
    ...

进入解包后的图片文件夹中可以看到三个 image 对应的图片:

navigation 用于插入开始游戏，设置等按钮，不是 main_menu 时表示是在游戏对话界面，此时插入保存，快进等按钮

1
screen navigation():
2
    vbox:
3
    # 样式设置
4
        style_prefix "navigation"
5
        xpos gui.navigation_xpos
6
        yalign 0.8
7
        spacing gui.navigation_spacing
8
    # 第一次进入游戏 if autoload 会返回 False
9
        if not persistent.autoload or not main_menu:
10
      # 当前处于开始菜单
11
            if main_menu:
12
        # 二周目显示乱码开始按钮
13
                if persistent.playthrough == 1:
14
                    textbutton _("ŔŗñĮ¼»ŧþŀÂŻŕěōì«") action If(persistent.playername, true=Start(), false=Show(screen="name_input", message="Please enter your name", ok_action=Function(FinishEnterName)))
15
                else:
16
          # 一周目正常显示开始游戏的按钮，点击后判断是否有用户名，false 时会提示输入名字，然后通过 true=Start() 调用 script.rpy 中的 start
17
                    textbutton _("New Game") action If(persistent.playername, true=Start(), false=Show(screen="name_input", message="Please enter your name", ok_action=Function(FinishEnterName)))
18

19
            else:
20
        # 不是在主菜单中，添加历史，保存等按钮
21
                textbutton _("History") action [ShowMenu("history"), SensitiveIf(renpy.get_screen("history") == None)]
22

23
                textbutton _("Save Game") action [ShowMenu("save"), SensitiveIf(renpy.get_screen("save") == None)]
24

25
            textbutton _("Load Game") action [ShowMenu("load"), SensitiveIf(renpy.get_screen("load") == None)]

1 简介#

2 预备知识#

2.1 什么是 Ren’Py#

2.2 文件结构与解包#

3 代码逻辑#

3.1 启动动画#

3.2 开始菜单#

Comments

Music

Table of Contents

DDLC 中的 meta 机制分析 [1]

1 简介#

2 预备知识#

2.1 什么是 Ren’Py#

2.2 文件结构与解包#

3 代码逻辑#

3.1 启动动画#

3.2 开始菜单#

Comments

Music

Table of Contents