Slotmachine

Slotmachine является объектом для реализации игр с механикой игровых автоматов. Slotmachine не просто управляет движением иконок на барабанах - он отвечает за анимацию выигранных линий и добавления новых линий для подсчета очков.

Общие параметры

(см. описание Object)

• тип - тип объекта
• имя - имя объекта
• синхронизация - синхронизация между лейаутами
• положение
  • x - положение объекта по оси х
  • y - положение объекта по оси y
• размер
  • w - ширина объекта в пикслях
  • h - высота объекта в пикселях
• модификаторы
  • alpha - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
  • angle - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
  • scale x - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
  • scale y - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
• вычислять размер (calcsize) - Вычислять размер исходя из ширины и высоты объекта или использовать размер картинок" calcsize: размер графики = 0, размер объекта = 1
• сдвиг по y (y_shift) - Смещение иконок по y.
• множитель скорости (speedm) - Множитель скорости для изменения направления вращения барабана.
• ' (') -
• эффект ячейки (effect_obj) - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
• доп. эффект ячейки (effect_obj2) - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов. Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
• эффект линии (line_obj) - Машина, обеспечивающая анимацию выигравших линий. Должна иметь состояния line_0 ... line_N (N от 4 до 24)

пример машины для анимации линий

• ribbon (ribbon_obj) - Объект типа Ribbon для эффекта линии.
• смещение ribbon (ribbon_y_shift) - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
• интрига:
  • множитель интриги (speedi) - Множитель скорости для режима интриги.
  • ячеек для интриги (numi) - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
  • эффект интриги (intrigue_obj) - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния hide_animation или в начале спина.
• рельсы - пять полей с номерами иконок. ВАЖНО: Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
  • рельса N (r1..r5) - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
• параметры вращения:
  • time (spin_t) - Время вращения левого барабана.
  • time step (spin_t_step) - Время на которое каждый последующий барабан крутится дольше предыдущего. (таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата)
  • time delta - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана.
  • vel min (min_vel) - Минимальная скорость вращения (левый барабан)
  • vel max (max_vel) - Максимальная скорость вращения (правый барабан).

• звуки:
  • барабан вращается (sndspin) - барабан вращается.
  • запуск барабанов (sndstart) - запуск барабанов.
  • остановка барабана (sndstop) - остановка барабана.
  • выигрыш (sndwin) - выигрыш.
  • проигрыш (sndfail) - проигрыш.
  • особая комбинация (sndspecial) - особая комбинация.

• иконка (slotico) - добавляемый параметр с настройками иконки:
  • графика (icores) - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
  • тип (icotype) - Тип иконки. 0 - обычная, 1 - Bonus, 2 - Wild, 3 - Scatter.

0 - обычная иконка. 1 - при выпадении 3 и больше иконок на барабанах не зависимо от их расположения - запускается бонусная игра (пока не реализовано). 2- бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины (пока не реализовано).

• • выигрыш (icowin) - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
  • эффект ячейки (icoeffect) - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
  • доп. эффект ячейки (icoeffect2) - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".

если эти поля не заполнены - используются эффекты по умолчанию

Пример:

0, 1, 0, 0 - за строку начисляется выигрыш (1), если подряд попадается одна такая иконка. 

0, 0, 10, 0 - за строку начисляется выигрыш (10 очков), если подряд попадаются две таких иконки. 

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.

пример расположения линий

Важно! Иконки в линии считаются слева направо. На изображении линии 6 и 7 перепутаны.

Текущий выигрыш можно узнать считав параметр current_win у объекта. Количество линий, эффект для которых нужно показать отображает параметр lines_num. Считывается у объекта. Обновляется каждый раз при выполнении next_line_effect.

состояния

• Основные:
  • spin - запустить барабаны
  • add_line - добавить еще одну линию как игровую. При этом автоматически запускается эффект линии и переводится в состояние, соответствующее номеру последней добавленной линии.
  • remove_line - убирает одну линию. Одна линия для проверки - минимум, убрать её нельзя.

Оба состояния add_line и remove_line передаются с параметром кол-ва линий. par=param val=кол-во линий, аналогично dval у counter.

• • clear - убрать все строки (кроме первой) для проверки выигрыша
  • next_line_effect - вызывает эффект для следующей линии. Одновременно с этим вызывается эффект для ячейки.
  • stop - остановить барабаны. Вызывается с параметром param от 0 до 4 для остановки конкретного барабана. Примечание: перевод объекта в состояния

add_line и clear во время вращения барабана - приводит к его остановке.

• • stop_all - останавливает барабаны и пересчитывает награду (выпавшие линии), предназначено для остановки барабана по рычагу/кнопке .
  • shuffle - новое начальное положение барабана (выбирается случайная иконка на всей рельсе и от неё отображаются иконки на всех рельсах).
  • hide_animation - спрятать все эффекты линии и ячейки, которые были склонированы. Удобно использовать при досрочном закрытии мини-игры. Если вам нужно открывать что-то поверх активного слота ( во время показа анимации), вам нужно эти окна положить в отдельную сцену поверх сцены со слотом, т.к. анимация копируется в сцену со слот машиной.
  • add_bet - увеличить ставку (значение ставки берется из соответствующего поля. Максимальное и минимальное значения зависят от уровня опыта игрока)
  • dec_bet - уменьшить ставку
  • start_free_spins - начать режим бесплатных спинов (если scatter_num > 0).
  • pause_free_spins - приостановить режим бесплатных спинов. Скопирует значение из scatter_num в опции по ключу slot%id%.saved_scatter. При этом scatter_num обнуляется.
  • resume_free_spins - продолжить бесплатные спины. Скопирует значение по ключу и вставит его в scatter_num.
  • autotest - для текущего lvlNum запустит автоматический спин с текущей ставкой и кол-вом линий N раз. N берется из param у объекта.
  • ' -
  • ' -

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

Меню выбора Добавляемые параметры к объектам активируется по правой кнопки мыши.

изменить состояние объекта - бросок завершен проигрыш - При current_win=0 по завершению вращения перевести слушателя в состояние.

• объект- объект - состояние которого меняем.
• состояние- состояние - значение нового состояния

изменить состояние объекта - бросок завершен выигрыш - При current_win!=0 по завершению вращения перевести слушателя в состояние.

• объект- объект - состояние которого меняем.
• состояние- состояние - значение нового состояния

иконка линии - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.

• объект- объект, у которого забираем положение.

эффект ячейки - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.

• клип- ресурс. Перетаскивается из базы ресурсов.

Графика в виде фреймовой анимации. Допустим у нас есть набор из 8-ми анимаций.

Работает такая логика при выборе графики:

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

2. Для всех последующих в этом спине выигранных линий — графика последовательно выбирается из набора (оставшейся графики) в произвольном порядке.

3. Если линий больше 8-ми — повторяем с первого пункта, выбирая первой графику отличную от 8-мой.

Пример:

1й спин — выпало 12 линий.

0, 2, 4, 3, 5, 7, 1, 6 … (начинаем не с 6) 4, 0, 3, 1

2й спин — выпало 6 линий.

(начинаем не с 0) 5, 6, 7, 1, 0, 3

где 0..7 — номера анимаций.