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

Slotmachine

2016-06-01T10:09:54Z

Beletsky: /* Автотест */

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

При этом ставка на линию чаще всего преобразуется в абсолютно аналогичный "множитель", а кол-во линий (хоть и будет называться coins) - фиксированная величина. Т.е для самой математики подсчета суммарной ставки - ничего не поменялось. Выплата так же будет зависеть от "множителя".

При этом сам выигрыш можно считать как наличие иконки определенного типа последовательно на рельсах без пропусков.

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[Файл:mermaid_free_spins_wild.png|200px|thumb|left]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

===Тип иконки 4===

Данный тип иконки нужен для начисления ресурса1 за выпадение N иконок на поле.
Т.е условия запуска механики такие же, как и для иконки scatter.
Но в данном случае начисляются не бесплатные спины, а ресурс.

А вот и пример:

<code>
<slotico icores="1080" icotype="4" icowin="0,0,0,0,0,0" type4val="3" type4min="0,0,0,1,5,10" type4max="0,0,0,3,15,20" type4text="2383" type4dx="-5" type4dy="45" icoobj="3566" icohide="1" icoeffect2="5409"/>
</code>

Обратите внимание, что массивы type4min и type4max - связаны.

Как это работает:
Выпало 3 иконки на поле.
Для них мы включаем эффект2, сами иконки прячем.
За каждую иконку начисляем от type4min[3] до type4max[3] суммарных ставок.
Суммарная ставка была 100 монет. Выпало три иконки. За первую мы начисляем 100, 200 или 300 монет. За вторую и за третью аналогично.
Поверх эффекта2 будет отрисован и проанимирован счетчик type4text, со значением равным выигрышу за каждую из иконок соответственно.
При этом счетчик будет смещен на type4dx и type4dy относительно центра иконки (которая совпадает с пересечением диагоналей ячейки).

==Автотест==

Запускается автотест из viewer путём вызова состояния *autospin* объекту слота.

Дополнительные параметры param - кол-во спинов, которые будут сделаны и param2 - кол-во итераций.

После начала режима создается файл возле options.xml с результатами автотеста, который заполняется по ходу работы.

Файл имеет название id из файла уровней _ кол-во спинов из param _ name из файла уровней _ месяц _ день _ часы _ минуты
Если на момент запуска новой итерации время не изменилось - идет дозапись в текущий файл.

Внутри csv-файла видим таблицу

{| class="wikitable" style="text-align: center"
|spin
|slot id
|lines
|line bet
|res1before
|res1after
|win
|type
|pos1
|pos2
|pos3
|pos4
|pos5
|bonus_num
|-
|номер спина
|id из файла уровней
|сколько линий
|какая ставка на линию
|баланс до спина
|баланс после спина
|выигрыш за спин
|тип спина r/f обычный/бесплатный
|позиция на рельсе1
|позиция на рельсе2
|позиция на рельсе3
|позиция на рельсе4
|позиция на рельсе5
|множитель бонусный игры, если был
|}

По окончанию итерации будет выведена краткая статистика:

return = отдача

free spins = кол-во бесплатных спинов

win spins = количество победных спинов

bonus spins = кол-во бонусных игр

big win = кол-во big win

mega win = кол-во mega win

[[Категория:Game mechanic]]

Slotmachine

2016-06-01T10:09:28Z

Beletsky: /* Автотест */

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

При этом ставка на линию чаще всего преобразуется в абсолютно аналогичный "множитель", а кол-во линий (хоть и будет называться coins) - фиксированная величина. Т.е для самой математики подсчета суммарной ставки - ничего не поменялось. Выплата так же будет зависеть от "множителя".

При этом сам выигрыш можно считать как наличие иконки определенного типа последовательно на рельсах без пропусков.

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[Файл:mermaid_free_spins_wild.png|200px|thumb|left]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

===Тип иконки 4===

Данный тип иконки нужен для начисления ресурса1 за выпадение N иконок на поле.
Т.е условия запуска механики такие же, как и для иконки scatter.
Но в данном случае начисляются не бесплатные спины, а ресурс.

А вот и пример:

<code>
<slotico icores="1080" icotype="4" icowin="0,0,0,0,0,0" type4val="3" type4min="0,0,0,1,5,10" type4max="0,0,0,3,15,20" type4text="2383" type4dx="-5" type4dy="45" icoobj="3566" icohide="1" icoeffect2="5409"/>
</code>

Обратите внимание, что массивы type4min и type4max - связаны.

Как это работает:
Выпало 3 иконки на поле.
Для них мы включаем эффект2, сами иконки прячем.
За каждую иконку начисляем от type4min[3] до type4max[3] суммарных ставок.
Суммарная ставка была 100 монет. Выпало три иконки. За первую мы начисляем 100, 200 или 300 монет. За вторую и за третью аналогично.
Поверх эффекта2 будет отрисован и проанимирован счетчик type4text, со значением равным выигрышу за каждую из иконок соответственно.
При этом счетчик будет смещен на type4dx и type4dy относительно центра иконки (которая совпадает с пересечением диагоналей ячейки).

==Автотест==

Запускается автотест из viewer путём вызова состояния *autospin* объекту слота.

Дополнительные параметры param - кол-во спинов, которые будут сделаны и param2 - кол-во итераций.

После начала режима создается файл возле options.xml с результатами автотеста, который заполняется по ходу работы.

Файл имеет название id из файла уровней _ кол-во спинов из param _ name из файла уровней _ месяц _ день _ часы _ минуты
Если на момент запуска новой итерации время не изменилось - идет дозапись в текущий файл.

Внутри csv-файла видим таблицу

{| class="wikitable" style="text-align: center"
|spin
|slot id
|lines
|line bet
|res1before
|res1after
|win
|type
|pos1
|pos2
|pos3
|pos4
|pos5
|bonus_num
|-
|номер спина
|id из файла уровней
|сколько линий
|какая ставка на линию
|баланс до спина
|баланс после спина
|выигрыш за спин
|тип спина r/f обычный/бесплатный
|позиция на рельсе1
|позиция на рельсе2
|позиция на рельсе3
|позиция на рельсе4
|позиция на рельсе5
|множитель бонусный игры, если был
|}

По окончанию итерации будет выведена краткая статистика:
return = отдача
free spins = кол-во бесплатных спинов
win spins = количество победных спинов
bonus spins = кол-во бонусных игр
big win = кол-во big win
mega win = кол-во mega win

[[Категория:Game mechanic]]

Slotmachine

2016-06-01T10:01:28Z

Beletsky: /* Автотест */

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

При этом ставка на линию чаще всего преобразуется в абсолютно аналогичный "множитель", а кол-во линий (хоть и будет называться coins) - фиксированная величина. Т.е для самой математики подсчета суммарной ставки - ничего не поменялось. Выплата так же будет зависеть от "множителя".

При этом сам выигрыш можно считать как наличие иконки определенного типа последовательно на рельсах без пропусков.

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[Файл:mermaid_free_spins_wild.png|200px|thumb|left]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

===Тип иконки 4===

Данный тип иконки нужен для начисления ресурса1 за выпадение N иконок на поле.
Т.е условия запуска механики такие же, как и для иконки scatter.
Но в данном случае начисляются не бесплатные спины, а ресурс.

А вот и пример:

<code>
<slotico icores="1080" icotype="4" icowin="0,0,0,0,0,0" type4val="3" type4min="0,0,0,1,5,10" type4max="0,0,0,3,15,20" type4text="2383" type4dx="-5" type4dy="45" icoobj="3566" icohide="1" icoeffect2="5409"/>
</code>

Обратите внимание, что массивы type4min и type4max - связаны.

Как это работает:
Выпало 3 иконки на поле.
Для них мы включаем эффект2, сами иконки прячем.
За каждую иконку начисляем от type4min[3] до type4max[3] суммарных ставок.
Суммарная ставка была 100 монет. Выпало три иконки. За первую мы начисляем 100, 200 или 300 монет. За вторую и за третью аналогично.
Поверх эффекта2 будет отрисован и проанимирован счетчик type4text, со значением равным выигрышу за каждую из иконок соответственно.
При этом счетчик будет смещен на type4dx и type4dy относительно центра иконки (которая совпадает с пересечением диагоналей ячейки).

==Автотест==

Запускается автотест из viewer путём вызова состояния *autospin* объекту слота.
Дополнительные параметры param - кол-во спинов, которые будут сделаны и param2 - кол-во итераций.

После начала режима создается файл возле options.xml с результатами автотеста, который заполняется по ходу работы.

Файл имеет название id из файла уровней _ кол-во спинов из param _ name из файла уровней _ месяц _ день _ часы _ минуты
Если на момент запуска новой итерации время не изменилось - идет дозапись в текущий файл.

Внутри csv-файла видим таблицу

{| class="wikitable" style="text-align: center"
|spin
|slot id
|lines
|line bet
|res1before
|res1after
|win
|type
|pos1
|pos2
|pos3
|pos4
|pos5
|bonus_num
|-
|номер спина
|id из файла уровней
|сколько линий
|какая ставка на линию
|баланс до спина
|баланс после спина
|выигрыш за спин
|тип спина r/f обычный/бесплатный
|позиция на рельсе1
|позиция на рельсе2
|позиция на рельсе3
|позиция на рельсе4
|позиция на рельсе5
|множитель бонусный игры, если был
|}

[[Категория:Game mechanic]]

Slotmachine

2016-06-01T09:35:43Z

Beletsky:

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

При этом ставка на линию чаще всего преобразуется в абсолютно аналогичный "множитель", а кол-во линий (хоть и будет называться coins) - фиксированная величина. Т.е для самой математики подсчета суммарной ставки - ничего не поменялось. Выплата так же будет зависеть от "множителя".

При этом сам выигрыш можно считать как наличие иконки определенного типа последовательно на рельсах без пропусков.

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[Файл:mermaid_free_spins_wild.png|200px|thumb|left]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

===Тип иконки 4===

Данный тип иконки нужен для начисления ресурса1 за выпадение N иконок на поле.
Т.е условия запуска механики такие же, как и для иконки scatter.
Но в данном случае начисляются не бесплатные спины, а ресурс.

А вот и пример:

<code>
<slotico icores="1080" icotype="4" icowin="0,0,0,0,0,0" type4val="3" type4min="0,0,0,1,5,10" type4max="0,0,0,3,15,20" type4text="2383" type4dx="-5" type4dy="45" icoobj="3566" icohide="1" icoeffect2="5409"/>
</code>

Обратите внимание, что массивы type4min и type4max - связаны.

Как это работает:
Выпало 3 иконки на поле.
Для них мы включаем эффект2, сами иконки прячем.
За каждую иконку начисляем от type4min[3] до type4max[3] суммарных ставок.
Суммарная ставка была 100 монет. Выпало три иконки. За первую мы начисляем 100, 200 или 300 монет. За вторую и за третью аналогично.
Поверх эффекта2 будет отрисован и проанимирован счетчик type4text, со значением равным выигрышу за каждую из иконок соответственно.
При этом счетчик будет смещен на type4dx и type4dy относительно центра иконки (которая совпадает с пересечением диагоналей ячейки).

==Автотест==

Запускается автотест из viewer путём вызова состояния *autospin* объекту слота.
Дополнительные параметры param - кол-во спинов, которые будут сделаны и param2 - кол-во итераций.

После начала режима создается файл возле options.xml с результатами автотеста, который заполняется по ходу работы.

Файл имеет название id из файла уровней _ кол-во спинов из param _ name из файла уровней _ месяц _ день _ часы _ минуты
Если на момент запуска новой итерации время не изменилось - идет дозапись в текущий файл.

Внутри csv-файла видим таблицу

{|spin||slot id||lines||line bet||res1before||res1after||win||type||pos1||pos2||pos3||pos4||pos5||bonus_num| - |номер спина||id из файла уровней||сколько линий||какая ставка на линию||баланс до спина||баланс после спина||выигрыш за спин||тип спина r/f обычный/бесплатный||позиция на рельсе1||позиция на рельсе2||позиция на рельсе3||позиция на рельсе4||позиция на рельсе5||множительно бонусный игры, если был|}

[[Категория:Game mechanic]]

Slotmachine

2016-06-01T08:29:13Z

Beletsky: /* Дополнительные настройки механик */

Slotmachine

2016-06-01T08:18:18Z

Beletsky:

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

При этом ставка на линию чаще всего преобразуется в абсолютно аналогичный "множитель", а кол-во линий (хоть и будет называться coins) - фиксированная величина. Т.е для самой математики подсчета суммарной ставки - ничего не поменялось. Выплата так же будет зависеть от "множителя".

При этом сам выигрыш можно считать как наличие иконки определенного типа последовательно на рельсах без пропусков.

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[Файл:mermaid_free_spins_wild.png]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

[[Категория:Game mechanic]]

Slotmachine

2016-06-01T08:17:33Z

Beletsky:

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

При этом ставка на линию чаще всего преобразуется в абсолютно аналогичный "множитель", а кол-во линий (хоть и будет называться coins) - фиксированная величина. Т.е для самой математики подсчета суммарной ставки - ничего не поменялось. Выплата так же будет зависеть от "множителя".

При этом сам выигрыш можно считать как наличие иконки определенного типа последовательно на рельсах без пропусков.

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[mermaid_free_spins_wild.png]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

[[Категория:Game mechanic]]

Файл:Mermaid free spins wild.png

2016-06-01T08:15:19Z

Beletsky:

Slotmachine

2016-06-01T06:30:44Z

Beletsky:

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>

===Дополнительные настройки механик===

[[Категория:Game mechanic]]

Slotmachine

2016-06-01T06:27:07Z

Beletsky: /* Состояния */

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>
[[Категория:Game mechanic]]

Slotmachine

2016-05-31T08:35:58Z

Beletsky:

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''''' -
** '''''' -

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - были бонусные ячейки''' - bonus_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

[[Файл:+.png]] '''изменить состояние объекта - конец фри спинов''' - scatter_num стал равен нулю. Не вызывается после паузы бесплатных спинов.

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

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

[[Файл:+.png]] '''изменить состояние объекта - начало вращения''' - после успешного начала спина вызываем обработчик.

[[Файл:+.png]] '''изменить состояние объекта - начало автоспинов''' - после успешного начала автоспинов.

[[Файл:+.png]] '''изменить состояние объекта - досрочное окончание автоспинов''' - автоспины были оборваны игроком.

[[Файл:+.png]] '''изменить состояние объекта - окончание автоспинов''' - указанное кол-во автоспинов закончилось.

[[Файл:+.png]] '''изменить состояние объекта - копилка заполнилась''' - копилка заполнилась.

[[Файл:+.png]] '''замена графики''' - объекты и графика для них в зависимости от режимов (обычный, бесплатные спины, интрига).
*'''объект''' - id объекта
*'''нормальная''' - графика обычного спина
*'''фриспины''' - графика бесплатного спина
*'''рельса интриги''' - порядковый номер подложки рельсы, начиная с самого левого барабана.
*''интрига'''' - графика режима "интрига".

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>
[[Категория:Game mechanic]]

Slotmachine

2016-05-31T08:18:51Z

Beletsky:

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''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)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

*'''авто спины''' -
** '''осталось спинов''' (''cntAutoSpins'') - сколько осталось спинов после запуска режима. Счетчик, который заполняется объектом и перерисовывается в начале каждого спина.
** '''задержка перед след. спином выигр''' (''autoWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''autoLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

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

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

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 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 у объекта.
** '''''' -
** '''''' -

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

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен проигрыш''' - При current_win=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

[[Файл:+.png]] '''иконка линии''' - При наличии объектов, которые каким-либо образом обозначают начало линии - указываем их через добавляемое свойство по порядку, начиная с нуля. Эффект линии в виде объекта ribbon будет рисоваться начиная (или заканчивая) этими объектами.
*'''объект'''- объект, у которого забираем положение.

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 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 — номера анимаций.
</pre>
[[Категория:Game mechanic]]

Slotmachine

2016-05-31T07:03:27Z

Beletsky:

Slotmachine

2016-05-30T14:13:48Z

Beletsky:

Slotmachine

2016-05-30T13:44:11Z

Beletsky:

Slotmachine

2016-05-30T12:42:01Z

Beletsky:

Slotmachine

2016-05-23T13:32:17Z

Beletsky: /* Общие параметры */

Flurry

2016-02-11T14:28:55Z

Beletsky:

{{TOC right}}
[[Object|Объект]] '''flurry''' используется для сбора статистики об использовании приложения.

По умолчанию записывает такие параметры как время сессии, количество сессий, устройство, версия ОС, количество пользователей, и представляет эти данные в виде графиков и таблиц. Также можно записать какие кнопки нажимались, время между нажатиями определённых кнопок. Для сбора общих данных достаточно добавить в соответствующем виде flurry-id приложения в app.icf или в viewer.xml соответствующей платформы перед сборкой. Для сбора данных о нажатиях кнопок и др. необходимо кроме добавления flurry-id приложения в app.icf или в viewer.xml соответствующей платформы, также добавить в проект объект типа flurry и передавать ему интересующие события.

Общая статистика на сервисе Flurry выглядит примерно так:

[[Файл:Flurry sum stat.jpg]]

==Параметры и состояния объекта flurry==

===Параметры объекта flurry===

Чтобы в игре установить сбор статистики нажатий определённых кнопок необходимо в редакторе сцен добавить объект Flurry (желательно на глобальный экран) и передать ему определённые параметры.
У объекта flurry есть 3 параметра которые можно задавать. Это:
* '''event''' - задаёт имя события
* '''param_name''' - задаёт имя параметра
* '''param_value''' - задаёт значение параметра
Для корректной работы сбора статистики с нажатия кнопки все три поля должны быть обязательно заполнены.
Рассмотрим принцип формирования названий событий на примере кнопки выбора пака в пазлах.

Параметр '''''event''''' должен обозначить общее название группы событий, на пример ''Pack_select'';

Параметр '''''param_name''''' должен указывать на конкретный параметр который будет записываться, в нашем случае его можно назвать ''pack_name'';

Параметр '''''param_value''''' задаёт конкретное значение параметра, на пример ''pack_1''.

