[MZ] Сборник рецептов для добавления «ЭкшОна» в игру (и некоторые размышления)

**Darchan Kaen** · 30.03.2022, 18:55

И снова здравствуйте.

В данном тексте мне хотелось «закруглить» свое мини-исследование мукера, дать готовые к употреблению/модификации рецепты, и где-то немножко порассуждать (поныть то есть).

Текст является чем-то средним между туториалом, сборником рецептов и статьей и состоит из нескольких частей:
0. Предисловие
1. Подготовительная часть (теоретическая и техническая информация).
2. Практическая часть («сборник рецептов»).
3. Нюансы по практической части.
4. Послесловие

Читать все их подряд не обязательно: например, если вы знаете, что из себя представляет RPG Maker как платформа, можно пропустить Теоретическую часть, а если знаете внутренние структуры мейкера ($gameMap, $dataMap, $dataItems, итд) – можно пропустить Техническую часть. Но нюансы все таки прочитайте, если будете применять «рецепты» - чтоб потом не удивляться.

Приготовьтесь к тому, что многие вещи могут быть для вас очевидны и / или банальны. Буков будет много.

Спойлер 0. Предисловие:

**Darchan Kaen** · 30.03.2022, 18:57

Спойлер 1. Подготовительная часть:

**Darchan Kaen** · 30.03.2022, 19:00

Спойлер 2. Практическая часть:

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

Большая часть кода практически использовалась в игре “ALWBAW”, ее же можно рассматривать как демо-версию – игра не зашифрована, ее можно открыть редактором (подбросив файл проекта MZ); если будете открывать – особый интерес представляют первые три «технические» карты и Общие события. Игру можно найти на данном форуме, на Светлой полосе, на Юнионе.
Если «рецепт» в реальной игре не тестировался – это будет указано отдельно.
Демо-игра также использует логику «сопартиец-как-патрон», что в рамках данного туториала рассматриваться не будет.

В существенной части рецептов используется применение скрипта в Маршруте эвента и тот факт, что на скорость исполнения маршрута влияет частота эвента. Также используется возможность хранения и записи текста в Примечании эвента. Кроме того, для ряда рецептов (прыжок, платформы) используется задание регионов на карте – во всех примерах корректным является регион с номером «1» (это тоже можно менять).

У каждого эвента-врага специальным образом заполнено Примечание и две страницы – первая, активируемая лок. переключателем «A» активная и вторая, активируемая лок. переключателем «B» не активная (враг уничтожен).
У эвентов-"пулек" и эвентов-"бомб" - три страницы, первая пустая не активная (но уже с нужной графикой!), вторая и третья как у эвентов-врагов

Номера функций в примерах кода взяты из игры, вы можете ставить любые. Код приводится в «сжатом» варианте – гарантированно влезает в команду «Скрипт» на MZ. Скриншотов не будет.
Код, как и логику что он реализует, может быть не оптимальна.

Спойлер Рецепт №1. «Прыжок с проверкой допустимости конечной точки»:

Цель:
Игрок прыгает на N-клеток вперед в сторону, которую повернут лицом (это называется «направление» в контексте мейкера) и только в том случае, если конечная точка допустима для приземления (чтоб не оказаться в стене, яме, итд). Направление передается из вызывающего кода.

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

Код функции Прыжка:

Код:

$gameVariables.setValue(10, (direction) => {
let jumpRadius = 3; let playerEndpointCoords = [];
if(8 === direction){ playerEndpointCoords = [$gamePlayer._x, $gamePlayer._y - jumpRadius];
}else if(6 === direction){ playerEndpointCoords = [$gamePlayer._x + jumpRadius, $gamePlayer._y];
}else if(4 === direction){ playerEndpointCoords = [$gamePlayer._x - jumpRadius, $gamePlayer._y];
}else if(2 === direction){ playerEndpointCoords = [$gamePlayer._x, $gamePlayer._y + jumpRadius];
}
let playerEndpointRegionId = $gameMap.regionId(playerEndpointCoords[0], playerEndpointCoords[1]);
if(1 === playerEndpointRegionId){
let jumpCoordX = playerEndpointCoords[0] - $gamePlayer._x;
let jumpCoordY = playerEndpointCoords[1] - $gamePlayer._y;
if(undefined !== jumpCoordX && undefined !== jumpCoordY){
$gamePlayer.jump(jumpCoordX, jumpCoordY);
$gameScreen.startShake(7, 7, 15); AudioManager.playSe({ name: 'Earth1', volume: 60, pitch: 100, pan: 0 });
}else{ AudioManager.playSe({ name: 'Buzzer1', volume: 60, pitch: 100, pan: 0 }); }
}else{ AudioManager.playSe({ name: 'Buzzer1', volume: 60, pitch: 100, pan: 0 }); }
});

