Расширение цикла игры ct.js с инъекциями

Автоматически переведённая страница

К сожалению, на полный ручной перевод у нас не хватает ресурсов.
Если вы увидели ошибку — отправьте пул-риквест с исправлениями (ссылка для редактирования в конце страницы).

Инъекции являются мощным инструментом для расширения функциональности фреймворка ct.js за счет добавления методов или свойств. Это позволяет добавлять логику в игровой цикл, загружать ресурсы, создавать пакеты шаблонов и т.д.

В папке "injections" внутри каталога вашего модуля хранятся файлы с кодом, который будет внедрен при экспорте игры. Все они являются необязательными, и здесь представлен список всех возможных инъекций:

Общие события:

• load.js — вызывается один раз при загрузке кода игры, но еще ничего не произошло, например, ресурсы не были загружены;
• start.js — вызывается один раз при загрузке всех ресурсов игры. Логика игры еще не выполнялась.
• switch.js — вызывается каждый раз при переключении комнаты, но до выполнения любого другого кода. Здесь переменная "room" — это название новой комнаты.

События, специфичные для комнаты:

• beforeroomoncreate.js — вызывается перед созданием комнаты, но после установки камеры и рендера.
• roomoncreate.js — вызывается после входа в новую комнату. Этот код выполняется после пользовательского события OnCreate, когда были созданы все копии. Здесь "this" равно новой комнате.
• roomonleave.js — вызывается перед выходом из комнаты, но до выполнения любого пользовательского скрипта. Копии все еще существуют здесь.
• beforeroomdraw.js
• afterroomdraw.js
• beforeroomstep.js
• afterroomstep.js

События, специфичные для копии:

• onbeforecreate.js — применяется к только что созданной Копии перед ее событием OnCreate, но после применения типа информации. Работает с чистыми Копиями (копиями без шаблона) также.
• oncreate.js — применяется к только что созданной Копии сразу после своего собственного события OnCreate.
• ondestroy.js — применяется к Копии перед ее удалением. Этот код выполняется до события OnDestroy копии.
• beforedraw.js
• beforestep.js
• afterdraw.js
• afterstep.js

Шаблоны и утилиты:

• css.css — внедряет CSS в экспортируемую игру.
• res.js — вызывается один раз при парсинге загруженных изображений.
• resload.js — вызывается один раз после загрузки всех ресурсов.
• templates.js — здесь можно разместить свои собственные шаблоны.
• styles.js — здесь можно разместить свои собственные стили рисования.
• htmltop.html — этот код размещается прямо перед канвой рисования.
• htmlbottom.html — этот код размещается прямо после канвы рисования.

Также см. [Порядок вызовов с инъекциями модуля](event-order.html# порядок-вызовов-с-инъекциями-модуля) для более полной картины порядка вызовов.

Шаблонирование

Каждая инъекция может подменить специальную метку значением из ваших настроек. Если вы определили поле настройки с ключом enableSockets, то все совпадения с /*%enableSockets%*/ в файлах js, css и html будут заменены выбранным пользователем значением.

Будьте осторожны, так как поле может вернуть пустое значение. В JavaScript вы можете использовать этот обрамляющий символ, чтобы безопасно прочитать переменную без нарушения синтаксиса: [/*%enableSockets%*/][0]. Это вернет либо определенное значение, либо undefined.

Совет

Шаблонирование также поддерживается в вашем файле index.js.