===Состояния объекта flurry===

* '''event''' - отправляет накопленные данные

В самом объекте flurry можно задать начальные параметры, но при изменении его параметров те которые были - изменятся, а если до изменения параметров перевести объект flurry в состояние event, то на сервер статистики отправятся значения по-умолчанию, которые были записаны.

* '''send_log''' - отправляет файл walkthrough.log на сервер

В файл walkthrough.log флури пишет прохождение по игре: каждая строка лога содержит значения ключевых параметров (опыт, монеты, кристаллы, последний выполненный таск и т.д.) на момент записи, запись новой строки вызывается при наступлении различных событий (повышение уровня, начисление ресурса, выполнение задния и т.д.)

Внимание!!! В проекте, собранном без дебага, лог не пишется. Для логирования прохождения без дебага нужно в app.icf в группе Flurry указать log_walkthrough = 1 (это касается файла walkthrough.log). С дебагом будет логироваться вне зависимости от этого.

==Пример применения объекта flurry==

Пример того как кнопка отправляет на сервер информацию о том, что она была нажата:

[[Файл:Flurry button.jpg]]

В данном случае кнопка записывает событие, название параметра, значение параметра, и сразу отправляет на сервер статистики.

==Настройки приложения для отправки статистики==

'''Для отправки статистики также необходимо добавить flurry-id в app.icf или в viewer.xml соответствующей платформы.'''
Т.к. нагляднее выглядит статистика отдельно для платформы ios и отдельно для android, а также поскольку сервис предоставляет разные flurry-sdk для каждой из платформ, то flurry-id лучше всего вставлять в viewer.xml соответствующей платформы.

В app.icf необходимо добавить строки:

'''''[Flurry]'''''

'''''game_id="здесь указывается flurry-id приложения"'''''

или добавить в viewer.xml соответствующей платформы такую строку после globaltop, если таковой имеется, если его нет, то после настроек банеров (<banners platform_id="".../>):

'''''<flurry game_id="здесь указывается flurry-id приложения"/>'''''

==Реклама==

Управление показом рекламы идёт через объект типа [[Advertisement]].

В объекте [[Advertisement]] в качестве провайдера должен быть указан объект типа flurry и должны быть указаны '''тип''', '''space''', '''size'''.

Также в [[app.icf]] или [[viewer.xml]] должен быть указан flurry id приложения, согласно ему идет работа банерной системы.

Кроме этого в итоговый ''AndroidManifest.xml'' должны быть добавлены следующие строки:

<pre>

<activity android:name="com.flurry.android.FlurryFullscreenTakeoverActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode"
android:hardwareAccelerated="true" >
</activity>

</pre>

Также должно быть следующее разрешение:

<pre>

<uses-permission android:name="android.permission.INTERNET"/>

</pre>

==Примечания==

Исходя из значений параметров будет строиться на сервисе Flurry диаграмма по параметру указанному в ''param_name''. К примеру, если для одной кнопки зададим в ''param_value'' значение ''pack_1'', второй кнопке зададим значение ''pack_2'', то в итоге, на странице сервиса в статистике приложения в раздеде Events получим список событий, которые были записаны, если выберем событие и выберем отобразить статистику по параметрам, для наглядности в круговой диаграмме, то увидим круговую диаграмму с долями которые занимает определённый параметр. Доли высчитываются исходя из количества пришедших значений параметров, то есть если 3 раза придёт значение ''pack_1'' и один раз придёт значение ''pack_2'', то доля ''pack_1'' будет 75%, а ''pack_2'' - 25% .

Также можно выбрать из выпадающего списка по каким параметрам(которые указывались в '''''param_name''''' в рамках текущего имени события) необходимо отобразить статистику по значениям параметра.

[[Файл:Flurry ev stat.jpg]]

===Рекомендации Flurry к событиям===
* Составьте цели и план действий вокруг приложения
* Если Вы хотите изменять функционал - отслеживайте его
* Убедитесь что Вы собираете события вокруг навигации и монетизации
* Имена событий должны легко различаться и поддаваться категоризации
* Используйте временные события. Flurry автоматически разобьёт их по группам и Вы получите наглядную информацию.
* Не тратьте много времени на планирование. Вы можете добавить события позже.

[http://support.flurry.com/index.php?title=Analytics/GettingStarted/Events Рекомендации Flurry к параметрам]

=== Отправка объектом Economics Flurry событий и параметров ===

Объект Economicsавтоматически оправляет следующие Flurry события и параметры:

1) При достижении уровня - '''xplevel_ _reached''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*xplevel - Уровень опыта
*coins_spent_log - Сколько потрачено монет
*coins_left_log - Сколько осталось монет
*diams_spent - Сколько потрачено кристаллов
*diams_left - Сколько осталось кристаллов
*hints_used - Сколько хинтов использовано

2) При покупке в банке - '''purchase_ok_<item>''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*price_usd - Цена в долларах
*history - История покупок через запятую
*total_usd - Сколько суммарно потрачено денег
*last_location - Последняя локация
*last_task - Последняя мода
*was_discount - Была ли скидка
*from_hidden - 1-из хиддена, 0 -из меню
*last_anomaly - Последняя аномалия

3) При первой покупке энергии - '''1st_run_buy_energy''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя
*energy_left - Сколько осталось энергии

4) При первом использовании энергии - '''1st_run_use_energy''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя
*energy_left - Сколько осталось энергии

5) При покупке энергии - '''buy_energy''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_pric - Цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя

6) При покупке энергии - '''buy_energy''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_pric - Цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя

7) При покупке хинтов - '''buy_hints''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя
*from_game - 1- да, 0 -нет
*was_anomaly - 1 - да, 0 -нет

8) При покупке амулетов - '''buy_amulets''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя
*from_game - 1- да, 0 -нет
*from_main_menu - 1 - да, 0 -нет

9) При использовании амулетов - '''use_amulets''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*last_task_open - Последняя открытая таска
*last_loc - Последняя сыгранная локация
*xp_level - Уровень пользователя
*from_game - 1- да, 0 -нет
*from_main_menu - 1 - да, 0 -нет

10) При покупке чарджеров - '''buy_chargers''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*coins_price - Цена в монетках
*xp_level - Уровень пользователя

