Ren'Py对话框自定义完全指南：动态排版+响应式设计+2026避坑技巧

1
# 方式1：通过Text参数
2
screen test_screen():
3
    text "这是特殊字体的文本":
4
        font SPECIAL_FONT
5
        size 32
6
        color "#ffffff"
7

8
# 方式2：通过style
9
style special_text:
10
    font SPECIAL_FONT
11
    size 28
12
    color "#FF6B6B"
13
    text_align 0.5
14

15
# 在对话框中使用特殊字体
16
init python:
17
    style.say_dialogue.font = MAIN_FONT
18
    style.say_label.font = SPECIAL_FONT

1
# 定义语言选择器
2
default persistent.language = "zh_cn"
3

4
# 字体映射配置
5
init python:
6
    FONT_MAP = {
7
        "zh_cn": ("fonts/source_han_sans.ttf", 22),
8
        "zh_tw": ("fonts/source_han_sans_tc.ttf", 22),
9
        "ja": ("fonts/NotoSansJP-Regular.otf", 20),
10
        "ko": ("fonts/NotoSansKR-Regular.otf", 22),
11
        "en": ("fonts/Roboto-Regular.ttf", 20),
12
    }
13

14
    def apply_language_font():
15
        font_path, font_size = FONT_MAP.get(persistent.language, FONT_MAP["en"])
16
        style.say_dialogue.font = font_path
17
        style.say_dialogue.size = font_size
18
        style.default.font = font_path
19
        style.default.size = font_size
20

21
# 在语言切换时调用
22
label start:
23
    $ apply_language_font()
24
    "当前语言已切换为中文（简体）"

1
init python:
2
    # 定义打字机音效
3
    type_sound = "audio/type_sound.wav"
4

5
    # 自定义打字机效果回调
6
    def type_sound_callback(event, **kwargs):
7
        if event == "show":
8
            renpy.sound.play(type_sound, channel="sound")
9

10
    # 注册回调
11
    config.voice_callback = type_sound_callback
12

13
# 针对不同角色的差异化打字机效果
14
init python:
15
    def create_character(name, cps=25, sound=""):
16
        char = Character(name, what_slow_cps=cps)
17

18
        if sound:
19
            # 为角色定制音效
20
            def char_sound_callback(event, **kwargs):
21
                if event == "show":
22
                    renpy.sound.play(sound, channel="sound", loop=False)
23

24
            return char
25
        return char
26

27
define protagonist = create_character("主角", cps=30, sound="audio/protagonist_type.wav")
28
def create_npc_character(name, sound_file="audio/npc_type.wav"):
29
    char = Character(name, what_slow_cps=20)
30
    char_voice_callback = lambda event: None
31

32
    def type_callback(event, **kwargs):
33
        if event == "show":
34
            renpy.sound.play(sound_file)
35

36
    char.voice_callback = type_callback
37
    return char

1
# 使用 {w=秒数} 控制暂停
2
e "这句话会显示...{w=0.5}暂停0.5秒...{w=1.0}然后继续"
3

4
# 使用 {nw} 实现无打字机效果的句子
5
e "这句话瞬间显示{nw}"
6

7
# 使用 {fast} 加速当前句子
8
label test:
9
    e "这是一句很长的文本..."
10
    show screen speed_button
11
    e "下一句..."
12

13
screen speed_button():
14
    textbutton "加速" action SetVariable("config.text_cps", 60) xalign 0.9 yalign 0.1
15

16
# 逐字控制样式
17
e "普通的文本 {b}加粗文本{/b} {i}斜体文本{/i} {size=36}大字文本{/size}"

1
# 为不同角色定制打字机效果
2
init python:
3
    class TypedCharacter(Character):
4
        def __init__(self, name, cps=25, sound=None, **kwargs):
5
            super(TypedCharacter, self).__init__(name, **kwargs)
6
            self.custom_cps = cps
7
            self.custom_sound = sound
8

9
            if sound:
10
                self.voice_callback = lambda event: (
11
                    renpy.sound.play(sound) if event == "show" else None
12
                )
13

14
define alice = TypedCharacter("爱丽丝", cps=35, sound="audio/alice_type.wav", color="#FF69B4")
15
define bob = TypedCharacter("鲍勃", cps=20, sound="audio/bob_type.wav", color="#4169E1")
16

17
# 在剧情中使用
18
label scene1:
19
    alice "我是爱丽丝，说话比较快~"
20
    bob "我是鲍勃，说话...比较...慢..."

1
# 修改对话框基础样式
2
init python:
3
    # 对话框窗口样式
4
    style.window.background = Frame("ui/dialogue_box.png", 10, 10)
5
    style.window.xalign = 0.5
6
    style.window.yalign = 0.85
7
    style.window.xminimum = 800
8
    style.window.xmaximum = 1200
9

10
    # 对话框内边距
11
    style.window.left_padding = 30
12
    style.window.right_padding = 30
13
    style.window.top_padding = 25
14
    style.window.bottom_padding = 25
15

16
    # 对话框文本样式
17
    style.say_dialogue.size = 24
18
    style.say_dialogue.color = "#ffffff"
19
    style.say_dialogue.line_height = 1.4
20
    style.say_dialogue.outlines = [(2, "#000000", 0, 0)]  # 文字描边
21

22
    # 角色名标签样式
23
    style.say_label.size = 26
24
    style.say_label.color = "#FFD700"
25
    style.say_label.outlines = [(2, "#000000", 0, 0)]
26
    style.say_label.xpos = 10
27
    style.say_label.ypos = 10

1
# 检测屏幕尺寸并调整对话框
2
init python:
3
    def update_dialogue_layout():
4
        screen_width = config.screen_width
5
        screen_height = config.screen_height
6

7
        if screen_width >= 1920:  # 大屏
8
            style.window.xmaximum = 1400
9
            style.say_dialogue.size = 28
10
        elif screen_width >= 1280:  # 标准屏
11
            style.window.xmaximum = 1000
12
            style.say_dialogue.size = 24
13
        else:  # 小屏
14
            style.window.xmaximum = 800
15
            style.say_dialogue.size = 20
16

17
    # 在游戏启动时调用
18
    config.start_callbacks.append(update_dialogue_layout)
19

20
# 动态调整对话框位置
21
screen dynamic_dialogue():
22
    frame:
23
        style "say_window"
24
        # 根据文本长度自动调整位置
25
        xalign 0.5
26
        yalign 0.85 if len(what_text) < 100 else 0.75
27

28
        vbox:
29
            spacing 10
30
            text who_id style "say_label"
31
            text what_text style "say_dialogue"

1
init python:
2
    # 存储角色位置信息
3
    character_positions = {}
4

5
    def update_dialogue_position(speaker):
6
        pos = character_positions.get(speaker, "center")
7

8
        if pos == "left":
9
            style.window.xalign = 0.3
10
        elif pos == "right":
11
            style.window.xalign = 0.7
12
        else:
13
            style.window.xalign = 0.5
14

15
# 在角色定义时关联位置
16
define alice_left = Character("爱丽丝", callback=lambda **kwargs: (
17
    character_positions.__setitem__("爱丽丝", "left")
18
))
19
define bob_right = Character("鲍勃", callback=lambda **kwargs: (
20
    character_positions.__setitem__("鲍勃", "right")
21
))
22

23
# 剧情中使用
24
label dynamic_test:
25
    show alice at left
26
    show bob at right
27

28
    alice_left "我在左边，对话框也会偏左"
29
    bob_right "我在右边，对话框也会偏右"