配置项变量 link

配置项变量控制Ren’Py的执行器行为，允许Ren’Py自身使用多种方式的定制化。配置项囊括了常见变量(比如改变界面尺寸)到罕见变量(添加新类型的归档文件)。

Ren’Py执行器会假设，GUI系统已完成初始化，配置项变量不会发生改变。在 init 语句块(block)之外修改配置项变量会导致未定义的行为。配置项变量不是存档文件的一部分。

大多数配置项变量可以使用 define 语句设置：

define config.rollback_enabled = False

字典和列表变量可以使用 define 语句或在 init python 语句块(block)中定义：

define config.preload_fonts += ["OrthodoxHerbertarian.ttf"]
define config.adjust_attributes["eileen"] = eileen_adjust_function

init python hide:
    def inter_cbk():
        # 这是一个糟糕的回调
        renpy.notify("Interacting !")

    config.interact_callbacks.append(inter_cbk)

常用配置项 link

define config.name = "" link: 一个字符串给定了游戏名。这个配置项还会用作回溯等日志文件名的一部分，与版本号一起使用。

define config.save_directory = "..." link

用于生成游戏和保存持久化信息使用的目录。具体的游戏目录取决于不同的平台：

Windows: %APPDATA%/RenPy/save_directory
Mac OS X: ~/Library/RenPy/save_directory
Linux/Other: ~/.renpy/save_directory

该项设置为None的话，将在game目录下创建一个“saves”文件夹。不推荐这样做，因为这无法防止game目录被系统的多用户共享。当某个游戏以管理员身份安装，以普通用户运行时，这种配置也会导致运行问题。

配置该项时，必须使用define语句或者Python语句块。无论使用哪种，配置项的语句都会在其他任何语句之前运行，所以其应该是一个字符串而不能是表达式。

需要打开存档目录时，使用 config.savedir 而不是config.save_directory。

define config.version = "" link: 一个字符串给定了游戏版本号。这个配置项还会用作回溯等日志文件名的一部分。

define config.window = None link

这个配置项控制对话窗口管理的默认方法。若不为空值(None)，该项应该是“show”、“hide”或者“auto”。

当设置为“show”的情况下，对话窗口始终会显示。当设置为“hide”的情况下，除了say语句等需要显示对话内容之外，对话窗口会隐藏。当设置为“auto”的情况下，对话窗口会在scene语句前隐藏，显示对话时再出现。

这个配置项设置了默认值。默认值可以使用 window show 、 window hide 和 window auto 语句改变。详见对话窗口管理。

转场 link

这些配置项控制各种场景的转场效果。

define config.adv_nvl_transition = None link: 在ADV模式文本后直接显示NVL模式文本使用的转场效果。

define config.after_load_transition = None link: loading之后使用的转场效果。

define config.end_game_transition = None link: 游戏正常结束后返回到主菜单使用的转场效果，比如调用return却没有明确的返回点，或者调用 renpy.full_restart()。

define config.end_splash_transition = None link: 在splashscreen后显示主菜单时使用的转场效果。

define config.enter_replay_transition = None link: 若非None，回放(replay)使用的转场效果。

define config.enter_transition = None link: 若非None，进入游戏菜单时使用的转场效果。

define config.enter_yesno_transition = None link: 若非None，进入yes/no提示界面的转场效果。

define config.exit_replay_transition = None link: 若非None，退出回放(replay)时使用的转场效果。

define config.exit_transition = None link: 若非None，退出游戏菜单使用的转场效果。

define config.exit_yesno_transition = None link: 若非None，退出yes/no提示界面使用的转场效果。

define config.game_main_transition = None link: 若非None，使用 MainMenu() 行为函数从游戏菜单离开显示主菜单时使用的转场效果。

define config.intra_transition = None link: 在游戏菜单的各界面之间使用的转场效果。(即使用 ShowMenu() 切换界面。)

define config.main_game_transition = None link: 从主菜单进入游戏菜单，以及点击“Load Game”或“Preferences”后使用的转场效果。

define config.nvl_adv_transition = None link: 在NVL模式文本后直接显示ADV模式文本使用的转场效果。

define config.say_attribute_transition = None link: 若非None，用image属性(attribute)的say语句改变图像时使用的转场效果。

define config.say_attribute_transition_callback : Callable link

这里可以配置一个函数，返回一个应用的转场和转场使用的图层。

该函数有四个入参：图像标签(image tag)， mode 参数，含有前置转场标签的 set ，以及包含后置转场标签的 set 。 mode 参数的值为下列之一：

“permanet”，永久修改属性(attribute)，当前say语句开始一直生效。
“temporary”，临时修改属性(attribute)，仅对当前say语句生效，之后保存修改过的临时属性。
“both”，永久和临时修改属性(attribute)同时生效。(针对部分属性需要在当前say语句之后继续生效，而部分属性需要恢复的情况。)
“restore”，临时属性(attribute)失效，恢复之前的值。。

返回值是一个2元的元组，包含下列内容：

使用的转场(transition)，如果不使用转场则发挥None。
转场所在的图层名，应该是一个字符串或者None。大多数情况下都是None。

默认应用返回值为(config.say_attribute_transition, config.say_attribute_transition_layer)。

define config.say_attribute_transition_layer = None link: 若非None，这必须是给定图层(layer)名的字符串。(大多数情况都是“master”。)say属性(attribute)会应用于命名的那个图层，且Ren’Py不会暂停等待转场效果发生。在对话显示时，这也会对属性(attribute)中的转场生效。

define config.window_hide_transition = None link: 没有显示指定转场效果时，window hide语句使用的转场效果。

define config.window_show_transition = None link: 没有显示指定转场效果时，window show语句使用的转场效果。

环境设定默认值 link

Ren’Py有一些变量设置了环境设定的默认值。请查看环境设定变量部分的内容。

偶尔用到的配置项 link

define config.adjust_attributes = { } link

若非None，该项是一个字典型数据。当某个包含图像属性(image attribute)的语句或函数执行或预加载时，会将图像标签(tag)作为键值在字典内搜索。如果没有搜索到，则使用键值None再次搜索。

如果搜索到了字典内的值，该值需要是某个函数。此函数的入参是一个由图像名称、图像标签(tag)和属性(attribute)组成的元组。函数返回值是另一个元组，由一组新的图像属性组成的元组。

该函数可能会在预加载阶段被调用，所以其不应该依赖于图片的状态。

define config.after_default_callbacks = [ ... ] link

一个函数列表。当 dafault 语句执行时会无参调用列表中的函数。 default语句除了初始化阶段执行之外，还会在游戏启动之前、加载存档时、回滚之后、lint检查前和少数其他时机。

与default语句类似，这些回调函数也是一个添加游戏必要数据的好地方。

define config.after_load_callbacks = [ ... ] link