11) При покупке доступов к локациям - '''buy_keys''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*coins_price - Цена в монетках
*xp_level - Уровень пользователя

12) При покупке ингридиентов для крафта - ''' buy_Ingridients''' (buy_parts):
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*coins_price - Цена в монетках
*xp_level - Уровень пользователя

13) При покупке ингридиентов для крафта - ''' buy_Ingridients''':
*t_log_play - Время логарифмическое игровое
*t_log_cal - Время логарифмическое календарное
*id - Id предмета
*diams_price - Цена в кристаллах
*coins_price - Цена в монетках
*xp_level - Уровень пользователя

=== Перечень source для событий coins_get, energy_get, diams_get===

SOURCE_UNKNOWN = 0, //!< неизвестный источник
SOURCE_PURCHASE = 1, //!< покупка
SOURCE_HIDDEN_WIN = 2, //!< выигрыш в хиддене
SOURCE_MINIGAME_WIN = 3, //!< выигрыш в миниигре
SOURCE_DAILY_BONUS = 4, //!< дейли бонус
SOURCE_SOCIAL_BONUS = 5, //!< бонусы за социалку
SOURCE_CASINO = 6, //!< казино
SOURCE_EXCHANGE = 7, //!< биржа
SOURCE_DEPOSIT = 8, //!< депозит
SOURCE_COLLECTION_GOT = 9, //!< сдача коллекций
SOURCE_GUES = 10, //!< угадайка
SOURCE_TASK_COMPLETE = 11, //!< выполнена задача
SOURCE_TRIVIA = 12, //!< миллионер
SOURCE_REDEEM = 13, //!< начисление из админки
SOURCE_LEVEL_UP = 14, //!< достижение уровня
SOURCE_USE_ITEM = 15 //!< использование предмета

== Ограничения для разных сервисов статистики ==
* Flurry:
** 300 уникальных имен событий,
** 10 параметров,
на данный момент отображаются топ-500 значений параметров для каждого события
* FaceBook:
** 1000 уникальных имен событий,
** 25 параметров,
** Максимальное кол-во символов в значении параметра - 100
* Amazon:
** 1500 уникальных пользовательских имен событий
** 40 параметров,
** Максимальное кол-во символов в названии параметра - 50,
** Максимальное кол-во символов в значении параметра - 200

[[Category:Options]]
[[Category:Реклама]]

Wallet

2016-01-29T11:47:06Z

Beletsky: /* Параметры объекта Wallet */

[[Object|Объект]] '''Wallet''' необходим для начисления игровой валюты при InApp покупке через объект [[Economics]]

== Параметры объекта Wallet ==

*'''economics''' (''economics'') - ссылка на объект economics
*'''InApp - покупка'''
**'''Внутренний id покупки''' (''id'') - Внутренний id покупки
**'''Монеты''' (''res1'') - количество монет
**'''кристаллы''' (''res2'') - количество кристаллов
**'''поле в опциях для множителя''' (''multfield'') - ключ в опциях для множителя монет. ВАЖНО: указывать без идентификатора пользователя. Пример: ecomics65.stmult - без p0!
**'''базовая прибавка к статусу''' (''status'') - прибавка к статусным очкам
**'''множитель от уровня''' (''multlev'') - применять ли дополнительный множитель от уровня экономики. Т.е значение из
**'''эталонная цена''' (''price'') - цена in-app в валюте для подсчета потраченных игроком денег.
([http://wiki.appsalutecreator.com/index.php/Economics#.D0.A1.D1.82.D0.B0.D1.82.D1.83.D1.81 | Что такое статус и с чем его едят]). Базовая - потому что будет множиться на коэф., который зависит от текущего статуса. Коэф. указывается в экономики в соответствующем разделе.

== Принцип работы ==

На успех покупки объект Wallet проверяет внутренний id и если находит совпадение в добавляемых свойствах, то начисляет указанное там количество монет и кристаллов.

== Состояния ==

* ''recalc'' - перезаписать значения монет и статусных очков, учитывая множители.

Ключ в опциях:

* ''wallet%d.i%s.res1'' - ключ к значению монет, учитывая множитель.
* ''wallet%d.i%s.status'' - ключ к значению статусных очков, учитывая множитель.
* ''%player%.wallet_total_usd'' - ключ к сумме потраченных единиц валюты на in-app.

[[Category:Options]]

Wallet

2016-01-29T11:44:18Z

Beletsky: /* Состояния */

[[Object|Объект]] '''Wallet''' необходим для начисления игровой валюты при InApp покупке через объект [[Economics]]

== Параметры объекта Wallet ==

*'''economics''' - ссылка на объект economics
*'''InApp - покупка'''
**'''Внутренний id покупки''' - Внутренний id покупки
**'''Монеты''' - количество монет
**'''кристаллы''' - количество кристаллов
**'''поле в опциях для множителя''' - ключ в опциях для множителя монет. ВАЖНО: указывать без идентификатора пользователя. Пример: ecomics65.stmult - без p0!
**'''базовая прибавка к статусу''' - прибавка к статусным очкам ([http://wiki.appsalutecreator.com/index.php/Economics#.D0.A1.D1.82.D0.B0.D1.82.D1.83.D1.81 | Что такое статус и с чем его едят]). Базовая - потому что будет множиться на коэф., который зависит от текущего статуса. Коэф. указывается в экономики в соответствующем разделе.

== Принцип работы ==

На успех покупки объект Wallet проверяет внутренний id и если находит совпадение в добавляемых свойствах, то начисляет указанное там количество монет и кристаллов.

== Состояния ==

* ''recalc'' - перезаписать значения монет и статусных очков, учитывая множители.

Ключ в опциях:

* ''wallet%d.i%s.res1'' - ключ к значению монет, учитывая множитель.
* ''wallet%d.i%s.status'' - ключ к значению статусных очков, учитывая множитель.
* ''%player%.wallet_total_usd'' - ключ к сумме потраченных единиц валюты на in-app.

[[Category:Options]]

Slotmachine

2016-01-12T15:28:13Z

Beletsky:

Slotmachine

2016-01-12T15:06:06Z

Beletsky:

Использование AppSalute Debugger при отладке

2015-12-17T11:42:39Z

Beletsky:

Что такое debugger?

Debugger (он же отладчик) - это отдельное приложение, которое предназначено для поиска и локализации ошибок в работе приложения.

Зачем он нужен?

Это незаменимый инструмент в процессе отладки, ведь чаще всего нужно:

- Узнать текущее значение той или иной переменной.

- Выяснить по какому пути выполнялся код.

Что нужно сделать, чтобы начать пользоваться отладчиком?

Первоначально следует проверить настройки подключения к viewer, которые хранятся в теге [Game] в app.icf. Этот файл должен находится в корне директории с редактором.

Что я должен увидеть в этом файле?

Обязательным для работы является наличие двух строк в теге [Game]:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><tt>DebuggerIP="xxx.xxx.xxx.xxx" 
DebuggerPort=5322</tt></div>

Где <var>DebuggerIP</var> - это IP адресс машины, на которой запущен отладчик. А <var>DebuggerPort</var> - порт подключения, который остаётся неизменным!

DebuggerIP - может принимать несколько значений:

<ol>
<li>127.0.0.1 - т.е localhost, что не позволит использовать отладчик на удалённом устройстве, но прекрасно подойдет, если Вы не знаете IP машины, за которой работаете.</li>
<li>IP в локальной сети, который можно узнать у системного администратора. Этот является предпочтительным.</li>
</ol>

Что нужно сделать в SceneEditor, чтобы запустить отладчик?

Чтобы запустить режим отладки нужно нажать на кнопку в верхней панели. [[Файл:Debug_button.png]]

После чего откроется окно.

[[Файл:Debug_lock.png]]

А в конткестном меню (вызывается нажатием ПКМ) появятся новые строки.

[[Файл:Context_menu.png]]

Я запустил viewer, что делать дальше?

Нужно подключиться к "серверу", которым является Ваша рабочая машина с запущенным SceneEditor.exe.

Для этого нужно во viewer нажать F6.

Как узнать, что подключение успешно?

В окне отладки появится строка:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>connection successful!</code></div>

А за ней периодически будут появляться строки вида:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>viewer pinged</code></div>

Что я могу делать с помощью отладчика?

<ul>
<li>Первое и самое полезное - установка breakpoint.</li>
</ul>

Breakpoint - это остановка выполнения всей программы при определенных условиях. Пример: машина состояний перешла в другое состояние, переменная поменяла своё значение и т.д.

Важно помнить, что у нас существует возможность устанавливать breapoint только на машину состояний!

<ul>
<li>Запросить данные из GData любого объекта из дерева проекта.</li>
<li>Подсветить выбранный объект во viewer.</li>
</ul>

Как установить breakpoint?

Для этого в контекстном меню для выбранного объекта следует выбрать пункт Toggle breakpoint on every state.

Что автоматически задает условием остановки переход этой машины состояний в любое состояние.

Чтобы указать конкретное состояние - нужно в поле state вместо звёздочки указать имя состояния.

Вот так это выглядит в окне  отладчика.
[[Файл:Debug_lock.png]]
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Enabled - быстрое включение/отключение breakpoint. Важно: отключается при каждом запуске viewer!</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Object ID - ID объекта.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">State - состояние, в которое должна попасть машина состояний, чтобы сработала остановка. По-умолчанию - *, что означает, что остановка будет произведена при переходе в любое состояние.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Parameter - параметр, при изменении которого будет произведена остановка.</div>

Что происходит во время остановки?

Открывается окно, которое является точной копией окна настройки машины состояний, но недоступное для редактирование.

Дополнительно в первой колонке отображаются все параметры из GData машины.

Существуют два режима отображения в таком окне:

<ol>
<li>При переходе в новое состояние столбец с одноименным состоянием не заменяется, а все новые добавляются справа от текущего.</li>
<li>Заменяются столбцы с одноименным состоянием, а все параметры, которые поменяли своё значение - подсвечиваются красным.</li>
</ol>

Переключаться между режимами можно с помощью кнопки:
[[Файл:Btn_no_rewrite.png]] [[Файл:Btn_rewrite.png]]
Зачем нужна вторая вкладка Logging?

В этой вкладке мы видим окно отображения лога, которое обновляется в режиме реального времени.
[[Файл:Logging_dock.png]]
Каждый из столбцов обладает фильтром.

Чтобы добавить условие фильтрации нужно выделить стобец и в поле Filter вписать строку, при нахождении которой полная строка появится в окне.

Чтобы очистить лог нужно нажать на кнопку Clear Log [[Файл:Clear_log_btn.png]]

Чтобы открыть файл с логами нужно нажать клавишу с тремя точками и выбрать указать путь к нужному файлу в стандартном окне проводника операционной системы. [[Файл:Dots_btn.png]]

Использование AppSalute Debugger при отладке

2015-12-17T11:41:50Z

Beletsky:

Что такое debugger?

Debugger (он же отладчик) - это отдельное приложение, которое предназначено для поиска и локализации ошибок в работе приложения.

Зачем он нужен?

Это незаменимый инструмент в процессе отладки, ведь чаще всего нужно:

- Узнать текущее значение той или иной переменной.

- Выяснить по какому пути выполнялся код.

Что нужно сделать, чтобы начать пользоваться отладчиком?

Первоначально следует проверить настройки подключения к viewer, которые хранятся в теге [Game] в app.icf. Этот файл должен находится в корне директории с редактором.

Что я должен увидеть в этом файле?

Обязательным для работы является наличие двух строк в теге [Game]:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><tt>DebuggerIP="xxx.xxx.xxx.xxx" 
DebuggerPort=5322</tt></div>

Где <var>DebuggerIP</var> - это IP адресс машины, на которой запущен отладчик. А <var>DebuggerPort</var> - порт подключения, который остаётся неизменным!

DebuggerIP - может принимать несколько значений:

<ol>
<li>127.0.0.1 - т.е localhost, что не позволит использовать отладчик на удалённом устройстве, но прекрасно подойдет, если Вы не знаете IP машины, за которой работаете.</li>
<li>IP в локальной сети, который можно узнать у системного администратора. Этот является предпочтительным.</li>
</ol>

Что нужно сделать в SceneEditor, чтобы запустить отладчик?

Чтобы запустить режим отладки нужно нажать на кнопку в верхней панели. [[Файл:Debug_button.png]]

После чего откроется окно.

[[Файл:Debug_lock.png]]

А в конткестном меню (вызывается нажатием ПКМ) появятся новые строки.

[[Файл:Context_menu.png]]

Я запустил viewer, что делать дальше?

Нужно подключиться к "серверу", которым является Ваша рабочая машина с запущенным SceneEditor.exe.

Для этого нужно во viewer нажать F6.

Как узнать, что подключение успешно?

В окне отладки появится строка:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>connection successful!</code></div>

А за ней периодически будут появляться строки вида:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>viewer pinged</code></div>

Что я могу делать с помощью отладчика?

<ul>
<li>Первое и самое полезное - установка breakpoint.</li>
</ul>

Breakpoint - это остановка выполнения всей программы при определенных условиях. Пример: машина состояний перешла в другое состояние, переменная поменяла своё значение и т.д.

Важно помнить, что у нас существует возможность устанавливать breapoint только на машину состояний!

<ul>
<li>Запросить данные из GData любого объекта из дерева проекта.</li>
<li>Подсветить выбранный объект во viewer.</li>
</ul>

Как установить breakpoint?

Для этого в контекстном меню для выбранного объекта следует выбрать пункт Toggle breakpoint on every state.

Что автоматически задает условием остановки переход этой машины состояний в любое состояние.

Чтобы указать конкретное состояние - нужно в поле state вместо звёздочки указать имя состояния.

Вот так это выглядит в окне  отладчика.
[[Файл:Debug_lock.png]]
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Enabled - быстрое включение/отключение breakpoint. Важно: отключается при каждом запуске viewer!</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Object ID - ID объекта.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">State - состояние, в которое должна попасть машина состояний, чтобы сработала остановка. По-умолчанию - *, что означает, что остановка будет произведена при переходе в любое состояние.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Parameter - параметр, при изменении которого будет произведена остановка.</div>

Что происходит во время остановки?

Открывается окно, которое является точной копией окна настройки машины состояний, но недоступное для редактирование.

Дополнительно в первой колонке отображаются все параметры из GData машины.

Существуют два режима отображения в таком окне:

<ol>
<li>При переходе в новое состояние столбец с одноименным состоянием не заменяется, а все новые добавляются справа от текущего.</li>
<li>Заменяются столбцы с одноименным состоянием, а все параметры, которые поменяли своё значение - подсвечиваются красным.</li>
</ol>

Переключаться между режимами можно с помощью кнопки:

Зачем нужна вторая вкладка Logging?

В этой вкладке мы видим окно отображения лога, которое обновляется в режиме реального времени.
[[Файл:Logging_dock.png]]
Каждый из столбцов обладает фильтром.

Чтобы добавить условие фильтрации нужно выделить стобец и в поле Filter вписать строку, при нахождении которой полная строка появится в окне.

Чтобы очистить лог нужно нажать на кнопку Clear Log [[Файл:Clear_log_btn.png]]

Чтобы открыть файл с логами нужно нажать клавишу с тремя точками и выбрать указать путь к нужному файлу в стандартном окне проводника операционной системы. [[Файл:Btn_no_rewrite.png]] [[Файл:Btn_rewrite.png]]

Файл:Dots btn.png

2015-12-17T11:33:31Z

Beletsky:

Файл:Clear log btn.png

2015-12-17T11:33:22Z

Beletsky:

Файл:Btn rewrite.png

2015-12-17T11:33:12Z

Beletsky:

Файл:Btn no rewrite.png

2015-12-17T11:33:03Z

Beletsky:

Файл:Debug button.png

2015-12-17T11:32:50Z

Beletsky:

Файл:Context menu.png

2015-12-17T11:32:16Z

Beletsky:

Файл:Logging dock.png

2015-12-17T11:31:59Z

Beletsky:

Файл:Debug lock.png

2015-12-17T11:31:42Z

Beletsky:

Использование AppSalute Debugger при отладке

2015-12-17T10:32:30Z

Beletsky:

Что такое debugger?

Debugger (он же отладчик) - это отдельное приложение, которое предназначено для поиска и локализации ошибок в работе приложения.

Зачем он нужен?

Это незаменимый инструмент в процессе отладки, ведь чаще всего нужно:

- Узнать текущее значение той или иной переменной.

- Выяснить по какому пути выполнялся код.

Что нужно сделать, чтобы начать пользоваться отладчиком?

Первоначально следует проверить настройки подключения к viewer, которые хранятся в теге [Game] в app.icf. Этот файл должен находится в корне директории с редактором.

Что я должен увидеть в этом файле?

Обязательным для работы является наличие двух строк в теге [Game]:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><tt>DebuggerIP="xxx.xxx.xxx.xxx" 
DebuggerPort=5322</tt></div>

Где <var>DebuggerIP</var> - это IP адресс машины, на которой запущен отладчик. А <var>DebuggerPort</var> - порт подключения, который остаётся неизменным!

DebuggerIP - может принимать несколько значений:

<ol>
<li>127.0.0.1 - т.е localhost, что не позволит использовать отладчик на удалённом устройстве, но прекрасно подойдет, если Вы не знаете IP машины, за которой работаете.</li>
<li>IP в локальной сети, который можно узнать у системного администратора. Этот является предпочтительным.</li>
</ol>

Что нужно сделать в SceneEditor, чтобы запустить отладчик?

Чтобы запустить режим отладки нужно нажать на кнопку в верхней панели.

После чего откроется окно.

А в конткестном меню (вызывается нажатием ПКМ) появятся новые строки.

Я запустил viewer, что делать дальше?

Нужно подключиться к "серверу", которым является Ваша рабочая машина с запущенным SceneEditor.exe.

Для этого нужно во viewer нажать F6.

Как узнать, что подключение успешно?

В окне отладки появится строка:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>connection successful!</code></div>

А за ней периодически будут появляться строки вида:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>viewer pinged</code></div>

Что я могу делать с помощью отладчика?

<ul>
<li>Первое и самое полезное - установка breakpoint.</li>
</ul>

Breakpoint - это остановка выполнения всей программы при определенных условиях. Пример: машина состояний перешла в другое состояние, переменная поменяла своё значение и т.д.

Важно помнить, что у нас существует возможность устанавливать breapoint только на машину состояний!

<ul>
<li>Запросить данные из GData любого объекта из дерева проекта.</li>
<li>Подсветить выбранный объект во viewer.</li>
</ul>

Как установить breakpoint?

Для этого в контекстном меню для выбранного объекта следует выбрать пункт Toggle breakpoint on every state.

Что автоматически задает условием остановки переход этой машины состояний в любое состояние.

Чтобы указать конкретное состояние - нужно в поле state вместо звёздочки указать имя состояния.

Вот так это выглядит в окне  отладчика.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Enabled - быстрое включение/отключение breakpoint. Важно: отключается при каждом запуске viewer!</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Object ID - ID объекта.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">State - состояние, в которое должна попасть машина состояний, чтобы сработала остановка. По-умолчанию - *, что означает, что остановка будет произведена при переходе в любое состояние.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Parameter - параметр, при изменении которого будет произведена остановка.</div>

Что происходит во время остановки?

Открывается окно, которое является точной копией окна настройки машины состояний, но недоступное для редактирование.

Дополнительно в первой колонке отображаются все параметры из GData машины.

Существуют два режима отображения в таком окне:

<ol>
<li>При переходе в новое состояние столбец с одноименным состоянием не заменяется, а все новые добавляются справа от текущего.</li>
<li>Заменяются столбцы с одноименным состоянием, а все параметры, которые поменяли своё значение - подсвечиваются красным.</li>
</ol>

Переключаться между режимами можно с помощью кнопки:

Зачем нужна вторая вкладка Logging?

В этой вкладке мы видим окно отображения лога, которое обновляется в режиме реального времени.

Каждый из столбцов обладает фильтром.

Чтобы добавить условие фильтрации нужно выделить стобец и в поле Filter вписать строку, при нахождении которой полная строка появится в окне.

Чтобы очистить лог нужно нажать на кнопку Clear Log

Чтобы открыть файл с логами нужно нажать клавишу с тремя точками и выбрать указать путь к нужному файлу в стандартном окне проводника операционной системы.

Использование AppSalute Debugger при отладке

2015-12-17T10:20:07Z

Beletsky:

Что такое debugger?

Debugger (он же отладчик) - это отдельное приложение, которое предназначено для поиска и локализации ошибок в работе приложения.

Зачем он нужен?

Это незаменимый инструмент в процессе отладки, ведь чаще всего нужно:

- Узнать текущее значение той или иной переменной.

- Выяснить по какому пути выполнялся код.

Что нужно сделать, чтобы начать пользоваться отладчиком?

Первоначально следует проверить настройки подключения к viewer, которые хранятся в теге [Game] в app.icf. Этот файл должен находится в корне директории с редактором.

Что я должен увидеть в этом файле?

Обязательным для работы является наличие двух строк в теге [Game]:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><tt>DebuggerIP="xxx.xxx.xxx.xxx" 
DebuggerPort=5322</tt></div>

Где <var>DebuggerIP</var> - это IP адресс машины, на которой запущен отладчик. А <var>DebuggerPort</var> - порт подключения, который остаётся неизменным!

DebuggerIP - может принимать несколько значений:

<ol>
<li>127.0.0.1 - т.е localhost, что не позволит использовать отладчик на удалённом устройстве, но прекрасно подойдет, если Вы не знаете IP машины, за которой работаете.</li>
<li>IP в локальной сети, который можно узнать у системного администратора. Этот является предпочтительным.</li>
</ol>

Что нужно сделать в SceneEditor, чтобы запустить отладчик?

Чтобы запустить режим отладки нужно нажать на кнопку в верхней панели.

После чего откроется окно.

А в конткестном меню (вызывается нажатием ПКМ) появятся новые строки.

Я запустил viewer, что делать дальше?

Нужно подключиться к "серверу", которым является Ваша рабочая машина с запущенным SceneEditor.exe.

Для этого нужно во viewer нажать F6.

Как узнать, что подключение успешно?

В окне отладки появится строка:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>connection successful!</code></div>

А за ней периодически будут появляться строки вида:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>viewer pinged</code></div>

Что я могу делать с помощью отладчика?

<ul>
<li>Первое и самое полезное - установка breakpoint.</li>
</ul>

Breakpoint - это остановка выполнения всей программы при определенных условиях. Пример: машина состояний перешла в другое состояние, переменная поменяла своё значение и т.д.

Важно помнить, что у нас существует возможность устанавливать breapoint только на машину состояний!

<ul>
<li>Запросить данные из GData любого объекта из дерева проекта.</li>
<li>Подсветить выбранный объект во viewer.</li>
</ul>

Как установить breakpoint?

Для этого в контекстном меню для выбранного объекта следует выбрать пункт Toggle breakpoint on every state.

Что автоматически задает условием остановки переход этой машины состояний в любое состояние.

Чтобы указать конкретное состояние - нужно в поле state вместо звёздочки указать имя состояния.

Вот так это выглядит в окне  отладчика.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Enabled - быстрое включение/отключение breakpoint. Важно: отключается при каждом запуске viewer!</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Object ID - ID объекта.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">State - состояние, в которое должна попасть машина состояний, чтобы сработала остановка. По-умолчанию - *, что означает, что остановка будет произведена при переходе в любое состояние.</div>

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">Parameter - параметр, при изменении которого будет произведена остановка.</div>

Что происходит во время остановки?

Открывается окно, которое является точной копией окна настройки машины состояний, но недоступное для редактирование.

Дополнительно в первой колонке отображаются все параметры из GData машины.

Существуют два режима отображения в таком окне:

<ol>
<li>При переходе в новое состояние столбец с одноименным состоянием не заменяется, а все новые добавляются справа от текущего.</li>
<li>Заменяются столбцы с одноименным состоянием, а все параметры, которые поменяли своё значение - подсвечиваются красным.</li>
</ol>

Переключаться между режимами можно с помощью кнопки:

Зачем нужна вторая вкладка Logging?

В этой вкладке мы видим окно отображения лога, которое обновляется в режиме реального времени.

Каждый из столбцов обладает фильтром.

Чтобы добавить условие фильтрации нужно выделить стобец и в поле Filter вписать строку, при нахождении которой полная строка появится в окне.

Использование AppSalute Debugger при отладке

2015-12-17T09:45:01Z

Beletsky:

Что такое debugger?

Debugger (он же отладчик) - это отдельное приложение, которое предназначено для поиска и локализации ошибок в работе приложения.

Зачем он нужен?

Это незаменимый инструмент в процессе отладки, ведь чаще всего нужно:

- Узнать текущее значение той или иной переменной.

- Выяснить по какому пути выполнялся код.

Что нужно сделать, чтобы начать пользоваться отладчиком?

Первоначально следует проверить настройки подключения к viewer, которые хранятся в теге [Game] в app.icf. Этот файл должен находится в корне директории с редактором.

Что я должен увидеть в этом файле?

Обязательным для работы является наличие двух строк в теге [Game]:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><tt>DebuggerIP="xxx.xxx.xxx.xxx" 
DebuggerPort=5322</tt></div>

Где <var>DebuggerIP</var> - это IP адресс машины, на которой запущен отладчик. А <var>DebuggerPort</var> - порт подключения, который остаётся неизменным!

DebuggerIP - может принимать несколько значений:

<ol>
<li>127.0.0.1 - т.е localhost, что не позволит использовать отладчик на удалённом устройстве, но прекрасно подойдет, если Вы не знаете IP машины, за которой работаете.</li>
<li>IP в локальной сети, который можно узнать у системного администратора. Этот является предпочтительным.</li>
</ol>

Что нужно сделать в SceneEditor, чтобы запустить отладчик?

Чтобы запустить режим отладки нужно нажать на кнопку в верхней панели.

После чего откроется окно.

А в конткестном меню (вызывается нажатием ПКМ) появятся новые строки.

Я запустил viewer, что делать дальше?

Нужно подключиться к "серверу", которым является Ваша рабочая машина с запущенным SceneEditor.exe.

Для этого нужно во viewer нажать F6.

Как узнать, что подключение успешно?

В окне отладки появится строка:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>connection successful!</code></div>

А за ней периодически будут появляться строки вида:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;"><code>viewer pinged</code></div>

Использование AppSalute Debugger при отладке

2015-12-17T09:41:43Z

Beletsky: Новая страница: «Что такое debugger? Debugger (он же отладчик) - это отдельное приложение, которое п…»

Что такое debugger?

Debugger (он же отладчик) - это отдельное приложение, которое предназначено для поиска и локализации ошибок в работе приложения.

Зачем он нужен?

Это незаменимый инструмент в процессе отладки, ведь чаще всего нужно:

- Узнать текущее значение той или иной переменной.

- Выяснить по какому пути выполнялся код.

Что нужно сделать, чтобы начать пользоваться отладчиком?

Первоначально следует проверить настройки подключения к viewer, которые хранятся в теге [Game] в app.icf. Этот файл должен находится в корне директории с редактором.

Что я должен увидеть в этом файле?

Обязательным для работы является наличие двух строк в теге [Game]:

<tt>DebuggerIP="xxx.xxx.xxx.xxx" 
DebuggerPort=5322</tt>

Где <var>DebuggerIP</var> - это IP адресс машины, на которой запущен отладчик. А <var>DebuggerPort</var> - порт подключения, который остаётся неизменным!

DebuggerIP - может принимать несколько значений:

<ol>
<li>127.0.0.1 - т.е localhost, что не позволит использовать отладчик на удалённом устройстве, но прекрасно подойдет, если Вы не знаете IP машины, за которой работаете.</li>
<li>IP в локальной сети, который можно узнать у системного администратора. Этот является предпочтительным.</li>
</ol>

Что нужно сделать в SceneEditor, чтобы запустить отладчик?

Чтобы запустить режим отладки нужно нажать на кнопку в верхней панели.

После чего откроется окно.

А в конткестном меню (вызывается нажатием ПКМ) появятся новые строки.

Я запустил viewer, что делать дальше?

Нужно подключиться к "серверу", которым является Ваша рабочая машина с запущенным SceneEditor.exe.

Для этого нужно во viewer нажать F6.

Как узнать, что подключение успешно?

Absolutist Framework

2015-12-17T09:15:00Z

Beletsky: /* Обучение */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Kub.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Wallet

2015-11-06T08:59:56Z

Beletsky:

Wallet

2015-11-06T08:54:01Z

Beletsky: /* Параметры объекта Wallet */

[[Object|Объект]] '''Wallet''' необходим для начисления игровой валюты при InApp покупке через объект [[Economics]]

== Параметры объекта Wallet ==

*'''economics''' - ссылка на объект economics
*'''InApp - покупка'''
**'''Внутренний id покупки''' - Внутренний id покупки
**'''Монеты''' - количество монет
**'''кристаллы''' - количество кристаллов
**'''поле в опциях для множителя''' - ключ в опциях для множителя монет. ВАЖНО: указывать без идентификатора пользователя. Пример: ecomics65.stmult - без p0!
**'''базовая прибавка к статусу''' - прибавка к статусным очкам ([http://wiki.appsalutecreator.com/index.php/Economics#.D0.A1.D1.82.D0.B0.D1.82.D1.83.D1.81| Что такое статус и с чем его едят]). Базовая - потому что будет множиться на коэф., который зависит от текущего статуса. Коэф. указывается в экономики в соответствующем разделе.

== Принцип работы ==

На успех покупки объект Wallet проверяет внутренний id и если находит совпадение в добавляемых свойствах, то начисляет указанное там количество монет и кристаллов.

== Состояния ==

* ''recalc'' - перезаписать значения монет и статусных очков, учитывая множители.

Ключ в опциях:

* ''wallet%d.i%s.res1'' - ключ к значению монет, учитывая множитель.
* ''wallet%d.i%s.status'' - ключ к значению статусных очков, учитывая множитель.

[[Category:Options]]

Economics

2015-11-06T08:52:16Z

Beletsky:

[[Object|Объект]] '''Economics''' служит для реализации сложной игровой механики типа "ферма". Он осуществляет связь между игровыми локациями, накопленным опытом, текущим количеством энергии, денег и кристаллов (можно использовать и другие названия ресурсов), а также управляет объектами коллекций, магазина, инвентаря и игровых заданий.

= Свойства =

*'''предметы''' - Объект типа [[eitems]].
*'''задачи''' - Объект типа [[taskorganizer]].

==Параметры==
===Основные параметры===

*'''Сдвиг уровней''' ( ''levels_shift'' ) - число на которое сдвинется анлок уровней в economics setup; после задания параметра нужно проинитить экономику;
*'''Уровни''' - опыт, необходимый для перехода на следующий уровень. Последовательность чисел через запятую.
*'''Уровни парабола''' - Три числа через запятую, задающие коэффициенты параболы, которые определяют необходимый опыт после уже перечисленных уровней.
*'''Энергия''' - максимум энергии на каждом из уровней. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Энергия прибавка''' - Число определяющее прибавку к максимуму энергии после уже перечисленных уровней.
*'''Ресурс 1''' - количество ресурса 1 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Ресурс 2''' - количество ресурса 2 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Перезарядка''' - время за которое восстанавливается единица энергии в ms.
*'''нач. ресурс 1''' - Начальное значение ресурса 1.
*'''нач. ресурс 2''' - Начальное значение ресурса 2.
*'''время напоминания''' - время напоминания о задачах на каждом из уровней. Записывается в виде последовательности чисел через запятую. Последнее значение будет зациклено для всех последующих уровней. Время изменяется в часах.
*'''напоминание об энергии''' - уведомление перетаскивается с текстового редактора, представляет собой напоминание о том что энергия восстановилась. Например, "Ваше энергия полностью восстановлена".
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32 битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние

===Основные счетчики===
Этот раздел содержит необходимые объекты для подсчета (counter, timer, progressbar).

*'''Уровень''' - счетчик текущего уровня игрока.
*'''Прогресс в уровне (счетчик)''' - Набранный на этом уровне опыт и остаток до следующего уровня (счетчик).
*'''Прогресс в уровне (бар)''' - Набранный на этом уровне опыт и остаток до следующего уровня (прогрессбар).
*'''Опыта до уровня''' - счетчик показывающий сколько опыта необходимо для перехода с текущего уровня на следующий.
*'''Текущая энергия''' - прогрессбар текущей энергии.
*'''Максимальная энергия''' - счетчик, который отображает значение максимальной энергии.
*'''Таймер энергии''' - таймер отображающий время до восстановления единицы энергии.
*'''Таймер всей энергии''' - таймер, который отображает время до восстановления всей энергии.
*'''Ресурс 1''' - счетчик первого ресурса (денег).
*'''Ресурс 2''' - счетчик второго ресурса (кристаллов).
*'''анимация рес.1''' - Анимационный объект награды в ресурсе 1. Должен иметь состояние show.
*'''анимация рес.2''' - Анимационный объект награды в ресурсе 2. Должен иметь состояние show.
*'''анимация опыт''' - Анимационный объект награды в опыте. Должен иметь состояние show.

===Окно перед локацией===
Настройка окна, которое всплывает перед посещением локации. В этом окне отображается информация о локации которую мы хотим посетить.

*'''Окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояния ''open'' - открыта, ''open_lvl'' - не хватает лвл, ''open_buy'' - разница в уровнях позволяет нам купить анлок, ''open_item'' - не хватает предмета для анлока, ''open_unlock'' - состояние вызываемое окну перед локацией после успешной покупки предмета для анлока, ''open_energy'' - состояние вызываемое окну перед локацией в случае нехватки энергии.
*'''Превью локации''' - графический ресурс для отображения превью локации. В это поле можно поставить любую картинку для того, чтобы корректно разместить ее в "окне перед локацией". Далее экономикс сам будет подставлять нужные превью.
*'''Название локации''' - текстовый объект, в который будет подставляться название локации.
*'''Описание локации''' - текстовый объект, в который будет подставляться описание локации.
*'''Уровень мастерства''' - счетчик уровня мастерства.
*'''Прогрессбар уровня мастерства''' - прогрессбар, который отображает уровень мастерства.
*'''Текущий уровень''' - счетчик текущего уровня мастерства.
*'''Необходимая энергия''' - счетчик необходимой энергии.
*'''Аномальная энергия''' - счетчик, который отображает дополнительную энергию при наличии аномалии в локации.
*'''Призовой ресурс 1''' - счетчик призовых денег.
*'''Аномальный ресурс 1''' - счетчик, который отображает количество дополнительных призовых денег, которые даются за игру в локацию с наличием аномалии.
*'''Призовой ресурс 2''' - счетчик призовых кристаллов.
*'''Призовой опыт''' - счетчик призового опыта.
*'''Аномальный опыт''' - счетчик, который отображает значение дополнительного опыта, который дается за игру в локацию с наличием аномалии.
*'''Таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно найти в данной локации.

''для закрытой по уровню локации''
*'''Режим игры''' - машина, которой будут устанавливаться состояния в зависимости от режима игры (может быть смешанный, текст или силуэт). TODO пока обладает только режимом text и icon. Эта машина будет передавать настройки таблице, в которую помещаются поисковые объекты, поэтому важно, чтобы к этой таблице был доступ (например она может находится на глобальном экране).

*'''индикатор уровня''' - счетчик с необходимым для локации уровнем.

''для локации c ценой''

*'''цена ресурс 1''' - Стоимость анлока локации в ресурсе 1.
*'''цена ресурс 2''' - Стоимость анлока локации в ресурсе 2.

''для локации c требуемым предметом''

*'''предмет''' - иконка необходимого для локации предмета.
*'''название предмета''' - в этом поле указывается название, необходимого для локации предмета.
*'''счетчик цены''' - счетчик, который отображает стоимость предмета.
*'''иконка цены''' - иконка цены предмета, представляет собой картинку, которая перетаскивается из базы ресурсов.
*'''кнопка купить''' - Будет видна, если предмет нужно купить. Передает экономиксу состояние unlock_item.
*'''кнопка искать''' - Будет видна, если предмет поисковый.
*'''блок аномалии''' - контейнер, представляющий собой машину, которая содержит всю информацию про аномалию. Должна содержать в себе состояния hide, show и remov (состояние после прогона аномалии, чтобы сделать красивые эффекты, после которого машина попадет в состояние hide).
*'''иконка аномалии''' - иконка аномалии.
*'''название аномалии''' - текстовый объект, который будет отображать название аномалии.
*'''описание аномалии''' - текстовый объект, который будет отображать описание аномалии.
*'''иконка предмета''' - иконка предмета, необходимого для того что бы прогнать аномалию.
*'''кнопка прогнать предметом''' - кнопка по нажатию которой, можно прогнать аномалию используя предмет.
*'''кнопка купить предмет''' - кнопка по нажатию которой, можно купить предмет для прогона аномалии.
*'''кнопка прогнать миниигрой''' - кнопка по нажатию которой, можно прогнать аномалию мини игрой.
*'''корневой объект''' - некая машина, олицетворяющая собой блок перехода в связанную локацию. Должно иметь состояния enable и disable.
*'''таблица артефактов''' - в таблицу будут сложены предметы, необходимы для переключения локации.
*'''галочка в таблице''' - графический ресурс поверх найденных предметов.
*'''иконка ключа''' - сюда сложим иконку предмета необходимого для переключения на альтернативную локацию.

===Окно после локации===

Настройка окна, которое всплывает после посещения локации. В этом окне отображается информация о полученных очках и предметах за исследование локации.

*'''Окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние ''open''.
*'''Название локации''' - текстовый объект, в который будет подставляться название локации.
*'''Описание локации''' - текстовый объект, в который будет подставляться описание локации.
*'''Уровень мастерства''' - счетчик уровня мастерства.
*'''Прогрессбар мастерства''' - прогрессбар, который отображает уровень мастерства.
*'''Текущий уровень''' - счетчик текущего уровня мастерства.
*'''Призовой ресурс 1''' - счетчик призовых денег.
*'''Аномальный ресурс 1''' - счетчик, который отображает количество дополнительных денег за прохождение локации с аномалией.
*'''Призовой ресурс 2''' - счетчик призовых кристаллов.
*'''Призовой опыт''' - счетчик призового опыта.
*'''Аномальный опыт''' - счетчик, отображающий дополнительный призовой опыт, который дается за прохождение локации с аномалией.
*'''Таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно найти в данной локации.
*'''ничего не найдено''' - Любой объект, так или иначе сообщающий игроку, что он не нашел ничего ценного.

===Окно перед монстром===
*'''окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние open - все условия выполнены, open_energy - не хватает энергии для игры, но предмет для прогона есть, open_item - есть энергия, но не хватает предмета для прогона, open_item_energy - не хватает энергии для игры и нет предмета для прогона.
*'''превью монстра ''' - картинка, отображающая превью монстра.
*'''название монстра''' - текстовый объект, показывающий название монстра.
*'''описание монстра''' - текстовый объект, показывающий описание монстра.
*'''необходимая энергия''' - счетчик, отображающий количество необходимой энергии.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''иконка предмета''' - картинка, которая отображает предмет необходимый для игры с монстром.
*'''нужно предметов''' - счетчик, который отображает необходимое количество предметов.
*'''есть предметов''' - счетчик, который отображает текущее количество предметов, находящееся в наличии.
*'''суммарная стоимость''' - счетчик, который отображает суммарную стоимость недостающих предметов.
*'''кнопка купить''' - кнопка, по нажатию которой, происходит покупка недостающих предметов.
*'''кнопка прогнать''' - кнопка, по нажатию которой, можно прогнать монстра не играя в игру, эту кнопку можно не задавать.

===Окно после монстра===

*'''окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние open.
*'''превью монстра''' - картинка, отображающая превью монстра.
*'''название монстра''' - текстовый объект, показывающий название монстра.
*'''описание монстра''' - текстовый объект, показывающий описание монстра.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''ничего не найдено''' - любой объект, сообщающий игроку, так или иначе, что он не нашел ничего ценного на данной локации.

===Окно коллекций===

*'''Шаблон коллекции''' - ссылка на объект типа ecollection который будет использоваться в качестве исходного для всех коллекций.
*'''Таблица''' - таблица, куда по ссылке будут добавлены шаблоны коллекции.
*'''алерт''' - некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окно с информацией о предмете всплывает в окне с коллекциями.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.
*'''цифры''' - фреймовая анимация содержащая в себе цифры. Последний фрейм анимации - отметка много.

===Окошко коллекционного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.

===Окошко поздравления со сдачей коллекции===

*'''окно''' - некая машина,содержащая необходимую информацию, олицетворяющая само окно предмета. Должна иметь в себе состояние open.
*'''иконка''' - картинка отображающая иконку предмета-награды ( в параметр reward_text_id - запишется текстовый ID итогового предмета из текстовой базы);
*'''текст(объект)''' - текстовый объект, отображающий название коллекции.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призовых денег.

===Окошко инвентарного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.

===Окошко поздравления с получением уровня===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само окно предмета. Должна иметь состояние open.
*'''уровень''' - счетчик, отображающий номер полученного уровня.
*'''энергия''' - счетчик, отображающий количество энергии, которая прибавляется к максимуму.
*'''ресурс 1''' - счетчик, отображающий количество денег.
*'''ресурс 2''' - счетчик, отображающий количество кристаллов.

===Окошко поздравления с получением уровня и открытием локации===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само поздравительное окошко. Должна иметь состояние open.

*'''уровень''' - счетчик, отображающий номер полученного уровня.

*'''энергия''' - счетчик, отображающий количество энергии, которая прибавляется к максимуму.

*'''ресурс 1''' - счетчик, отображающий количество денег.

*'''ресурс 2''' - счетчик, отображающий количество кристаллов.

*'''иконка локации''' - картинка, отображающая иконку локации, которая стала доступна

*'''описание локации''' - текстовый объект, который отображает описание локации, которая стала доступна.

===Окошко получения уровня на локации===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само поздравительное окошко. Должна иметь состояние open.
*'''спецпредмет''' - объект, в который положится иконка коллекционного предмета, полученного за достижение очередного уровня мастерства на локации (настройки предмета в уровнях мастерства).
*'''опции''' - поле в опциях, в которое записывается уровень по локации.

===Окошко, когда не хватает чарджера (общее) ===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само уведомительное окошко. Должна иметь состояние open.
*'''иконка''' - картинка, отображающая иконку предмета, который игрок получит за сдачу коллекции.
*'''текст''' - текстовый объект, который будет отображать описание коллекции.
*'''суммарная цена ресурса 1''' - счетчик, отображающий суммарную цену всех необходимых чарджеров, представлена в виде ресурса 1 (деньги).
*'''суммарная цена ресурса 2''' - счетчик, отображающий суммарную цену всех необходимых чарджеров, представлена в виде ресурса 2 (кристаллы).
*'''кнопка купить все''' - кнопка, по нажатию которой, происходит покупка необходимых предметов. Если в кнопке есть необходимость она будет появляться, в противном случае - сама исчезать.

===Окошко, которое выезжает когда найден коллекционный предмет ===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяет собой само поздравительное окошко. Должна иметь состояние show.
*'''текст''' - текстовый объект, который используется для отображения названия коллекции.
*'''таблица''' - таблица, в которую складываются объекты коллекции.

===Окошко покупки артефакта===

Кратко об артефактах. Артефакты это инвентарные предметы, которые можно найти либо купить. Они необходимы для того, чтобы была возможность играть в связанную локацию. Связанная локация - локация, которая имеет свой уникальный порядковый номер в списке локаций, но тем не менее логически привязана к локации с другим порядковым номером. Когда все артефакты, необходимые для игры в связанную локацию собраны, то при вызове состояния ''location'' объекту economics локация выбирается случайным образом между оригинальной и связанной. При этом есть возможность сменить локацию (ротация между оригинальной и связанной локацией) вызвав состояние ''location_switch''. Чтобы сменить локацию нужен предмет, который перетаскивается в поле "предмет переключения" настроек локации.

*'''окно''' - Некая машина, олицетворяющая собой само окошко покупки. Должна иметь состояние show
*'''таблица''' - Таблица должна иметь две строки и заполнение по столбцам. В верхнюю попадут иконки артефактов, в нижнюю - кнопки купить
*'''кнопка 1''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 2''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 3''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 4''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact

===Дополнительные достижения ===

В этом разделе указаны некоторые достижение, которые отправляются объектом economics в gamecenter.

*'''достижение на трату ресурса 1''' - id достижения, отправляемого за трату ресурса 1 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 1''' - сумма ресурса 1, которую необходимо потратить для получения достижения.
*'''достижение на трату ресурса 2''' - id достижения, отправляемого за трату ресурса 2 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 2''' - сумма ресурса 2, которую необходимо потратить для получения достижения.
*'''достижение на число открытых локаций''' - id достижения, отправляемого за открытия количества локаций из следующего поля (при открытии нужного количества локаций отправляется 100% достижения).
*'''количество локаций''' - кол-во локаций, которое необходимо открыть для получения достижения.
*'''достижение за покупки чего-либо''' - id достижения, отправляемого за совершенное количество покупок из следующего поля (при покупке нужного количества отправляется 100% достижения).
*'''количество покупок''' - количество покупок, которое необходимо свершить для получения достижения.

===Покупка рандомного предмета===

При вызове объекту economics состояния ''buy_random_col'' покупается случайный коллекционный предмет. Визуализацией покупки служит выпадающий на сцену объект из вкладки настроек "Летающий объект"

*'''res1''' - цена предмета в ресурсе 1.
*'''исключения''' - id предметов, которые не попадут в случайный выбор. Перетаскиваются из текстовой базы.
*'''каунтер''' - объект типа counter в который сложится цена предмета.

=== Статус ===
Статус - дополнительный экономический параметр игрока, который зависит от внутриигровых действий. Статус определяется кол-вом статусных очков, которые начисляются за совершение in-app покупки и при достижении нового уровня (exp).

Тесно связан с [[Wallet|Wallet]].

*'''очки для повышения''' - массив чисел, указываем через запятую. Обозначает нужное кол-во очков статуса для перехода на следующий уровень. Пример: 0, 150, 3850. Изначальный уровень уже получен при инициализации экономики. Для перехода на следующий (2-й) нужно получить 150 очков. На 3-й - 3850 и т.д.
*'''множитель статуса при покупке''' - массив чисел, указываем через запятую. Обозначает коэф., на который домножим базовое значение статусных очков при покупке. Зависит от текущего статуса. Пример: 1,2,3. Базовое значение за покупку - 18 очков статуса. При совершении покупки, имея 1-й статус - получаем 18 очков. Имея второй статус - 36, третий - 54.
*'''множитель монет при покупке''' - Аналогично предыдущему пункту.
*'''прибавка за уровень''' - массив чисел, указываем через запятую. Показывает сколько статусных очков будет получено при достижении уровня exp, учитывая текущий статус.
*'''множитель дейли-бонуса''' - массив чисел, указываем через запятую. Множитель, который можно использовать при начислении ежедневного бонуса. Зависит только от текущего статуса.

'''Поля в опциях'''
* ecomics%d.stlev - текущий уровень статуса (начиная с 0!)
* ecomics%d.stpoints - поинты внутри текущего уровня
* comics%d.stdaily - множитель для дейли бонуса
* ecomics%d.stmult - множитель для монеток

=== Настройки симуляции ===

*'''время''' - время симуляции, измеряется в секундах.

*'''минимум в локации''' - нижняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.

*'''максимум в локации''' - верхняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.
*'''порог покупки''' - число, указывающее какую долю, от ресурсов игрока, должна составлять цена локации, что бы он решился её купить.
*'''порог покупки предмета''' - число, указывающее какую долю,от ресурсов игрока, должна составлять цена предмета, что бы он решился его купить.
*'''вероятность задачи''' - число, отображающее вероятность того, что симуляция будет выбирать не из всех доступных локаций, а из связанных с заданиями.
*'''вероятность матча''' - число, отображающее вероятность того, что симуляция будет играть в матч.
*'''изначально хинтов''' - изначальное количество хинтов.
*'''предметов на хинт''' - на сколько найденных предметов игрок израсходует хинт.
*'''цена хинта монеты''' - сколько монет (ресурс 1), стоит некий усредненный хинт.
*'''цена хинта кристаллы''' - сколько кристаллов (ресурс 2), стоит некий усредненный хинт.
*'''хидденов подряд''' - игрок будет пытаться пройти не менее данного числа хидденов подряд.
*'''восстановить энергии''' - некое усредненное количество энергии для восстановления.
*'''цена энергии монеты''' - сколько монет стоит энергия (цена в ресурсе 1).
*'''цена энергии кристаллы''' - сколько кристаллов стоит энергия (цена в ресурсе 2).
*'''вероятность победы в матче'' - число, отображающее вероятность победы в матче.
*'''время в матче''' - условное время пребывания в матче.
*'''вероятность покупки за реал''' - каждый раз когда игроку не хватает денег или кристаллов - проверяем эту вероятность.
*'''цена монеты в деньгах''' - цена монеты в деньгах.
*'''количество монет в покупке''' - количество монет в покупке.
*'''цена кристаллов в деньгах''' - цена кристаллов деньгах.
*'''количество кристаллов в покупке''' - количество кристаллов в покупке.

