Блоки-функции
Блоки-функции - основной инструмент работы каждого разработчика, из которого состоит весь код игры.
Категории
Событие
Событием является те блоки-функции, с которых начинается последующий код. Большим отличием от других категорий является то, что блоки-функции из этой категории ставятся только на голубое стекло, то есть в начало строчки.
Действие
Действия являются неотъемлемой частью любого кода, поскольку только блоки-функции этой категории способны совершать какие-либо действия над игроками и игрой.
Условие
Условием является требование, только при выполнении которого продолжится работа кода. Также используется условием для выбора объекта специальным действием.
Синтаксис
Синтаксисом является правильная установка блоков-функций для работоспособного кода.
- Блоки-функции с категорией "Событие" всегда ставятся только вначале (на голубое стекло);
- Блоки-функции с категорией "Условие" и "Действие" ставятся только на светло-серое стекло;
- Поршни - пределы условия. Если Действие нужно выполнять только при достижении определённого условия, то Действие нужно поставить между поршнями условия;
- Одновременных Условий может быть много, главное, чтобы при установки Условия в Условии, количество конечных скобок соответствовало количеству условий
- Код, который идёт после "Выбрать объект", будет выполняться над выбранным объектом;
- Блок-функция Иначе ставится только после поршня Условия и не может быть установлена после себя.
Список событий
Событие игрока
Используется для активации кода в строчке в момент выполнения события.
Примеры использования
- Игрок зашёл в игру;
- Моб заспавнился;
- Игрок передвинулся.
Функция
Используется для вызова заранее заготовленного кода, который часто повторяется в коде или для того, чтобы продлить строчку. Чтобы переименовать функцию, необходимо установить текстовой переменной нужное название и кликнуть ПКМ ею по табличке функции.
Примеры использования
- Оптимизация места в строчках и времени;
- Создание рекурсивной функции;
- Продолжение закончившейся строчки.
Цикл
Используется для множественного повторения одного и того же действия с указанным промежутком. Чтобы установить промежуток, необходимо взять в руки числовую переменную и установить ей нужный временной промежуток в тиках.
Примеры использования
- Таймер, по истечению которого происходят определённые действия;
- Регулярное обновления разных способов коммуникации типа скорборда;
- Выполнение однотипных игровых проверок.
Список действий
Действие игрока
Используется для манипуляций над игроком. Поддерживает интегрированную выборку.
Примеры использования
- Отправить сообщение;
- Изменить режим игры;
- Кикнуть из игры.
Игровое действие
Используется для изменения настроек мира, спавна сущностей и т.д.
Примеры использования
- Действия со скорбордами;
- Изменение времени и погоды в мире;
- Спавн различных сущностей и NPC.
Присвоить переменную
Используется для установки значения динамической переменной.
Примеры использования
- Установить значение переменной;
- Сгенерировать случайное число между двумя числами;
- Изменить координату.
Выбрать объект
Используется для выбора объекта, с которым будет работать последующий код.
Примеры использования
- Выбрать всех игроков/мобов/сущностей;
- Выбрать игрока/моба/сущность по условию;
- Выбрать последнего заспавненного моба.
Вызвать функцию
Используется для вызова заранее созданной функции.
Примеры использования
- Продление строчки кода;
- Синхронный или асинхронный запуск функции;
- Создание рекурсивнй функции.
Список условий
Если игрок
Используется для установки условия игрока, при выполнении которого продолжается исполнение кода.
Примеры использования
- Проверяет, приседает ли игрок;
- Проверяет, равно ли сообщение игрока другому значению;
- Проверяет, ломает ли игрок проверяемый блок.
Если переменная
Используется для сравнения различных значений.
Примеры использования
- Проверяет, больше ли одно число другого;
- Проверяет, содержит ли один текст другой;
- Проверяет, существует ли переменная.
Иначе
Активирует код в скобках "Иначе", если предыдущее условие не соответствует заданным значениям.
Примеры использования
- Проверка одного значения в случае несоответствия другого.
Если существо
Используется подобно условию "Если игрок", но распространяется уже только на сущности.
Примеры использования
- Проверяет, равняется ли сущность указанному типу;
- Проверяет, является ли сущность мобом/NPC/снарядом;
- Проверяет, равно ли имя сущности заданному значению.
Если игра
Используется для проверки игровых значений.
Примеры использования
- Проверяет, стоит ли указанный блок на указанном месте;
- Проверяет, содержит ли сундук указанный предмет;
- Проверяет, содержит ли табличка указанный текст.
