开发者工具 link

Ren’Py包含一些功能,可以让开发工作变得更容易。其中很多功能需要配置项 config.developer 设置为True才能执行。

Shift+O 控制台 link

调试控制台(debug console)可以在交互模式下运行Ren’Py脚本和Python语句,而且能立刻看到运行结果。控制台可以在开发者模式下,或者当 config.console 为True时运行。组合键“shift+O”能打开控制台。

控制台可以用于:

  • 跳转到某个脚本标签(label)。
  • 在交互模式下尝试运行Ren’Py脚本语句。
  • 运算某个Python表达式或语句并查看结果。
  • 在游戏过程中追踪Python表达式。

Shift+E Editor 帮助与支持 link

配置项 config.editor 允许开发者使用“启动编辑器”组合键(默认是“shift+E”)时,运行指定的编辑器命令。

详见 集成文本编辑器

Shift+D 开发者菜单 link

config.developer 为True时,使用组合键“shift+D”会显示开发者菜单,并提供下面那些功能的简易接入。

Shift+R 重新加载脚本 link

config.developer 为True时,使用组合键“shift+R”会保存当前游戏,重新加载游戏脚本,并重新加载游戏。这个操作通常会回到你使用“shift+R”之前未修改过的最近那条语句。

这个功能允许开发者使用外部编辑器修改脚本后,不需要退出并重启Ren’Py就能看到修改后的效果。

需要注意的是游戏状态,包含了变量值和场景列表重载后会被重置。这意味着某些语句的执行结果可能也发生了变化,需要回滚并重新执行那些语句才能看到修改后的效果。

Shift+I 样式检查 link

config.developer 为True,使用组合键“shift+I”能触发样式检查。样式检查中会显示鼠标指针下面的可视组件列表。并显示每一个可视组件的类型、样式和渲染尺寸。

Shift+Y Style 样式备份 link

config.developer 为True,使用“备份样式”组合键(默认是“shift+Y”),会把Ren’Py知道的所有样式描述信息都记录到文件“sytles.txt”中。样式描述信息包括样式的每一种特性(property),特性的值,以及特性继承自哪种样式。

> Fast Skipping link

config.developerconfig.fast_skipping 为True时,使用“快速跳过”快捷键(默认是“>”),将触发游戏立刻跳到下一个重要互动。出于这种需求,重要互动不由say语句、转场(transition)和暂停(pause)命令触发的。通常情况下,快速跳过会直接跳到下一个菜单选项,但也会在用户自定义的互动行为前停止。

传送至某行 link

Ren’Py支持脚本中“传送(warp)至某行”功能,不需要开发者运行整个脚本到达那处。尽管使用传送技巧总是会伴随着一大堆告警(warning)信息,在提供实时预览方面依然很常用。

调用传送功能时,使用命令行运行Ren’Py,使用参数 --warp ,后面再跟上filename:line,这样就能传送到需要的那行。举例:

renpy.exe my_project --warp script.rpy:458

(my_project 是工程基础目录的全路径。)

调用传送功能时,Ren’Py出列了一系列工作。它首先找到程序中的所有scene语句,然后尝试找到使用scene语句到达脚本中每条语句的路径,接着选取最接近目标行的路径(在目标行前或正好到达目标行)。Ren’Py从找到的语句倒推至某个scene语句,记录下使用的路径。然后Ren’Py会执行找到的路径上所有scene和show、hide语句。最后Ren’Py将主控流程切换到目标语句。

关于传送功能,有几条重要事项需要说明。第一条是,传送时只能检查单一路径,这意味着这条路径是实际执行路径之一,在其他路径上可能还是存在bug。总体来说,这条路径不考虑游戏逻辑,所以它也可能是一条实际上并不存在的路径。(对于重流程的游戏,这的确是个大问题,特别是包含大量Python语句的情况。)

然而,最大的问题是,在传送的目标语句前的Python语句不会执行。这表示所有变量都是未经初始化的,使用时可能直接让程序挂掉。为了防止这个问题,创作者可以定义一个脚本标签(label) after_warp ,写一些只有传送后才会执行的语句。这个脚本标签可以在程序中配置变量,并在预览中返回。

传送功能需要 config.developer 设置为True。

调试函数 link

renpy.get_filename_line() link

返回当前语句的文件名和行号的二元元组。

renpy.log(msg) link

config.log() 没有配置,则不执行任何操作。否则,将打开日志文件(如果还没有打开的话),根据 config.log_width 配置的宽度将信息格式化,并打印在日志文件上。

renpy.unwatch(expr) link

停止对给定Python表达式的观察(watch)。

renpy.watch(expr) link

观察(watch)给定Python表达式,信息显示在屏幕的右上角。