读档时，(无入参)调用的回调函数列表。

若回调函数会修改数据(例如，从旧版迁移数据到新版)，应该调用 renpy.block_rollback() 函数，以防止用户回滚导致修改回退。

define config.after_replay_callback = None link: 若非None，该项是回放(replay)结束后，不使用入参那调用的函数。

define config.always_shown_screens = [ ] link

Ren’Py中始终强制显示的界面列表。该列表中的界面在UI隐藏时或打开菜单时，依然会显示。列表中的某个界面就算尝试隐藏或不显示，依然会被强制显示。一般只被Ren’Py内部使用，也可以根据需求修改该列表。

通常直接设置 config.overlay_screens 更合适。

define config.audio_filename_callback = None link

若非None，该函数调用时需要传入一个音频文件名，并返回另一个音频文件名，并实际播放后者。

在音频文件格式需要改变，但又不想改游戏脚本时，可以使用该配置项。

define config.audio_filename_callback = None link

若非None，该项是一个函数。入参是一个音频文件名，可能会返回另一个音频文件名，用作稍后连续播放。

该项可用在音频文件格式发生改变的场景，但最好不要用于更改游戏脚本。

define config.auto_channels = { "audio" : ( "sfx", "", "" ), ... } link

该项用于定义自动音频通道。它将通道名映射为一个3元的元组：

混合器使用的通道名。
通道上播放文件的前缀。
通道上播放文件的后缀。

define config.auto_movie_channel = True link

若为True，play 入参传入 Movie()。每个影片都会自动生成对应的音频通道名。

config.single_movie_channel 的优先级高于该配置项。

define config.auto_load = None link: 若非None，该项表示Ren’Py启动时自动加载的一个存档文件名。该项是提供给针对开发者用户，而不是终端用户用的。将该项设置为1的话，就会自动读取槽位1的存档。

define config.auto_voice = None link

该项可以是一个字符串、一个函数或者空值(None)。若为None，自动语音功能就被禁用。

若是一个字符串，字符串格式带有与表示对话当前行标识绑定的变量 id 。如果该项给出了一个存在的文件，那个文件就被作为语音播放。

若是一个函数，该函数会带一个入参被调用，即对话当前行标识号。该函数应该返回一个字符串，这个字符串给出的文件存在的情况下，文件就会作为语音播放。

更多细节详见自动语音。

define config.autosave_callback = None link

后台自动存档时，将调用的回调函数或行为函数列表。尽管可以在列表中添加行为函数，但如果返回其他行为函数则不会执行。

若非行为类回调函数会显示一个可视组件或界面，需要调用 renpy.restart_interaction()。

::: define config.autosave_callback = Notify(“Autosaved.”)

define config.autosave_prefix_callback = None link: 若不是None，该项是一个无参调用的函数，会返回自动存档文件名的前缀。默认前缀为“auto-”，对应的存档文件名分别为“auto-1”、“auto-2”等。

define config.autosave_slots = 10 link: 自动存档使用的槽位编号。

define config.cache_surfaces = False link: 若为True，图像的底层数据存储在RAM中，允许图像操作器(manipulator)使用时不需要从磁盘加载。若为False，数据会从缓存中删除，但会在显存中存为一份纹理(texture)，降低RAM使用。

define config.character_id_prefixes = [ ... ] link

该项指定了一个可以用于 Character() 对象的样式特性(property)前缀列表。当某个样式前缀与列表中的前缀匹配，带有那个前缀的可视组件就会应用对应的样式。

例如，给默认GUI添加“namebox”前缀。当某个角色给定了namebox_background特性时，它会将带有id“namebox”的可视组件设置为say界面的 background。

define config.conditionswitch_predict_all = False link: 针对 ConditionSwitch() 和 ShowingSwitch() 的predict_all入参默认值，决定是否所有可用的可视组件都显示。

define config.context_callback = None link: 当Ren’Py进入一个新上下文(context)时(比如某个菜单上下文)，调用的回调函数。

define config.context_copy_remove_screens = [ 'notify', ... ] link: 该项是一个界面列表。当回滚或保存时导致上下文(context)复制时，将移除列表中的所有界面。

define config.context_fadein_music = 0 link: 环境发生变化时，Ren’Py播放音乐淡入的时间值，单位为秒。(通常是指游戏加载的情况)

define config.context_fadeout_music = 0 link: 环境发生变化时，Ren’Py播放音乐淡出的时间值，单位为秒。(通常是指游戏加载的情况)

define config.debug = False link: 启用调试功能(大多数时候将文件丢失问题转成错误信息)。在发布版本中，该项应该是关闭的。

define config.debug_image_cache = False link: 若为True，Ren’Py会把关于图像缓存的信息写入到image_cache.txt文件中。

define config.debug_prediction = False link: 若为True，Ren’Py会将预加载(执行流程、图像、界面)时发生的错误记录到日志log.txt和控制台中。

define config.debug_sound = False link: 启用声音调试功能。该项禁用了声音生成过程中的错误抑制机制。不过，如果声卡丢失或者故障，这样的错误是正常的，启用这个调试项可能会导致Ren’Py的正常功能无法工作。在发布版本中，该项应该是关闭的。

define config.debug_text_overflow = False link: 当该项为True时，Ren’Py会把文本溢出记录到text_overflow.txt文件中。文本组件渲染一个比其自身更大尺寸的区域时，会产生一个文本溢出。该项设置为True，并把样式特性中的 xmaximum 和 ymaximum 设置为对话窗口尺寸，就能在对话长度相对窗口过大时生成溢出报告。

define config.default_attribute_callbacks = { } link

当某个含有图像属性(attribute)的语句或函数执行、预加载时，如果发现该属性的图像当前并没有显示，则从该配置项字典寻找对应图像。如果没有找到，则使用None作为键再次搜索。

如果还是没找到，则需要执行某个函数。此函数会指定一个图像名称，一个包含必要图像标签和属性的元组。次函数会返回一个可迭代数据，包含图像初次显示时应用的额外属性。

函数的执行结果被认为是附加的，任何显式的冲突和反向的属性都会优先于函数执行结果。

由于此函数可能在预加载时调用，所以函数必须能在任意状态都响应。

define config.default_language = None link

若不是None，该项是一个字符串，指定多语言框架下游戏默认使用的语言。

详见多语言。

define config.default_tag_layer = "master" link: 图像显示的默认图层(layer)，前提是图像标签(tag)在 config.tag_layer 不存在。

define config.default_transform = ... link

使用show或scene语句显示某个可视组件时，从此项配置的transform获取并初始化可视组件transform特性(property)的值。

默认的default_transform是 center，居中。

define config.defer_styles = False link

当该项为True时，style语句的执行会推迟到所有 translate python 语句块(block)执行后。这允许多语言支持python语句块更新某些变量。这些变量会用于多语言支持样式之外的style语句中。