Что можно улучшить:
Можно задать динамическую дальность прыжка, храня «радиус» в отдельной переменной. Можно сделать так, что в случае некоррктности конечной клетки, проверяется корректность предыдущий…и игрок прыгает хоть как-то. Можно хранить стартовые (до-прыжковые) координаты игрока в отдельной переменной.

Спойлер Рецепт №2. «Клонирование эвента с его последующей активацией»:

Цель:
Создать новый эвент программно, по образцу уже существующего. При этом существующий эвент «не активен», т.е. первая страница пуста, а для работы он требует включеный локальный переключатель «A». При этом новый эвент создается по конкретным координатам с конкретным направлением. Id эвента для копирования, необходимые координаты и направление передаются из вызывающего кода.

Логика:
Копируем эвент, задаем ему новый случайный Id (цифры 1000 и 500 произвольны и исходят из кол-во ОБЫЧНЫХ, не клонированных, эвентов на карте), вставляем его в массивы эвентов игровые объектов $dataMap и $gameMap (для второго предварительно нужно создать новый «игровой» эвент), задаем новому эвенту направление, перемещаем в координаты, включаем у него «активный» локальный переключатель и обновляем графику всех эвентов на карте (сцене), тем самым делая клонированный эвент видимым.

Код функции Клонирования:

Код:

$gameVariables.setValue(5, (eventToCloneId, cloneInCoordX, cloneInCoordY, cloneInDirection) => {
let eventToCloneData = $dataMap.events[eventToCloneId]; 
let clonedEventData = {...eventToCloneData};
let newId = eventToCloneId + Math.floor(Math.random() * 1000 + 500); 
if($dataMap.events.length < newId){ $dataMap.events.length = newId; }
$dataMap.events[newId] = clonedEventData;
let clonedMapEvent = new Game_Event(this._mapId, clonedEventData.id);
clonedMapEvent._direction = cloneInDirection;
clonedMapEvent.locate(cloneInCoordX, cloneInCoordY);
$gameMap._events.push(clonedMapEvent);
$dataMap.events[$dataMap.events.length - 1].id = newId; 
$gameMap._events[$gameMap._events.length - 1]._eventId = newId;
$gameSelfSwitches.setValue([$gameMap._mapId, newId, 'A'], true);
SceneManager._scene._spriteset.createCharacters();
});

Что можно улучшить:
Вероятно, можно улучшить генерацию случайного Id для нового эвента, введя доп. проверки на наличие таких Id.

Спойлер Рецепт №3. «Понижение ХП игрока, урон по игроку»:

Спойлер Рецепт №4. «Шипы»:

Спойлер Рецепт №5. «Движущиеся платформы»:

Спойлер Рецепт №6. «Жив ли враг»:

Спойлер Рецепт №7. «Уменьшение ХП врага»:

Цель:
Уменьшение характ-ки ХП эвента-врага. Id врага-эвента задается извне, как и урон.

Логика:
Получаем Примечание нужного эвента (по его Id), парсим и читаем Примечание, уменьшаем ХП, записываем обратно в Примечание эвента.
Если ХП в результате меньше 0, то показываем на врага анимацию, включаем его «побежденный» переключатель «B», делая его тем самым неактивным, и приплюсовываем к переменной для кол-ва уничтоженных врагов единицу (если номер переменной равен 0, он игнорируется мейкером).
ХП возвращается из ф-ии, т.к. это нужно для "бомбы".

Код функции Уменьшения ХП врага:

Код:

$gameVariables.setValue(3, (enemyEvent, damageValue = 1) => {
let enemyData = $dataMap.events[enemyEvent._eventId].note;
if(0 === enemyData.length){ return false; }
let enemyDataObj = JSON.parse(enemyData);
let enemyHp = parseInt(enemyDataObj.hp);
if(0 === enemyHp ){ return false; } 
enemyHp -= damageValue;
enemyDataObj.hp = enemyHp;
$dataMap.events[enemyEvent._eventId].note = JSON.stringify(enemyDataObj);
if(enemyHp <= 0){ 
if('ENEMY' === enemyDataObj.type){ $gameTemp.requestAnimation([enemyEvent], 58); }
$gameSelfSwitches.setValue([$gameMap._mapId, enemyEvent._eventId, 'B'], true);
let countVarId = parseInt(enemyDataObj.countVarId); $gameVariables.setValue( countVarId, ($gameVariables.value(countVarId) + 1) );
}
return enemyHp; 
});

