在开始前，需要提醒的是，这个系列并不真的是从”入门“开始，而是作为《DDLC Mod开发指南》之后的“入土”系列，涉及到对于Ren'Py的底层逻辑与代码改动，需要较多的Ren'Py开发经验与较高的Python基础。对于初入者，本系列将不会对入门Ren'Py与Mod开发有任何的帮助，您应该在阅读《DDLC Mod开发指南》后阅读本系列。本系列旨在通过对Ren'Py底层代码的介绍与解读为想要提升自己的编程能力的人提供帮助。

同时需要注意的是，本系列将以Ren'Py 7.6.1的源码作为基础。

欢迎来到Ren'Py从入门到入土系列的第一章：游戏生命周期。了解游戏生命周期有助于我们理解Ren'Py的底层运行逻辑，便于我们后面对Ren'Py的一系列魔改与Mod的制作。

在Ren'Py文档中，我们可以找到有关游戏生命周期的文章：Ren’Py游戏的生命周期(lifecycle)。

然而文档中对于生命周期的介绍是不全面的、缺失的。因此在本章中，我们将通过挖掘Ren'Py的运行流程的方式，从游戏的启动切入，去探寻Ren'Py真正的生命周期。利用这些流程，我们也能做一些进阶的操作，例如通过向游戏传递参数进入隐藏剧情等。

首先，让我们将目光聚焦到游戏根目录中生成的*.py文件。

这是一切的起点，当我们点击可执行文件时，首先会根据运行平台在/lib/查找对应的Python可执行文件，并将根目录下的*.py传递给Python运行。

随后，在*.py文件中主要干了三件事：

定义游戏的基础目录(basedir)；
导入Ren'Py的系列模块（Module）；
导入renpy.bootstrap.bootstrap并执行。

renpy.bootstrap.bootstrap属于文档中启动阶段，在其中，Ren'Py主要干了：

检测游戏基础目录下是否存在environment.txt文件，如果存在则运行其中的代码并将运行后的命名空间中的变量同步到os.environ中；
解析传递的参数与选项：

其中，位置参数按照顺序有：
- basedir - 定义游戏的基础目录，会覆盖之前定义的basedir变量
- command - 运行指令，默认为run，接受的参数有：
  - run - 运行游戏，其接受选项 --wrap，可以直接跳转到某脚本的某行
  - lint - 代码检查模式
  - compile - 编译游戏脚本
  - rmpersistent - 清除持久化数据
  - quit - 退出
  - load-test - 测试加载时间
  选项有：
- --savedir - 指定存取目录
- --trace [0|1|2] - 输出所有的 call/line 到 trace.txt 文件中
- --version - 显示Ren'Py版本
- --compile - 强制编译脚本
- --keep-orphan-rpyc - 防止编译脚本时自动删除孤立的*.rpyc
- --safe-mode - 强制进入安全模式，供玩家进行切换渲染器、调整帧率等操作
  
  值得注意的是，我们发现renpy.exe似乎并不会将其接受到的参数传递给Python可执行文件，因此若想要将参数传递给Ren'Py必须使用以下方式传递：（假设当前工作目录为游戏根目录）
```
   ./lib/<对应平台>/<对应Python可执行文件> <.py文件> . command=<参数>
```
设置gamedir：Ren'Py会依次遍历game、data、launcher/game三个目录，只要访问成功其中一个目录就将gamedir设为该目录；
显示presplash界面；
导入renpy模块与所有子模块；
初始化import：将python-packages与gamedir添加至Python模块搜索目录中；
初始化游戏相关变量，包括config.basedir、config.gamedir等；
使用 try-except 进入死循环：
* 使用 try-except 进入renpy.main.main()
- 接受到renpy.game.QuitException时：如果 Exception 中 relaunch 最终运算值为True，则将启动子进程并将可执行文件传递给子进程；
  - 接受到renpy.game.UtterRestartException时：执行renpy.reload_all函数；
    
    reload_all函数会重置一切变量，再次初始化import
  - 对于其他任何异常，都会触发sys.exit。
- 游戏结束后，清理所有变量，对游戏进行收尾处理；

而在renpy.main.main()，其依次干了：

清除line cache，同步脚本，防止可能的发生的代码改变；
初始化参数处理器；
初始化界面语言解析器：对所有界面语言语法进行定义；
初始化config：在全局范围内定义scene、show、hide、tts_function、notify、autoreload_functions变量；
重置live2d；
设置界面类型（pc、tablet、android等）；

随后进入 Early Init 阶段：
设置renpy.game.basepath=gamedir、将basepath添加到搜索目录中；
设置commondir：指向./renpy/common/
将环境变量中的RENPY_SEARCHPATH目录添加至搜索目录中；
遍历renpy.config.searchpath，加载游戏资源：
1. 加载 Ren'Py Extension(*.rpe)
  
  Ren'Py Extension是一种zip文件，其中应包含一个autorun.py文件用于定义如何执行。
2. 加载 Ren'Py Archive(*.rpa)
  
  Ren'Py Archive 分为三个版本：v1、v2、v3，三个版本的加密方式不同；Ren'Py通过rpa文件的文件头来判断版本决定如何解密。
  
  renpy.loader会加载Archive中的索引。