该项默认值是False， gui.init() 被调用时会将该项设置为True。

define config.defer_tl_scripts = Fasle link: 当该项为True时，除非选择了指定的语言，Ren’Py不会从tl目录加载脚本。详见翻译文件延迟加载。

define config.developer = "auto" link

若设置为True，启用开发者模式。开发者模式下能使用shift+D进入开发者菜单，使用shift+R重新加载脚本，以及各种不支持终端用户的功能特性。

该项可以是True、False或“auto”。若设置为“auto”，Ren’Py会检查整个游戏是否已经构建打包，并设置合适的config.developer值。

define config.disable_input = False link: 该项为True时， renpy.input() 函数立即终止，并返回其 default 参数。

define config.displayable_prefix = { } link: 请见可视组件前缀。

define config.emphasize_audio_channels = [ 'voice' ] link

给出音频通道名的字符串列表。

如果启用了“emphasize audio”环境设定，当列表内某个音频通道开始播放一个声音时，所有不在列表内的通道都将在 config.emphasize_audio_volume 定义的时间(单位为秒)内将自身的音量中值降低到 config.emphasize_audio_time 的值。

当没有列表内的通道播放声音时，所有不在列表内的通道将在 config.emphasize_audio_time 定义的时间(单位为秒)内将自身的音量中值提高到1.0。

例如，将该项设置为 [ 'voice' ] 的话，播放语音时所有非语音通道的音量都会被降低。

define config.emphasize_audio_time = 0.5 link: 见上面的说明。

define config.emphasize_audio_volume = 0.5 link: 见上面的说明。

define config.empty_window : Callable link

当_window项为True且界面上不显示任何窗口时，该项会被无参调用。(那表示， renpy.shown_window() 函数没有被调用。)通常用于在界面上显示一个空的窗口，返回后不会触发互动行为。

该项的默认用法是，叙述者角色显示一个空白行不使用互动行为。

define config.enable_language_autodetect = False link: 若为True，Ren’Py会尝试根据玩家系统的地区信息自动决定使用的语言。若自动检测并设置成功，这种语言后续将作为默认的语言。

define config.enter_sound = None link: 若非None，这是进入游戏菜单播放的音效文件。

define config.exit_sound = None link: 若非None，这是离开游戏菜单播放的音效文件。

define config.file_slotname_callback = None link

若非None，该项是一个回调函数，会被文件行为函数使用，将某个存档页和对应的名称转换为存档槽的名称，并传给存档函数。

page: 该项是一个字符串，对应当前存档页的名称。该字符串通常包含一个数字，但也可能会包含特殊字符串比如“quick”或“auto”。
name: 该项是一个字符串，包含当前存档页上某个存档槽的名称。该项也可以包含正则表达式(比如 r’d+’)，所有匹配正则表达式的结果都将包含在返回结果中。

默认行为等效于：

def file_slotname_callback(page, name):
    return page + "-" + name

config.file_slotname_callback = file_slotname_callback

该配置项的用途之一是，给存档文件名加前缀。

相关信息查看 config.autosave_prefix_callback。

define config.fix_rollback_without_choice = False link: 该项决定了回退时，内建菜单和imagemap的构建方式。该项默认值是False，表示只有之前选择的菜单选项是可以点击的。若设置为真(False)，之前的选择会被标记，但所有选项都不是可点击的。用户可以使用点击在回退缓存中处理随意向前。

define config.font_hinting = { None : "auto" } link

该项是一个字典，指定了hinting模式下 hinting 样式特性各种情况使用的字体文件名。当 hinting 为True时，Ren’Py会在字典中搜索并启用对应字体。

如果字典内没有匹配的键(key)，则启用键为None对应的值。

define config.font_name_map = { } link: 该项是一个字典，表示字体与字体文件路径/字体组的映射关系。字体名称简化为 {font} 标签，并指定标签内文字对应的字体组功能特性。

define config.font_replacement_map = { } link

该项是一个从(font, bold, italics)到(font, bold, italics)映射，用来使用指定的粗体或斜体替换默认字体。例如，如果想要 Vera.ttf 版本的斜体使用 VeraIt.ttf 代替，可以这样写：

init python:
    config.font_replacement_map["Vera.ttf", False, True] = ("VeraIt.ttf", False, False).

请注意，这种映射只能用于字体的特定变化。也就是说，请求“Vera”字体的粗体兼斜体版本，会得到一个粗体兼斜体版本的“Vera”字体，而不是斜体“Vera”的粗体版本。

define config.game_menu_music = None link: 若非None，该项是在游戏菜单时播放的音乐文件。

define config.gl_clear_color = "#000" link: 在有意义的图像绘制前，用于清理窗口使用的颜色。当游戏在窗口或显示器全屏模式下的显示器高宽比与游戏定义的高宽比不匹配时，letterbox或pillarbox的边框就是用的这种颜色。

define config.gl_lod_bias = -0.5 link: uniform变量 u_lod_bias 的默认值，控制Ren’Py使用的mipmap。

define config.gl_test_image = "black" link: 运行OpenGL性能测试时使用的图片名称。这个图片会在启动时显示5帧或者0.25秒，然后自动隐藏。

define config.has_autosave = True link: 若为True，游戏会启动自动保存。若为False，禁用自动保存。

define config.history_callbacks = [ ... ] link

该项包含一个回调(callback)函数列表，其中的回调函数会在Ren’Py在_history_list中添加新对象之前被调用。调用回调函数时，新增的HistoryEntry对象会作为第一个入参，还可以在那个对象中添加新的字段(field)。

Ren’Py使用内置的历史回调函数，所以创作者应该将自己的回调函数添加到这个列表中，而不是替换整个列表。

define config.history_length = None link: Ren’Py保存的对话历史层的数量。该项被默认GUI设置为250。

define config.hw_video = False link: 若为True，在移动平台播放视频启用硬件解码。硬件解码视频更快，但受到某些格式和全屏播放的限制。若为False，使用软解解码播放，但效率堪忧。

define config.hyperlink_handlers = { ... } link: 一个字典，建立超链接协议与协议处理器(handler)之间的映射关系。处理器(handler)是一个函数，使用超链接做为值(在英文冒号之后的内容)，并执行一些行为。如果有返回值，互动行为就停止。否则，点击操作会被忽略，互动行动继续。

define config.hyperlink_protocol = "call_in_new_context" link: 没有关联任何协议的超链接所使用的协议。详见文本标签中关于可用协议部分。

define config.image_cache_size = None link

如果非None，该项用于设置图像缓存的大小，是界面尺寸的整倍数，单位为像素。

如果设置过大，是浪费内存的行为。如果设置过小，图像从磁盘直接加载，会降低性能。

define config.image_cache_size_mb = 300 link