Что можно улучшить:
Проверку по ХП. Возможно, добавить в «объект врага» кроме переменной – включение какого-то переключателя, это может быть полезно для Боссов.

Спойлер Рецепт №8. «Удар игроком врага в ближнем бою»:

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

Логика:
Логика делится на две части:
1) Получения массива координат, в которых будет проходить поиска врагов; это и есть дальность и «радиус» удара; тут он не только перед игроком, но еще и по диагонали влево и вправо – для удобства. Массивы высчитывается исходя их координат игрока и его направления.
2) По найденному массиву координат проходимся циклом, записываем его в массив найденных врагов. После чего проходимся уже по нему и для каждого найденного врага, проверяем жив ли он, и если да – наносим урон по эвенту-врагу и проигрываем анимацию.
Перед вызовом скрипта с кодом атаки в ближнем бою, опционально, можно проиграть анимацию средствами команд мейкера.

Код атаки врага в ближнем бою:

Код:

let getCoordsList = $gameVariables.value(1); let isEnemyyAlive = $gameVariables.value(2)
let changeEnemyHP = $gameVariables.value(3);
let coordsList = getCoordsList($gamePlayer); 
let enemiesList = [];
for(let n = 0; n < coordsList.length; n++){
let currentEnemy = $gameMap.eventsXy(coordsList[n][0], coordsList[n][1]);
if(currentEnemy.length > 0){
enemiesList.push(currentEnemy[0]);
}
} 
enemiesList.forEach(enemy => { 
if(true === isEnemyyAlive(enemy)){
$gameTemp.requestAnimation([enemy], 1); 
changeEnemyHP(enemy); 
}
});

Код функции Получения массива координат перед игроком:

Код:

$gameVariables.setValue(1, (player) => {
let direction = player._direction;
let coordsList = [];
if(8 === direction){
coordsList = [ [player._x - 1, player._y - 1], [player._x, player._y - 1], [player._x + 1, player._y - 1] ];
}else if(6 === direction){
coordsList = [ [player._x + 1, player._y - 1], [player._x + 1, player._y], [player._x + 1, player._y + 1] ];
}else if(4 === direction){
coordsList = [ [player._x - 1, player._y - 1], [player._x - 1, player._y], [player._x - 1, player._y + 1] ];
}else if(2 === direction){
coordsList = [ [player._x - 1, player._y + 1], [player._x, player._y + 1], [player._x + 1, player._y + 1] ];
}
return coordsList;
});

Что можно улучшить:
Можно сделать несколько видов оружия ближнего боя и, в зависимости от выбранного оружия, менять массив координат для урона (оружие бьет вокруг, бьет с дальностью 2 клетки, бьет букой «Г», итд).

Спойлер Рецепт №9. «Удар врагом игрока в ближнем бою»:

Цель:
Эвент-враг атакует игрока, находящегося рядом, понижая его ХП.

Логика:
Логика схожа с логикой удара игроком эвента.
Сначала, исходя из координат атакующего эвента, получаем массив возможных координат атаки (функция в Рецепте №9).
После чего для каждого варианта координат сверяем, совпадают ли они с координатами игрока и если да, то проигрываем на игрока анимации и снижаем его ХП. Опционально, в зависимости от направления эвента, проигрывается анимация «взмаха» оружием.
Все это делает эвент-враг функцией, которую вызываем в маршруте (например: повторяющиеся шаг к игроку и вызов функции).
Мне показалось, что оптимальная частота здесь не максимальная, а высокая.

Код для маршрута:

Код:

let meleeEnemyAttack = $gameVariables.value(11); meleeEnemyAttack(this);

Код функции Атаки врагом игрока в ближнем бою:

Код:

