Персонажи

Эта статья о создании новых персонажей; о ванильных персонажах см. страницу ресурсов игры.

Ранее мы уже разобрали, как выводить реплики персонажей, теперь давайте разберём, как создавать своих персонажей, чтобы говорить от их лица.

#Создание своих персонажей

Чтобы создать своего персонажа, достаточно объявить новую переменную и вызывать её в повествовании. Для создания персонажа используется функция¹ Character.
Синтаксис:

1
2init: # При инициализации...
    $ <Название переменной> = Character("<Имя персонажа>", kind=<Родительский персонаж>, <Прочие аргументы>)

1
2
3    # В повествовании...
    <Название переменной> "<Реплика персонажа>"
    # ...

Если у персонажа есть свой родитель², то он будет наследовать его свойства. Чаще всего это называется наследованием.
Пример:

1
2init:
    $ test_char = Character("Пример", kind=sl)

Персонаж в примере позаимствует от sl (Слави) цвет имени и стиль текста реплики³, но имя у него будет новое — "Пример".

#Персонаж-шаблон

Используя наследование, можно создать шаблон персонажа, который можно будет использовать для создания других персонажей со свойствами одного общего родителя.
Пример:

1
2
3
4init:
    $ template = Character(None, what_color="#F00", what_underline=True, what_bold=True) # Родительский персонаж
    $ test_char = Character("Пример", kind=template) # Дочерние персонажи
    $ test_char_2 = Character("Пример 2", kind=template)

Реплики персонажей test_char и test_char_2 в примере будут красными, подчёркнутыми и полужирными, несмотря на то, что имеют разные имена.

#NVL-персонаж

Наследуйте вашего персонажа от nvl, если хотите, чтобы он использовал экран NVL для вывода реплик. При этом если наследоваться от любого ванильного персонажа (лучше всего от narrator), то менять режим повествования можно так же, как и для ванильных персонажей, с помощью $ set_mode_nvl().

1
2init:
    $ test_char = Character("Пример", kind=narrator)

1
2
3
4
5    # ...
    test_char "Здесь будет обычная реплика."
    $ set_mode_nvl()
    test_char "А здесь - реплика в NVL-режиме."
    # ...

#Свойства персонажа

#Префиксы и постфиксы имени и реплик

Аргументы who_prefix, who_suffix, what_prefix и what_suffix позволяют добавлять текст в начале и конце имени и реплик персонажа.
Пример:

1
2init:
    $ test_char = Character("Пример", who_prefix="1", who_suffix="2", what_prefix="3", what_suffix="4")

Персонаж в примере будет иметь цифру "1" перед именем, "2" после имени, "3" перед репликами и "4" после реплик.

1
2label test_label:
    test_char "Привет!" #1Пример2 "3Привет!4"

#Свойства стиля

Прочие аргументы функции Character, начинающиеся с who_, what_ и window_, очищаются от префикса и используются для применения свойств стиля к тексту имени, тексту реплик и окну соответственно.
Пример:

1
2init:
    $ test_char = Character("Пример", who_color="#F00", what_underline=True)

Персонаж в примере будет иметь полностью красный цвет имени, а текст реплик будет подчёркнут.

Таким же образом к тексту имени, тексту реплик или окну можно применить целые стили.
Пример:

1
2init:
    $ test_char = Character("Пример", who_style="my_style")

#Создание прокси-функций

Так же, как и персонажей, можно использовать простые функции, которые уже будут обращаться к другим персонажам. Такая функция принимает аргументы в виде самой реплики (what) и прочих именованных аргументов (kwargs).
Пример:

1
2
3
4
5
6init python:
    def test_func_char(what, **kwargs):
        if len(what) % 2 == 0: # Если в реплике чётное число символов...
            narrator(what, **kwargs) # Говорит "narrator" - рассказчик
        else: # Если нет...
            th(what, **kwargs) # Говорит "th" - мысли ГГ

1
2
3
4    # ...
    test_func_char "Чётное" # Скажет рассказчик
    test_func_char "Нечётное" # Скажут мысли ГГ
    # ...             ↑ Пробел считается за символ

Сам по себе персонаж — это объект, метод __call__ которого принимает аргументы в виде реплики и прочих именованных аргументов. Зная это, можно найти огромный простор для экспериментов с контролем над выводом реплик.

#Больше информации

Получить больше информации о повествовании вы можете на странице официальной документации Ren'Py.