初始化日志、store、style；
创造一个Script对象：
1. 尝试读取游戏基础目录下的lock.txt，若存在则作为key值对脚本进行校验。
2. 初始化字节码，尝试读取cache/bytecode-<大版本号><小版本号>.rpyb
3. 遍历游戏目录，添加任何以_ren.py、.rpy、.rpyc、.rpym、.rpymc的文件
初始化系统样式；
读取脚本：
1. 对所有脚本进行排序，按Unicode字码顺序读取；
2. 读取脚本；
3. 进行版本校验，若版本不一致则拒绝返回脚本代码；
4. 校验key值是否一致，不一致则拒绝返回解密后的脚本；

在rpy与rpyc同时存在的情况下，优先读取rpyc中的内容。

初始化存档令牌：

存档令牌是一种用于校验存档数据的密钥，使用ECDSA算法。

游戏尝试读取gamedir目录下的tokens文件夹，加载签名密钥和校验密钥；若没有则不启用存档令牌。
初始化偏好设置；
初始化存档位置：

首先是用户文件夹，再寻找gamedir下saves文件夹中的存档，最后遍历renpy.config.extra_savedirs查找额外的存档目录。
更新所有存档，使用签名密钥签名；
初始化持久化数据；
开始执行脚本代码；
查找重复label并报告；
按照名称排序图片；
分析脚本（？），编译ATL语言；
再次查找Ren'Py Archive文件，防止可能的rpa文件更变；
设置renpy.game.less_memory、renpy.game.less_mouse、renpy.game.less_updates为os.environ中的值；
初始化图像缓存；
复制一份干净的存储空间；
配置gc；
进入死循环：
1. 如果restart运算值为真，则执行before_restart，将所有界面restarting赋值为真；
1. 使用try-except运行run函数：
  - 重置所有命名空间；
  - 初始化翻译；
  - 重新构建编译样式缓存；
  - 分析界面；
  - 准备显示界面；
  - 若restart运算值不为真，则保存pyanalysis与字节码；
  - 结束presplash界面显示；
  - 重新初始化日志；
  - 切换上下文；
  - 跳转到_start或start标签：
    
    _start标签被定义在renpy/common/00start.rpy文件中，其中：
    1. 执行所有的default语句，预加载主界面；
    2. 从os.environ中获取RENPY_AUTO_LOAD，并在设置了的情况下自动读档；
    3. 备份旧_game_menu_screen、_history变量，重置变量；
    4. 若os.environ中RENPY_SKIP_SPLASHSCREEN运算值不为True，并且可以加载splashscreen标签，则调用；
    5. 恢复旧_game_menu_screen、_history变量；
    6. 播放主界面音乐（如果有）；
    7. 停止预加载主界面；
    8. 跳转到_restart变量的第二个元素；
  - 执行代码，直到一个Exception被引起（RestartContext与RestartTopContext除外）；
    
    restart被赋值为一个三元元组，其中第一个是结束游戏的转场，第二个元素是"_invoke_main_menu"，第三个元素是"_main_menu"。
    
    _invoke_main_menu、_main_menu 被定义在renpy/common/00start.rpy中。
    
    其中_invoke_main_menu会先判断_restart变量运算值是否为True，若是则在新的上下文中跳转到_restart的第三个元素，否则读取RENPY_SKIP_MAIN_MENU变量，若为False则跳转到_main_menu；若_main_menu返回，则跳转到start标签；
    
    _main_menu则会跳转到_main_menu_screen，先执行before_main_menu，再依次跳转到main_menu、main_menu_screen、_library_main_menu标签；
  - 若捕捉到QuitException，则淡出音频，执行finally中的代码，再次raise跳出死循环；
  - 若捕捉到FullRestartException，则将restart赋值为Exception的reason属性。
    
    运行结束后，进入finally代码：更新持久化数据，重置live2d，保存游戏，执行退出的回调函数，结束main函数运行。

通过对Ren'Py的生命周期与部分运行细节的了解，我们在进行一些对Ren'Py的修改时便知道从哪里入手了。例如：我们正在制作一款剧情解密向的Mod，想要通过修改环境变量的方式解锁真结局，便可以通过environment.txt文件修改，也可以通过修改读取的目录与文件提升谜题难度；亦或是想要避免玩家解包代码获取一些版权资源或是查看源代码作弊的行为，也可以通过修改、增加renpy.loader中的Archive Handler达到废除“一键解包”的傻瓜式操作。

通过对游戏周期的了解，我们也能够解释为什么renpy.utter_restart会触发代码的重编译而renpy.full_restart并不会触发代码重编译。

题外话：本来这个系列是准备咕咕咕了，最近忙于三次生活中，学校校报那边事很多然后开学又是升高二加上学期初就是社团招新季，所以也是很久没有上论坛了。冲浪的时候偶然间看到自己之前写的开发指南还是帮助到了一些人的，于是决定不咕咕咕了把这个系列开写顺便找个时间把之前文档的一些虫抓了（（）