该项用于设置图像缓存的大小，单位是MB。如果 config.cache_surfaces 的值是False，每个图像的一个像素占用4 byte的存储空间；否则，每个图像的一个像素占用8 byte的存储空间.

如果设置过大，是浪费内存的行为。如果设置过小，图像从磁盘直接加载，会降低性能。只要 config.image_cache_size 的配置不是空值(None)，就不使用config.image_cache_size_mb。

define config.input_caret_blink = 1.0 link: 若非False，将设置默认光标的闪烁间隔时间，单位为秒。

define config.layer_transforms = { } link

一个字典，用于表示图层名称与对应的变换列表。所有变换会在最后应用于图层，生效时间在 show layer 和 camera 变化之后。

若图层名为None，变换会应用于所在定义在 config.layers 中的图层，生效时间晚于各种转场(transition)。

define config.lint_character_statistics = True link: 若为True，并且 config.developer 也为True时，lint的分析报告会包含对话段落中每个角色的统计数据。游戏打包后，角色统计数据将禁用，以防止对游戏运行产生干扰。

define config.load_failed_label = None link

如果配置为一个字符串，表示一个脚本标签(label)。脚本修改过多导致Ren’Py无法恢复产生读档失败的情况下，将跳转到该脚本标签。在执行读档前，Ren’Py将主控流程切换为最后执行语句开头，并清空调用栈。

也可以配置为一个函数。该函数没有入参，返回值需要是一个脚本标签(label)。

define config.locale_to_language_function = ... link

该函数基于用户所在地区(locale)决定游戏使用的语言。

函数有两个入参，分别为地区(locale)的ISO编码和行政区(region)的ISO编码。

返回值是一个字符串，对应支持的语言名称，或者返回None表示使用默认语言。

define config.main_menu_music = None link: 若非None，就是一个在主菜单播放的音乐文件。

define config.main_menu_music_fadein = 0.0 link: config.main_menu_music 中用于淡入的时间，单位为秒。

define config.max_texture_size = (4096, 4096) link

Ren’Py能加载的最大单一纹理(texture)尺寸。该项仅用于3D模型。 2D图片在有需要时会切分为多个纹理。

Live2d will adjust this to fit the largest live2d texture.

define config.menu_arguments_callback = None link

若该项不是None，应是一个函数，可能有固定位置入参和关键词入参。当menu语句运行时，就调用该项配置的函数。入参就是menu语句。

返回值有两个，一个是包含固定入参的元组(大多数情况下是空的)，以及关键词入参的字典型数据。

define config.menu_clear_layers = [] link: 图层名(以字符串形式)列表，列表中的图层在进入游戏菜单时会清空。

define config.menu_include_disabled = False link: 设置了这个配置项后，可以使用if语句将某个分支选项(choice)禁用，效果类似禁用某个按钮(button)。

define config.menu_window_subtitle = "" link: 进入主菜单或游戏菜单时， _window_subtitle （窗口标题）变量。

define config.minimum_presplash_time = 0.0 link: 设置了一个时间值，单位为秒。表示presplash、安卓presplash或iOS的启动画面最短显示的时间。如果Ren’Py在这段时间内完成初始化，它将会休眠，确保图像至少显示配置的时间。如果Ren’Py启动耗时较长，启动画面也可以显示更久。

define config.missing_background = "black" link: 当 config.developer 为True且某个之前 scene语句使用了未定义的图像时，该项就会作为背景使用。该项的值应该是一个图像名(字符串)，而不是可视组件。

define config.mode_callbacks = [ ... ] link

进入某个模式(mode)时调用的回调函数列表。详见模式章节的内容。

其默认值由 config.adv_nvl_transition 和 config.nvl_adv_transition 共同构成。

define config.mouse = None link

这个配置项控制用于定义的鼠标指针。若为空，使用系统鼠标，也就是一个黑白色的光标指针。

否则，该项应该是一个给定多种鼠标类型动画的字典。默认库中使用的键(key)包括“default”、“say”、“with”、“menu”、“prompt”、“imagemap”、“pause”、“mainmenu”和“gamemenu”。键“default”必须存在，它会在其他特定键不存在的情况下使用。

字典中的每个键对应的值都是一个(image, xoffset, yoffset)形式元组的列表，按帧排序。

image: 鼠标指针图像。图像的最大尺寸取决于用户的硬件配置。32×32的图像可以用在任何地方，64×64在大多数硬件上可以运行。更大的图像可能就无法工作了。
xoffset: 从指针左端开始算的热点(hotspot)偏移量，单位是像素。
yoffset: 从指针顶端开始算的热点(hotspot)偏移量，单位是像素。

序列帧以20Hz的频率循环播放。

define config.mouse_displayable = None link

若非None，该项可以是一个可视组件或者可以返回一个可视组件的可调用对象。如果可调用对象可以返回None，Ren’Py会预处理这种情况。

如果该项的值指定为可视组件，鼠标光标将被隐藏，指定的可视组件会显示在其他所有画面元素之上。指定的可视组件可以相应所以鼠标光标位置和绘制的事件消息，与 MouseDisplayable() 等组件类似。

define config.narrator_menu = True link: 若为True，菜单内的叙述会使用旁白(narrator)角色。否则，叙述会显示为菜单标题。

define config.nearest_neighbor = False link: 默认使用近邻过滤，支持像素化和柔化。

define config.notify = ... link: renpy.notify() 和 Notify() 函数会调用该配置项，入参为 message ，效果为显示通知消息。默认配置为 renpy.display_notify() 。该配置还可以让创作者拦截通知。

define config.optimize_texture_bounds = True link: 当该项为True，Ren’Py会扫描图像并找到所有不透明像素的绑定框(box)，并加载这些像素转为一张纹理(texture)。

define config.overlay_functions = [ ] link: 一个函数列表。当被调用时，每个函数都会用ui函数在overlay图层上添加可视组件。

define config.overlay_screens = [ ... ] link: 当覆盖(overlay)启用时，显示的界面列表；当覆盖(overlay)被阻止时，隐藏界面列表。(界面在screen图层上显示，而不是overlay图层。)

define config.pause_after_rollback = False link: 若为False，即默认值，回滚将跳过所有暂停，只在某些对话和菜单选项才会停止。若为True，Ren’Py在回滚时，所有用户可能遇到的没有设置时间的暂停都会停止。

define config.physical_height = None link: 若设置后，该项表示Ren’Py游戏窗口的默认高度，单位为像素。若没有设置，窗口的默认高度为 config.screen_height。

define config.physical_width = None link: 若设置后，该项表示Ren’Py游戏窗口的默认宽度，单位为像素。若没有设置，窗口的默认宽度为 config.screen_width。

define config.preload_fonts = [ ] link: Ren’Py启动时加载的TrueType和OpenType字体名列表。添加在这个列表中的字体名称可以防止引入新字体Ren’Py出现暂停。