==Поле economics setup==
По клику на "..." открывается редактор экономикса. В этом редакторе можно задать все настройки локациям и коллекциям, которые используются в игре.

[[Файл:Economics 1.jpg|500px]]

Economics setup содержит 11 вкладок : локация хидден, коллекция, предметы, окошко когда не хватает чарджера (чарджер), нехватка ресурсов на чарджер, монстр, летающий объект, аномалия, сдача коллекции, временный эффект, достижение.
Вверху можно увидеть ряд кнопок для добавления и удаления: справа для локаций, слева для уровней мастерства.

===Локация хидден===

Форма редактора экономикса разделена на 4 колонки. В первой колонке мы видим список локаций, используемых в игре. Имена локаций можно изменять. Добавляются новые локации по нажатию на кнопку ''Добавить локацию'', удаляются кнопкой ''Удалить локацию''. Во второй колонке отображаются свойства выделенной локации.

[[Файл:Economics 2.jpg|right]]
*'''Объект на карте''' - это объект ведущий в локацию с карты. Должен иметь как минимум состояния open и closed, которые ему будет вызывать экономикс.
*'''индиктор уровня''' - каунтер, который будет отображать номер уровня, начиная с которого локация доступна.
*'''Экран''' - экран, в котором расположен локация.
*'''Превью локации''' - графический ресурс для отображения превью локации из базы ресурсов.
*'''Имя локации''' - название локации, перетаскивается из текстовой базы.
*'''Описание локации''' - описание, перетаскивается из текстовой базы.
*'''Уровень''' - уровень требуемый для того, чтобы играть в локацию.
*'''Результат''' - имя поля в опциях, куда локацией будет занесен результат. Расчитываем найти там число.
*'''Связанный хидден лист''' - хидден-лист, связанный с локацией.
*'''необходимый предмет''' - предмет необходимый для входа в локацию. Может быть как коллекционным, так и инвентарным.
*'''разница в уровнях''' - разница в уровнях, при которой можно купить доступ в локацию.
*'''цена ресурс 1''' - если наш уровень ниже необходимого на разницу из верхнего поля, мы можем разлочить локацию за деньги.
*'''цена ресурс 2''' - если наш уровень ниже необходимого на разницу из верхнего поля, мы можем разлочить локацию за кристаллы.
*'''достижение''' - достижение, которое будет открываться по мере игры в эту локацию.
*'''процент''' - проценты достижения из предыдущего поля.

В третей колонке записываются уровни мастерства. Их можно переименовать. Добавляются кнопкой ''Добавить уровень мастерства''. Удаляются кнопкой ''Удалить уровень мастерства''. В четвертой колонке настраивается выделенный уровень мастерства.

[[Файл:Economics 3.jpg|right]]
*'''энергия''' - энергия требуемая для того, чтобы играть в локацию.
*'''ресурс 1''' - деньги даваемые за прохождение локации.
*'''ресурс 2''' - кристаллы даваемые за прохождение локации.
*'''опыт''' - опыт даваемый за прохождение локации.
*'''кол-во объектов''' - максимальное количество доступных для поиска объектов в одной игровой сессии.
*'''время игры''' - общее время игры (если -1, то игнорируется).
*'''время игры (блиц)''' - время игры с аномалией "блиц".
*'''время игры (аном)''' - время игры с остальными аномалиями.
*'''режим игры''' - режим игры: 0 - случайный, 1- слова, 2 - силуэты, 3 - поиск отличий;
*'''использовать различия''' - да - будут генирироватся режим поиска отличий, нет - не будут; Для корректной работы, следующей за сценой с хидн предметами, должна находиться пустая сцена с такими же параметрами как и у сцены с хидн предметами. Также между двумя сценами ( хидн и fake-сценой) должна быть связь по тасканию;
*'''аномалия''' - вероятность возникновения аномалии в локациях.
*'''доступные аномалии''' - перечень доступных на данном уровне мастерства аномалий. Записываются в виде чисел через запятую. Доступные значения 0, 1, 2, 3.
*'''множитель''' - коэффициент, на который умножаются набранные очки. при расчете перехода на следующий уровень. Может быть меньше 1.
*'''постоянный прирост''' - постоянный прирост, если он больше 0, то будет использоваться ВМЕСТО реально набранных в хиддене очков и множителя.
*'''очки''' - очки, которые нужно набрать для перехода на следующий уровень мастерства. Набранные в локции очки умножаются на множитель и суммируются. Когда превысят это значение - произойдет переход.
*'''Предметы''' - id коллекционных предметов, которые можно найти на локации. Не обязаны принадлежать к одной коллекции. Перетаскиваются из текстового редактора. Будет использоваться их иконка.
*'''Вероятность''' - вероятность найти один из коллекционных предметов из предыдущего поля.
*'''Вероятность 2''' - вероятность найти один из коллекционных предметов из предыдущего поля.
*'''Вероятность 3''' - вероятность найти один из коллекционных предметов из предыдущего поля.
*'''Инвентарь''' - id инвентарных предметов, которые можно найти на локации. Перетаскиваются из текстового редактора.
*'''Вероятность инв.''' - вероятность найти один из инвентарных предметов из предыдущего поля.
*'''Вероятность инв. 2''' - вероятность найти один из инвентарных предметов из предыдущего поля.
*'''Вероятность инв. 3''' - вероятность найти один из инвентарных предметов из предыдущего поля.
*'''Коллекционный предмет''' - предмет из коллекций, который будет дан игроку по достижению этого уровня мастерства.

===Коллекция===

Во вкладке ''Коллекция'' используются только первые две колонки. В первой колонке отображаются добавленные коллекции. Добавляются кнопкой ''Добавить локацию''. Удаляются кнопкой ''Удалить локацию''. Коллекции можно переименовывать. Второй столбик содержит id предметов входящих в коллекции. Перетаскиваются из текстового редактора. Будет использоваться их иконка. Ресурс 1 и ресурс 2 - ресурсы, которые даются за сдачу коллекции. Опыт - опыт, который дается за сдачу коллекции.

*'''имя''' - Имя (а также - описание, если нужно) конкретно коллекции.
*'''предметы''' - id предметов входящих в коллекции. Перетаскиваются из текстового редактора. Будет использоваться их иконка.
*'''ресурс 1''' - деньги даваемые за сдачу коллекции.
*'''ресурс 2''' - кристаллы даваемые за сдачу коллекции.
*'''опыт''' - опыт даваемый за сдачу коллекции.
*'''награда''' - предмет даваемый за сдачу коллекции. Перетаскивается из текстовой базы.
*'''заряжатели''' - Предметы инвентаря, необходимые для сдачи коллекции. ВНИМАНИЕ: будут использоваться не более первых 4х элементов списка.
*'''достижение''' - достижение, которое будет открываться по мере сдачи этой коллекции.
*'''процент''' - проценты достижения из предыдущего поля.
*'''уровень для подарка''' - уровень, начиная с которого предметы этой коллекции можно дарить

===Предметы===

Раздел "Предметы" позволяет добавлять список инвентарных предметов, которые могут использоваться в процессе игры, предоставлять различные бонусы. В первой колонке список предметов. Добавляется кнопкой "Добавить локацию", удаляется кнопкой "Удалить локацию". Предметы могут быть переименованы. Во второй колонке записаны свойства каждого предмета.

[[Файл:Economics 4.jpg|350px|right]]

*'''nm''' - имя предмета

*'''section''' - категория предмета.

*'''use''' - если 1, то предмет может использоваться (кнопка Use видимая).

*'''nm''' - имя предмета (txtID).

*'''опции''' - если это поле задано, то в него будет записываться актуальное количество объектов.

*'''начальное количество''' - начальное количество предметов данного типа в инвентаре.

*'''можно продать''' - возможность продавать предмет: 1 - можно продать, 0 - нельзя продать.

*'''уникальный''' - если 1 - то предмет уникальный пропадает после покупки, если 0 - предмет после покупки не пропадает.

*'''res1''' - цена предмета в ресурсе 1.

*'''res2''' - цена предмета в ресурсе 2.

*'''sres1''' - продажа - цена предмета в ресурсе 1.

*'''sres2''' - продаже - цена предмета в ресурсе 2.

*'''en''' - восстанавливает энергии единовременно.

*'''tm''' - длительность действия в секундах.

*'''dTm''' - уменьшение времени восстановления энергии в %.

*'''dFnd''' - увеличение вероятности нахождения предмета в %.

*'''dExp''' - увеличение начисляемого опыта в %.

*'''dRes1''' - увеличение полученного ресурса 1 в %.

*'''dRes2''' - увеличение полученного ресурса 2 в %.

*'''dOvP''' - увеличение перегруженной вероятности нахождения предметов в %.

*'''dMaxEn''' - увеличение максимума энергии в %.

*'''dBonus1''' - накопительный монетный бонус (в случае, если предмет дает ежедневный денежный прирост). Суммируется (от всех предметов имеющих это поле отличное от 0) и записывается в поле total_amulet_bonus1 экономикса. Автоматически не начисляется.

*'''dBonus1''' - накопительный кристальный бонус (в случае, если предмет дает ежедневный денежный прирост). Суммируется (от всех предметов имеющих это поле отличное от 0) и записывается в поле total_amulet_bonus2 экономикса. Автоматически не начисляется.

*'''dPurchase''' - к каждой покупке предмета добавляется еще столько таких же предметов. Актуально в тех случаях, когда приобретение предмета активирует акцию 1+1.

*'''num''' - число предметов в сундуке. Выбираются случайно из следующего поля. При 0 - следующее поле не используется.

*'''items''' - предметы, которые можно найти в сундуке. Перетаскиваются из текстовой базы.

*'''use_id''' - задание этого поля говорит о том, что данный предмет является оптовым пучком для предмета указанного у этом поле. Num, в этом случае, - количество.

*'''объект''' - связанный объект, будет добавляться в инвентарь.

*'''достижение''' - достижение, которое будет открываться по мере применения подобный предметов.

*'''процент''' - процент достижения их предыдущего поля.

*'''владелец''' - на данный момент - номер правильной кнопки в окне угадайки (если -1. то игнорируется).

*'''монстр''' - номер монстра, в игре с которым нужно применить этот предмет. Актуально для задач на применение хинтов в мини играх.

*'''обработчик конца действия''' - объект, обработчик конца действия амулета.

*'''состояние обработчика''' - состояние обработчика конца действия амулета (объект из поля выше будет переведен в это состояние по окончанию действия амулета).

*'''дарить с уровня''' - уровень с которого возможно дарить этот предмет

====Создание предметов (крафт)====

В третьей колонке можно добавлять ингридиенты из которых состоит предмет. Ингридиенты сами по себе являются также инвентарными предметами. В четвертой колонке указывается текстовый id ингридиента и необходимое количество данного ингридиента.

===Окошко когда не хватает чарджера===
Позволяет добавлять окна. Окно добавляется кнопкой "Добавить локацию", окно можно переименовывать, удаляется кнопкой "Удалить локацию".

*'''название''' - текстовый объект в который вкладывается название чарджера.
*'''иконка''' - иконка чарджера.
*'''описание''' - текстовый объект в который вкладывается название чарджера.
*'''купить''' - кнопка покупка чарджера, передает economics состояние buy_charger.
*'''искать''' - кнопка поиска чарджера, передает economics состояние search_charger.
*'''есть''' - счетчик, который показывает сколько чарджеров есть сейчас.
*'''нужно''' - счетчик, который показывает сколько чарджерова необходимо для сдачи коллекции.
*'''цена ресурса 1''' - счетчик, который показывает цену чарджера в ресурсе 1.
*'''цена ресурса 2''' - счетчик, который показывает цену чарджера в ресурсе 2.
*'''достаточно''' - объект, который отображается вместо кнопки, в тот момент, когда чарджеров достаточное количество.

===Нехватка ресурсов на чарджер===
Позволяет изменить состояние выбранному объекту при нехватке ресурсов на чарджер. Добавляется кнопкой "Добавить локацию", можно переименовывать, удаляется кнопкой "Удалить локацию".

===Монстр===
В первой колонке добавляется монстр, добавляется кнопкой "Добавить локацию", если возможность переименовать, удаляется кнопкой "Удалить локацию"
Во второй колонке отображаются свойства выделенной колонки.

*'''Объект на карте''' - объект, который представляет монстра на карте. Как правило окно, которое должно иметь состояние hide (скрыт),show и disappear (прогнали).
*'''Имя монстра''' - текстовый id из которого берется иконка, имя и описание монстра.
*'''Экран''' - экран в котором расположена локация.
*'''min уровень''' - уровень, при достижении которого, появляется монстр.
*'''max уровень''' - уровень, при достижении которого, монстр исчезает.
*'''необходимый предмет''' - предмет необходимый для игры с духом.
*'''количество''' - количество предметов из поля "необходимый предмет".
*'''связанный баттл''' - поле в котором указывается связанный объект типа matchbattle.
*'''связанный матч''' - поле в котором указывается связанный матч.
*'''окно внутри монстра''' - объект, который покажем в экране с мини игрой в случае победы. Должен иметь состояния open - в случае обычной победы, open_win - если перешли на следующий уровень мастерства. Чтобы это окно перешло в одно из этих состояний передаем экономике состояние ''monster_win_wnd''.
*'''текст внутри монстра''' - текстовый объект, в который сложим поздравительный текст о переходе на следующий уровень мастерства.

В третей колонке записываются уровни мастерства. Их можно переименовывать. Добавляются уровни кнопкой "Добавить уровень мастерства", удаляются кнопкой "Удалить уровень мастерства".
В четвертой колонке настраивается выделенный уровень мастерства.

*'''энергия''' - энергия необходимая для того, что бы можно было начать играть в локацию.
*'''ресурс1''' - деньги даваемые за прохождение локации.
*'''опыт''' - опыт даваемый за прохождение локации.
*'''постоянный прирост''' - постоянный прирост.
*'''штраф за поражение''' - кол-во очков, которые отнимаются за проигрыш.
*'''очки''' - количество очков, которое необходимо набрать для перехода на следующий уровень мастерства.
*'''предметы''' - id коллекционных предметов, которые можно найти на локации. Предметы не обязательно должны быть из одной коллекции. Необходимые предметы перетаскиваются из текстового редактора, при этом будет использоваться их иконка.
*'''Вероятность''' - вероятность найти один из коллекционных предметов из поля "предметы".
*'''Вероятность 2''' - вероятность найти один из коллекционных предметов из поля "предметы".
*'''Вероятность 3''' - вероятность найти один из коллекционных предметов из поля "предметы".
*'''Инвентарь''' - id инвентарных предметов, которые можно найти на локации. Перетаскиваются из текстового редактора.
*'''Вероятность инв.''' - вероятность найти один из инвентарных предметов из поля "инвентарь".
*'''Вероятность инв. 2''' - вероятность найти один из инвентарных предметов из поля "инвентарь".
*'''Вероятность инв. 3''' - вероятность найти один из инвентарных предметов из поля "инвентарь".
*'''текст при разлочке уровня''' - текстовый id из которого возьмем поздравительный текст о разлочке нового уровня.
*'''жизни врага''' - записываются значения вражеских жизней.
*'''начальные жизни врага''' - начальное значение вражеских жизней.
*'''регенерация врага''' - время (в ms), за которое у противника отрастает жизнь. Если установлено -1, то отрастания жизни противника на происходит.
*'''число цветов''' - это число будет записываться в параметр numTokenNums матча.

Автоматические уровни мастерства отличаются всего несколькими дополнительными полями.

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

Также есть возможность перегружать некоторые параметры уровней мастерства. Для этого нужно выбрать монстра и в выпадающем списке вверху выбрать пункт "перегрузка параметров".Перегрузок может быть несколько.

Для настройки перегрузки нужно выбрать ее в 3 колонке, при этом в 4 колонке отобразятся параметры перегрузки.
Сейчас перегрузку можно привязать к уровням XP игрока и к уровню монстра. Под уровнем монстра имеется ввиду уровень мастерства, отсчет начинается с 0. Перегружать можно энергию, затрачиваемую на монстра, награду (золото и опыт), а также инвентарные и коллекционные предметы.

''Важно!'' Если поля инвентарных и коллекционных предметов оставить пустыми - то предметы выпадать не будут.

===Летающий объект===
Впервой колонке кнопкой "Добавить локацию" добавляется летающий объект - объекты которые вылетают после прохождения локации или после покупки сундуков. Удаляется кнопкой "Удалить локацию". Во второй колонке добавляется объект выделенного летающего объекта. Состояния hide, wait, inventory и collection - обязательны для этого предмета.

''hide'' - состояние, когда объект не видно на экране. В этом состоянии можно указать свойство alpha=0.

