wiki.appsalutecreator.com - Вклад участника [ru]

Bubble Shooter

2017-03-16T08:21:05Z

Iskorobog: /* Пример проекта */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': неудача: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-16T08:20:50Z

Iskorobog: /* Пример проекта */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': неудача: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Isomover

2017-03-16T08:15:58Z

Iskorobog: /* Пример */

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в fail
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер Перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер Восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

===Пример===
Ознакомится с принципами работы isomover можно на примере следующего приложения. В isomap помещены два объекта isomover1 и isomover2. isomover2 совершает движение по определенному маршруту, заданному с помощью машины состояний iso2_mach (двигается из ноды p4 к заданной ноде p3 и совершает движение по кругу p3->p2->p8->p7->p3->...). isomover1 выходит из ноды p11 к заданной ноде p2 и ожидает клика на карту в точки "перекрестков" (по клику совершает движение к заданной ноде). Движение осуществляется с помощь машины iso1_navig. Во время движения isomover1 совершает атаку на isomover2, что описано в Добавленном свойстве объекта isomover1 "взаимодействие с другими объектами", если тот оказывается в достаточной близости (уничтожает его и двигается дальше). isomover2 будет "воскресать" после уничтожения и двигаться по заданному маршруту по истечению некоторого времени.
*'''Пример:
S:\!MOBILE\!!!EditorGames\Wiki_sample\Isomap.rar

[[Category:Main objects]]
[[Category:Game mechanic]]

Isomover

2017-03-16T07:50:41Z

Iskorobog:

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в fail
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер Перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер Восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

===Пример===
[[Category:Main objects]]
[[Category:Game mechanic]]

Isomover

2017-03-16T07:50:28Z

Iskorobog: /* Пример */

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в fail
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер Перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер Восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

[[Category:Main objects]]
[[Category:Game mechanic]]

Isomover

2017-03-16T07:50:03Z

Iskorobog:

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в fail
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер Перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер Восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

[[Category:Main objects]]
[[Category:Game mechanic]]
===Пример===

Isomover

2017-03-16T07:49:22Z

Iskorobog:

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в fail
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер Перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер Восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

===Пример===
[[Category:Main objects]]
[[Category:Game mechanic]]

Isomover

2017-03-16T07:41:39Z

Iskorobog: /* Добавляемые параметры */

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в fail
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер Перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер Восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

[[Category:Main objects]]
[[Category:Game mechanic]]

Isomover

2017-03-16T07:34:27Z

Iskorobog: /* Дополнительные параметры */

'''Isomover''' - [[Object|объект]] используется для осуществления движения и взаимодействия в изометрической карте.

Isomover обязательно должен быть подобъектом [[isomap]].

В проекте с картой ([[isomap]]) и движущимися по ней объектами (isomover) часто используют [[economics]] и [[eitems]] потому, что для завершения процессов часто требуется применить предмет или ресурс.

Начало движения множества изомуверов сильно нагружает систему, поэтому следует позаботиться, чтобы это происходило не в один момент времени. По возможности добавляйте небольшую и различную паузу каждому изомуверу перед стартом. 
==Основные параметры==
*'''Положение''' (''x'',''y'') - рекомендуется выносить isomover-объекты за пределы карты. Иначе, если объект должен появляться не сразу, то он будет просто стоять без движения
*'''Память''' - всегда должно быть значение 1, обязательное условие корректной работы. Это позволяет объекту двигаться последовательно, не инициализируясь после каждого движения в исходной точке
*'''тип ребра min''' (''edge_t_min'') - перемещаться по ребрам не ниже заданного, -1 не проверять
*'''тип ребра max''' (''edge_t_max'') - перемещаться по ребрам не выше заданного, -1 не проверять. Типы ребер задаются в isomap
*'''Старт''' (''start'') - точка старта, выбирается из списка точек Isomap
*'''Финиш''' (''finish'') - точка финиша, выбирается из списка точек Isomap
*'''Скорость (макс)''' (''vel_max'') - максимальная скорость, с которой передвигается объект Isomover
*'''Скорость''' (''vel'') - не использовать, вычисляется по формуле автоматически, позже будет скрыто. V = Vmax*(k+(1-k)*(P/Pmax))
*'''Жизнь (макс)''' (''pow_max'') - максимальная жизнь
*'''Жизнь''' (''pow'') - текущая жизнь, высчитывается по формуле автоматически
*'''Сохранять жизнь в опции''' (''powsave'') - если да, то объекты сцены сохранят уровень жизни при выходе со сцены и возвращении на нее
*'''Коэффициент скорости''' (''speed_k'') - коэффициент k в формуле расчета скорости. Чтобы скорость не зависела от значения жизни - указываем speed_k = 1
*'''Менять угол''' (''fixangle'') - изменение угла для предания плавности смены графики при дугообразном перемещении объекта. С появлением 3D-объектов больше не используется
*'''Тип''' (''mtype'') - объекты можно разделять на типы (люди, монстры, звери и т.д.). Взаимодействие происходит между объектами разных типов, настраивается в добавляемых параметрах
*'''Радиус''' (''mradius'') - значения радиуса. Попадание изомувера другого типа в этот радиус позволит начать взаимодействие.
*'''Цель при действии''' (''mtarget'') - мувер может быть целью взаимодействия пока сам действует
*'''Запретить действие''' (''disact'') - мувер не сможет перейти из acting_wait в acting
*'''Время появления''' (''appear_time'') - время в миллисекундах появления и исчезания изомувера (длительность перехода по alpha)
*'''Время провала''' (''fail_time'') - длительность анимации смерти объекта, по его окончанию произойдет переход в состояние ''disappear''
*'''Время паузы''' (''pause_time'') - длительность "заморозки" объекта
*'''Предмет паузы''' (''pause_item'') - предмет для включения паузы
*'''fail при 0 жизни''' (''zerofail'') - 1- при нулевом уровне жизни изомувер перейдет в fail, 0 - останется жив
*'''Не пересчитывать маршрут''' (''softrecalc'') - 1- при отключении ребер графа не произойдет пересчета маршрута, 0 - маршрут будет пересчитан
*'''Реагировать на''' (''tapreact'') - 1- на тап, 0- на клик
 

==Дополнительные параметры==
[[Файл:Isomover1.png|right|300px]]
*'''Графический ресурс:'''
**вверх (''res0'') - графический ресурс движения вверх
**вверх/вправо (''res1'') - графический ресурс движения вверх/вправо
**вправо (''res2'') - графический ресурс движения вправо
**вниз/вправо (''res3'') - графический ресурс движения вниз/вправо
**вниз (''res4'') - графический ресурс движения вниз
**вниз/влево (''res5'') - графический ресурс движения вниз/влево
**влево (''res6'') - графический ресурс движения влево
**вверх/влево (''res7'') - графический ресурс движения вверх/влево. Достаточно указать первые пять ресурсов, а остальные редактор отобразит автоматически симметрично
**деятельность (''resa'') - графический ресурс для состояния acting
**иконка персонажа (''char_ico'') - иконка, которая будет находится сверху над персонажем. Изменение масштаба во время игры не влияет на масштаб иконки. Рекомендуется создавать ее с пивотом у нижней границы, тогда при масштабировании не будет образовываться зазор между иконкой и графикой объекта
**смещение иконки персонажа (''char_ico_shift'') - смещение иконки по вертикали
**рисовать при действии (''resad'') - 1- мувер рисуется при состоянии acting, 0- не рисуется
**провал (''resf'') - графический ресурс состояния fail. Может быть картинкой или анимацией
**пауза (''resp'') - графический ресурс состояния pause
**восстановление жизни (''resheal'') - графический ресурс восстановления жизни
*'''3D ресурс'''
**модель (''mdl'') - трехмерный ресурс для отображения объекта
**scale x (''mdlSx'') - масштаб по оси ''x''
**scale y (''mdlSy'') - масштаб по оси ''y''
**scale z (''mdlSz'') - масштаб по оси ''z''
*'''Звуки'''
**всплывание подложки (''snd_panel'') - звук показывающейся подложки
**исчезание подложки (''snd_panel_hide'') - звук прячущейся подложки
**переход в acting (''snd_to_acting'') - звук перехода в состояние acting
**применение предмета (''snd_item_used'') - звук применение предмета при взаимодействии
**предмет при паузе (''snd_item_pause'') - звук применение предмета при паузе
**конец паузы (''snd_pause_end'') - звук при окончании паузы
**фейл взаимодействия (''snd_fail'') - звук при переходе в fail
**успех взаимодействия (''snd_success'') - звук при переходе в win
**клик (''snd_click'') - звук при клике
*'''Коэффициент скорости'''
**вертикальное (''speed_0'') - на этот коэффициент умножается скорость при вертикальном движении
**диагональное (''speed_1'') - на этот коэффициент умножается скорость при диагональном движении
**горизонтальное (''speed_2'') - на этот коэффициент умножается скорость при горизонтальном движении
Обычно горизонтальный коэффициент равен 1.00, чуть меньше диагональный и еще меньше вертикальный. Это необходимо для создания реалистичности движения относительно перспективы. То есть объекты, двигаясь вверх, как бы отдаляются от нас в глубь, поэтому по экрану они движутся медленней
[[Файл:Isomover2.png|right]]
*'''Таймер''':
**подложка (''digBg'') - фон для цифр таймера
**цифры (''digNorm'') - набор из 10-и цифр в виде ресурса анимации (клипа)
**двоеточие (''colNorm'') - графический ресурс двоеточия
**dx (''dx'') - смещение таймера по оси ''x'' относительно пивота изомувера
**dy (''dy'') - смещение таймера по оси ''y'' относительно пивота изомувера
**dx между цифрами (''digShift'') - расстояние между цифрами таймера
**dx от (''colShift'') - отступы числовых разрядов влево и вправо от двоеточия
**жизнь (''objlife'') - здесь выбирается объект типа прогресс_бар для отображения шкалы уровня жизни. Progress_bar создается отдельным объектом
Таймер позволяет отобразить время до окончания взаимодействия объектов. Например "корабль" прибыл в "порт" и начал отгружать груз. С помощью числового таймера или progress_bar можно увидеть через сколько закончится отгрузка. На рисунке справа показано взаимодействие двух объектов с изображение шкалы жизни одного из объектов и времени до конца взаимодействия.
*'''Преследование'''
**тип (''chasetype'') - тип объекта, который можно преследовать
**радиус (''chaseradius'') - если объект указанного типа окажется в этом радиусе, то начнется преследование (например полицейская погоня)
*'''Дорожное движение'''
**радиус (''stopradius'') - объекты, которые двигались по одному ребру, останавливаются на расстоянии этого радиуса (необходимо для препятствия наслоений объектов на дороге, железнодорожных путях)
*'''восстановление жизни''':
**критический уровень (''pow_min'') - Критический уровень жизни
**предмет (''pow_item'') - Предмет восстановления
**время (''pow_time'') - Время восстановления жизни

*курсор (''curs'') - Графический ресурс курсора текущего и всех дочерних объектов
*прокликиваемая (''passClk'') - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше" regexp="нет=0, да=1, обработать и пропустить=2
*группа (''gr'') - Группа, в которую входит текущий объект
*eitems (''eitems'') - Объект типа eitems
 

==Добавляемые параметры==
[[Файл:Isomover9.png|right|300px]]
[[Файл:+.png]] '''Взаимодействие с другими объектами''':
*тип (''mtype'') - тип объекта с которым по настроенному ниже сценарию будет происходить взаимодействие, -1 для любого типа
*min жизнь (''minlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*max жизнь (''maxlife'') - минимальное значение жизни для начала взаимодействия, -1 не проверять
*тип актив (''mtype_a'') - тип мувера, который активирует взаимодействие, если данный в процессе подготовки
*анимация (''res_a'') - анимация взаимодействия, например боя, разгрузки, разговора. Перетаскивается мышкой из редактора ресурсов
*старт тип (''stype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*старт таймер (''stimer'') - время, за которое нужно активировать взаимодействие тапом
*старт изм.жизни (''slife'') - скорость изменения жизни до активации взаимодействия тапом
*старт изм.жизни другого (''slife_o'') - скорость изменения жизни враг до активации взаимодействия тапом
*предмет (''item'') - предмет, необходимый для запуска активности. Актуально, когда имеется объект economics
*иконка (''ico'') - иконка активности
*смещение иконки (''ico_shift'') - смещение иконки активности по вертикали
*актив тип (''atype'') - тип старта взаимодействия
**0 - бесконечное ожидание тапа. Переход в состояние acting не начнется, пока не произойдет тап по объекту
**1 - автоматический переход в состояние acting
**2 - время, через которое произойдет переход из acting_wait в acting после начала взаимодействия объектов
**3 - переход по значению жизни
*актив таймер (''atime'') - время, которое длится взаимодействие
*актив изменение жизни (''alife'') - скорость изменения жизни текущего объекта (ед/сек) в состоянии active
*актив изменение жизни другого (''alife_o'') - скорость изменения жизни другого объекта (ед/сек) в состоянии active

[[Файл:Isomover3.png|right|300px]]
*объект инит (''obj'') - объект, состояние которого нужно изменить при переходе изомувера в acting_wait
*состояние инит (''st'') - новое состояние другого объекта
*объект старт (''obj_s'') - объект, состояние которого нужно изменить при переходе изомувера в acting
*состояние старт (''st_s'') - новое состояние другого объекта
*объект фейл (''obj_f'') - объект, состояние которого нужно изменить при переходе изомувера в состояние fail (проигрыш)
*состояние фейл (''st_f'') - новое состояние другого объекта
*объект успех (''obj_w'') - объект, состояние которого нужно изменить при переходе изомувера в состояние win (в случае победы)
*состояние успех (''st_w'') - новое состояние другого объекта
*дельта жизнь (''deltalife'') при успехе взаимодействия изменить значение жизни на эту величину
*переводить другой в фейл (''o_fail'') - 1- переводить цель действия в fail, 0- в idle
*переводить другой в мув (''o_move'') - при неудачном действии 1- переводить цель действия в move, 0- в idle
*можно ускорить (''canspeed'') - 1- действие можно ускорить. От этого параметра зависит, какое событие будет вызываться по клику на объект в состоянии acting
*звук ожидания (''snd_wait'') - звук, который будет воспроизводиться в состоянии acting_wait
*звук действия (''snd_act'') - звук, который будет воспроизводиться в состоянии acting
Для каждого типа объектов, с которыми взаимодействие возможно, необходимо добавить отдельный параметр "взаимодействие с другими объектами" и настроить его. Объекты инит, старт, фейл и успех вызываются при переходе текущего объекта в соответствующие состояния. Например, это может быть диалоговое окно, предлагающее продолжить взаимодействие, запуск дополнительных индикаторов, фейерверк в случае победы.

[[Файл:+.png]] '''Клик при простое''' (''nst_idle''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии idel
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_move''), он же '''клик при движении''':
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии move
*состояние - новое состояние объекта
[[Файл:+.png]] '''Клик при паузе''' (''nst_pause''):
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии pause (заморозка)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_aw_n'') он же '''клик при acting_wait, если другие действия не возможны'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting_wait
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_1'') он же '''клик при acting, ускорение возможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_a_2'') он же '''клик при acting, ускорение НЕвозможно'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии acting и ускорение не возможно
*состояние - новое состояние объекта
[[Файл:+.png]] '''Изменить состояние объекта''' (''nst_beact'') он же '''клик при beeng_acting'''
*объект - объект, состояние которого меняется, если изомувер был нажат в состоянии beeng_acting, когда воздействие совершалось над ним другим объектом
*состояние - новое состояние объекта
[[Файл:+.png]] '''Конец движения''' (''nst_finish''):
*объект - объект, состояние которого меняется, если изомувер закончил движение (достиг точки finish)
*состояние - новое состояние объекта
[[Файл:+.png]] '''Отправили в текущую ноду''' (''nst_place''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в fail''' (''nst_gopause''):
*объект - объект, состояние которого меняется, если изомувер перешел в pause
*состояние - новое состояние объекта
[[Файл:+.png]] '''Перешел в pause''' (''nst_heal''):
*объект - объект, состояние которого меняется, если изомувер восстановил здоровье
*состояние - новое состояние объекта
[[Файл:+.png]] '''Восстановил здоровье''' (''nst_low_time''):
*объект - объект, состояние которого меняется, если изомувер направлен в ту же ноду, в которой и находится
*состояние - новое состояние объекта
[[Файл:+.png]] '''Время истекло: изменить состояние объекта''' (''nst_low_time'') он же '''время на исходе: изменить состояние объекта''':
*значение, при котором срабатывает обработчик
*объект - объект, состояние которого меняется по истечению времени
*состояние - новое состояние объекта
 

==Состояния==
[[Файл:isomover_box.png|right|350px]]
*'''idle''' - дефолтное состояние, в которое isomover переходит после всех манипуляций. Недвижимым объектам следует передавать idle, чтобы они появились (нарисовались) на карте. Для движущихся объектов его практически не используют, объект сам рисуется с началом движения. 
*'''acting_wait''' - первое состояние взаимодействия (запускается первый таймер, анимация взаимодействия и ожидается старт). 
*'''acting''' - второе состояние взаимодействия (вызывается после применения предмета или клика, запускает второй таймер). 
*'''being_acted''' - в этом состоянии пребывает тот объект, над которым идет действие. Объект в этом состоянии невидим. 
*'''move''' - состояние движения от старта к финишу. 
*'''move_to_smooth''' - состояние движения от текущей ноды (или следующей, если объект идет) к финишу. 
*'''appear''' - показать по альфе за время появления. 
*'''disappear''' - скрыть по альфе за время появления. 
*'''prepare_acting''' - вызвать взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку. 
*'''start_acting''' - продолжить взаимодействие без оппонента. Перед вызовом нужно в поле param записать номер взаимодействия по порядку.
*'''pause''' - состояние "заморозки"
 

==Особенности работы==
[[Файл:Isomover6.png|right|300px]][[Файл:Isomover8.png|left|200px]]
Движение объекта типа ''isomover'' задается с помощью отдельной машины состояний через которую происходит управление состояниями move, acting и остальными. Рассмотрим на конкретном примере. У нас есть объект '''woman''' типа ''isomover''. Необходимо, чтобы наш изомувер начал движение с точки b1 и дальше начал двигаться бесконечно по кольцу b2-b3-b4-b5. Движение задается машиной состояний ''woman_machine''. 
Для управления циклическим ходом назначим дополнительный параметр ''ww''. Название параметра должно быть уникально и не совпадать с параметрами игровых объектов. 
Для того, чтобы изомувер двигался каждый раз к новой точке, необходимо повторно инициализировать его точку финиша. Однако, если мы продолжим указывать ему состояние move для движения, то каждый раз он будет начинать движение с точки старта. Чтобы это исправить воспользуемся состоянием move_to_smooth, которое заставляет двигаться изомувер от текущей ноде к финишу, будто старт и финиш мы все время смещаем на шаг.
 Основная логика будет находиться в состоянии ''circle_moving'' нашей машины. Надо сделать так, чтобы изомувер переходил в это состояние после движения по каждому из ребер. Для этого зайдем в свойства изомувера, нажмем правой кнопкой мыши и добавим параметр '''конец движения'''. У него есть поля ''объект'' и ''свойство''. Объект - машина состояний ''woman_machine'', состояние ''circle_moving'' этой машины. Таким образом, в конце каждого акта движения изомувер будет запускать состояние, в котором мы будем менять его точку финиша и запускать его движение.
 Не забываем, что все операции с переменными должны отделяться скобками, как и сама переменная 

[[Category:Main objects]]
[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:40:57Z

Iskorobog: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': неудача: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:31:00Z

Iskorobog: /* Файл:+.png кастомные параметры поля */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:28:46Z

Iskorobog: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:27:01Z

Iskorobog: /* Файл:+.png параметры хинта бомба удаляющая цвет к которому коснулась при выстреле */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:26:15Z

Iskorobog: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:25:14Z

Iskorobog: /* Файл:+.png параметры хинта бомба */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:22:41Z

Iskorobog: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:15:30Z

Iskorobog: /* Очковая система */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:11:24Z

Iskorobog: /* Ядро */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:08:16Z

Iskorobog: /* Цвет */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T08:06:12Z

Iskorobog: /* Мина */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:59:36Z

Iskorobog: /* Настройки */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''номер фрейма графики шариков''' - (clip_frame) Номер фрейма в клипе графики шариков.
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''подтип классического досыпания''' - (addrowt) Вид классического досыпания шариков (нормальное=0,с заполнениями пустот=1).
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''матч по цифрам''' - (nummatch) Матч по цифрам (нет=0, да=1).
*'''multColor''' - (multColor) умножать число сматченых шариков на номер цвета при подсчете очков (нет=0, да=1).
*'''removeDropWait''' - (removeDropWait)
*'''объект подложки''' - (objback) Объект подлжоки, которой будет передана графика и состояни выстрела и его окончания.
*'''включить анти-чит''' - (anti_cheat) Включить проверку на чит (нет=0, да=1).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''складывать строки''' - (is_summing) Включить сбор статистики (нет=0, да=1).Складывать ли наезжающие строки при выбивании нескольких цветов.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:44:04Z

Iskorobog:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:41:52Z

Iskorobog:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:40:50Z

Iskorobog:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.
'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:40:22Z

Iskorobog: /* настройки Lost Numbers */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.
'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=настройки Lost Numbers=
*'''время перекрашивания''' - (lnreptm)
*'''макс скейл перекрашивания''' - (lnrepmaxsc)
*'''перекрашивать сразу''' - (lnrepimm) нет=0, да=1

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:38:16Z

Iskorobog:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.
'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=настройки Lost Numbers=

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:35:28Z

Iskorobog: /* Курсор */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.
'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.
*'''минимальный скейл''' - (curminsc) минимальный скейл графики шариков
*'''максимальный скейл''' - (curmaxsc) максимальный скейл графики шариков
*'''время скалирования''' - (cursctm) время скалирования шариков

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-03-15T07:30:42Z

Iskorobog: /* BubbleShooter Setup */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.
'''Группа - Сохранения'''
*'''нужны''' - если '''да''', то сохраняет результаты игры в опции.
*'''сохранять глобально''' - (prof) Если ==0, то значение будет сохранено в текущий профиль, если 1 - то глобально.
*'''место''' - место в опциях, куда сохраняются данные игры.
*'''флаг старых сейвов''' - (old_records) Место в опциях, куда пишем флаг 1 , когда считали и отправили сейвы со старого бабл шутера

=Графика=
*'''красные шарики''' - графический ресурс шарика данного цвета.
*'''зеленые шарики''' - графический ресурс шарика данного цвета.
*'''синие шарики''' - графический ресурс шарика данного цвета.
*'''желтые шарики''' - графический ресурс шарика данного цвета.
*'''голубые шарики''' - графический ресурс шарика данного цвета.
*'''пурпурные шарики''' - графический ресурс шарика данного цвета.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Кол-во шариков''' - количество шариков в курсоре.
*'''Отражения''' - максимальное кол-во отражений от стенок.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.
*'''Очки в намберсах''' - объект, запускаемый в месте лопанья шариков.
*'''Очки в намберсах 2''' - объект с финальными очками, летящими в цель.

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего''' - Позиция стреляющего шарика (x;y)
*'''Расстояние от следующего''' - Расстояние от стреляющего шарика до следующего за ним.
*'''Высота физической сетки''' - Высота физической сетки поля.
*'''Ширина физической сетки''' - Ширина физической сетки поля.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''Мин.энергия''' - Мин.энергия выстрела. (или что-то в этом духе, более точной информацией обладает только создатель оригинального кода баббла)
*'''Макс.энергия''' - Макс.энергия выстрела.
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Тип досыпания''' - Тип досыпания шариков. Снукер или классический бабблшутер.
*'''Обваливать висячие''' - Обваливать висячие шарики (да/нет). Отключение этого параметра используется в игре снукер.
*'''Отскок от потолка''' - Название говорит само за себя. Используется в снукере.
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''intro''' - Звук в начале игры.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Говорит само за себя.
*'''Взрыв бомбы ядро''' - Говорит само за себя.
*'''Взрыв бомбы цвет''' - Говорит само за себя.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

=Добавляемые параметры=

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

===[[Файл:+.png]] Игра выиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при выигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра выиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при выигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Игра проиграна: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при проигрыше.
*'''Состояние''' - новое состояние объекта.

===[[Файл:+.png]] Игра проиграна: изменить параметр объекта===
*'''Объект''' - объект, параметр которого меняем при проигрыше.
*'''Параметр''' - параметр, который меняем.
*'''Значение''' - новое значение параметра.

===[[Файл:+.png]] Выбили цвет: изменить состояние объекта===
*'''Объект''' - объект, состояние которого меняем при удалении цвета с поля. При этом BSh передает указанному объекту параметр ''param_removed_colors'' со значением количества выбитых цветов за данный ход.
*'''Состояние''' - новое состояние объекта.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

=Пример реализации: задание уровня=

::'''1)''' Если нам необходимо задать уровень шутеру прямиком из экрана где он находиться, и при этом он уже запустился (прорисовалась графика). То с начало мы должны передать ему состояние end, после чего задать необходимый уровень и переинитить сцену на которой он находиться (желательно чтобы на этой сцене был только шутер):

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]