define config.preserve_volume_when_muted = False link: 若为False，即默认值，当音频通道处于静音状态时，对应通道的音量值为0，并不能改变。否则，音频通道在静音状态下可以调整音量值。

define config.python_callbacks = [ ] link

一个函数列表。列表中的函数会在初始化阶段之外的任何时候被调用，不使用任何入参。

这种函数的可能用途之一，是某个变量每次调整后，都需要使用一个函数将其值限制在某个范围内的情况。

当Ren’Py启动时游戏未启动前，这些函数就可以被调用，而且可能这些函数相关的变量还未进行初始化。这些函数被要求处理这种情况，通过使用 hasattr(store, 'varname') 检查某个变量是否定义过。

define config.quicksave_slots = 10 link: 快速存档使用的槽位编号。

define config.quit_action = ... link: 当用户点击程序窗口的退出按钮时调用的行为。默认的行为会提示用户确认是否真的想要退出。

define config.reload_modules = [ ] link: 一个字符串列表，表示游戏中会重新加载的所有Python模块名。这些模块的子模块也会重新加载。

define config.replace_text = None link

若非None，这是一个使用一个入参的函数，函数向用户展示一段文本。该函数可以将传入的文本原样返回，也可以返回某些数据被替换后的文本。

只有文本替代执行后且文本已经使用标签(tag)分割，这个函数才会被调用，所以入参就是实际文本。所有可视文本都可以传入这个函数：不限于对话文本，还包括用户接口文本。

这个函数可以用来把特定的ASCII编码序列替换为Unicode字符，样例如下：

def replace_text(s):
    s = s.replace("'", u'\u2019') # apostrophe
    s = s.replace('--', u'\u2014') # em dash
    s = s.replace('...', u'\u2026') # ellipsis
    return s
config.replace_text = replace_text

极少使用或内部使用 link

define config.adjust_view_size = None link

若非None，该项应该是一个函数，使用两个入参：物理窗口的宽度和高度。它会返回一个元组，给出OpenGL视点(viewport)的宽度和高度，也就是Ren’Py会绘制图片的一块屏幕区域。

该项配置用于配置Ren’Py只允许使用某些尺寸的屏幕。例如，下列配置值允许使用原始屏幕的整数倍大小(保持宽高比)：

init python:

    def force_integer_multiplier(width, height):
        multiplier = min(width / config.screen_width, height / config.screen_height)
        multiplier = max(int(multiplier), 1)
        return (multiplier * config.screen_width, multiplier * config.screen_height)

    config.adjust_view_size = force_integer_multiplier

define config.afm_bonus = 25 link: 自动前进模式生效的情况下，计算对话字符串长度时，额外添加的字符数量。

define config.afm_callback = None link: 若非None，这是一个Python函数，用于判断启用自动前进是否安全。该项的意义在于，语音系统中播放某个语音途中禁用自动前进功能。

define config.afm_characters = 250 link: 自动前进模式下，播放各段对话间存在一个间隔时间。该配置项设置的值表示该长度的字符串与这个间隔时间等效。

define config.afm_voice_delay = .5 link: 语音文件播放完成后，在AFM能进入下一段文本之前，等待的时间值，单位为秒。

define config.all_character_callbacks = [ ] link: 可以通过所有角色调用的回调函数列表。这个列表会前向添加到指定角色回调函数列表。 Ren’Py会把自身用到的回调函数添加到该列表中。

define config.allow_skipping = True link: 如果设置为False，用户就不能跳过游戏的文本内容。参见 _skipping 。

define config.allow_screensaver = True link: 若为True，游戏运行时可以激活截屏工具。若为False，禁用截屏工具。

define config.archives = [ ] link

用于搜索图片和其他数据的归档文件列表。所有归档文件的入口应该是包含归档文件基本名的字符串，不包含.rpa扩展名。

归档文件的搜索按照列表中的顺序进行。第一个搜索到的归档文件会被使用。

在启动阶段，Ren’Py会检索game目录内的所有归档文件，按照ascii码排序，自动插入到这个列表中。例如，如果Ren’Py找到了文件 data.rpa、patch01.rpa 和 patch02.rpa，最终生成的列表为 ['patch02', 'patch01', 'data'] 。

define config.at_exit_callbacks = [ ] link: 一个回调函数列表，当Ren’Py退出或重启游戏时将调用。这些回调函数不应该有用户交互。

define config.auto_choice_delay = None link: 若非None，这个变量给定了一个时间值(单位为秒)，这个时间值内Ren’Py会暂停，之后会在游戏内选项中随机选择一个。我们希望这个配置项在发布版本中始终设置为None，不过没有什么人工做互动的情况下可以用来自动演示。

define config.autoreload = True link

若为True，使用shift+R组合键可以自动重新加载脚本。并且，当自动重加载功能启用后，Ren’Py一旦发现使用的文件发生修改就会自动重加载。

若为False，Ren’Py值在每次按下shift+R时才会重新加载脚本。

define config.autosave_frequency = 200 link: 表示经过多少次互动行为后会发生自动存档。如果要禁用自动存档，将 config.has_autosave 设置为False，不需要修改该项的值。

define config.autosave_on_choice = True link: 若为True，Ren’Py会在每次游戏内选项后自动存档。(当 renpy.choice_for_skipping() 被调用时。)

define config.autosave_on_quit = True link: 若为True，Ren’Py会在用户做出以下操作时尝试自动存档：退出、返回主菜单、游戏中读取其他存档。(存档时，当用户被提示确认就会执行自动存档。)

define config.autosave_on_input = True link: 若为True，Ren’Py在用户输入文本时自动保存(调用 renpy.input() 时)。

define config.call_screen_roll_forward = False link: 当界面的 roll_forward 特性值为None时，则使用该配置项的值。

define config.character_callback = None link: Character对象回调参数的默认值。

define config.choice_empty_window = None link

若非None，并且(通常使用 menu 语句调用的)选项菜单没有标题，就调用此处定义的函数生成标题，入参为(“”, interact=False)。

使用方法为：

define config.choice_empty_window = extend

这样就可以让选项菜单的标题显示为之前对话内容的最后一句。

还有其他实现方式，前提是对话窗口总是显示。

define config.choice_layer = "screens" link: 选择界面(使用menu语句)显示的图层(layer)名。

define config.clear_layers = [] link: 一个图层(layer)名的列表，当进入主菜单和游戏菜单时，就会清除列表上所有图层的图像。

define config.console = False link: 该项会在 config.developer 不是True的情况下依然能启用控制台。

define config.context_clear_layers = [ 'screens', 'top', 'bottom', ... ] link: 一个图层(layer)名的列表，当进入一个新的上下文(context)时，会清除列表上所有图层的图像。