''wait'' - состояние, в которое попадают летающие объекты, которые отображают коллекционные предметы до того, как объекту economics будет вызвано состояние col_item_found.

''collection'' - состояние, которое будет вызвано летающему объекту, который отображает коллекционный предмет после того как объекту economics будет вызвано состояние col_item_found (он может лететь в таблицу с нужной коллекцией).

''inventory'' - состояние, которое вызывается летающему объекту в случае, если он отображает инвентарный объект (в этом состоянии предмет становится видимым и в дальнейшем может перемещаться).

===Аномалия===

В хидден-локации могут присутствовать аномалии, затрудняющие ее прохождение.
Впервой колонке добавляется аномалия, добавляется кнопкой "Добавить локацию", можно переименовывать, удаляется кнопкой "Удалить локацию".
Во второй колонке отображаются свойства выделенной аномалии.
*'''id''' - поле в которое перетаскивается текстовый id, из которого используется название, описание и иконка аномалии.
*'''предмет''' - предмет необходимый для того, что бы изгнать аномалию.
*'''экран''' - в этом поле указывается экран, в котором расположена мини игра.
*'''прибавка к энергии''' - указывается прибавка к энергии, поскольку для игры в аномалию будет нужно больше энергии. Например, при значении 0,5 - энергии потребуется больше в полтора раза.
*'''прибавка к опыту''' - указывается прибавка к опыту, поскольку игра в локацию с аномалией будет давать больше опыта. Например, при значении 0,5 - опыта приобретается больше в полтора раза.
*'''прибавка к ресурсу 1''' - указывается прибавка к ресурсу 1. поскольку игра в локацию с аномалией будет давать больше ресурса 1. Например, при значении 0,5 - ресурса 1 приобретается больше в полтора раза.

===Сдача коллекции===

В первой колонке добавляется событие на сдачу коллекции кнопкой "Добавить локацию", удаляется кнопкой "Удалить локацию".
Во второй колонке устанавливается состояние объекту сдачи коллекции.

===Временный эффект===

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

*'''иконка''' - из редактора ресурсов, перетаскивается иконка временного эффекта
*'''таймер''' - указывается объект типа timer, который соответствует выбранному временному эффекту.
*'''подложка''' - из редактора ресурсов, перетаскивается картинка подложки для таймера указанного в поле "таймер".

===Достижение===
В первой колонке записываются достижения. Добавляются кнопкой "Добавить локацию", удаляются кнопкой "Удалить локацию".
Во второй колонке отображаются свойства выбранного достижения.

*'''достижение''' - достижение, которое будет открываться по мере применения подобных предметов.

*'''процент''' - в виде числа, указывается процент достижения из поля "достижение".

*'''режим игры''' - указывается режим игры, ели 0 - режим игры не важен для достижения, 1 - режим игры слова, 2 - режим игры силуэты.

*'''аномалия''' - указывается аномалия необходимая для достижения, если указывается -2 - то аномалия не важна для достижения, если указывается -1 - то для достижения может использоваться любая аномалия.

==Состояния==

[[Файл:Economics 5.jpg|right]]
Перед вызовом некоторых состояний объекту economics необходимо передать параметр '''param''' и его значение. Например когда нам нужно открыть окно перед локацией мы передаем параметр номера этой локации в списке локаций (начиная с 0).

 
*'''idle''' - состояние по умолчанию.
*'''completed''' - передает состояние окончания исследования локации (необходим параметр номера локации), перед вызовом состояния, можно экономике заполнить поле '''additional_inv''' - перечнем инвентарных предметов которые хотим добавить пользователю ( поместить в таблицу + чтобы экономика поместила их в летающие объекты), через запятую (к примеру additional_inv="12345,25841") .
*'''exp''' - передает состояние начисления опыта (необходим параметр количества опыта). Нужен больше для тестирования, чем для самой игры.
*'''play''' - передает состояния перехода на локацию для исследования(при условии что хватит энергии и выполнены прочие условия).
*'''location''' - открывает окно перед локацией (необходим параметр номера локации).
*'''collection''' - заставляет экономикс заполнить таблицу коллекций. Лучше вызывать сразу перед открытием окна коллекций или во время его открытия.
*'''collections_scroll''' - заполняет таблицу коллекций и проматывает на коллекцию содержащую последний предмет для которого было показано окошко с информацией о предмете.
*'''collections_custom''' - перематывает таблицу к нужной коллекции. id коллекции записывается предварительно в param.
*'''item_collections''' - заставляет экономикс показать окошко с информацией о коллекционном предмете. Вызывается при тапе на таблицу в темплейте коллекций (объект ecollection).
*'''item_effect''' - сообщает economics, что необходимо показать окошко предмета от таймэфекта (необходим параметр номера эффекта)
*'''item_preview''' - заставляет экономикс показать окошко с информацией о предмете, который можно найти при обыске локации. Вызывается при тапе на таблицу с предметами в окне перед локацией.
*'''item_review''' - заставляет экономикс показать окошко с информацией о предмете, который нашли после обыска локации. Вызывается при тапе на таблицу с предметами в окне после локации.
*'''item_monster_preview''' - заставляет экономикс показать окошко с информацией о предмете, который можно найти при игре с монстром. Вызывается при тапе на таблицу с предметами в окне перед монстром.
*'''item_monster_review''' - заставляет экономикс показать окошко с информацией о предмете, который нашли после игры с монстром. Вызывается при тапе на таблицу с предметами в окне после монстра.
*'''completed_animation''' - состояние запускает анимацию полученной награды за прохождение локации после "окна после локации". Можно запускать из состояния закрытия окна после локации.
*'''unlock_item''' - передает состояние покупки предмета, необходимого для открытия локации. Как правило, предмет находится в окне перед локацией.
*'''unlock''' - передает состояние при котором происходит разлочка локации если текущий уровень на один ниже, чем необходимый для открытии локации или значение ''разница в уровнях'', позволяет разлочить локацию. Как правило кнопка для разблокирования локации размещается в окне перед локацией. Когда разница уровней достаточна, чтобы разлочить локацию машина локации переводится в состояние '''can_buy'''.
*'''completed_reward''' - вызывается объектом анимации награды после прохождения локации. Если объектов несколько (опыт, монеты, кристаллы), то вызывается только один раз одним из объектов.
*'''search_charger''' - производит поиск недостающего чарджера. Пока только по монстрам. Номер чарджера 0 или 1 - в парам.
*'''buy_charger''' - производит покупку недостающего чарджера (номер в параметре, -1 - купить все).
*'''update''' - обновить все локации на карте.
*'''level_up''' - проверяет получение нового уровня. Чтобы окно с получением нового уровня не открывалось самостоятельно, мы вызываем это состояние, когда нам удобно. Проверяется был ли получен новый уровень, если был, то вызывается окно с получением нового уровня.
*'''res1''' - Добавить ресурс 1 (значение в параметре).
*'''res2''' - Добавить ресурс 2 (значение в параметре).
*'''res1s''' - скорректировать статистику по ресурсу 1 (значение в параметре, когда, например, ресурс не заработан, а выигран в казино).
*'''res2s''' - скорректировать статистику по ресурсу 2 (значение в параметре, когда, например, ресурс не заработан, а выигран в казино).
*'''energy''' - Добавить энергию (значение в параметре).
*'''failed''' - текущая локация провалена (не дается опыта и прочих наград за прохождение локации). Требует параметра локации.
*'''item_effect''' - показать окошко предмета от таймэффекта. В param - номер эффекта.
*'''search_collection''' - проскроллить карту на локацию где можно найти коллекционный предмет. При этом машина локации (Объект на карте) будет переведена в состояние highlight, в котором локацию можно посветить или выделить ее каким-то образом.
*'''search_task''' - проскроллить карту на локацию где можно найти предмет из задания. При этом машина локации (Объект на карте) будет переведена в состояние highlight, в котором локацию можно посветить или выделить ее каким-то образом.
*'''search_charger''' - проскролить карту на монстр, в котором можно найти чарджер (необходимо значение чарджера в параметре 0 или 1).
*'''monster''' - Открыть превью для монстра с номером указанном в поле параметр.
*'''monster_play''' - Играть в мини игру выбранного монстра (при условии, что хватит энергии и выполнены прочие условия).
*'''monster_removed''' - Монстра прогнали предметами. Вычесть предметы и успешно завершить.
*'''monster_completed''' - Текущая мини игра так или иначе пройдена, перед вызовом состояния, можно экономике заполнить поле '''additional_inv''' - перечнем инвентарных предметов которые хотим добавить пользователю ( поместить в таблицу + чтобы экономика поместила их в летающие объекты), через запятую (к примеру additional_inv="12345,25841") .
*'''monster_failed''' - Текущая мини игра провалена, отличается от предыдущего тем, что не дается бонусного опыта и прочих наград.
*'''monster_buy''' - попытаться докупить предметы, необходимые для игры с монстром.
*'''col_item_param''' - Добавить коллекционный предмет, взяв его айди из параметра.
*'''anomaly_item''' - попытаться прогнать аномалию в текущей локации предметом. В зависимости от номера аномалии, машина локации (Объект на карте) переводится в состояние anomaly_N, где N - номер аномалии начиная с 0. (anomaly_0, anomaly_1 и т.д.). Таким образом можно визуализировать аномалию на карте.
*'''anomaly_game''' - попытаться прогнать аномалию в текущей локации мини игрой.
*'''anomaly_completed''' - мини игра по прогону аномалии успешно завершена.
*'''anomaly_buy''' - показать окно покупки для предмета прогона аномалии (в текущей локации).
*'''cheat_loc_level''' - "накачать" всем локациям скилл левел до максимума (для тестирования).
*'''chest_animation''' - анимировать последний использованный сундук.
*'''col_item_found''' - показать окошко с коллекцией для одного найденного коллекционного предмета из очереди.
*'''cheat_one_level''' - просимулировать один уровень развития игрока.
*'''purchase_ok''' - сообщает economocs что произошла покупка. Сформировать событие флури.
*'''buy_random_col''' - купить случайный коллекционный предмет.
*'''location_switch''' - переключить локацию на связанную (если есть предмет и собраны все артефакты, необходимые для перехода).
*''' anomaly_set_everywhere''' - генерация аномалии. Если в объекте Economics в параметре param указан номер аномалии, то состояние добавляет аномалию всем локациям, а если -1, то убирает аномалию из всех локаций.
*''' buy_artefact''' - осуществляет покупку артефакта для локации. Для этого у объекта economics в param должен быть записан номер локации, а в param2 номер артефакта (номер по порядку начиная с 0).
*'''show_artefacts''' - Показать таблицу покупки артефактов в param - номер локации
*'''location_buy_all_switchers''' - Купить все артефакты доступные для данной локации
*'''search_ingridient''' - переход в локацию для поиска ингредиента, который указан в param.
*'''search_needitem''' - поиск необходимого для исследования локации предмета из окна перед локацией. В param должен быть указан id необходимого предмета.

=Сопутствующие объекты=

