ru:api:room

Комната Salet

Класс SaletRoom - это основной класс комнат Salet.

2.0 Также см. класс Контейнер, который наследует Комната.

Количество раз, которое игрок посетил эту комнату. У новых комнат, конечно, равно 0.

ID комнаты. По этому уникальному ID движок может найти эту комнату. Обязательное свойство.

Название комнаты. Используется при генерации списка путей ("вы можете пройти в: …") и, возможно, при управлении историей браузера (зависит от браузера). Нужно, если вы используете свойство ways.

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

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

Приоритет; используется для сортировки вариантов выбора до того, как они будут отфильтрованы по maxChoices. Сортировка идёт по убыванию, поэтому комната с наибольшим приоритетом останется в списке.

Порядок; используется для сортировки вариантов выбора после того, как они отфильтрованы по maxChoices.

Флаг, который показывает, может ли игрок сохраниться в этой комнате. Если salet.autosave включён, то этот же флаг определяет, будет ли игра автоматически сохраняться в этой комнате. По умолчанию true.

Массив ID комнат, в которые можно выйти из этой комнаты. Связи односторонние, т.е. если выйти куда-то из этой комнаты, то вы не обязательно сможете вернуться тем же путём. По этому массиву игра автоматически делает список связанных комнат, который показывается отдельным блоком. Используйте функции link и bilink, чтобы управлять связями.

Перечисление тегов или комнат, по которому генерируется автоматический список вариантов выбора. Теги задаются в формате #тег; Salet уже ищет все комнаты, где в массиве tags есть тег. Комнаты задаются по ID без префиксов.

Пример: choices = '#капуста'

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

То есть, если maxChoices = 4, то в автосписке этой комнаты будет не больше четырёх вариантов.

Массив тегов, которые ассоциированы с этой комнатой, см. choices. Теги перечисляются без дополнительных модификаторов, т.е. не #тег, а тег

Пример: tags = ['жуть', 'ответ', 'капуста']

Текст ссылки, которая выводится в автоматическом списке вариантов выбора. Ссылка ведёт на эту комнату. Текст обрабатывается Markdown и может быть любым HTML.

(если функция) Аргумент: имя текущей комнаты

Описание комнаты. Выводится каждый раз при входе в комнату.

Флаг, который показывает, нужно ли продолжать предыдущую секцию при входе в комнату. Если false, то переход будет незаметным в транскрипте игры. По умолчанию true.

Флаг, который показывает, нужно ли очищать экран при входе в эту комнату. По умолчанию true.

Объект, который хранит обработчики ссылок вида _writer_*, _replacer_*, _inserter_*.

Ссылка вида _writer_<id> вызывает функцию writers.<id>, вывод которой записывается в конец транскрипта.

Ссылка вида _replacer_<id> вызывает функцию writers.<id>, которая заменяют текст транскрипта в блоке #<id> на свой вывод.

Ссылка вида _inserter_<id> вызывает функцию writers.<id>, вывод которых записывается в блок транскрипта #<id> (не в конце текста).

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

Функция вызывается каждый раз, когда игрок покидает комнату.

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

По умолчанию возвращает true. Может быть булевым значением, а не функцией.

Аргумент: ID комнаты, в которую вышел игрок

Системная функция, которая обрабатывает вход в комнату.

Аргумент 1: ID комнаты, из которой вышел игрок

Аргумент 2: флаг форсированного входа; если true, то canExit не проверяется. По умолчанию false

Системная функция, обработчик всех ссылок в этой комнате.

Аргумент: цель ссылки.

Системная функция, регистрирует комнату в списке комнат Salet.

Связывает эту комнату с указанной, добавляя связь в массив ways.

Аргумент: ID (name) комнаты.

Связывает эту комнату с указанной и указанную с этой, устанавливая двустороннюю связь. См. ways

Аргумент: ID (name) комнаты.

Вызывается перед выводом вариантов выбора в указанной комнате.

Возвращённое значение выводится в текст игры в формате Markdown.

Вызывается перед выводом вариантов выбора в указанной комнате.

Возвращённое значение выводится в текст игры в формате Markdown.

  • ru/api/room.txt
  • Последнее изменение: 2021/01/24 10:42
  • (внешнее изменение)