define config.controller_blocklist = [ ... ] link: 一个字符串列表，每个字符串都会尝试匹配对应游戏控制器的GUID。当字符串匹配到控制器GUID(可以在 log.txt 中看到对应日志)或其前缀，将在初始化阶段就禁用对应控制器。

define config.exception_handler = None link

如果不是None，该项应该是一个函数，并带有3个入参：

一个字符串，表示记录traceback的缩略文本，仅包含创作者编写的文件。
traceback完整文本，同事包含传作者编写和Ren’Py的文件。
包含traceback方法的文件路径。

该函数用于控制是否向用户展现程序错误。若函数返回True，忽略异常(exception)并将主控流程切换到下一个语句。若函数返回False，启用内建的异常处理机制。该函数也可以调用 renpy.jump() 将主控流程切换至其他文本标签(label)。

define config.detached_layers = [ ] link: 该项设置的图层不会自动添加到场景中。它们总是被当作 粘滞图层 ，并且用作嵌在 Layer 可视组件中。

define config.display_start_callbacks = [ ] link: 该项包含一个函数列表，在Ren’Py显示某个窗口后渲染窗口第一帧之前调用。该项的主要用途是，允许某些需要初始化GUI的库，比如OpenGL函数，读取资源文件。

define config.ex_rollback_classes = [ ] link

该项为一个对象列表，可以使之前的版本中回滚会告警的类，不再产生告警信息。如果创作者不想要某个类对回滚操作的支持，就把类的对象放在该列表中。

有时候，并不需要如实一一添加，而只要把自定义类的基类 object 添加到列表中。

define config.fadeout_audio = 0.016 link

默认的音频淡出时间。使用 stop 语句和 renpy.music.stop() 函数停止某个音频，或者使用 play 语句和 renpy.music.play() 函数开始一段新的音轨都会用到淡出效果。不过音频队列不会使用淡出效果来衔接。

这个暂短的淡出可以用来掩盖音频停止和切换时的点击声和爆音。

define config.fast_skipping = False link: 该项设置为True的话，允许在开发者模式之外也使用快速跳过。

define config.file_open_callback = None link

若非None，该项是一个函数，当某个文件需要被打开是会调用该函数。函数会返回一个类似文件的对象，或者使用Ren’Py的文件加载机制时返回None。类似文件的对象必须能用使用read、seed、tell和close方法。

对应的，还需要定义 config.loadable_callback 。

define config.focus_crossrange_penalty = 1024 link: 当用键盘移动焦点时，这是应用于垂直于所选运动方向的移动的惩罚量。

define config.gamedir = ... link: 游戏中 game/ 目录的完整路径。该项是一个只读变量。但不能保证所有文件都保存在该卢姆，尤其是在安卓之类的平台上。

define config.gl_resize = True link: 决定是否允许用户调整OpenGL绘制窗口的大小。

define config.hard_rollback_limit = 100 link: Ren’Py允许用会回滚的最大步数。该项设置为0则完全不允许回滚。我们不推荐这样做，因为回滚是用户错误使用跳过功能后，回看之前文本的有效途径。

define config.help = None link: Help() 行为的默认值。

define config.help_screen = "help" link: 帮助界面名称，可以通过调用 Help() 行为函数或按键盘F1键呼出。

define config.hide = renpy.hide link: 当 hide语句执行时调用的函数。该项使用与renpy.hide一样的入参。

define config.imagemap_auto_function : Callable link

将界面语言中 imagebutton 或 imagemap auto 特性(property)扩展为可视组件。这个函数使用auto特性(property)值和使用的图像，以及下列状态之一：“insensitive”、“idle”、“hover”、“selected_idle”、“selected_hover”、“ground”。函数返回一个可视组件对象或None。

默认的使用方法是使用图像格式化 auto 特性，并检查得到的文件名是否存在。

define config.keep_side_render_order = True link: 若为True，Side位置的子串顺序将决定子组件的渲染顺序。

define config.implicit_with_none = True link: 若为True，也就是默认值，等效于每次通过对话、菜单输入和imagemap等互动行为之后都使用了 with None 语句。该项用于确保在转场之后旧的界面不再显示。

define config.interact_callbacks = [ ... ] link: 一个(不带入参的)回调函数列表，当互动行为开始或重新开始时调用列表中的函数。

define config.keep_running_transform = True link: 若为True，上一个图像使用的transform或ATL语句块(block)会沿用，前提是新图像使用相同的图像标签(tag)。若为False，transform会被停用。

define config.keymap = { ... } link: 这个配置项是一个字典，包含了键盘按键和鼠标按键跟每个操作之间的映射关系。详见定制按键映射章节内容。

define config.label_callbacks = [] link: 这是到达某个脚本标签(label)后会调用的函数列表。调用时使用两个参数。第一个参数是脚本标签(label)名。第二个参数在通过jump、call或创建新上下文(context)的情况下为True，其他情况下为False。

define config.label_overrides = { } link: 该项配置给出了在Ren’Py脚本中jump和call脚本标签(label)时，重定向到其他脚本标签(label)的方法。例如，如果你需要添加一个“start”到“mystart”的映射关系，所有jump和call到“start”标签最终都会转到“mystart”。

define config.layer_clipping = { ... } link

控制图层(layer)剪裁。这是一个从图层名称到(x, y, height, width)元组的映射关系，其中x和y的值是从图层左上角开始计算的坐标值，height和width是图层的高和宽。

如果某个图层没有在config.layer_clipping中提及，则该图层会使用其容器的完整尺寸，通常也就是整个界面。少数情况下其显示在一个可视组件 Layer 内。

define config.layeredimage_offer_screen = True link: 该项设置层叠式图像 offer_screen 特性的默认值。详见相关章节。

define config.layers = [ 'master', 'transient', 'screens', 'overlay', ... ] link

该配置项是一个所有Ren’Py已知图层(layer)的列表，按这些图层在界面的显示顺序排列。(列表中第一个元素就是最底部的图层。)Ren’Py内部会使用“master”、“transient”、“screens”和“overlay”图层(未来可能还有其他图层)，所以这些图层应该总是保存在这个列表中。

renpy.add_layer() 函数可以在不需要知道该配置项原始内容的情况下，新增图层到该列表。

define config.lint_hooks = [ ... ] link: 当lint工具运行时，不使用入参被调用的函数列表。这些函数用于检查脚本数据是否有错误，并在标准输出打印找到的错误(这种情况下使用Python的print语句就行)。

define config.load_before_transition = True link: 若为True，互动行为的启动会延迟到所用到的所有图像都加载完毕之后。(是的，这个名字很让人讨厌。)

define config.loadable_callback = None link: 若非None，该函数调用时带一个文件名。当文件可以加载时，函数返回True，否则返回False。这个函数可以跟 config.file_open_callback 或 config.missing_image_callback 协同生效。