Объекты, которые используются вместе с объектом economics и имеют с ним непосредственную связь:

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря(магазина) и экономики.
* [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина.
* [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря.
* [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий.
* [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания.
* [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции.
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры=
Данные параметры можно вычесть с помощью команды "var" в машине состояний. Параметры нужно вычитать из профиля, если не сказано обратное.
[id] - числовой id экономики в проекте, если не указана другая информация.

*'''ecomics[id].res1sp''' - количество потраченного ресурса_1 за все время игры;
*'''ecomics[id].res2sp''' - количество потраченного ресурса_2 за все время игры;
*'''ecomics[id].level''' - текущий уровень игрока;
*'''ecomics[id].res1''' - текущее количество ресурса_1;
*'''ecomics[id].res2''' - текущее количество ресурса_2;
*'''ecomics[id].res1ea''' - количество заработанного ресурса_1 за все время игры;
*'''ecomics[id].res2ea''' - количество заработанного ресурса_2 за все время игры;
*'''economics[id].stat.energy_spent''' - количество потраченной энергии за все время игры;
*'''ecomics[id].mplayed''' - количество сыгранных миниигр (монстр) за все время;
*'''ecomics[id].lplayed''' - количество сыгранных хидденов за все время;
*'''ecomics[id].total_score''' - количество заработанного опыта за все время игры;
*'''ecomics[id].exp''' - текущий опыт на уровне;
*'''ecomics[id].energy''' - текущий уровень энергии;
*'''ecomics[id].loc[loc_id].an''' - номер аномалии, которая будет в локации loc_id;

Каждая экономика пишет в пользователя следующие параметры:
*'''public.EconomicsRes1''' - текущее количество ресурса_1;
*'''public.EconomicsRes2''' - текущее количество ресурса_2;
*'''public.EconomicsLevel''' - текущий уровень игрока;
*'''public.EconomicsEnergy''' - текущий уровень энергии;
*'''public.EconomicsTotalScore''' - количество заработанного опыта за все время игры;
*'''public.EconomicsCollectionsUniq''' - количество сданных коллекций ( значение повышается каждый раз при сдаче коллекции), пишется Экономикой только если поле - '''fbopt''' не пустое;

[[Category:Game mechanic]]
[[Category:Economics|*]]

Wallet

2015-11-06T08:34:36Z

Beletsky:

[[Object|Объект]] '''Wallet''' необходим для начисления игровой валюты при InApp покупке через объект [[Economics]]

== Параметры объекта Wallet ==

*'''economics''' - ссылка на объект economics
*'''InApp - покупка'''
**'''Внутренний id покупки''' - Внутренний id покупки
**'''Монеты''' - количество монет
**'''кристаллы''' - количество кристаллов
**'''поле в опциях для множителя''' - ключ в опциях для множителя монет. ВАЖНО: указывать без идентификатора пользователя. Пример: ecomics65.stmult - без p0!
**'''базовая прибавка к статусу''' - прибавка к статусным очкам (тут будет ссылка на статус). Базовая - потому что будет множиться на коэф., который зависит от текущего статуса. Коэф. указывается в экономики в соответствующем разделе.

== Принцип работы ==

На успех покупки объект Wallet проверяет внутренний id и если находит совпадение в добавляемых свойствах, то начисляет указанное там количество монет и кристаллов.

== Состояния ==

* ''recalc'' - перезаписать значения монет и статусных очков, учитывая множители.

Ключ в опциях:

* ''wallet%d.i%s.res1'' - ключ к значению монет, учитывая множитель.
* ''wallet%d.i%s.status'' - ключ к значению статусных очков, учитывая множитель.

[[Category:Options]]

Wallet

2015-11-06T08:04:25Z

Beletsky: /* Параметры объекта Wallet */

[[Object|Объект]] '''Wallet''' необходим для начисления игровой валюты при InApp покупке через объект [[Economics]]

== Параметры объекта Wallet ==

*'''economics''' - ссылка на объект economics
*'''InApp - покупка'''
**'''Внутренний id покупки''' - Внутренний id покупки
**'''Монеты''' - количество монет
**'''кристаллы''' - количество кристаллов
**'''поле в опциях для множителя''' - ключ в опциях для множителя монет. ВАЖНО: указывать без идентификатора пользователя. Пример: ecomics65.stmult - без p0!
**'''базовая прибавка к статусу''' - прибавка к статусным очкам (тут будет ссылка на статус). Базовая - потому что будет множиться на коэф., который зависит от текущего статуса. Коэф. указывается в экономики в соответствующем разделе.

== Принцип работы ==

На успех покупки объект Wallet проверяет внутренний id и если находит совпадение в добавляемых свойствах, то начисляет указанное там количество монет и кристаллов.

[[Category:Options]]

Slotmachine

2015-09-21T07:42:56Z

Beletsky: /* Общие параметры */

Roadmap

2015-06-24T06:33:37Z

Beletsky:

'''Что нового в версии 3.60 beta:'''

*Поддержка многопоточности в Android и iOS.
*Обновление ключевых SDK (Facebook SDK 3.2.0 iOS/Android, MAT SDK 3.4.1 iOS/3.3.3 Android, Amazon Advertisment SDK 6.0.2 iOS/5.1.0 Android, Google Play Services 6587000, Flurry SDK 5.4.46, ChartBoost 5.1.3 iOS/Android и другие).
*Поддержка актуальной на данный момент версии Marmalade 7.5.1 и ниже.
*Новые утилиты для SceneEditor (редактирование viewer.xml, подсветка синтаксиса viewer.log, редактор app.icf и т.д)
*Новые игровые объекты (2048, Majong, Memory, Gemslider, Slotmachine, Words, Collaps, Match10, Dragbox, Pipes, TapTheBubble)
*Обновлены объекты работы с сервисами статистики и рекламы (AdMob, MobileAppTracking, Amazon Advertisement, ChartBoost, Flurry, Playhaven, Tapjoy).
*Импорт и отрисовка примитивных 3D моделей.
*Поддержка свободного видеокодека Theora (возможность воспроизведения видео формата OGV с каналом прозрачности).
*Поддержка динамической загрузки текстур, а так же формата BPG для многих платформ.
*Новый функционал экспорта проекта (менеджер паков, менеджер предзарузки графики, возможность использования 4k текстур).

'''Новая версия 3.0 Бета выход - '''
*Исправлено сохранение и загрузка проекта в редакторе сцен.
*Переход с Iw2D на IwGX. Доступ к созданию эффектов с использованием шейдеров.
*Добавлен игровой объект с готовыми наборами эффектов (туман, инверсия RGB, вода, блюр)
*Добавлена функция задания и движения по сплайну
*Добавлена функция ручного распределения (исключения) графических ресурсов по текстурами. Задание максимального размера текстуры. Оптимизирован алгоритм запаковки графики в текстуры.
*Упаковка текстур в PVR формат для iOS устройств. Уменьшение занимаемого размера графических файлов на диске в 3 раза, в видео памяти устройства в 8 раз. Уменьшение скрости загрузки в память устройства.
*Исправлена функция распределение текстур по пакетам для поэтапной подгрузки контента в приложение
*Добавлены новые игровые объекты
*Добавлена функция тайлинга графики для интерфейсных элементов.
*Добавлена система показа рекламы Amazone Ads
*Добавлены системы привлечения трафика Playhaven, Tapjoy, Facebook, ChartBoost.
*Добавлена система трекинга трафика Mobileapptracking
*Flurry Ads + SDK update поддержка iOS 7.0
*Добавлена поддержка многоячзычности в редакторе сцен
*Оптимизировано распределение памяти на устройстве, добавлен вывод отладочной информации.
*Уменьшено время загрузки на мобильных устройствах

[[Category:Main]]

Controls

2015-06-03T08:20:45Z

Beletsky: /* Примечание */

'''Controls''' - [[Object|объект]], используемый для выполнения каких либо действий по нажатию на клавиши клавиатуры или на девайсе.
{{TOC right}}
== Добавляемые параметры ==
[[Файл:Controls1.png|right]]
Открывается при нажатии правой кнопки мыши в поле параметров обьекта.

[[Файл:+.png]] '''Реакция на нажатие кнопки''' - При нажатии на кнопку перевести обьект в новое состояние.
*'''кнопка''' - Константа кнопки. (Таблица приведена ниже)
*'''объект''' - При клике на кнопку перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''Реакция на отпускание кнопки''' - При отпускании кнопки перевести обьект в новое состояние.
*'''кнопка''' - Константа кнопки. (Таблица приведена ниже)
*'''объект''' - При клике на кнопку перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

== Таблица констант клавиш ==

{| border="1"
|s3eKeyFirst = 0 || Invalid Key
|-
|s3eKeyEsc = 1 || Esc (cancel)
|-
|s3eKeyTab = 2, || Tab.
|-
|s3eKeyBackspace = 3, || Backspace.
|-
|s3eKeyEnter = 4, || Enter.
|-
|s3eKeyLeftShift = 5, || Left shift key.
|-
|s3eKeyLeftControl = 6, || Left control key.
|-
|s3eKeyReserved = 7, || Reserved, do not use.
|-
|s3eKeySpace = 8, || Key Space.
|-
|s3eKeyLeft = 9, || Key Left.
|-
|s3eKeyUp = 10, || Key Up.
|-
|s3eKeyRight = 11, || Key Right.
|-
|s3eKeyDown = 12, || Key Down.
|-
|s3eKey0 = 13, || Key 0 on device numberpad and on main keyboard.
|-
|s3eKey1 = 14, || Key 1 on device numberpad and on main keyboard.
|-
|s3eKey2 = 15, || Key 2 on device numberpad and on main keyboard.
|-
|s3eKey3 = 16, || Key 3 on device numberpad and on main keyboard.
|-
|s3eKey4 = 17, || Key 4 on device numberpad and on main keyboard.
|-
|s3eKey5 = 18, || Key 5 on device numberpad and on main keyboard.
|-
|s3eKey6 = 19, || Key 6 on device numberpad and on main keyboard.
|-
|s3eKey7 = 20, || Key 7 on device numberpad and on main keyboard.
|-
|s3eKey8 = 21, || Key 8 on device numberpad and on main keyboard.
|-
|s3eKey9 = 22, || Key 9 on device numberpad and on main keyboard.
|-
|s3eKeyA = 23, || Key A.
|-
|s3eKeyB = 24, || Key B.
|-
|s3eKeyC = 25, || Key C.
|-
|s3eKeyD = 26, || Key D.
|-
|s3eKeyE = 27, || Key E.
|-
|s3eKeyF = 28, || Key F.
|-
|s3eKeyG = 29, || Key G.
|-
|s3eKeyH = 30, || Key H.
|-
|s3eKeyI = 31, || Key I.
|-
|s3eKeyJ = 32, || Key J.
|-
|s3eKeyK = 33, || Key K.
|-
|s3eKeyL = 34, || Key L.
|-
|s3eKeyM = 35, || Key M.
|-
|s3eKeyN = 36, || Key N.
|-
|s3eKeyO = 37, || Key O.
|-
|s3eKeyP = 38, || Key P.
|-
|s3eKeyQ = 39, || Key Q.
|-
|s3eKeyR = 40, || Key R.
|-
|s3eKeyS = 41, || Key S.
|-
|s3eKeyT = 42, || Key T.
|-
|s3eKeyU = 43, || Key U.
|-
|s3eKeyV = 44, || Key V.
|-
|s3eKeyW = 45, || Key W.
|-
|s3eKeyX = 46, || Key X.
|-
|s3eKeyY = 47, || Key Y.
|-
|s3eKeyZ = 48, || Key Z.
|-
|s3eKeyF1 = 49, || Key F1.
|-
|s3eKeyF2 = 50, || Key F2.
|-
|s3eKeyF3 = 51, || Key F3.
|-
|s3eKeyF4 = 52, || Key F4.
|-
|s3eKeyF5 = 53, || Key F5.
|-
|s3eKeyF6 = 54, || Key F6.
|-
|s3eKeyF7 = 55, || Key F7.
|-
|s3eKeyF8 = 56, || Key F8.
|-
|s3eKeyF9 = 57, || Key F9.
|-
|s3eKeyF10 = 58, || Key F10.
|-
|s3eKeyNumPad0 = 59, || Key 0 on keyboard numberpad.
|-
|s3eKeyNumPad1 = 60, || Key 1 on keyboard numberpad.
|-
|s3eKeyNumPad2 = 61, || Key 2 on keyboard numberpad.
|-
|s3eKeyNumPad3 = 62, || Key 3 on keyboard numberpad.
|-
|s3eKeyNumPad4 = 63, || Key 4 on keyboard numberpad.
|-
|s3eKeyNumPad5 = 64, || Key 5 on keyboard numberpad.
|-
|s3eKeyNumPad6 = 65, || Key 6 on keyboard numberpad.
|-
|s3eKeyNumPad7 = 66, || Key 7 on keyboard numberpad.
|-
|s3eKeyNumPad8 = 67, || Key 8 on keyboard numberpad.
|-
|s3eKeyNumPad9 = 68, || Key 9 on keyboard numberpad.
|-
|s3eKeyNumPadPlus = 69, || Plus key on keyboard numberpad.
|-
|s3eKeyNumPadMinus = 70, || Minus key on keyboard numberpad.
|-
|s3eKeyNumPadEnter = 71, || Enter key on keyboard numberpad.
|-
|s3eKeyRSK = 72, || Right soft key.
|-
|s3eKeyLSK = 73, || Left soft key.
|-
|s3eKeyLS = 74, || Left shoulder button.
|-
|s3eKeyRS = 75, || Right shoulder button.
|-
|s3eKeyHash = 76, || Key #.
|-
|s3eKeyStar = 77, || Key * (on keyboard numberpad for normal keyboards).
|-
!colspan="2" align="center" | Select/ok button
|-
|s3eKeyOk = 78, || Select key.
|-
|s3eKeyCLR = 79, || CLR key.
|-
!colspan="2" align="center"| Volume
|-
|s3eKeyVolUp = 80, || Volume Up key.
|-
|s3eKeyVolDown = 81, || Volume Down key.
|-
!colspan="2" align="center"|Camera
|-
|s3eKeyCamera = 82, || Camera.
|-
|colspan="2"|
|-
|s3eKeyMic = 83, || Microphone button.
|-
|s3eKeyFn = 84, || Fn button.
|-
|s3eKeySym = 85, || Sym button.
|-
!colspan="2" align="center"| Call
|-
|s3eKeyAccept = 86, || call accept (talk).
|-
|s3eKeyEnd = 87, || call end (reject).
|-
|s3eKeyHomePage = 88, || Home key.
|-
|colspan="2"|
|-
|s3eKeyButton1 = 89, || Generic Button1.
|-
|s3eKeyButton2 = 90, || Generic Button2.
|-
|s3eKeyButton3 = 91, || Generic Button3.
|-
|s3eKeyButton4 = 92, || Generic Button4.
|-
|s3eKeyButton5 = 93, || Generic Button5.
|-
|s3eKeyButton6 = 94, || Generic Button6.
|-
|s3eKeyButton7 = 95, || Generic Button7.
|-
|s3eKeyButton8 = 96, || Generic Button8.
|-
|colspan="2"|
|-
|s3eKeyF11 = 97, || Key F11.
|-
|s3eKeyF12 = 98, || Key F12.
|-
|s3eKeyLeftAlt = 99, || Left Alt key.
|-
|colspan="2"|
|-
|s3eKeyRightControl = 100, || Right Control Key.
|-
|s3eKeyRightAlt = 101, || Right Alt Key.
|-
|s3eKeyRightShift = 102, || Right Shift Key.
|-
|s3eKeyBacktick = 103, || Backtick '`' Key.
|-
|s3eKeyComma = 104, || Comma ',' Key.
|-
|s3eKeyPeriod = 105, || Period '.' Key.
|-
|s3eKeySlash = 106, || Forward slash '/' Key.
|-
|s3eKeyBackSlash = 107, || Back slash '\' Key.
|-
|s3eKeySemicolon = 108, || Semicolon ';' Key.
|-
|s3eKeyApostrophe = 109, || Apostrophe (') Key.
|-
|s3eKeyLeftBracket = 110, || Left Bracket '[' Key.
|-
|s3eKeyRightBracket = 111, || Right Bracket ']' Key.
|-
|s3eKeyEquals = 112, || Equals '=' Key.
|-
|s3eKeyMinus = 113, || Minus '-' key on main keyboard.
|-
|s3eKeyCapsLock = 114, || Caps Lock key
|-
|colspan="2"|
|-
|s3eKeyNumPadPeriod = 115, || Period '.' key on numberpad
|-
|s3eKeyNumPadSlash = 116, || Slash '/' key on numberpad
|-
|s3eKeyNumLock = 117, || NumLock key
|-
|s3eKeyInsert = 118, || Insert key
|-
|s3eKeyHome = 119, || Home key
|-
|s3eKeyPageUp = 120, || Page Up key
|-
|s3eKeyPageDown = 121, || Page Down key
|-
|s3eKeyKbEnd = 122, || End key (on keyboard)
|-
|s3eKeyDelete = 123, || Delete key
|-
|s3eKeyPause = 124, || Pause key
|-
|s3eKeyAt = 125, || At '@' key
|-
|s3eKeyBack = 126, || Back key
|-
|s3eKeyMenu = 127, || Menu key
|-
|s3eKeySearch = 128, || Search key
|-
|s3eKey3DMode = 129, || 3D Mode key
|-
|s3eKeyMyApps = 130, || My Apps key
|-
|s3eKeyPrintScreen = 131, || Print screen key
|-
|s3eKeyScrollLock = 132, || Scroll lock key
|-
|colspan="2"|
|-
|s3eKeyAbsGameA = 200, || Abstract Game keyA.
|-
|s3eKeyAbsGameB = 201, || Abstract Game keyB.
|-
|s3eKeyAbsGameC = 202, || Abstract Game keyC.
|-
|s3eKeyAbsGameD = 203, || Abstract Game keyD.
|-
|s3eKeyAbsUp = 204, || Abstract Up.
|-
|s3eKeyAbsDown = 205, || Abstract Down.
|-
|s3eKeyAbsLeft = 206, || Abstract Left.
|-
|s3eKeyAbsRight = 207, || Abstract Right.
|-
|s3eKeyAbsOk = 208, || Abstract Ok.
|-
|s3eKeyAbsASK = 209, || Abstract action softkey.
|-
|s3eKeyAbsBSK = 210, || Abstract backwards softkey.
|-
|colspan="2"|
|-
|s3eKeyLeftWindows = 211, || The left Windows key.
|-
|s3eKeyRightWindows = 212, || The right Windows key.
|-
|s3eKeyLeftBackSlash = 213,|| The left backslash "\" key.
|}

==Использование==
[[Файл:Control_esc.png|right]]
Нужно создать экземпляр обьекта на экране. Желательно создавать его на глобальном экране, на сцене с опциями, т.к. в таком варианте клавиши будут доступны со всех экранов в проекте.

Далее задаем обьект и состояние в которое должна перейти машина. (На рис. это машина "esc" в состояние "choose").

Также задаем код клавиши, который берем из таблицы ( Код 1 - это клавиша "ESC").

=== Примечание ===
В отладочном Viewer клавиша пробел ([[Интерфейс Viewer#Клавиша SPACE|Space]]) отвечает за паузу. Это может вызвать проблемы при отладке нажатия/отпускания Space (s3eKeySpace = 8).

Для flash viewer клавишам-стралкам up, down, left, right отвечают коды из поля Abstract.

==Комбинации клавиш==

Ниже показан пример как можно реализовать нажатие комбинации клавиш ( SHIFT +Q )

[[Файл:Combo_cntrl1.png]] [[Файл:Combo_esc.png]]

== Пример ==

[http://fs5.absolutist.com/files/wikisample/controls.rar Download]

[[Category:Options]]

Простейший вывод версии приложения

2015-05-29T08:01:47Z

Beletsky:

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

== Реализация вывода информации об версии ==
Для реализации нам понадобиться один текстовый объект и одна запись в текстовой базе.

[[Файл:Text base.jpg|right]]
*'''1)''' В текстовой базе создаём запись с текстом: << Ver. ver_opt >>

[[Файл:Text obj var.jpg|right]]

*2) В нужном нам месте, создаём текстовый объект. В текстовом объекте ставим память ( чтобы в одной игровой сессии у нас единожды вычиталась переменная) и добавляем переменную:
::___'''''имя''''' - ver_opt ;
::___'''''объект''''' - '''Options''' ; - Ваши опции;
::___'''''параметр''''' - Version;

----
Второй вариант:
Добавить одну переменную и вписать её название с любым текстом в поле *text*.

[[Файл:Ver2fromoptions.png|right]]

:Полученный результат:

[[Файл:Text result.jpg]]

[[Category:Learning]]

Файл:Ver2fromoptions.png

2015-05-29T07:59:46Z

Beletsky:

Slotmachine

2015-05-05T06:25:09Z

Beletsky: /* Общие параметры */

Counter

2015-04-20T13:51:59Z

Beletsky: /* Состояния */

[[Файл:Counte.jpg|right]]
'''Counter''' - [[Object|объект]], который хранит значение целого положительного числа, значение которого могут изменять другие объекты. Используется для визуализации числа сделанных ходов или кликов в игре, количества оставшихся подсказок и т.п. Он может быть скрыт и использоваться для хранения целого числа, необходимого для работы других объектов, например, [[Machine|машинами состояний]].
== Общие параметры ==
Смотреть описание [[Object|Object]].
== Основные параметры ==
*'''res''' ('' res '') - Графический ресурс для отображения цифр ([[Интерфейс_ResourceEditor|анимированный клип]] из 10 фреймов: первый фрейм - 0, последний 9). Перетаскивается мышкой из редактора ресурсов.
*'''min''' ('' min '') - Минимальное значение счетчика.
*'''max''' ('' max'') - Максимальное значение счетчика.
*'''val''' ('' val '') - Начальное (текущее) значение счетчика.
*'''val2''' ('' val2 '') - Дополнительное значение счетчика. Только для время == 2.
*'''new_val''' ('' new_val '') - Новое значение. Будет записано в val при вызове состояния save.
*'''шаг (inc, dec)''' ('' dval '') - Величина, на которую изменяется счетчик при inc и dec ( min=1) ( если меняем значение во вьювере, после задания значения - инитим счётчик).
*'''dx между цифрами''' ('' digShift '') - Расстояние между цифрами.
*'''выравнивание''' ('' left ''):
:'''1''' - число будет выравниваться по левому краю (цифры числа сдвигаются слева направо);
:'''2''' - будет выравниваться по центру;
:'''0''' - выравнивание по правому краю.
*'''время''' ('' time ''):
:'''1''' - число будет считаться временем в секундах и отображаться в виде mm:ss. Двоеточие должно быть 11 кадром графического ресурса;
:'''2''' - будет отображаться разделитель и второе значение из поля val2, разделитель также из 11 кадра графики;
:'''0''' - будет отображенно число без форматирование во временную единицу.
'''Группа - времена''':
:'''невидимости''' ('' tmBeg '') - Время невидимости перед открытием;
:'''открытия''' ('' tmOpn '') - Время проявления от полной прозрачности к прозрачности, заданной в модификаторах;
:'''закрытия''' ('' tmCls '') - Время исчезания до полной прозрачности;
:'''изменения''' ('' tmChg '') - Время, за которое счетчик изменяется (inc, dec);
:'''шага изменения''' ('' tmChgIt '') - Скорость, с которой счетчик изменяется (inc, dec).
:'''скорость изменения''' ('' velChg'') - Время промежутков, через которые происходит обновление счетчика при изменении (inc, dec).
*'''сохранять в профиль''' ('' prof ''):
:'''1''' - значение будет сохранено в текущий профиль;
:'''0''' - сохранено глобально.
*'''игра''' ('' game '') - Имя игры (раздела в опциях), который надо вычитать для получения начального значения счетчика (например, для отображения результатов).
*'''уровень''' ('' level '') - Имя уровня (параметра в разделе игра - см.выше), который надо вычитать для получения начального значения счетчика (например, для отображения результатов). Раздел равен: game.level.

*'''Группа - шрифт''':
:'''имя''' ('' fn ''):
::'''число, начиная с 0''' - порядковый номер шрифта (чтобы отобразился шрифт, нужно каунтеру задать ресурс (res), ресурс во вьювере отображён не будет);
::'''-1''' - рисовать каунтер клипами.
:'''размер''' ('' fs '') - Размер шрифта в пикселях;
:'''цвет 1''' ('' fc '') - Цвет текста.

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

[[Файл:Counte_1.png|right]]
Меню выбора ''Добавляемые параметры'' к объектам активируется по нажатию правой кнопки мыши.

[[Файл:+.png]] '''dec: при уменьшении изменить объект''' ('' decChg '') - При уменьшении значения счетчика, изменить объект:
*'''объект''' ('' obj '') - При уменьшении значения счетчика, изменить этот объект;
*'''состояние''' ('' obj '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' st '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела dec''' ('' decIf '') - Условие при выполнении которого происходят изменения из раздела dec. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' val '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''dec: при уменьшении изменить объект''';
:'''0''' - если условие выполняется, работает '''dec: при уменьшении изменить объект'''.

[[Файл:+.png]] '''при опускании под min изменить объект''' ('' minChg '') - При уменьшении значения счетчика ниже min, изменить объект:
*'''объект''' ('' obj '') - При уменьшении значения счетчика ниже min, изменить этот объект;
*'''состояние''' ('' st '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела min''' ('' minIf '') - Условие при выполнении которого происходят изменения из раздела min. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' buy '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''при опускании под min изменить объект''';
:'''0''' - если условие выполняется, работает '''при опускании под min изменить объект'''.

[[Файл:+.png]] '''inc: при увеличении изменить объект''' ('' incChg '') - При увеличении значения счетчика, изменить объект:
*'''объект''' ('' obj '') - При уменьшении значения счетчика, изменить этот объект;
*'''состояние''' ('' st '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела inc''' ('' incIf '') - Условие при выполнении которого происходят изменения из раздела inc. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' buy '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''inc: при увеличении изменить объект''';
:'''0''' - если условие выполняется,работает '''inc: при увеличении изменить объект''';

[[Файл:+.png]] '''при превышении max изменить объект''' ('' maxChg '') - При увеличении значения счетчика более max, изменить объект:
*'''объект''' ('' obj '') - При увеличении значения счетчика более max, изменить этот объект;
*'''состояние''' ('' st '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела max''' ('' maxIf '') - Условие при выполнении которого происходят изменения из раздела max. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' buy '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''при превышении max изменить объект''';
:'''0''' - если условие выполняется,работает '''при превышении max изменить объект''';

== Состояния ==

Объект '''Counter''' обладает рядом состояний:
*'''dec''' - Уменьшить значение счетчика на 1;
*'''inc''' - Увеличить значение счетчика на 1;
*'''min''' - Установить счетчик в минимальное значение;
*'''max''' - Установить счетчик в максимальное значение;
*'''init''' - Переинициализировать счетчик;
*'''reset''' - Переустановить счетчик;
*'''read''' - Прочитать значение счетчика из опций;
*'''read_anim''' - Прочитать значение счетчика из поля в опциях; При этом: воспринимает параметры tmChg, tmChgIt, velChg. Это значит, что счетчик при передаче ему этого состояния, "прокручивает" графику до значения, считанного из опций. Это заменяет используемую связку последовательного изменения dval, передачи init и inc.
*'''save''' - Сохранить значение счетчика в опции.

== Пример ==

В качестве графического ресурса в счетчик перетаскивается анимационный клип из 10 кадров
с цифрами от 0 до 9 (кадров может быть больше, но первые 10 - это цифры). Диапазон изменения задается в полях '''min''', '''max'''. Начальное значение в поле '''val'''. Счетчик можно увеличивать или уменьшать, меняя ему состояния '''inc''' (увеличить на 1) и '''dec''' (уменьшить на 1).

Рассмотрим пример использования. Пусть есть счетчик и четыре кнопки. При помощи клика правой кнопки мыши, добавим каждой кнопке раздел "изменить состояние объекта", в котором при нажатии на кнопку будет вызываться состояние счетчика '''dec''', '''inc''', '''min''', '''max''' соответственно.
<center>
[[Файл:test_cnt_1.png]]
</center>
В результате, при клике на кнопку '''inc''' будет происходить увеличение цифр 0 до 30 . После достижения максимальной границы, равной 30, счетчик перестанет увеличиваться. Аналогично, при клике на кнопку '''dec''', можно уменьшить значения счетчика. Клик на кнопку '''min''' и '''max''' переводят значение счетчика в минимальное и максимальное значение соответственно.

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

'''Прямое изменение значения.'''

Значение счетчика можно изменить напрямую, например, их машины состояний:
<pre>
st = "wait"
{
click { go="change" } // при клике - идем в состояние "change"
}

st = "change"
{
set { obj=counter par="val" val="5" } // меняем значение счетчика
set { obj=counter st="reset" } // переустанавливаем его
wait{ go="wait" }
}
</pre>
При клике на машину, она переходит в состояние "change".
В этом состоянии устанавливается параметр счетчика '''val''' в значение 5, после чего он перезапускается, переводясь в состояние "'''reset'''" (параметр '''val''' является строковым и счетчику его нужно перечитать, что и делается в состоянии "reset"). Аналогично счетчик можно было бы перевести в состояние "init", но тогда он бы полностью переинитился (обновились бы все его параметры из начальных настроек). В состоянии "reset" обновляется только поле "val".

'''Достижение границ.'''

Пусть после серии уменьшений счетчика (состояния "dec") он достиг минимального значения '''min''' и попытался снизиться ниже. Этого не произойдет (ограничения не дают выйти за них).
При достижении границ счетчика можно изменить состояния или параметры других объектов.
Для этого необходимо в свойствах при помощи правой кнопки мыши добавить раздел:

[[Файл:+.png]] '''при опускании под min изменить объект''':
:'''объект''' - При уменьшении значения счетчика ниже min, изменить этот объект;
:'''состояние''' - Состояние в которое переводится объект;
:'''параметр''' - Параметр, который мы изменяем;
:'''значение''' - Новое значение параметра.

При изменении параметра переинициализировать объект не надо (это произойдет автоматически).

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

Пусть к примеру, разрешено 3 раза нажать на некоторую кнопку (например, хинт в игре). После 3-х изменений должно появляться окно с надписью "подсказки кончились" с кнопкой "close". При закрытии окна и повторной попытке нажать на кнопку, окно должно появляться снова.
Это можно сделать при помощи счетчика, двух кнопок, и машины состояний в виде окна (верхняя таблица справа - это машина состояния окна, ниже - свойства кнопки и счетчика):
<center>
[[Файл:counter3a.png]]
</center>

'''Значение из options.'''

Начальное значение счетчика можно задавать не только в редакторе (поле '''val'''), но и получать его сохраненное значение в [[Options|опциях игры]]. Пусть некоторая миниигра сохранила в опциях целое значение в переменной, например, с именем "scores". Тогда это значение будет присвоено счетчику, если в настройках счетчика в поле "уровень" написать "scores".

Если помимо поля "уровень" задано поле "игра", то значение для счетчика будет искаться
не в глобальных параметрах опций, а в разделе, определяемом полем "игра".
Если строка в поле "игра" разделено точками, то они определяют подразделы.
Так, если "уровень"="scores", а "игра"="puzzle.pack1", а xml файл options.xml
будет выглядеть примерно так:
<pre>
<obj nm="options" >
<puzzle>
<pack1 scores="3" />
</puzzle>
</obj>
</pre>
то начальное значение счетчика будет равно 3. Если такого раздела или поля не окажется,
то счетчик будет невидимым.

Напомним, что объект [[Options]] в игре существует в единственном экземпляре и должен находиться на экране, помеченном как глобальный.

[[Category:Main objects]]

Counter

2015-04-20T13:49:09Z

Beletsky: /* Основные параметры */

[[Файл:Counte.jpg|right]]
'''Counter''' - [[Object|объект]], который хранит значение целого положительного числа, значение которого могут изменять другие объекты. Используется для визуализации числа сделанных ходов или кликов в игре, количества оставшихся подсказок и т.п. Он может быть скрыт и использоваться для хранения целого числа, необходимого для работы других объектов, например, [[Machine|машинами состояний]].
== Общие параметры ==
Смотреть описание [[Object|Object]].
== Основные параметры ==
*'''res''' ('' res '') - Графический ресурс для отображения цифр ([[Интерфейс_ResourceEditor|анимированный клип]] из 10 фреймов: первый фрейм - 0, последний 9). Перетаскивается мышкой из редактора ресурсов.
*'''min''' ('' min '') - Минимальное значение счетчика.
*'''max''' ('' max'') - Максимальное значение счетчика.
*'''val''' ('' val '') - Начальное (текущее) значение счетчика.
*'''val2''' ('' val2 '') - Дополнительное значение счетчика. Только для время == 2.
*'''new_val''' ('' new_val '') - Новое значение. Будет записано в val при вызове состояния save.
*'''шаг (inc, dec)''' ('' dval '') - Величина, на которую изменяется счетчик при inc и dec ( min=1) ( если меняем значение во вьювере, после задания значения - инитим счётчик).
*'''dx между цифрами''' ('' digShift '') - Расстояние между цифрами.
*'''выравнивание''' ('' left ''):
:'''1''' - число будет выравниваться по левому краю (цифры числа сдвигаются слева направо);
:'''2''' - будет выравниваться по центру;
:'''0''' - выравнивание по правому краю.
*'''время''' ('' time ''):
:'''1''' - число будет считаться временем в секундах и отображаться в виде mm:ss. Двоеточие должно быть 11 кадром графического ресурса;
:'''2''' - будет отображаться разделитель и второе значение из поля val2, разделитель также из 11 кадра графики;
:'''0''' - будет отображенно число без форматирование во временную единицу.
'''Группа - времена''':
:'''невидимости''' ('' tmBeg '') - Время невидимости перед открытием;
:'''открытия''' ('' tmOpn '') - Время проявления от полной прозрачности к прозрачности, заданной в модификаторах;
:'''закрытия''' ('' tmCls '') - Время исчезания до полной прозрачности;
:'''изменения''' ('' tmChg '') - Время, за которое счетчик изменяется (inc, dec);
:'''шага изменения''' ('' tmChgIt '') - Скорость, с которой счетчик изменяется (inc, dec).
:'''скорость изменения''' ('' velChg'') - Время промежутков, через которые происходит обновление счетчика при изменении (inc, dec).
*'''сохранять в профиль''' ('' prof ''):
:'''1''' - значение будет сохранено в текущий профиль;
:'''0''' - сохранено глобально.
*'''игра''' ('' game '') - Имя игры (раздела в опциях), который надо вычитать для получения начального значения счетчика (например, для отображения результатов).
*'''уровень''' ('' level '') - Имя уровня (параметра в разделе игра - см.выше), который надо вычитать для получения начального значения счетчика (например, для отображения результатов). Раздел равен: game.level.

*'''Группа - шрифт''':
:'''имя''' ('' fn ''):
::'''число, начиная с 0''' - порядковый номер шрифта (чтобы отобразился шрифт, нужно каунтеру задать ресурс (res), ресурс во вьювере отображён не будет);
::'''-1''' - рисовать каунтер клипами.
:'''размер''' ('' fs '') - Размер шрифта в пикселях;
:'''цвет 1''' ('' fc '') - Цвет текста.

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

[[Файл:Counte_1.png|right]]
Меню выбора ''Добавляемые параметры'' к объектам активируется по нажатию правой кнопки мыши.

[[Файл:+.png]] '''dec: при уменьшении изменить объект''' ('' decChg '') - При уменьшении значения счетчика, изменить объект:
*'''объект''' ('' obj '') - При уменьшении значения счетчика, изменить этот объект;
*'''состояние''' ('' obj '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' st '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела dec''' ('' decIf '') - Условие при выполнении которого происходят изменения из раздела dec. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' val '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''dec: при уменьшении изменить объект''';
:'''0''' - если условие выполняется, работает '''dec: при уменьшении изменить объект'''.

[[Файл:+.png]] '''при опускании под min изменить объект''' ('' minChg '') - При уменьшении значения счетчика ниже min, изменить объект:
*'''объект''' ('' obj '') - При уменьшении значения счетчика ниже min, изменить этот объект;
*'''состояние''' ('' st '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела min''' ('' minIf '') - Условие при выполнении которого происходят изменения из раздела min. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' buy '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''при опускании под min изменить объект''';
:'''0''' - если условие выполняется, работает '''при опускании под min изменить объект'''.

[[Файл:+.png]] '''inc: при увеличении изменить объект''' ('' incChg '') - При увеличении значения счетчика, изменить объект:
*'''объект''' ('' obj '') - При уменьшении значения счетчика, изменить этот объект;
*'''состояние''' ('' st '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела inc''' ('' incIf '') - Условие при выполнении которого происходят изменения из раздела inc. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' buy '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''inc: при увеличении изменить объект''';
:'''0''' - если условие выполняется,работает '''inc: при увеличении изменить объект''';

[[Файл:+.png]] '''при превышении max изменить объект''' ('' maxChg '') - При увеличении значения счетчика более max, изменить объект:
*'''объект''' ('' obj '') - При увеличении значения счетчика более max, изменить этот объект;
*'''состояние''' ('' st '') - Состояние в которое переводится объект;
*'''параметр''' ('' par '') - Параметр, который мы изменяем;
*'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''условие при котором происходят изменения из раздела max''' ('' maxIf '') - Условие при выполнении которого происходят изменения из раздела max. Их может быть несколько (логический AND):
*'''объект''' ('' obj '') - Объект, свойства которого мы проверяем;
*'''состояние''' ('' st '') - Находится ли в этом состоянии объект;
*'''параметр''' ('' par '') - Имеет ли объект параметр в значении следующего поля;
*'''значение''' ('' val '') - Имеет ли объект параметр из следующего поля в этом значении;
*'''куплено''' ('' buy '') - Имя фичи для проверки её купленности;
*'''нет''' ('' not '') : Это условие должно не выполняться:
:'''1''' - если условие не выполняется, работает '''при превышении max изменить объект''';
:'''0''' - если условие выполняется,работает '''при превышении max изменить объект''';

== Состояния ==

Объект '''Counter''' обладает рядом состояний:
*'''dec''' - Уменьшить значение счетчика на 1;
*'''inc''' - Увеличить значение счетчика на 1;
*'''min''' - Установить счетчик в минимальное значение;
*'''max''' - Установить счетчик в максимальное значение;
*'''init''' - Переинициализировать счетчик;
*'''reset''' - Переустановить счетчик;
*'''read''' - Прочитать значение счетчика из опций;
*'''save''' - Сохранить значение счетчика в опции.

== Пример ==

В качестве графического ресурса в счетчик перетаскивается анимационный клип из 10 кадров
с цифрами от 0 до 9 (кадров может быть больше, но первые 10 - это цифры). Диапазон изменения задается в полях '''min''', '''max'''. Начальное значение в поле '''val'''. Счетчик можно увеличивать или уменьшать, меняя ему состояния '''inc''' (увеличить на 1) и '''dec''' (уменьшить на 1).

Рассмотрим пример использования. Пусть есть счетчик и четыре кнопки. При помощи клика правой кнопки мыши, добавим каждой кнопке раздел "изменить состояние объекта", в котором при нажатии на кнопку будет вызываться состояние счетчика '''dec''', '''inc''', '''min''', '''max''' соответственно.
<center>
[[Файл:test_cnt_1.png]]
</center>
В результате, при клике на кнопку '''inc''' будет происходить увеличение цифр 0 до 30 . После достижения максимальной границы, равной 30, счетчик перестанет увеличиваться. Аналогично, при клике на кнопку '''dec''', можно уменьшить значения счетчика. Клик на кнопку '''min''' и '''max''' переводят значение счетчика в минимальное и максимальное значение соответственно.

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

'''Прямое изменение значения.'''

Значение счетчика можно изменить напрямую, например, их машины состояний:
<pre>
st = "wait"
{
click { go="change" } // при клике - идем в состояние "change"
}

st = "change"
{
set { obj=counter par="val" val="5" } // меняем значение счетчика
set { obj=counter st="reset" } // переустанавливаем его
wait{ go="wait" }
}
</pre>
При клике на машину, она переходит в состояние "change".
В этом состоянии устанавливается параметр счетчика '''val''' в значение 5, после чего он перезапускается, переводясь в состояние "'''reset'''" (параметр '''val''' является строковым и счетчику его нужно перечитать, что и делается в состоянии "reset"). Аналогично счетчик можно было бы перевести в состояние "init", но тогда он бы полностью переинитился (обновились бы все его параметры из начальных настроек). В состоянии "reset" обновляется только поле "val".

'''Достижение границ.'''

Пусть после серии уменьшений счетчика (состояния "dec") он достиг минимального значения '''min''' и попытался снизиться ниже. Этого не произойдет (ограничения не дают выйти за них).
При достижении границ счетчика можно изменить состояния или параметры других объектов.
Для этого необходимо в свойствах при помощи правой кнопки мыши добавить раздел:

[[Файл:+.png]] '''при опускании под min изменить объект''':
:'''объект''' - При уменьшении значения счетчика ниже min, изменить этот объект;
:'''состояние''' - Состояние в которое переводится объект;
:'''параметр''' - Параметр, который мы изменяем;
:'''значение''' - Новое значение параметра.

При изменении параметра переинициализировать объект не надо (это произойдет автоматически).

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

Пусть к примеру, разрешено 3 раза нажать на некоторую кнопку (например, хинт в игре). После 3-х изменений должно появляться окно с надписью "подсказки кончились" с кнопкой "close". При закрытии окна и повторной попытке нажать на кнопку, окно должно появляться снова.
Это можно сделать при помощи счетчика, двух кнопок, и машины состояний в виде окна (верхняя таблица справа - это машина состояния окна, ниже - свойства кнопки и счетчика):
<center>
[[Файл:counter3a.png]]
</center>

'''Значение из options.'''

Начальное значение счетчика можно задавать не только в редакторе (поле '''val'''), но и получать его сохраненное значение в [[Options|опциях игры]]. Пусть некоторая миниигра сохранила в опциях целое значение в переменной, например, с именем "scores". Тогда это значение будет присвоено счетчику, если в настройках счетчика в поле "уровень" написать "scores".

Если помимо поля "уровень" задано поле "игра", то значение для счетчика будет искаться
не в глобальных параметрах опций, а в разделе, определяемом полем "игра".
Если строка в поле "игра" разделено точками, то они определяют подразделы.
Так, если "уровень"="scores", а "игра"="puzzle.pack1", а xml файл options.xml
будет выглядеть примерно так:
<pre>
<obj nm="options" >
<puzzle>
<pack1 scores="3" />
</puzzle>
</obj>
</pre>
то начальное значение счетчика будет равно 3. Если такого раздела или поля не окажется,
то счетчик будет невидимым.

Напомним, что объект [[Options]] в игре существует в единственном экземпляре и должен находиться на экране, помеченном как глобальный.

[[Category:Main objects]]