$gameVariables.setValue(11, (enemyEvent) => {
let getCoordsList = $gameVariables.value(1);
let damagePlayer = $gameVariables.value(9);
let coordsList = getCoordsList(enemyEvent);
let direction = enemyEvent._direction;
for(let n = 0; n < coordsList.length; n++){
if(coordsList[n][0] === $gamePlayer._x && coordsList[n][1] === $gamePlayer._y){
if(8 === direction){ $gameTemp.requestAnimation([enemyEvent], 122); 
}else if(6 === direction){ $gameTemp.requestAnimation([enemyEvent], 125); 
}else if(4 === direction){ $gameTemp.requestAnimation([enemyEvent], 124); 
}else if(2 === direction){ $gameTemp.requestAnimation([enemyEvent], 123); 
}
$gameTemp.requestAnimation([$gamePlayer], 1); 
damagePlayer();
}
} 
});

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

Спойлер Рецепт №10. «Выстрел игрока и/или врага»:

Спойлер Рецепт №11. «Тикающая бомба»:

Цель:
При активации скрипта, на месте игрока / врага создается эвент-бомба, «взрывающийся» через некоторое количество времени.

Логика:
Логика схожа с логикой выстрела, т.к. для клонирования используется специальный объект-«часовая бомба», у которой тоже маршрут со скриптом, и которая тоже наносит себе же урон. При достижении 1 ХП и происходит «взрыв», нанося урон всем (и игроку, и эвентам-врагам) в заданном радиусе.
А еще бобма прыгает в процессе "тикания".

Код для «призыва бомбы»:

Код:

$gameVariables.setValue(15, (enemyEvent) => {
const EVENT_TO_SPAWN_ID = $gameVariables.value(28);
let getFaceSideCoords = $gameVariables.value(4);
let spawnEvent = $gameVariables.value(5); 
let direction = enemyEvent._direction;
let coordsForSpawn = getFaceSideCoords(enemyEvent);
spawnEvent(EVENT_TO_SPAWN_ID, coordsForSpawn[0], coordsForSpawn[1], direction);
AudioManager.playSe( { name: 'Bite', volume: 90, pitch: 100, pan: 0 } );
});

Код для маршрута «бомбы»:

Код:

let tickBombEvent = $gameVariables.value(7); tickBombEvent(this);

Код функции Тикания «бомбы»:

Код:

$gameVariables.setValue(7, (bombEvent) => { let isEnemyAlive = $gameVariables.value(2); let decreaseHp = $gameVariables.value(3);
let hp = decreaseHp(bombEvent); bombEvent.jump(0, 0); 
let bombRadius = [ [bombEvent._x - 1, bombEvent._y - 1], [bombEvent._x, bombEvent._y - 1], [bombEvent._x + 1, bombEvent._y - 1],
[bombEvent._x - 1, bombEvent._y], [bombEvent._x, bombEvent._y], [bombEvent._x + 1, bombEvent._y],
[bombEvent._x - 1, bombEvent._y + 1], [bombEvent._x, bombEvent._y + 1], [bombEvent._x + 1, bombEvent._y + 1], ];
let enemiesList = [];
if(1 === hp){
$gameTemp.requestAnimation([bombEvent], 66); 
for(let n = 0; n < bombRadius.length; n++){
let currentEnemy = $gameMap.eventsXy(bombRadius[n][0], bombRadius[n][1]);
if(currentEnemy.length > 0){
enemiesList.push(currentEnemy[0]);
}
if(bombRadius[n][0] === $gamePlayer._x && bombRadius[n][1] === $gamePlayer._y){
let damagePlayer = $gameVariables.value(9); damagePlayer();
$gameTemp.requestAnimation([$gamePlayer], 1); 
}
} console.log('enemiesList:', enemiesList);
enemiesList.forEach(enemy => { 
if(true === isEnemyAlive(enemy)){
$gameTemp.requestAnimation([enemy], 1); 
decreaseHp(enemy, 3); 
}
});
}
});

Что можно улучшить:
Не знаю, мне просто нравится как это работает.

Спойлер Рецепт №12. «Вывод информации»:

Спойлер Рецепт №DKR. «Бонус»:

Что еще можно сделать:
«Не вошедшее»
Бумеранг. Отражение «пулек» обратно в точку их старта. Телепорт-«крюк».
И все, на что вам хватит фантазии и силы в борьбе с мукером.

**Darchan Kaen** · 30.03.2022, 19:23

Спойлер 3. Нюансы по практической части:

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