define config.log = None link: 若非None，该项应该是一个文件名。通过 say 或 menu 语句展示给用户的文本都会记录在这个文件中。

define config.log_width = 78 link: 使用 config.log 时，每行日志的宽度。

define config.longpress_duration = 0.5 link: 在触控设备上，用户需要按住屏幕多少时间才会被认为是一次长按操作。

define config.longpress_radius = 15 link: 在触控设备上，用户长按需要维持的最小像素数量。

define config.longpress_vibrate = .1 link: 在触控设备上，用户长按操作后的震动时长。

define config.main_menu_stop_channels = [ "movie", "sound", "voice", ... ] link: 一个音频通道列表名，当进入或返回主菜单时将停止对应音频通道的声音。

define config.mipmap_dissolves = False link: Dissolve()，ImageDissolve()，AlphaDissolve() 和 AlphaMask() 的mipmap入参默认值。

define config.mipmap_movies = False link: Movie() 的mipmap入参默认值。

define config.mipmap_text = False link: Text() 的mipmap入参默认值, 包括在screen语句中使用的文本。

define config.missing_image_callback = None link

若非None，当加载图片失败时会调用这个函数。调用时会将文件名或缺失的图像传入该函数。函数可能会返回None，也可能返回一个图像控制器。如果返回的是图像控制器，可以使用图像控制器代替丢失的图片。

创作者可能需要同时配置 config.loadable_callback 的值，特别是使用 DynamicImage() 对象的情况。

define config.missing_label_callback = None link: 若非None，当Ren’Py尝试转到某个不存在的脚本标签(label)时，配置的函数会被调用。该函数会返回一个脚本标签名称，用以代替那个丢失的脚本标签。若Ren’Py抛出异常(exception)时则返回None。

define config.mouse_focus_clickthrough = False link: 若为True，鼠标点击使游戏窗口获取焦点，并正常处理点击事件。若为False，则鼠标点击事件将忽略。

define config.mouse_hide_time = 30 link

在配置的时间值内没有鼠标操作就隐藏鼠标指针，单位为秒。该项应该配置成比读取一个界面的期望时间长，这样鼠标用户就不会遇到鼠标消失的时间比鼠标显示时间更长的情况。

若为None，鼠标指针永远不会隐藏。

define config.movie_mixer = "music" link: 当某个 Movie() 对象自动定义的视频播放通道所使用的混合器(mixer)。

define config.new_translate_order = True link: 启用新的style和translate语句命令，详见 Ren’Py 6.99.11 。

define config.new_substitutions = True link: 若为True，Ren’Py会将应用新形式(圆括号)替换(substitution)所有显示的文本上。

define config.old_substitutions = True link: 若为True，Ren’Py会将应用旧形式(百分号)替换(substitution) say 和 menu 语句中显示的文本。

define config.open_file_encoding = False link

若非False，renpy.open_file() 的 encoding 参数为None时，则使用该配置项。该配置项主要用于Python 2游戏使用Python 3的 renpy.file() 函数可以默认以文本模式打开文件。

该配置项的默认值源自环境变量RENPY_OPEN_FILE_ENCODING。

define config.overlay_during_with = True link: 如果我们想要在 with 语句覆盖已显示图像就设置为True，如果我们想要在with语句中隐藏重叠部分就设置为False。

define config.overlay_layers = [ 'overlay', ... ] link: 该项是一个所有可覆盖图层(layer)的列表。可覆盖图层在overlay函数调用前会被清空。“overlay”图层应该总是放在这个列表中。

define config.pad_bindings = { ... } link: 等效于游戏手柄的 config.keymap。详见定制按键映射章节。

define config.pause_with_transition = False link: 若为False，pause 语句将必定调用 renpy.pause()。若为True，可以指定一个延迟时间，pause 5 语句等效于 with Pause(5)。

define config.pass_controller_events = False link: 若为True，类似pygame控制器的相关事件会发送到可视组件的事件处理器。反之，则由Ren’Py处理以上事件。

define config.pass_joystick_events = False link: 若为True，类似pygame手柄的相关事件会发送到可视组件的事件处理器。反之，则由Ren’Py处理以上事件。

define config.per_frame_screens = [ ... ] link: 该项是一个界面名字符串的列表，列表内的界面会在每一帧都更新，而不是每次互动后更新。Ren’Py内部使用这个列表。所以创作者需要在这个列表中添加界面名，而不是整个替换原列表。

define config.periodic_callbacks = [ ... ] link: 若非None，该项应该是一个函数列表。列表中的函数会以大约20Hz的频率被不断调用，不带任何入参。

define config.play_channel = "audio" link: 被 renpy.play() 、 hover_sound 和 activate_sound 使用的音频通道名称。

define config.predict_statements = 32 link: 这是一个语句的数量值，包括当前语句，会被检查是否执行图像预加载。从当前语句开始执行广度优先搜索，直到包含配置数量的语句。在这个范围内的语句引用的图像都会在后台预先加载。将该项设置为0会禁用图像预加载功能。

define config.profile = False link: 若设置为True，某些档案(profile)信息会输出到stdout标准输出。

define config.profile_init = 0.25 link: init 和 init python 语句块执行时间超过该配置项时，将会记录到日志文件中。

define config.quit_on_mobile_background = False link: 若为True，当移动app失去焦点时就会退出，而不是在后台保存自身状态。 (参考配置项 config.save_on_mobile_background，其控制具体表现。)

define config.rollback_enabled = True link: 设置是否允许用户在游戏中回滚(rollback)。若设置为False，用户不能主动回滚。

define config.rollback_length = 128 link

当回滚(rollback)日志中存在超过这个配置项数量的语句时，Ren’Py会修剪日志。这也包括脚本改变导致的读取存档时，Ren’Py会回滚的最大步数。

将该项设置得比默认值更低可能会导致Ren’Py运行不稳定。

define config.rollback_side_size = .2 link: 如果侧回滚被启用，则侧回滚的屏幕部分被单击或触摸时会导致回滚。

define config.say_allow_dismiss = None link: 若非None，这应是一个函数。当用户尝试dismiss某个 say 语句时，该函数会被调用，不使用任何入参。如果该函数返回True就允许dismiss，否则就忽略。

define config.say_layer = "screens" link: 显示say界面的图层(layer)。指定的图层名必须配置在 config.context_clear_layers 中。

define config.say_menu_text_filter = None link

若非None，这是一个函数，返回 say 和 menu 语句中的指定文本。这个函数用于返回新的(或者相同的)字符串替换原来的字符串。

列表中的函数在say和menu语句的早期就会执行，早于多语言(translation)和文本插值(substitution)。若需要一个运行时机更晚的过滤器(filter)，参见 config.replace_text。

define config.say_sustain_callbacks = [ ... ] link: 不使用入参调用的函数列表，在某行带pause分句的对话中，第二次或之后其他互动行为时被调用。该函数用于在暂停状态保持语音播放。

