Как написать мод на бесконечное лето

Как вы поняли, если значение переменной Да или Нет, то пишем True, если Да, и False, если Нет.

То есть у вас получится что-то такое:

Переменные очень полезные. Они могут обозначить наличие какого-то условия при событии, и количество “очков отношений“, на которых и строится всё Бесконечное Лето, да и другие Визуальные Новеллы.

Сейчас мы прописали изначальные значения переменных. Без них, переменные не смогут измениться, что вполне логично. Ведь изменяться будет нечему, дошло?)

О том, как же их изменять, и как они могут влиять на историю, поговорим ниже.

Глава 2: label — Как начать писать

Наконец мы дошли до самого важного, и основного в деле создания мода — писанины!

Помните, мы создали второй файлик, который называется так же как и ваш мод?
Открывайте его. Первые две строки копируйте из materials. Те, что с init.
Через строку, без четырёх пробелов или одного Tab, пишем:

label название_лейбла:

Название этого лейбла должно совпадать с тем, что вы писали под init.
Я же для наглядности написал test_mod_start, а не test_mod, как писал под init.

Основа БЛ это текст автора и чья-то речь, верно? Смотрим как их писать.

Весь текст пишется с 4-мя пробелами в начале, и под label. Не забываем об этом.

Чтобы написать текст автора, то есть просто текст, пишем кавычки, и в них текст:

Чтобы писать текст мыслей (с тильдами по бокам текста), перед кавычками добавляем инициалы th:

Именно эти инициалы мы прописывали для своих персонажей, и именно они используются для речи всех персонажей.

Чтобы написать речь кого-то, пишем его инициалы спереди кавычек, так же как и с мыслями:

тэг_персонажа “текст_кого_то“

У вас должно получится примерно вот так:

Большая часть оригинальных инициал персонажей из БЛ расписаны на этой знаменитой картинке:

Помимо этих, ещё имеются инициалы, собственно Семёна, и большинства героев, с условием неизвестности:
me — Семён
mep — Парень
unp — Пионерка (Лена)
dvp — Пионерка (Алиса)
usp — Пионерка (Ульяна)
slp — Пионерка (Славя)
mip — Пионерка (Мику)
uvp — Странная девочка (Юля)
elp — Пионер (Электроник)
shp — Пионер (Шурик)
mzp — Пионерка (Женя)
mtp — Вожатая (Ольга Дмитревна)
csp — Медсестра (Виола)

Визуальная составляющая

Сейчас ваш мод — просто резко появляющийся текст на чёрном экране с зимним интерфейсом.
Мы разобрались с речевой частью, пора разобраться и с визуальной! Затем займёмся и украшением текста.

Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

• В игре существует 4 вида интерфейса — зимний, дневной, вечерний, ночной.
  Последние три — летние. Думаю для чего они нужны и так понятно.
  Вы же не хотите показывать, как ГГ загорает на пляже с зимним интерфейсом?

Чтобы изменить интерфейс, в тексте пишем одну из этих команд:

$ prolog_time()
Для зимнего.

Интерфейс можно плавно скрыть или показать. Чтобы это сделать, пишем в тексте:
window hide
Чтобы скрыть.

Ещё движок может показывать текст поверх экрана, а не внизу. Этот режим называется — NVL, в то время как привычный нам — ADV. Команды связанные с этим:
$ set_mode_nvl()
Чтобы показать поверх экрана.

Если вы хотите использовать речь в этом режиме, то вам будет необходимо создать нового персонажа, и в его код (в скобки) добавить kind=nvl. И имена таких персонажей рекомендуется писать навроде этого:

Не забывая про пробел после двоеточия.

Пример полного кода:

Дабы не смотреть на текст на чёрном фоне, рассказывая о красоте пляжа, стоит добавить фон. Этим мы сейчас и займёмся.

Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

Чтобы на нашем экране появился фон или любая другая картинка, нам нужно прописать одну из этих команд:

scene название_сцены
Для показа сцены. То есть — фона. При переходе со сцены на сцену все спрайты остаются на предыдущей.

• hide название_картинки_или_фона
  Чтобы скрыть картинку или фон. А вы что ожидали?

Но опять же, всё происходит слишком резко. Так не пойдёт!
Где взять все коды BG и CG смотрите в разделе Все необходимые коды.
===========================================================================

Чтобы добавить эффект к появлению или исчезанию изображения добавляем в конец команды, после названия изображения, команду — with:

• show название_картинки with dissolve
  Чтобы картинка появилась плавно. Растворение средней скорости.

Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

Помимо dissolve движок имеет множество других эффектов:

• dspr — самое быстрое растворение, эффективно при смене эмоций на спрайтах.
• dissolve2 — растворение, дольше dissolve.
• dissolve_fast — растворение, быстрее dissolve, но медленней dspr.
• hell_dissolve — очень долгое растворение, 50 секунд.
• dissolve_long — невероятно долгое растворение, 100 секунд.
• flash — белая вспышка.
• flash_red — красная (кровавая) вспышка.
• fade — затемнение.
  Как аналог, можно использовать схему:

  punch работает и с текстом. Чтобы текст появился с тряской, пишите так:

  Показ спрайтов

  Теперь мы видим площадь. Но мы не видим Алису! Покажем же её.

  Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

  Дабы показать Алису, нужно вывести на экран её спрайт.
  У каждого спрайта в названии есть инициалы владельца и эмоция. Есть ещё одежда и дальность, но для пользовательских спрайтов, порой хватает и первых двух. Так что спрайты вызываются также как и картинки с фонами, но в отличие от них, у спрайтов не слитное название параметров. То есть, не — show тэг_персонажа эмоция_и_другие_значения, а — show тэг_персонажа эмоция другие_значения.
  Поэтому показываем спрайт примерно так:

  Чтобы показать спрайт на определённой позиции, у нас есть команда — at. Она пишется перед with. Выходит это:

  show тэг_персонажа эмоция другие_значения at сторона_экрана with эффект

  Вот возможные стороны:

  • fleft — дальнее лево.
  • left — лево.
  • cleft — ближнее лево.
  • center — центр. Используется только при перемещении спрайта с другой позиции в центр.
  • cright — ближнее право.
  • right — право.
  • fright — дальнее право.

  Получается, что мы вызываем второй, или любой другой по численности, спрайт подобной командой:

  А если же мы хотим показать их одновременно, и при этом плавно, то делаем такой же фокус, который использовали с эффектом punch:

  Однажды, в какую-нибудь тёмную ночь, вы заметите, что ваши спрайты слишком яркие. В этом случае вам поможет команды:

  • $ persistent.sprite_time = ‘day‘ — для дневного освещения. Освещение по умолчанию.
  • $ persistent.sprite_time = ‘sunset‘ — для вечернего освещения.
  • $ persistent.sprite_time = ‘night‘ — для ночного освещения.

  На первый взгляд, изменится не очень многое, но, поверьте, это очень полезная функция. Если вы прописали свои спрайты по специальному коду, то они тоже будут менять своё освещение, как и стандартные.

  Где достать коды всех спрайтов смотрите в разделе Все необходимые коды.

  linear, pos — Фокус с перемещением

  Когда-нибудь вы можете захотеть плавно переместить спрайт, или любую другую картинку, на другой край экрана. Для этого есть команда — linear.

  4 пробела помним?

  Чтобы переместить изображение по горизонтали пишем такую схемку:

  Первая строчка нам знакома, а вот вторая нет.
  Обратите внимание, что вторая строка пишется после двоеточия, и на 4 пробела дальше.

  linear означает перемещение картинки, после чего пишется время в секундах, за которое она должна переместиться.
  xalign и yalign определяют куда будет перемещаться изображение, по Y или по X. Y для вертикали, X для горизонтали.
  Затем пишется сами координаты в формате 0.0 — 1.0, где 0.0 левый край экрана, а 1.0 правый. Писать обязательно с десятыми.

  Примечание: по неизвестным для меня причинам, перемещение по Y в Бесконечном Лете не работает, в отличие от других игр на движке Ren’Py. Вероятно тут виновата ошибка разработчиков, которые писали код игры. Но этого, как говорится, мы никогда не узнаем.

  Для примера, перед тем как перемещать спрайт, нам нужно его плавно показать, иначе он появится в движении:

  Из этого кода мы видим, что по центру экрана появится весёлая Алиса, а затем переместится к левому краю экрана.

  Если писать координаты больше 1.0 или меньше 0.0 (например: -0.5), то изображение уйдёт за экран. Это можно использовать.
  ——————————————————————————————————-
  Если вы захотели поставить картинку в какое-то определённое место, вам поможет команда — pos:

  Координаты расчитываются по пикселям стандартного разрешения экрана, а это — 1920×1080. Однако расчёт идёт не с привычного левого верхнего угла, а с левого нижнего. То есть левый верхний угол будет равен — 0, 1080.

  Аудио

  Казалось бы — у нас всё есть: фон, текст, спрайты. Но зайдя в мод, мы тут же заметим…
  Что здесь гробовая тишина! Исправим это недоразумение!

  Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

  Как вы могли понять ранее, из курса по материалам, у нас есть три вида аудио — звуки, музыка и эмбиент. Чтобы их включить, у нас есть команда — play, и четыре дорожки воспроизведения:

  • play musicназвание_музыки — для музыки.
  • play soundназвание_звука — для звука. Воспроизводится лишь раз.
  • play sound_loopназвание_непрекращающегося_звука — для непрекращающегося звука. Работает как дорожки music или ambience.
  • play ambienceназвание_эмбиента — для эмбиента. Это звуки на заднем фоне — птицы, шум волн…

  В БЛ музыка имеет весьма странную форму записи — music_list[“название_музыки”]. Из-за чего можно запутаться, и подумать, что music писать уже не надо. Но это не так. Код воспроизведения оригинальной музыки должен быть примерно такой:

  Так как music это ID дорожки аудио, а music_list[“”] — это часть названия. Для своей музыки вы можете писать как адекватные люди, без этой тавтологии.
  ——————————————————————————————————-
  Кроме того, что мы изучили выше, мы можем поставить аудио в очередь, командой — queue. Оно будет писатся вместо play:

  • queue sound название_звука
  • queue sound название_следующего_звука

  Работает только в пределах одной дорожки. То есть у каждой дорожки своя очередь.
  Таким образом, у нас проиграет звук, а затем тут же пойдёт другой. Без необходимости высчитывать, сколько ему необходимо времени, и ставить на это время паузы.
  Кстати, я не уверен что есть смысл в этой команде в любых других дорожках, кроме sound. Ведь там аудио проигрывается бесконечно. Как и лето.
  ——————————————————————————————————-
  Когда же мы достаточно наслушаемся, останавливаем аудио командой — stop, с соответствующим ID дорожки:

  • stop music
  • stop sound
  • stop sound_loop
  • stop ambience
  • play music название_музыкиfadein сколько_секунд
  • stop ambience fadeout сколько_секунд

  fadein для плавного появления, а fadeout для исчезания. После них пишется сколько будет длиться эффект в секундах. Например:

  Где найти все коды музыки, звуков и эмбиентов смотрите в разделе Все необходимые коды.

  Пауза

  Всем рано или поздно нужно сделать паузу. И мы не исключение. Думаю не стоит пускаться в объяснения по поводу паузы. Надеюсь все и так понимают зачем она нужна.

  Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

  Чтобы сделать паузу используем одну из команд:

  pause сколько_секунд — простая пауза.
  Можно пропустить, нажав на Enter/Пробел/ЛКМ/Ctrl. Допустимо писать секунды в скобках. Но если подумать… Зачем заморачиваться?

  Секунды можно писать в десятых, то есть так: 0.2, 1.6, 32.4…

  Примечание: если поставить паузу без секунд, не важно простую или сложную — игра остановится и продолжить можно будет, только нажав на Enter/Пробел/ЛКМ/Ctrl.
  Так что не рекомендуется этого делать. А то у читателей может возникнуть затык, и они подумают, что игра зависла.

  Паузы рекомендуется ставить только со скрытым интерфейсом.
  Знаете, пять секунд смотреть на пустую строку текста не очень-то интересно!

  Паузы — это очень важная часть визуальной новеллы. Не забывайте о них. Но и не делайте слишком много, и слишком долгие. Читатели не привыкли ждать!

  Форматирование текста

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

  Не забываем про 4 пробела, они пишутся всегда. Исключения только init и label.

  Сами коды в игре не видны, виден только эффект:

  • — “какой_то_текст” — для курсива.
  • — “какой_то_текст” — для жирноты.
  • — “ какой_то_текст ” — для зачёркивания.
  • — “какой_то_текст. другой_текст” — для паузы в отображении текста. Отображение сначала остановится, на том месте где стоит команда, а после нажатия на Enter/Пробел/ЛКМ/Ctrl продолжится, и закончится там, где либо стоит ещё одна пауза, либо где конец кавычек.
  • n —”какой_то_текст. nдругой_текст” — для переноса остальной части текста на строку ниже.
  • “ — “какой_то_текст_“что_то_в_кавычках“_продолжение_текста” — для того чтобы была возможность поставить кавычки внутри текста.

  Уделите особое внимание пробелу, он нужен лишь один, так как команды исчезают из отображаемого текста.

  Другие полезности

  Вы хотите моргнуть? А может ваши глаза устали от всего этого, и вы хотите их закрыть?
  Это можно устроить.
  Пишем так:

  show blinking
  Чтобы моргнуть.

  Для лучшего эффекта отделяем паузами, примерно так:

  Вы хотите нам показать какой-то крутой видос? Без проблем!
  Чтобы сделать это пишем прямо в блоке label:

  • $ renpy.movie_cutscene (“путь_к_видео”)

  Полная команда будет примерно такая:

  За вами погоня? Или может это вы за кем-то бежите?
  Чтобы все поняли что вы бежите, вам поможет данная комбинация:

  Как вы поняли — это показ фона с эффектом. Так что, чтобы выключить бег просто снова включите этот же фон, ну или другой, без этого эффекта.

  Проверяем, что получилось

  Мы уже сделали достаточно, чтобы было на что посмотреть. Думаю каждому захочется проверить, что же он там наделал.

  Для этого запускаем игру > переходим в настройки (инструменты) > моды и пользовательские сценарии > и в данном списке выбираете ваш мод.

  Если вы сделали всё как надо, он там появится.

  А также, после того как вы запустите впервые ваш мод, в папке мода появится копии ваших .rpy файлов, но с расширением .rpyc. Это закодированные файлы текста, и именно их использует игра. Так что если удалить файлы .rpy, игра спокойно загрузит ваш мод.

  Глава 3: menu — Сложности выбора

  По сути, сейчас вы уже научились всему, что может понадобится при создании мода. Но только в случае, если там не будет выборов и если там всего одна концовка. Если же вы решите, что кинетическая новелла — это не про Вас, то смотрите самый сложный раздел руководства — выборы и их последствия.
  ===========================================================================

  Чтобы предоставить читателю выбор, пишем такую систему команд:

  Команда menu: вызывает меню выбора. Перед ним, желательно скрыть интерфейс.
  Затем, на следующей строке мы делаем 8 пробелов, так как формируется блок в блоке. Чем больше блоков, тем больше пробелов. Их количество всегда увеличивается на 4.
  После этих 8-ми пробелов в кавычках пишется выбор так, как он будет отображаться в игре, и двоеточие, означающее формирование ещё одного блока.
  Ниже, после 12-и пробелов будут последствия выбора. Это не обязательно должен быть текст, однако там должна быть хотя бы одна команда, иначе движок будет жаловаться, что блок пустой и не запустит нам игру.

  Выбор не обязательно должен быть из двух или более вариантов, их количество не ограничено. Ведь выбор из одного варианта — тоже выбор.

  Чтобы закончить последствия выбора, просто пишем дальше с 4-мя пробелами, как и раньше.

  Если хотите сделать выбор без исчезания текста, то есть, чтобы он отображался внизу, как и до выбора, то пишите так:

  А если вы в режиме NVL (тескст поверх экрана), и хотите чтобы выбор был там, перед выбором пишите команду define menu = nvl_menu, как на примере ниже:

  if, else — Снова переменные

  При условии, что вы прописали изначальные значения переменных ранее, их значение можно будет изменить в процессе игры. Конечно же для этого пригодятся выборы, иначе — какой смысл их писать вообще?

  Я надеюсь вы не забыли про 4 пробела?)

  Чтобы изменить значение переменной с True на False или наоборот, а также чтобы изменить числительное значение на конкретно другую цифру пишем так:

  • $ название_переменной = значение
    У вас зоркий глаз, если Вы заметили, что это точно такой же код, который мы писали в materials. Различие лишь в том, что прописывать переменные изначально нужно в блоке init, а изменять значение в label. Иначе не работает, естественно.

  А вот если вам приспичит прибавить или отбавить какое-то число к/у текущему/его количеству/а, пишем более интересные команды:

  $ название_переменной+=сколько_добавить
  Чтобы добавить сколько-то очков к значению.

  Логично, что изменять переменные нужно в зависимости от выбора читателя. Так что пишем эти команды в блоке последствий выбора.
  ===========================================================================

  Когда пришло время проверить сколько очков отношений у читателя с персонажем NN, или съел ли он всё таки свой суп, пишем проверку переменных.

  Проверки бывают трёх видов — равно, больше, меньше. С True или False больше и меньше не работает. Как ни жаль.

  Для проверки используется команда — if, за ним пишется название переменной, дальше в качестве обозначения равенства пишется двойное равно — ==, а для обозначения больше или меньше используются соответствующие знаки — >, <.

  Затем после двоеточия идут последствия, как и после выбора.
  Последствия последствий выбора…

  if название_переменной==значение:
  Если значение должно быть равнотакому-то.

  Всё естественно в системе блоков:

  В данном примере некая Она, при достаточных очках любви, одаривает главного героя улыбкой, однако это никак не влияет на его последующий выбор.
  Соответственно, если очков любви недостаточно, то Она даже не посмотрит на нашего героя, но выбор появится, и в итоге это никак не помешает ему потанцевать с Ней.
  Без else или jump большего не сделать.
  ——————————————————————————————————-

  В случае когда нам нужно сделать, по типу — “либо так, либо иначе“, используем команду — else. Ведь, если мы не будем использовать эту команду, история продолжится так, как будто ничего не произошло. Как альтернативу, можно использовать jump, но об этом позже.
  else пишется на том же уровне что и if, то есть либо на 4-х пробелах, либо на 8-и и выше.

  Думаю хватит и примера, чтобы вы поняли зачем нужна эта команда:

  Тут показаны только текст и проверка переменных, но для понятия сути, думаю вам хватит. =)

  (Пример придуман моей бурной фантазией по ходу написания раздела. Ни в одном из моих, или мне известных, модах такой сцены нет. Так что вам ничего не мешает использовать её, вероятно отредактированную, в своём моде. Или же сделать что-то по такой же схеме)
  ——————————————————————————————————-

  Ходят слухи, мол, ещё есть какой-то — elif, который может использоваться между if и else, однако у меня ничего с этой командой не получилось сделать. Игра просто делала вид, будто её не существует. Но и не жаловалась, что доказывает, что движок знает эту команду.
  Если вы лучше знакомы с Phyton или с самим Ren’Py, думаю вы сможете разобраться с этой командой.
  ——————————————————————————————————-

  Когда последствия проверки переменных закончатся, возвращаемся с 8-и пробелов к привычным 4-м.

  С помощью тех же переменных последствия ранних решений могут проявится где-то ещё, и не раз. Собственно, всё это видно из примера выше.

  jump — Зайчик делает прыг-прыг

  В случаях когда вы разделили мод на несколько частей, и каждая из них в отдельном файле, или же когда после выбора читатель должен отправиться совсем другой дорогой, вам поможет простая команда — jump. Она позволяет, буквально, прыгать между лейблами.
  Пишется таким образом:

  • jumpназвание_лейбла

  Таким образом у нас получилось две разные ветки событий. Чтобы не писать это всё в последствиях выбора, так как там может быть очень много, мы вывели это в отдельные лейблы, которые вполне могут быть, даже, в отдельном файле.
  ——————————————————————————————————-

  Помимо jump у нас имеется ещё одна подобная команда — call. Она перемещает читателя на другой лейбл, как и jump, но после его окончания возвращает туда, откуда было совершено перемещение. Это можно использовать, например, для длительных флешбэков:

  Как вы видите, call пишется точно также как и jump, но в отличие от него, call не является окончанием блока или лейбла.

  Карта

  Мы могли забыть о такой прекрасной вещи как — карта. В БЛ есть возможность выбирать куда пойти по карте. Смотрим что для этого нужно.

  Чтобы показать карту пишем команду:

  • $ show_map()

  Но так карта будет пустая, и с ней нельзя будет взаимодействовать. Смотрим дальше.
  Чтобы добавить локацию пишем код по такой схеме:

  • $ set_zone(“название_локации“, “название_лейбла“)

  Пишем эту команду столько раз, сколько будет локаций. У каждой должен быть свой лейбл. При нажатии читателем на эту локацию его перенесёт на соответствующий лейбл. Так что нет нужды писать jump.

  При повторном показе карты выбор локаций останется. Чтобы этого избежать пишем такую команду:

  • $ disable_all_zones()

  Чтобы сделать возможность идти только туда, куда ты ещё не ходил, то есть чтобы можно было обойти все локации, но только один раз, используем переменные и их проверку.
  Дарую вам примерную схемку:

  Не самая удобная, но вполне рабочая. В данном примере три локации: лес, музыкальных клуб и пляж. Всё пишется в отдельном лейбле, чтобы можно было вернуться с лейблов локаций обратно на карту. В начале пишется отключение активных локаций (иначе всё схема насмарку), и проверка, не обошёл ли читатель всё. Если нет, показывается карта, и те локации в которых он не был. Если же он всё обошёл, то его переносит на следующий за этим разделом лейбл.

  Естественно, чтобы вы смогли её использовать, Вам будет нужно поменять все названия лейблов и переменных на нужные Вам. Хотя вы можете использовать и мои)
  Главное не забудьте их прописать в materials.

  Где достать все коды локаций смотрите в разделе Все необходимые коды.

  return — Конец всему

  Вот и пришло время прощаться…
  Когда в конце последствий выбора должен быть конец игры, пишем команду — return.
  Если текст в лейбле закончится, эффект будет тот же.

  Это самая ужасная, страшная, и жестокая команда в этой игре, но каждый мододел однажды её напишет.

  save_name — Сохранения

  Ошибка большинства моддеров — отсутствие названия мода в сохранении. То есть ты сохраняешь игру, проходя мод, а потом не можешь понять, что это вообще за сохранение такое! Эта ошибка к сожалению появляется даже у опытных мододелов, хотя исправляется она элементарно.

  4 пробела, 4 пробела, помним мы о них всегда!

  Так как мы уже сделали большую часть мода, распределить сохранения будет проще. Чтобы добавить сохранению название, в блоке label пишем такую команду:

  • $ save_name = (‘название_сохранения‘)

  Просто, неправда ли? В то место, где название_сохранения, пишем как раз название сохранения. Если получается слишком длинное, какую-то часть можно перенести на другую строчку с помощью — n, иначе оно будет вылазить из слота. Например:

  Это название будет отображаться в игре так:

  Тестовый мод. День 1
  Прибытие в лагерь

  • $ new_chapter(день, u”Название_сохранения”)

  Получается примерно так:

  Сколько всего дней есть на этих мониторах, я, честно говоря, не помню, но где-то 5 — 7.

  Все необходимые коды

  Давным-давно, много лет назад, на просторах интернета я нашёл несколько файликов, в которых оказались расписаны коды всех локаций карт, BG, CG, музыки, звуков, эмбиента и спрайтов. Честно, я не знаю кто этот святой человек, что написал всё это, но я выражаю ему огромную благодарность.

  Так что у меня был выбор, между написанием отдельного руководства, где представлены только эти коды (так как их, ну о-о-очень много), и закидыванием этих файликов в один архив.
  Я выбрал второе.
  К тому же там моё Полевое руководство, по которому я и писал Это руководство.

  В общем. Я загрузил этот архив на Яндекс Диск, и теперь вы все сможете его скачать. Там будут оригинальные (почти) файлики со всеми кодами того-сего, а также моя Мини-справка, где есть всё что и в этом руководстве, но в сильно укороченом виде.

  Она выглядит вот так:

  Не обращайте внимания на что-бы… Это уже давно в прошлом…

  Ещё, для пользователей Notepad++, я оставил подарочек в виде 3-х синтаксисов:

  • sprite_sintдля сворачивания всех спрайтов определённого персонажа в файлике про спрайты.
  • spravka_sintдля красивого и сворачивающегося текста в Мини-справке.
  • И самый важный — renpy_sint, который даст вам возможность видеть код мода также как и я, и как он был показан на скринах выше.
    Пример:

  Все эти синтаксисы сделаны мной, и вы их спокойно можете изменить, если захочется.
  (Для тех кто будет использовать renpy_sint: при добавлении ваших новых персонажей в мод, вам будет нужно его добавить и в синтаксис, в 1-ю группу, в разделе Ключевых слов.)

  Чтобы скачать этот архив, просто нажмите на словосочетание скачать архив ниже.
  Скачать архив [disk.yandex.ru]
  Не бойтесь скачивать его, ничего такого там нет.

  Все коды подписаны на русском, так что вам будет достаточно скопировать нужный код из файлика и вставить в мод. Я сам ими постоянно пользуюсь)

  Публикуем и обновляем детище

  Время финального этапа — публикации мода.

  Обратите внимание — мы выкладываем не ту папку, которая в папке mods, а отдельную папку, что с публичной версией.

  Итак. Вот что мы делаем, для того чтобы выложить наш мод:

  1. Копируем папку мода куда-нибудь, например в Everlasting Summergame. Главное не оставлять её в mods.

  2. В путях файлов в materials убираем — mods/название_мода/. Это можно сделать разом, с помощью замены текста в Notepad++, как показано на скриншоте ниже.

  Не забудьте про это!

  2.1. При желании скрыть от хитрых читателей, которые знают как делается мод, ваш исходный код удаляем файлы с расширением .rpy, и оставляем только .rpyc.
  .rpyc должен был появится после запуска игры с модом.

  3. Когда мы полностью подготовили мод к публикации, запускаем от имени администратора ES_Content_Uploader, что находится в папке mods.
  Нас встретят такой вот приветственной надписью:

  4. Жмём Создать новый предмет.

  5. Вам будет представлен ID вашего будущего мода. Запишите его куда-нибудь. Затем жмём Продолжить.

  6. Появится весьма интересное окно:

  Многим тут уже будет всё интуитивно понятно, но мы всё же разберём всё по пунктам.

  6.1. Пишем название мода в строке Название предмета.

  6.2. Затем, в Описание предмета можем написать первое описание. Но это не обязательно. Вы можете написать его позже, уже на странице мода в мастерской.

  6.3. Указываем путь к папке мода, нажав на Обзор…, после чего появится новое окно. Там мы заходим в папку мода, и в ней нажимаем на кнопку Выбор папки в правом нижнем углу окна.

  6.4. Если у вас уже готов логотип мода, то нажимаем на Обзор… у строки Обложка предмета, в новом окне просто выбираем наш логотип. С ним может быть много проблем, так что возможно придётся перепробовать множество расширений, разрешений и соотношений сторон картинки… Но в итоге вы сможете его добавить.

  6.5. И у нас осталась, опять же, необязательная строка с описанием обновления. Его тоже можно написать в самой мастерской.

  7. Когда всё заполним, нажимаем на Загрузить, после чего начнётся загрузка.

  И в итоге нас обрадуют такой вот прекрасной надписью:

  Которая будет означать, что ваш мод успешно выложен. Поздравляю!

  Вы всегда сможете подписаться на свой же мод, и поиграть в него. Только не забудьте убрать папку мода, в которой вы работали, из mods. Иначе будет капут.

  Мод-то мы выложили, а обновлять кто будет? Тоже мы.
  Смотрим как.

  1. Делаем необходимые изменения в моде, и снова копируем их всех в нашу папку, с публичной версией мода.

  2. Снова запускаем ES_Content_Uploader, но на этот раз нажимаем на Обновить существующий предмет.

  3. Появится окно, которое потребует ID вашего мода. Вы же записали его, да?

  Но если нет, то это не такая уж большая беда. Переходите на страницу вашего мода в мастерской, и в зелёной строке сверху копируйте цифры ID. Ну, если у вас там нету этой строки, то просто скопируйте адрес страницы, с помощью правой кнопки мыши, вставьте куда-нибудь, и оттуда вытащите ID.
  Ну или можно подписаться на свой мод, а затем найти его по пути:
  …Steamsteamappsworkshopcontent331470
  Просто полазайте по папкам, и в одной из них будет знакомые вам файлы. Это и есть ваш мод)

  4. Как напишем ID в нужное поле, нажимаем продолжить, и появляется уже знакомое нам окно:

  Однако в нём автоматически будут стоять галочки, запрещающие изменять название и описание предмета. Что ж, на неё всегда можно нажать снова, если вы захотите изменить то или иное.

  Собственно тут всё как и раньше. Выбираем свою папку, логотип если надо, и пишем что изменилось, если хотите.

  5. Нажимаем на загрузить, и пойдёт загрузка.

  Затем нас снова поздравят той же самой надписью:

  Послесловие

  Вот и всё. Вы сделали свой собственный мод, уверен он будет отличным!
  Посему я могу с гордостью сказать:

  Спасибо всем, кто читал и пользовался моим руководством, всем кто оценивал, выдавал награды, комментировал и добавлял в избранное, как во время разработки, так и уже после!

  А ещё я хочу сказать спасибо тем замечательным людям, которые своими руководствами, обучили меня всему, чему теперь я обучил вас!
  Вот эти руководства:

  Руководство закончено, но конечно же может быть дополнено в будущем.

  Если что-то не получается, не стесняйтесь спрашивать.
  Постараюсь помочь, всем чем смогу!

  Лето, Советы и (не)много кода

  

  mods[«»] — команда, которая добавляет мод в список модов. В кавычках необходимо указать блок (латиницей), на который игрок переходит во время запуска.
  = — присваивание блоку запуска определённое имя в списке модов.
  u — в строке используются символы Unicode. И в кавычках — название мода на любом языке.

  Чтобы наш мод шёл плавно и без проблем, необходимо, чтобы из каждого блока можно было попасть в следующий. Для кинетических модов (моды, которые не имеют выбора и движутся по одной сюжетной линии) вообще не обязательно иметь более одного блока, но можно использовать несколько для красоты.

  После этого урока ты уже сможешь написать кинетический мод со встроенными материалами.
  Создаём наш запускаемый блок:

  

  После метки идёт её имя — то самое, которое мы задали в списке модов.
  И не забудь про «:»! Это показывает, что ниже — содержимое этого блока.

  Едем дальше. Теперь ты можешь писать любой текст, включать любую музыку и вставлять любые картинки. Как? Очень просто!

  

  Выглядеть это будет так:

  

  Теперь — сам код.
  play — запускает звук
  music — помещает его на канал «музыка». Есть три канала: music, sound и ambience. Music и ambience проигрывают звук в цикле.
  music_list[«»] — звук берётся из списка самой игры.
  fadein <число> — нарастание музыки в течение указанного количества секунд. Необязательно.

  scene — задаётся самый нижний слой, на который чаще всего помещаются фоны. При применении этой команды на непустой экран все спрайты и картинки скрываются.
  bg — указывает на то, что картинка является фоном. Можно использовать и без bg, но не всегда картинки будут работать.
  ext_camp_entrance_day — название картинки.
  with dissolve — анимация появления картинки. Можно использовать вообще без анимации, но это будет не так красиво. Dissolve — медленный переход, dspr — быстрый и используется чаще для изменения эмоций. Также существуют и другие, но об этом позже.

  show — появление картинки на фоне
  sl — название спрайта персонажа
  nomal — эмоция персонажа
  pioneer — одежда
  far, close — существует три положения относительно игрока. По умолчанию это среднее положение. Кроме этого, есть far — дальнее и close — ближнее положение.
  at left — положение относительно центра экрана. Слева направо: fleft, left, cleft, center, cright, right, fright. Если персонаж уже находится в нужном положении, можно не использовать.
  Также можно использовать только один wih dissolve на следующей строке после описания Слави. Тогда фон и спрайт появятся одновременно, а не последовательно. Также это можно использовать для одновременной смены эмоций разных персонажей.

  Весь текст пишется в кавычках.
  — пауза во время чтения. То есть, игрок должен нажать ЛКМ ещё раз, чтобы перейти к следующей части.
  sl, me — имена персонажей, отображаются в верхней части текстового окна. Полный список — тута. Кроме того, тут списки всех материалов из игры.
  th — мысли (

  текст такого типа

  )
  И return — возврат на предыдущий уровень. Если уровень последний, то игра выйдет в меню.

  Комментарии в коде можно оставлять с помощью #. Движок игры пропускает всё, что написано после этого символа и сразу переходит на следующую.

  На этом первый урок закончен. Потренируйся с этими инструментами, а если захочешь поделиться результатами — шли файл с кодом в комментарии с меткой «Урок 1».

  Ты уже достаточно потренировался с линейным моддингом, но хочется чего-то большего?
  Добро пожаловать во второй урок!

  Но до этого надо исправить парочку недочётов: остановим музыку.

  

  Аналогично с play — указываем нужный канал и, по желанию, время затухания.

  Начнём с самого элементарного — меню выбора действия. Но до этого добавим за спину Слави кого-нибудь чтобы разобраться со слоями.

  

  После указания персонажа, эмоции и типа одежды указываем, за кем должен стоять персонаж. В данном случае на экране у нас только Славя, поэтому пишем behind sl. Если ты используешь far или close, то команда behind должна стоять после. Но обязательно перед with-командой (или at, если она есть).

  Как написать мод на бесконечное лето

  Данная статья была написана мной более года назад в качестве отчёта о практике для универа. В кои-то веки я решил её опубликовать. Надеюсь, ещё не совсем потеряла актуальности :/

  В связи со спецификой появления, думаю, во избежание лишних вопросов мне стоит пояснить, что САФУ/NArFU — это название университета, а ИСМАРТ — конкретный институт в его составе, где я учусь. Стиль изложения также может несколько отличаться от моих обычных публикаций, так как подразумевалось, что читать текст будут люди совсем далёкие от игр и современной сетевой культуры.

  Также для основной версии сайта я прикрутил подсветку синтаксиса (на lite- и pda-версиях не работает), но Ren'Py — довольно специфичный язык, поэтому используется подсветка от Python'а. В итоге подсвечены будут, по сути, только строки и некоторые совпадающие ключевые слова.

  Если при чтении возникнут какие-то проблемы или вопросы по коду, то можно скачать архив с примерами. Он упакован в формат 7z, потому что, в отличие от zip’а, тот умеет упаковывать идентичные файлы так, чтобы они занимали место, как один.

  Гайд по созданию визуальной новеллы

  Здравствуй, дорогой читатель! Возможно, ты уже слышал о такой широко известной в узких кругах видеоигре от отечественных разработчиков, как «Бесконечное лето» (Everlasting Summer)? Впрочем, если нет, то ничего страшного: я расскажу о ней вкратце.

  Как гласит официальный сайт, «„Бесконечное лето“ — это визуальная новелла от российских разработчиков, дарящая самые искренние и светлые переживания об ушедших днях и надеждах, которым ещё предстоит сбыться». Поясняю:

  • Визуальный роман (но чаще встречается вариант с англицизмом: визуальная новелла) — это жанр компьютерных игр, в котором упор делается на текстовый контент, сдобренный порциями аудиовизуального сопровождения. По сути, это скорее книги, чем игры, но обильно снабжённые иллюстрациями, анимацией, музыкой и звуками окружающего мира. Также, в отличие от книг, представители данного жанра обычно имеют нелинейный сюжет с несколькими концовками, и исход зависит от выборов игрока.
  • «Бесконечное лето» повествует историю об одном асоциальном человеке, волею судеб оказавшемся в загадочном пионерлагере. Многим игра нравится именно атмосферой, позволяющей почувствовать себя пионером либо поностальгировать о временах былой молодости.

  Однако мы здесь собрались вовсе не для того, чтобы слушать рекламу и хвалебные оды, не так ли? Так что перейдём ближе к сути.

  «Бесконечное лето» написано на бесплатном движке Ren'Py. Это специальный движок, предназначенный для создания визуальных романов сценаристами, далёкими от программирования. Он имеет предельно простой синтаксис и множество встроенных средств для реализации практически всех функций, которые могут понадобиться в подобных играх. Тем не менее, сам движок свободен (open source) и расширяем, предоставляя возможность пользоваться всей мощью языка Python, на котором он написан.

  В этом небольшом гайде мы рассмотрим базовые возможности Ren'Py, а также слегка коснёмся темы создания модификаций к игре «Бесконечное лето».

  Для того, чтобы начать создавать игры на Ren'Py, первым делом скачай и установи/распакуй набор для разработчиков с официального сайта. После запуска покажется такое окно:

  

  Это Ren'Py Launcher — программа, из которой можно запустить любой из разрабатываемых проектов, открыть папку с ним или сразу перейти к редактированию скриптов. Все команды написаны на простом английском языке, не выходящем за рамки даже слабой школьной российской программы, так что не вижу смысла на них останавливаться. К тому же в настройках можно включить кривой перевод на русский язык.

  Создай новый проект, укажи папку (желательно, без кириллицы, но это не обязательно), имя проекта (вот тут только латиница!) и выбери любую тему (это непринципиально).

  Ren'Py уже при создании производит базовую настройку проекта, предоставляя интерфейс для меню, стили по умолчанию и т. д. Можешь посмотреть файлы скриптов, которые он создал:

  • В options.rpy находится большинство настроек: размеры окна, стили, переходы по умолчанию и т. д.
  • В screens.rpy описываются меню, диалоговое окно и прочие «экраны».
  • script.rpy предназначен, собственно, для самого скрипта-сценария романа.

  Вообще, это всё условно. Все файлы проекта находятся в папке game и Ren'Py читает там все файлы с расширением *.rpy, так что можно разбивать скрипты на любое количество файлов.

  Я бы мог рассказать ещё про основы языка Python, как сделано в документации, но всё, что нам понадобится для базового знакомства, интуитивно-понятно или будет пояснено в месте применения. Так что предлагаю просто нажать по ссылке на scripts.rpy в «лончере» (launcher), выбрать редактор (любой, я вообще пользуюсь Sublime Text 3 с плагином) и приступим к созданию твоего первого творения на Ren'Py!

  Текст, картинки, переходы

  Сотри всё, что уже есть в файле: мы начнём с нуля.

  Для упорядочивания кода Ren'Py пользуется системой меток (привет, ассемблер и GOTO!). При выборе кнопки «Начать игру» в главном меню игры, которое отображается сразу после запуска, управление передаётся на метку start:

  Что мы видим? После объявления метки start начинается принадлежащий ей блок кода, строки которого обладают отступом в 4 пробела. Внутри блока расположены речевые конструкции (say statements), с помощью которых выводится текст.

  В первой и третьей строчках (блока) располагаются слова автора или рассказчика. Фраза просто заключается в двойные кавычки (если внутри фразы нужно вывести кавычки, то они предваряются обратным слешем: \").

  Во второй и четвёртой строках находится фраза персонажа под именем Аня. Видно, что имя персонажа, так же заключённое в двойные кавычки, и его фраза отделяются пробелом.

  Возникает первая проблема: постоянно приходится повторять имя персонажа (а в больших сценариях с более длинными именами это реально представляет проблему). Ну и сразу обращаю внимание на вторую: все персонажи отображаются абсолютно одинаково, без какой-либо толики индивидуальности. Решим обе эти проблемы:

  В самое начало я добавил новую строку, которая определяет (define) нового персонажа (character) и задаёт ему имя и красноватый цвет имени (color). Новый персонаж присваивается короткой переменной a, которая теперь используется в речевых конструкциях вместо имени. Обратите внимание, что определения (что персонажей, что изображений, как мы увидим позже) пишутся вне любых меток, так как выполняются во время инициализации (немного про это будет сказано позже).

  Что же у нас получилось?

  

  Хм, надо бы избавиться от этих шашечек и добавить собственный фон. Я использую, например, фотографию крыльца своего института, найденную в Интернете. Закинь любое изображение достаточного размера в папку images внутри папки game. Внутри этой папки Ren'Py сканирует все изображения и по определённым правилам создаёт для них имена, но для наглядности мы определим фон вручную. Самый простой способ:

  image bg ismart = ‘images/ismart.jpg’

  Просто путь к файлу! Но если мы сделаем так, то получим странную картину:

  

  Виной всему слишком большой размер изображения. Поэтому придётся немного усложнить определение. Вот весь код:

  Во! Теперь всё в порядке:

  

  Теперь объясню, что делает добавленный код и как вообще происходит отображение. Всего появились две новые строчки: конструкция с image и конструкция с scene:

  • image, собственно, определяет изображение. Между ключевым словом и знаком равенства помещается имя отображаемого объекта. С ним не всё так просто. Как мы увидим дальше, в играх такого жанра, часто используются так называемые спрайты, то есть изображения персонажей с разными эмоциями и одеждой. Соответственно, частой операцией является смена спрайтов одного персонажа. По этой причине название изображения для Ren'Py состоит из, собственно, имени и атрибутов, разделённых пробелами. Всё это станет понятнее, когда будем рассматривать спрайты. А сейчас достаточно понять, что bg — название изображения, ismart — атрибут.
  • scene, как понятно из названия, предназначен для смены сцены. Выражение с этим словом очищает экран от любых других изображений и выводит указанное (обычно фон, хотя может и не выводить ничего).
  • im.Scale(d, width, height) — функция масштабирования, которая принимает отображаемый объект (displayable), в частности изображения, и изменяет его размеры к указанной ширине (width) и высоте (height). Сразу замечу, что существует аналогичная функция без префикса im.* (вне объекта im), которая отличается тем, что производит расчёты при каждом отображении и не сохраняет результат вычислений при определении.
  • config.screen_width и config.screen_height — две переменные в объекте конфигурации, хранящие заданные в настройках ширину и высоту экрана игры (их легко можно найти в options.rpy).

  Надеюсь, я объяснил достаточно понятно. Давай теперь поиграем со стилями? Открой screens.rpy, найди в самом начале описание экрана диалогов (screen say) и удалим всё «лишнее», добавив немного своего (выделено полужирным):

  Рассмотрение стилей, к сожалению, выходит за рамки данного гайда, так что я не стану ничего пояснять. Будем считать, что разобраться в работе стилей будет твоим домашним заданием 😉

  Ну а своим вандализмом мы добились такого цветастого безобразия без меню и возможности переключения режима отображения имени персонажа (в том же окне или в отдельном) из сценария:

  

  Мы обязательно должны рассмотреть отображение спрайтов, изменение места их расположения и переходы, но искать спрайты в Интернете мне лень, так что рассмотрим этот материал внутри обещанного блока про создание модификаций для «Бесконечного лета».

  Прежде всего скачай саму игру: либо через сервис цифровой дистрибуции Steam, либо через торрент-трекер Rutracker. Актуальные ссылки можно всегда найти на официальном сайте. Далее зайди в папку с игрой (для версии из Steam это \SteamApps\common\Everlasting Summer ). Там обычная структура файлов игры на движке Ren'Py. Заходим в game, как и прежде, а оттуда в папку mods. Скопируй туда scripts.rpy нашего проекта. Можешь даже его как-нибудь переименовать — не суть.

  Теоретически можно создать наш файл со скриптом в любом месте внутри папки game, но давай будем придерживаться соглашений. К тому же, нам надо перекинуть и картинку. Создай папку narfu_images рядом с файлом скрипта и скопируй туда наш фон.

  В последних сборках игры добавлен загрузчик модификаций, так что нам нужно лишь дать ему знать, что мы есть за скрипт. Открой файл в любимом текстовом редакторе. Пришло время познакомиться с блоками инициализации и запуском кода на Python!

  Определение изображений и персонажей, как было сказано в примечании ранее, автоматически размещается в блоке инициализации, который выполняется до загрузки игры. Соответственно, это то самое место, где наш скрипт будет заявлять о себе. Добавь этот код в самое начало скрипта:

  Блок инициализации объявляется ключевым словом init. Если дальше идут выражения на языке Python, а не на Ren'Py, то добавляется слово python. Вообще, в любом месте блоки кода на Python объявляются с помощью этого слова. Другой путь написать одиночную команду на Python — использовать знак доллара ($) в начале строки.

  В примере выше я вместо слова python явно задал приоритет блока. Блоки выполняются от меньшего приоритета к большему. По умолчанию подразумевается блок с нулевым приоритетом. Порядок выполнения блоков с одинаковым приоритетом не гарантирован и может быть случайным.

  Теперь объясняю саму команду. Переменная mods — это специальный список «ключ-значение», где перечисляются все модификации. Ключ должен быть уникальным значением на латинице без пробелов и в кавычках. Значение — название мода для отображения в загрузчике модификаций. Ключ играет роль названия метки при запуске мода, так что исправь label start на label narfu_practice. Также давай уберём определение персонажа a. Он нам больше не понадобится.

  Теперь сделаем магию! Вставляй в редактор оставшийся код и запускай игру через меню модификаций в настройках!

  

  С чего бы начать? «Бесконечное лето» предоставляет интерфейс, персонажей, спрайты к ним, фоны и музыку. Здесь мы пока использовали только первые три пункта.

  dv — это персонаж и тег изображений для Алисы Двачевской. Соответственно, scared, raged и pioneer — это атрибуты. Вообще, названия всех спрайтов в игре строятся по следующему плану: короткое_имя_персонажа эмоция одежда . Полный список спрайтов можно найти в знаменитых уроках LolBot'а (один из программистов игры, создатель системы модификаций). Официальной ссылки, насколько мне известно, не существует, а прочие быстро станут не актуальны, так что Google в помощь!

  При показе второго изображения с таким же тегом, первое исчезает. Это нужно как раз для удобной смены эмоций, как сделано в нашем примере. Чтобы отобразить два одинаковых изображения, можно воспользоваться конструкцией show..as <новая метка> (см. следующий параграф).

  Для отображения спрайтов используется ключевое слово show, похожее на scene, но не очищающее экран. Для обеих конструкций могут быть указаны переходы с помощью конструкции with. Строго говоря, изображение вообще отображается только после этой конструкции. Таким образом можно планировать показ нескольких изображений, для которых потом задавать один переход. Если with не встречается до следующего диалога, то Ren'Py использует with None, просто выводящий изображения мгновенно. А ещё его полезно использовать, когда нужно одно изображение отобразить мгновенно, а лишь второе — с переходом.

  Ren'Py имеет ряд встроенных переходов (мы использовали dissolve и fade), а также позволяет создавать свои с помощью специальных функций (например, with Dissolve(0.5) для «растворения» одного изображения в другом за полсекунды). Всё это очень интересно, но выходит за рамки данного гайда. Смотри документацию, если хочешь знать больше!

  Обрати внимание, как отображаются диалоги с изображениями в обоих случаях речи Алисы: в первом сначала рисуется персонаж, а затем печатается текст, а во втором — и текст, и персонаж переключатся с «растворением» одновременно.

  Для того, чтобы диалоговое окно не мерцало при показе изображений, я использовал window show, которое держит окно всегда на экране. По умолчанию же оно показывается при отображении диалогов и скрывается при показе изображений, что я обратно и включаю в конце скрипта (надо помнить, что мод заканчивается, но игра продолжает выполняться, и мы обязаны всё вернуть в исходное состояние!).

  Разумеется, существуют конструкции hide для скрытия изображении и window hide для скрытия диалогового окна.

  А теперь давайте добавим второго героя, музыки и украшательств!

  Прочитал комментарии? Я не буду пояснять про особенности игры, так как статья не об этом. Здесь мы обратим внимание позиционирование изображений, стилизацию текста и музыку.

  Для проигрывания музыки и звуков существуют play music и play sound соответственно. Они принимают либо путь к файлу, либо список путей к файлам (в данном случае все пути к музыке из игры расположены в специальном списке, из которого мы берём конкретный). Для остановки используются stop music и stop sound, соответственно.

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

  Расположение спрайтов задаётся при показе либо с помощью at, либо в виде отдельного блока. В первом случае указывается предопределённое расположение (left или right, например), а во втором используется специальный язык ATL. Подробнее о нём можно прочитать в документации, а я лишь опишу базовое позиционирование, о котором также можно посмотреть наглядно в туториале, прилагаемом к Ren'Py SDK.

  Положение изображений по обеим координатам задаётся с помощью двух точек: одной на изображении, называемой якорем (anchor), и второй на экране (pos). Задаётся либо с помощью целого числа, обозначающего координаты относительно верхнего левого угла экрана, либо с помощью дробного числа от нуля до единицы, обозначающего долю экрана, как сделано в примере.

  Стилизация текста. Текст может содержать специальные теги, показывающие, как он должен отображаться. Для знакомых с языком HTML тут будет совсем просто: чаще всего используются точно такие же теги: , , , (для ссылок). Хотя есть и различия: . Просто. Также в тексте в квадратных скобках могут использоваться подстановки из переменных, определённых в коде. Если же есть необходимость использовать в тексте сами символы фигурных и квадратных скобках, но их нужно продублировать: <<, >>, [[, ]].

  Внизу на картинке приведён результат. Неплохо получилось, не так ли?

  

  За сим я, пожалуй, откланиваюсь. В Ren'Py есть ещё очень много всего интересного, но место в этой статье не резиновое. Дальше, дорогой читатель, можешь либо почитать документацию (если знаешь английский язык, конечно), либо искать обучающие видео и руководства от других людей.

  Как написать мод на бесконечное лето

  

  9
  1
  2
  1
  1
  1
  1

  

  10,506	уникальных посетителей
  1,505	добавили в избранное

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  

  • Сама игра, в нашем случае Everlasting Summer
  • Текстовый редактор, я советую использовать Notepad++

  Весь моддинг "Бесконечного Лета" заключается в писании магических фраз в файлах .rpy, которые игра будет читать и делать то что мы захотим (но конечно же есть ограничения)

  Подожди, писать заклинания еще рано, сначала нужно понять, как правильно расставлять слова для эффекта

  Структура файла выглядит примерно так:

  Команды в блоке ВСЕГДА имеют отступ в 4 пробела относительно команды говорящей нам о начале блока.

  Есть несколько команд начинающих блок, пока стоит лишь запомнить то, что после команды, начинающей блок всегда ставится двоеточие (:)

  На данном этапе создания мода нам понадобится лишь одна блоковая команда

  label <Название метки>: — Обычно используется для разделения мода на части, для удобной навигации между ними

  Существует 2 варианта перейти от одного блока к другому

  Вариант 1 — "Прыжок"

  В этом варианте сначала выполняется первый блок, а затем второй. При этом используется команда

  jump <Название блока>

  Вот уже знакомый нам пример:

  В этом случае если написать в блоке vasya_mod_d1 что либо после jump’a, то игра просто пропустит это

  В отличии от прыжка, при использовании этого варианта после полного выполнения блока на который переходит игра, она вернется в первоначальный и продолжит его выполнение после команды. Команда для этого:

  call <Название блока>

  Ну и как же без примера:

  Окончание блоков, переход к которым осуществляется именно этим методом имеет некоторые особенности, о которых можно узнать дальше

  Если к этому блоку ведут jump’ы, то конец блока можно ничем не выделять, если только это не последний блок в вашем моде (Последний блок 1/x концовки). В ином же случае последней командой блока должна быть команда return. Зачем? В случае если это последний блок, чтобы игра могла закончить обработку мода и вернуться в главное меню. Если же на блок привела команда call, то игре просто необходимо знать, когда вернуться в предыдущий блок.

  Получается что наш пример call не будет работать и нам придется привести его к такому виду:

  Как мы все знаем "Бесконечное Лето" — это визуальная новелла и весь сюжет в ней разворачивается посредством диалогов персонажей и выборами Главного Героя,

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

  Все просто, этот ID говорит нам о том, с кем же сейчас ГГ разговаривает

  Для текста от автора ID не нужен

  Остальных говорящих вы можете увидеть на прикрепленной картинке да, картинка копипаст

  Для примера мы попросим поздороваться каждого из основных говорящих

  В игре вы встречались с тем, что некоторые слова во фразах персонажей были как-то выделены или вовсе были в ковычках. Для этого используются специальные теги.

  Как мы уже знаем, ковычки ограничивают реплики персонажей, так как же нам использовать их внутри этих реплик?

  Чтобы ковычки не учитывались игрой, перед ними нужно поставить \

  В самой игре при смене местоположения нашего ГГ меняется и картинка на фоне (bg)
  Так как же нам показать где сейчас наш герой?

  А делается это при помощи команды scene bg <Название фона>

  Все bg из игры -> Ссылка [drive.google.com]

  Так же в архиве приложен текстовый файл из которого сразу можно скопировать нужную строку

  Персонажи в игре — не что иное, как тоже картинки, только именуются они спрайты.
  Перечислять их все на буду, но скажу, что их более 350

  Вызываются все спрайты командой show <Имя спрайта>

  Имя спрайта обычно состоит из нескольких слов, разделенных пробелами

  В оригинальной игре имя персонажа совпадает с ID говорящего из предыдущего раздела этого руководства

  Список всех спрайтов -> Ссылка [drive.google.com]

  Если персонаж уже на экране, то повторное использование show будет менять эмоцию и/или одежду

  При простом использовании show <Спрайт> он будет появляться просто по центру, это можно исправить добавив в конец at <Позиция>

  show <Спрайт> at <Позиция>

  Всего в игре 7 позиций где может находиться спрайт:
  fleft, left, cleft, center, cright, right, fright

  На приведенном скриншоте были использованы команды:

  Так же можно показать персонажа ближе\дальше. Для этого можно воспользоваться атрибутом close/far

  На втором скриншоте как раз были использованны эти атрибуты. Команды:

  Для того, чтобы убрать персонажа воспользуйтесь

  hide <Имя персонажа>

  Если вы хотите вслед за этим сменить декорации, то прописывать hide для каждого персонажа не обязательно, команда scene сама их уберет

  Тут принцип как и с bg, только надо использовать scene cg

  Все cg со списком -> Ссылка [drive.google.com]

  Примеры думаю не нужны.

  Мы можем показать спрайты, bg и cg с некоторым замедлением, плавно

  Так же есть еще несколько эффектов, о которых речь пойдет далее, некоторые из эффектов можно применить не только к изображениям, но и даже друг к другу!

  Чтобы показать наши картиночки более красиво для человеческого глаза, мы можем использовать специальный атрибут. Это будет выглядеть примерно так:

  scene bg <Название bg> with <Атрибут>

  Атрибутов для плавности 6, они отличаются лишь своей скоростью.
  dspr — 0,2 сек — Самый быстрый, на практике не особо заметен
  dissolve — 1 сек — Средняя скорость, считаю оптимальной для смены cg на bg и наоборот и для эмоций спрайтов
  dissolve2 — 2 сек — Самая плавная картинка, считаю хорошим вариантом для переходов между локациями лагеря
  dissolve_fast — 0.5 сек.
  hell_dissolve — 50 секунд — на практике не особо применим, но вдруг пригодится.
  dissolve_long — 100 секунд.

  Так же можно группировать несколько обьектов для одновременного начала эффекта

  В приведенном примере мы попадем в ночной автобус и перед нами предстанет улыбающаяся Славя, и все это с задержкой в 2 секунды.

  Так же атрибут плавности может применяться к другим эффектам.

  Если все вышеприведённые примеры Вас не устраивают, можно добавить свой атрибут плавности. Для этого, пропишите его в блоке init.

  После этого мы можем использовать наш переход, так-же, как и все остальные.

  Я более чем уверен, что вы видели эффект того, как иногда ГГ моргает или вовсе закрывает глаза. Мы можем реализовать подобную возможность!

  show blink — Закрыть глаза
  show unblink — Открыть глаза
  show blinking — Моргание

  Будьте осторожны: blink и unblink это разные эффекты, они не могут отменить друг друга

  Как открыть глаза:

  Вполне может быть, что по сюжету Вашего мода, может не хватить имеющихся БГ, ЦГ и спрайтов. В таком случае, мы добавим свои. Где искать картинки, спрайты и т.д. — разбирайтесь сами, но вот что с ними делать дальше.
  Для начала нам надо объявить изображение в блоке init. Делается это, с помощью объявления переменной image. Покажем на примере. Допустим, мы нашли изображение с видом города и называется оно у нас gorod.jpg Для его объявления, пропишем такую команду:
  image gorod = "gorod.jpg"
  (Прим.: При условии, что изображение лежит в папке game. Если оно лежит в другом месте, например в папке вашего мода, который в свою очередь находится в папке mods, объявление изображения будет выглядеть так:
  image gorod = "mods/nazvanie_moda/gorod.jpg" )
  Теперь мы можем использовать имеющееся изображение так-же, как и остальные:
  scene gorod with dissolve
  или
  show gorod with dissolve

  Что за странные циферки? Ничего не понятно!
  Сейчас объясним.
  Возьмём наши координаты pos(0.5, 0.5), где первая цифра — xpos (положение по горизонтали), а вторая ypos (положение по вертикали).
  Весь экран условно делится на части, где 0.0 — крайняя левая часть, а 1.0 — крайняя правая (по аналогии верхняя и нижняя). Соответственно, наше 0.5 — это середина. Назревает вопрос. Можно ли использовать отрицательные числа, и числа больше одного? Да. Но в этом случае изображение будет вылезать за пределы экрана.

  У align назначение похожее, но немного отличается. Этот элемент, помимо указанных координат, использует собственный размер изображения. Для примера:
  Если при якоре (0.5, 0.5) мы зададим позицию pos(1.0, 0.5) — у нас пропадёт половина изображения, ибо точкой его появления будет указан край экрана. С align ситуация обстоит иначе. При использовании align(1.0, 0.5) изображение прижмётся к краю экрана, но не исчезнет.

  При назначении позиции координаты pos и align можно комбинировать.
  Давайте, для примера выведем спрайт улыбающейся Мику слева экрана.

  Очень и очень многое. Допустим, анимации.
  Вот стоит у нас слева на экране Мику, объявленная в прошлом блоке, но вдруг появилась Ульяна, и Мику из вежливости решила подвинуться чуть правее. Как мы это сделаем? Можно просто задать координаты положения, и Мику "телепортируется" туда, но разве это красиво? Не. У нас другие методы.

  Смена положения.
  Для смены положния существует 4 метода: linear, ease, easein, easeout. Для начала нам понадобится только linear. Как он работает? Очень просто. После linear мы пишем время в секундах, а после новые координаты в системе ATL.
  Пример. Созданим перемещение к правому краю экрана:

  Теперь добавим это в наш код.

  И импортируем её в код:

  Наверное вы и сами слышали, что в "Совенке" никогда не бывает тихо, где-то играет приятная музыка, иногда мы слышим стуки в двери, три раза в день, звук горна собирает всех обитателей у столовой.

  Для того чтобы проигрывания музыки используется всего две команды

  play music music_list["<Название>"] — Начинает проигрывать указанную музыку
  и
  stop music — Завершает проигрывание музыки

  Список всей фоновой музыки в игре -> Ссылка [drive.google.com]

  Послушать эту музыку можно прямо в игре, зайдя в раздел Галерея

  Для проигрывания прочих звуков нам понадобится все та же команда play, только немного в другом виде

  play ambience ambience_<Название> — Игра включает нам выбранный звук
  и
  stop ambience — Выключает его

  Список этих звуков -> Ссылка [drive.google.com]

  Увы, подобрать нужный звук вам поможет лишь базовое знание Английского языка и "метод научного тыка"

  Все что мы узнали раньше позволяет нам писать лишь статичные моды, в которых от игрока ничего не зависит. Теперь же нам пора добавить игроку возможность выбора

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

  Объявление переменных происходит в специальном блоке init. Имена и значения у переменных могут быть любые, но рекомендуется использовать короткие английские слова или цифры (цифры только в значении)

  Изменение значения переменных будет выглядеть так:

  После выполнения данных команд переменная "choice" будет иметь значение "True", а переменная "Count" увеличит свое значение на единицу.

  Если вы хотите дать игроку выбор, то вам необходимо использовать специальный блок menu:

  В приведенном примере Ольга Дмитриевна попросит нас взять мешок с сахаром, мы же можем как подчиниться и увеличить переменную "good" на 1, так и отказаться, причем в зависимости от нашего выбора события в игре могут измениться

  Будьте осторожны: Варианты ответа тоже открывают блок, и если мы не поставим после каждого двоеточие, мод может не запуститься

  Поясню данный отрезок. Если значение переменной "good" больше нуля, то игра продолжится на метке "good", если же нет, то мы переходим на метку "bad"

  Теперь же мы постараемся реализовать выборы, в которых в зависимости от прошлых выборов персонажа будут добавляться или убираться различные варианты ответов

  Иногда по нуждам сюжета необходимо дать игроку выбор куда ему пойти, использование для этого обычного меню выбора выглядит несколько не эстетично, так давайте же научимся ориентироваться в "Совенке" при помощи карты!

  Чтобы дать игре понять. когда развернуть перед игроком карту необходимо всего несколько простых команд.

  Далее заполняем конструкцию set_zone()
  Где первым значением будет выделенная на карте зона, а вторым — лейбл, куда прыгать, при клике на неё.

  т.е. чтобы при нажатии на клубы мы прыгали на лейбл mymodlabel2 (название, примера ради) нужно реализовать такую конструкцию:

  И в конце, выводим саму карту командой:

  Показываю пример полностью. Допустим нам нужны три зоны. Сцена, Муз. клуб и Пляж, и каждая ведёт к совим лейблам label1, label2 и label3, для этого мы делаем всё то, что я уже описал выше:

  Вполне возможно, что вашем моде вам понадобится персонаж, которого по какой-то причины разработчики не стали заселять в лагерь, что же делать в этом случае? Правильно создать его!

  Любой персонаж игры — простая переменная, с которой мы вольны делать что захотим (*зловещий смех*)

  Переменные создаются двумя способами, методом движка — с помощью команды define и методом "Питона" — с помощью символа — $.

  Далее мы присваиваем переменной свойство Character().
  Для примера создадим Вашего покорного слугу:

  define vladya = Character(u"Владя")
  (прим.: Символ u используется, для отображения русского текста у людей, у которых он не установлен в системе.)

  Теперь мы можем использовать переменную vladya в своём моде. Давайте, я поздороваюсь с Вами:
  vladya "Привет"

  Но стоп! Что же мы видим? У всех персонажей игры есть свой цвет, а наш персонаж белый. Некрасиво! Надо исправить. Но как-же это сделать? С помощью параметризации свойства Character у нашей переменной.
  Так давайте же это сделаем! Цвет имени персонажа указывается с помощью параметра color, так-же рекомендую использовать неизменный параметр what_color, для изменения цвета речи персонажа. В самой игре, все персонажи говорят цветом f1d076, так не будем выделяться. Назначим нашему персонажу в качестве цвета имени, скажем, зелёный цвет (008000) и установим в качестве цвета речи — f1d076:

  define vladya = Character(u"Владя", color="#008000", what_color="#f1d076")

  И давайте я вновь поздороваюсь с Вами:
  vladya "Привет"

  Намного лучше, не правда ли?

  Окей, окей. Без проблем.

  Допустим наш персонаж пересмотрел Ваномаса и теперь после каждого предложения говорит "ёпты блин" (пардоньте, в Стиме цензура, оригинал не работает), можно конечно прописывать после каждой строчки это замечательное словосочетание, а можно использовать команду what_suffix. Давайте дополним переменную:
  define vladya = Character(u"Владя", color="#008000", what_color="#f1d076", what_suffix=u", ёпты блин.")

  Для начала реализуем перед именем вот такую конструкцию:

  И после начала нашего мода прописываем:
  show screen scr123
  Этой командой мы будем обновлять значение переменной vano, каждую 0.1 секунду.

  И что-же будет теперь:

  И вот уже весь лагерь, включая нашего подопечного уснул. Несомненно вы видели, как в оригинальной игре о начале нового дня нас оповещали даже. не будящие нашего протагониста лучи солнца, а простой монитор компьютера, показывающий нам сколько времени мы провели в этом дивном месте. Чем же мы хуже, давайте сделаем себе такой же монитор!

  Для выведения на экран монитора, необходимо прописать две команды:

  Где:
  backdrop — фон с монитором.
  1 — номер дня, который будет показан на мониторе,
  Текст — то, как будет называться сохранение.
  Фонов (backdrop) в игре 5:

  Вы 100% видели, как в оригинальной игре да и некоторых модах, при прохождении концовок появляется картинка а-ля "Achivement Complted" И хотели бы в свой мод такую же.

  Для этого в нужном вам месте вставьте следующие команды

  Где "myachiv" — Ваша картинка с ачивкой.
  Ну, вот и всё. Ачивка выведена.

  Нет. У меня есть моё личное правило: если какой-то код периодически повторяется — я пишу под него функцию. Ибо удобно.

  К слову, в БЛ вывод ачивок реализован именно так, но оригинальная функция нам не подойдёт, ибо она подогнана только под уже заложенные ачивки "Лета", так что нам нужно немного её переделать, под более универсальные нужды.

  Для этого, реализуем следующую конструкцию в блоке питона.

  Теперь, в месте вывода ачивки, надо прописать лишь обращение к функции, и в скобках прописать картинку с Вашей ачивкой в кавычках.

  Где, опять же, "myachiv" — Ваша картинка с ачивкой.

  P.S.: Название функции "achiv_for_my_mod" дано, для примера, и его можно и нужно менять. т.к. если функция, с одним и тем же названием, дважды (или больше) встретится в разных модах — будут конфликты.

  Старайтесь в своем моде задавать уникальные имена блоков и функций, иначе игра не будет знать куда же ей переходить и что выполнять, что зачастую черевато вылетом

  Большинство модов, сценарий которых пишется одним человеком-разработчиком мода, да еще и в процессе написания самого мода, забрасываются на очень ранних этапах. Не советую вам начинать писать мод, не имея сценария, иначе это может ударить по вашей самооценке.

  Если вам прямо не терпится создать мод, а сценария нет, загляните на "Книгу Фанфиков [ficbook.net] ", там вы вполне сможете найти себе сюжет по душе, только свяжитесь с автором фанфика и узнайте, согласен ли он на создание мода по его творчеству или нет

  Вполне возможно, что во время написания мода вы могли что-то где-то не так сделать и теперь у вас выдает ошибку, давайте разберемся в самых частых ошибках.

  Решение: Проверьте свой мод на то что везде у вас отступ не Tab, а 4 пробела

  Решение: Обычно при этой ошибке еще и указан номер строки, проверьте, закрыли ли вы ковычки на этой строке

  Решение: Проверьте, везде ли отступ по 4 пробела

  Решение: Проверьте команду в указанной строке

  Решение: Проверьте label и jump/call на наличие опечаток

  Пишите возникающие у вас ошибки и решения будут добавлены сюда

  Писать мод. не имея возможности самому его запустить и протестировать — по меньшей мере глупо.

  Для того чтобы игра увидела ваш мод просто обьявите в init: блоке следующую переменную

  Где:
  MOD ID — Любое английское слово
  Название мода — То, какое вы хотите видеть в меню игры

  Проверьте, что ваш мод начнется с метки с тем же названием, что и Mod ID

  Теперь, положив ваш .rpy файл в Everlasting Summer/game вы сможете запустить ваш мод, так же как и любой другой

  • Вам не нужно отдельно прописывать все файлы
  • Потенциально может сработать не только с изображениями, но и с музыкой
  • Имя файла задается по строго определенному алгоритму и если изображения предварительно были названы "как попало" то в получившихся именах "без бутылки и не разберешься"

  Хотели использовать в своем моде возможность самостоятельно выбирать игроком музыку? Пришли к тому выводу, что лучший выбор — телефон / mp3 плеер , а делать его реализацию на Ren’Py весьма муторно? Обрадую вас, такая возможность уже реализована самым "прошаренным" в вопросах Ren’Py человеком в этом гайде — Владей

  Скачать и посмотреть этот телефон можно по ссылке — Телефон [drive.google.com]

  Весь код снабжен комментариями и должен быть понятен
  Телефон выполнен в виде отдельного мода, но при желании его можно вытащить из .rpy файла и использовать у себя (Не забывайте про Полезный совет №1)

  • Готовая реализация переключения музыки прямо в игре.
  • Возможность настроить внешний вид телефона
  • На мой взгляд несколько "не эстетичная" кнопка "Достать телефон" (Можно допилить до ума)
  • При открытии телефона плейлист автоматически будет прокручен до самого низа

  Раздел был написан Автором руководства, с использованием контента от Владя, с его личного разрешения.

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

  Благодарности:
  Команде Sovet Games — За создание столь прекрасной визуальной новеллы
  Владя — Автору нескольких интересных модов, за помощь в дополнениии данного руководства
  �� Лена �� — за помошь в коментариях всем, кто столкнулся с затруднениями

  Полезные ссылки:
  Все используемые в руководстве ссылки -> Ссылка [drive.google.com]

  Задавайте в комментариях свои вопросы, в процессе ответов на них, руководство будет дополняться

  Похожие публикации:

  1. 5 тонн это сколько килограмм
  2. Как найти группу по id в вк
  3. Как узнать сколько ватт потребляет компьютер программа
  4. Маска в фотошопе как пользоваться