1) Хоть мейкер и позволяет хранить функции в переменных, но «вешается», если таких функций будет много. Много, в моем случае, было равно 16. Пришлось делить объявление функций на три отдельных общих событий.
Что значит «вешается»? Перестает подгружать-применять изменение в коде функций. Может он их так хитро кэширует…но иначе я это побороть не смог.

2) Если у вас в игре есть перемещения по разным картам, то каждый раз после попадания игрока на карту с такой АБС, нужно заново вызывать событие инициализации всех функций. Поэтому событие с инициализацией (или которое вызываем Общее событие инициализации) нужно на карте ставить с «Удалением события» - это заставит его однократно отработать при КАЖДОМ перемещении на карту.

3) При большом количестве эвентов-врагов, особенно стреляющих-бомбистов, может лагать. Ограничивайте их кол-во или активируйте их при достижении определенного фрагмента карты.

4) Также при большом кол-ве эвентов может повторяться Id клонируемых, чем это чревато – я не знаю.

5) При использовании такого подхода в создании «АБС», может быть ситуация что эвент «удалится» быстрее чем нужно и будет игровая ошибка. Я не нашел решения этого вопроса, кроме как написание отдельного мини-плагина, оборачивающего ошибку (код плагина скопируйте в файл с расшерением .js и подключите к проекту):

Код:

Game_Event.prototype.findProperPageIndex = function() {
	try{
		const pages = this.event().pages;
		for (let i = pages.length - 1; i >= 0; i--) {
			const page = pages[i];
			if (this.meetsConditions(page)) {
				return i;
			}
		}
	}catch(exception){
		return -1;
	}
	return -1; 
};

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

**Darchan Kaen** · 30.03.2022, 19:26

Спойлер 4. Послесловие:

То есть нытье, субъективное.

Как я уже сказал, кроме того, что нам заботливо предлагает редактор с кнопками, сделать можно много чего, даже без плагинов. С плагинами, конечно, еще больше.

Встроенный API мейкера невелик, кривоват, неочевиден (особенно в графической части)…для меня, во всяком случае.

Так что создание каких-то «нестандартных» для мукера механик, это отдельный вид искусства, где не благодаря, а скорее вопреки.
Как говорит один мой друг – «мазохизм»(с)

И я надеюсь, что если Enterbrain / Kadokawa / Degica / кто сейчас владеет правами на серию /, будут развивать мейкер, они таки добавят больше универсальности в движок, увеличат хотя-бы в 2 раза поле ввода «Скрипта» и сделают более человеческий API.
А то в текущем состоянии движок похож на горизонт – манит «мнимой» полу-универсальностью, которую почти невозможно поймать за хвост.
И даже при таком положении дел некоторые делают почти невозможное, правильно комбинируя возможности движка, плагины и код (например, шутер «ALL CAN DIE»).

Но для своих нужд и официальных целей («rpg-игра без знания программирования») – все круто, Rpg Maker тащит.

Что для меня самое лучше в мукере? Кроме сотен плагинов…Комьюнити.
Комьюнити это лучшее, что есть у мейкера и за что его можно любить.

Спасибо за внимание и удачи нам всем в это нелегкое время.

Благодарности, без кого это мессиво текста было бы невозможным:

Комьюнити rpgmaker.su, rpgmaker.ru, rpgmakerunion.ru (практически, это одни и те же люди).

votetot – в одной из его игр, что была на RTP-2020 (название забыл, каюсь), меня впечатлило мастерство работы с движком и его графической частью…то был Vx Ace и это было круто. Да и другие его игры тоже круты, минимум в этом плане.

Phileas – за идею работы над плагинами…и еще одну.

Alx_Yago и Seibur – за идеи плагинов и помощь в реализации.

Посос – за механику головы-бумеранга в одной из игр («Nailed School»), мне стало интересно как это сделано, я подсмотрел…и понял, что таки можно сделать что-то нестандартной «из-коробки». Забыл, а потом как вспомнил.

Петр и Torontino - за идею конкурса "без плагинов", что заставила вспомнить о наличии команды "Скрипт" и вспомнить голову из пред. пункта; ну и первого также - за туториал по "Шипам", где параллельное событие используется (вроде он делал).

**votetot** · 04.04.2022, 14:01

Для увеличения поля ввода «Скрипта» можно прогой ResizeEnableRunner пользоваться, она не связана с мукером, но может растягивать любые окна в винде(если делать что-то для ртп конкурса наверно не пойдёт, но для личного пользования самое то)