define config.save = True link: 若为True，Ren’Py才允许玩家存档。若为False，Ren’Py则不允许玩家存档，甚至不会显示任何存档。

define config.save_dump = False link: 如果设置为True，存档时Ren’Py会创建文件save_dump.txt。生成的文件包含所有存档文件中的对象。每一行包含相关的占用空间估测，对象路径，某个对象是否别名的信息，以及对象的行为表现。

define config.save_on_mobile_background = True link: 若为True，移动app会在失去焦点时保存自身状态。保存状态的方式需要在app重新启动后能自动读档(并回复进度)。

define config.save_persistent = True link: 若为True，Ren’Py会保存持久化数据。若为False，持久化数据不会保存在存档中，游戏结束后持久化数据任何改变都将丢失。

define config.save_physical_size = True link: 若为True，窗口的物理尺寸会保存在环境设定(preference)中，并在游戏挂起时保存。

define config.savedir = ... link: 存档目录的完整路径。这只应该在 python early 语句块中配置。如果不在 python early 语句块中设置，则可以通过配置项 config.save_directory 生成初始值。

define config.scene = renpy.scene link: 在 scene 语句中用于代替 renpy.scene() 的函数。需要注意，这个函数用于清空界面，config.show 用于显示某个新图像。这个函数具有与 renpy.scene() 相同的签名(signature)。

define config.screenshot_callback : Callable link: 发生截屏时调用的函数。调用该函数时带一个参数，即截屏保存的完整文件名。

define config.screenshot_crop = None link: 若非None，该项应是一个(x, y, height, width)元组。截屏会在保存前剪裁为元组描述的矩形。

define config.screenshot_pattern = "screenshot%04d.png" link

用作创建截屏文件的正则表达式。这个(使用Python的格式规则)表达式应用自然数列生成一个文件名序列。生成的文件名是绝对路径，或与config.renpy_base关联。首个当前不存在的文件名会用作截屏的文件名。

如果表达式中的目录不存在，则会自动创建目录。详见 _screenshot_pattern 。

define config.script_version = None link

若非None，这被解释为脚本的版本号。库(library)会根据脚本版本号启用适合的特性(feature)。若为None，我们假设脚本版本为最新。

通常该项是项目构建时由Ren’Py启动器(launcher)自动添加在某个文件中。

define config.searchpath = [ 'common', 'game', ... ] link: 一个目录列表，用于在这些目录下搜索图片、音乐、归档及其他媒体文件，但不包括脚本文件。该项会初始化为包含“common”和游戏目录的一个列表。

define config.search_prefixes = [ "", "images/", ... ] link: 搜索的文件名前添加的前缀列表。

define config.show = renpy.show link: 在 show 和 scene 语句中中用于代替 renpy.show() 的函数。这个函数具有与 renpy.show() 相同的签名(signature)，并会将未知的关键字参数不做修改直接传入。

define config.skip_delay = 75 link: 当使用ctrl键跳过语句时，每段对话显示的时间，单位为毫秒。(实际上只是接近配置的值。)

define config.skip_indicator = True link: 若为True，当使用脚本跳过功能时，库(library)会显示一个跳过提醒标志。

define config.sound = True link: 若为True，使用声音。若为False，声音/混合器子系统完全禁用。

define config.sound_sample_rate = 48000 link: 声卡运行的采样率。如果你的所有wav文件都使用更低的采样率，修改该项配置可能会改善播放效果。

define config.start_callbacks = [ ... ] link

一个回调函数列表，列表内函数的调用时机在初始化环节之后，但在游戏开始之前，调用时不带参数。这主要通过framework用于初始化需要保存的变量。

这个配置项的默认值包含了Ren’Py内部使用的回调函数，以支持nvl模式特性等。新的回调函数可以添加到这个列表，但已存在的回调函数不能删除。

define config.start_interact_callbacks = ... link: 一个函数列表，当某个互动行为开始后(不带入参)被调用。某个互动行为重新开始的情况下，这些回调函数不会被调用。

define config.quit_callbacks = [ ... ] link: 一个函数列表，在Ren’Py进程终止时将(无参)调用。用于释放资源，例如打开的文件或启动的线程。

define config.sticky_layers = [ "master", ... ] link: 该项是一个图层名称的列表。当指定标签的图像显示在这些图层上时，可以暂时顶替 config.tag_layer 项，作为图像标签的显示入口。

define config.top_layers = [ "top", ... ] link: 一个图层(layer)名的列表，该列表中的图层会显示在其他所有图层上面，并且不接受应用于所有图层上的转场(transition)。如果某个图层在该列表中，它就不能再存在于列表 config.layers` 和 config.bottom_layers 中。

define config.transient_layers = [ 'transient', ... ] link: 该项变量是一个所有临时(transient)图层的列表。临时图层会在每次互动行为后被清空。“transient”应该总是保留在这个列表中。

define config.transform_uses_child_position = True link: 若为True，transform会从他们的子类继承 position properties 。若不是True，就不继承。

define config.transition_screens = True link: 若为True，界面会接受转场(transition)效果，使用溶解(dissolve)从旧的界面状态转为新的界面状态。若为False，只有界面的最新状态会被显示。

define config.translate_clean_stores = [ "gui", ... ] link: 一个命名存储区的列表。当使用的语言改变时，列表内存储区的状态会清除并恢复为初始化阶段的值。

define config.variants = [ ... ] link: 一个变换界面列表，用于搜索并选取向用户显示的界面。列表最后的元素总是None，确保能选到默认界面。详见界面变种。

define config.voice_filename_format = "{filename}" link: 该项配置的字符串会自动用voice语句的入参字符串替换“filename”，并作为向用户播放的语音文件名使用。例如，如果这里配置的是“{filename}.ogg”，那么 voice "test" 语句就会播放 test.ogg 文件。

define config.web_video_base = "./game" link

在Web浏览器中播放影片时，该项是一个URL链接，与影片文件名相连后得到完整的视频播放链接地址。可以包括子目录，比如 “https://share.renpy.org/movies-for-mygame/” 。

这样做可以让文件比较大的视频文件与游戏其他内容放在不同的服务器上。

define config.web_video_prompt = _("Touch to play the video.") link: iOS系统手机版Safari上运行时，用户需要点击后才能播放带音频的影片。该配置项是提示用户点击的消息。

define config.with_callback = None link: 若非None，该项应该是一个函数，会在使用 with语句时被调用。这个函数可以在转场(transition)过程中对添加在界面上的临时元素做出响应。转场(transition)过程中，调用该函数时使用两个入参：当前正使用的转场，以及后续要使用的转场。第二个入参通常为None，除了在with语句中显式声明。该函数会返回一个转场(transition)，可能就是作为入参的那个转场，也可能不是。