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

Text

2021-08-20T12:11:51Z

Dopryshko:

'''Text''' - [[Object|объект]] для отображения текстовой информации с поддержкой многоязычности. Для управления текстовыми ресурсами используется [[TextEditor]]. 
== Введение ==
[[Файл:2223.png]] 

Если необходимо разместить текст на сцене необходимо создать объект с типом text и перетащить на поле текстID текстовую строку из TextEditor. Также можно просто перенести их TextEditor выбранную текстовую запись, при этом автоматически создастся объект с типом Text. 

'''Обязательно в тексте ТекстовойБазы, после символа '|' должен стоять другой символ. Если делаем два переноса, это будет выглядеть: "текст| |тест".'''

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

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

=== Основные параметры ===

*'''res''' - Графический ресурс подложки на которой выводится текст. Перетаскивается мышкой из редактора текста (поле должно находится в состоянии редактирования). Может отсутствовать.
*'''текстID''' - Выводимый текст перетаскивается из ресурса текстов, для перетягивания поле в объекте Text должно быть в режиме редактирования. Решетка (#) разделяет на страницы, черта (|) - принудительный переход на новую строку.
*'''текст''' - Выводимый текст без использования базы текстовых ресурсов. Решетка (#) разделяет на страницы, черта (|) - принудительный переход на новую строку.
*'''textCanBeOptionsKey''' - позволяет выключить проверку на ключ в опциях (Если в поле '''text''' указать "x" - то с включённым функционалом, текстовый объект покажет значение из опций параметра "x"; Если выключено - отобразит "x");
*'''состояние''' - в поле указывается состояние текстового объекта, в которое он перейдет при загрузке экрана (это поле часто оставляют пустым, а состояния задают машиной).

'''!!! - Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.'''

[[Файл:Text1.PNG|800px|thumb|center]]

=== Дополнительные параметры ===

[[Файл:Text2.PNG|800px|thumb|right]]

'''Группа - форматирования'''

*'''dx''' - Бордюр (отступ текста слева и справа от границы прямоугольника объекта);
*'''dy''' - Бордюр (отступ текста сверху и снизу от границы прямоугольника объекта);
*'''отступ''' - Вертикальное расстояние между строчками в пикселях;
*'''h align''' - Горизонтальное форматирование. Если (c) - центрирование по горизонтали, если (r) - прижатие вправо;
*'''v align''' - Вертикальное форматирование. Если (c) - центрирование по вертикали.
[[Файл:2224.png|250px|center]]
[[Файл:Text11.png|250px|left]]
[[Файл:Text22.png|250px|center]]

 
*'''автоматическое уменьшение''' - Функция позволяет уменьшить размер шрифта, чтобы уместить текст внутри прямоугольника ( размеры текстового объекта).
*'''минимальный размер шрифта''' - Минимальный размер до которого уменьшит функция автоскейла.
*'''уменьшать до строк''' - Нужно для функционала автоматического уменьшения. Попытается строку преобразовать в n строк ( исп. для цен).
[[Файл:890a37f3ed.jpg|center]]
 

'''Группа - Параметры отображения текста'''

*'''время до открытия''' - Время перед началом проявления текста (от невидимого до заданной прозрачности);
*'''время открытия''' - Время проявления текста и подложки до alpha в начале;
*'''время закрытия''' - Время исчезновения текста и подложки от alpha до 0 в конце. Если отрицательно - текст не закрывается;
*'''буквы''' - Задержка в ms для перехода к новой букве при подсветке;
*'''слова''' - Задержка в ms перед подсветкой следующего слова;
*'''страницы''' - Задержка в ms перед переходом к следующей странице или увяданию по alpha-каналу.

'''Группа - Параметры используемого [[шрифт]]а'''

*'''имя''' - Номер [[шрифт]]а - целое число, начиная с 0 (порядковый номер шрифта).
*'''размер''' - Размер [[шрифт]]а в поинтах.
*'''цвет 1''' - Цвет текста начального вида (бледный).
*'''цвет 2''' - Цвет прочитанного текста (контрастный). Чтение делается по буквам.

'''Группа - Время'''
*'''до появления символов''' ( '''tmBefore''' ) - Время до появления символов по alpha-каналу. Только для режима спрятанных символов; Пауза перед стартом анимации (по сути отсрочка сост. "start");

'''Группа - Параметры поведения текста'''

*'''автопромотка''' - Автоматический переход на следующую страницу после завершения отображения текста;
* '''зациклить''' - Зациклить страницы (после последней, перейти опять на первую);
*'''подсветка''' - Тип подсветки: 0-не подсвечивать, 1-по слову; 2-по букве слова (караоке); 3-по букве с начала страницы;
*'''звук''' - 1 - есть озвучка, 0 - нет;
*'''случайный выбор''' - 1 - при переключении страницы будет выбираться случайная, 0 - все страницы последовательно. Если выбрана 1 - в редакторе Texts Editor между страницами надо поставить знак #.
*'''прятать % символов''' ( ''' hidesymbols ''' ) - указанный процент символов которые будут спрятаны;
Тонкости исп. ''' hidesymbols ''':
при сост. "init" - буквы будут выставленны моментально
при изменение параметра и передаче сост. "start" - буквы будут проявляться за время "проявления одного символа" ("tmAppear");
Добавленные буквы после сост. "start" записываются в текстовом объекте в поле "appearingChars" с разделителем "|" ;
П.С. текстовый объект сохраняет маску спрятанных букв в опции ( до тех пор, пока не меняется количество символов - т.е. поменяв txtID или локализацию - маска перегенерируется);

 Например:

[[Файл:Text3.PNG|800px|thumb|center]]

*'''голос''' - голос для озвучки. Звуковой файл для одной реплики.
*'''позиционирование текста'''
** горизонтальное - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому;
** вертикальное - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему.

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

[[Файл:Menadd.png|300px|right]]
Меню выбора ''Добавляемые параметры'' к объектам активируется по правой кнопки мыши.

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

Все состояния:

*'''beg''' - по прохождению времени из поля время->до открытия переходит в состояние ''open'';
*'''start''' - форматирует текст, после чего переходит в состояние ''beg'';
*'''open''' - проявляет текст по альфе за время, указанное в поле время->открытия и переходит в состояние ''first'';
*'''run''' - выводит текст из поля txt/txtID по правилам из группы "Подсветка";
*'''pause''' - остановка вывода текста в обьект на подсвеченом слове;
*'''wait''' - показ последней напечатанной страницы, ожидание следующей команды;
*'''first''' - запустить показ первой страницы текста (страницы отделяются в текстовом ID символами #) в соответствии с правилами подсветки;
*'''last''' - запустить показ последней страницы текста (страницы отделяются в текстовом ID символами #) в соответствии с правилами подсветки;
*'''next''' - запустить показ следующей страницы текста в соответствии с правилами подсветки (если текущая страница - последняя, то в этом состоянии ничего не произойдет);
*'''prev''' - запустить показ предыдущей страницы текста в соответствии с правилами подсветки (если текущая страница - первая, то в этом состоянии ничего не произойдет);
*'''close''' - плавно растворяет текст по альфе в течении времени, указанном в поле время->закрытия, после чего переходит в состояние ''end'';
*'''cross''' - зачеркнуть текст;
*'''end''' - убрать текст из текстового обьекта.

=== Параметры ===

*'''txtID''' - меняет объекту текстовый id. Перетягиваем из текстового редактора в поле ''val_txt'' необходимый текстовый id.
*'''fc1''' - предоставляет возможность изменить цвет шрифта текстового объекта. В поле ''val'' вписывается цвет в виде 16-го кода.
*'''sense''' - позволяет отображать разные поля текстового id. Если установить значение 0 - у текстового объекта будет отображаться поле ''word'', если 1 - ''sentence1'', если 2 - ''sentence2''.
*'''textWidth''' - ширина текущего текста в текстовом объекте в px (с учетом параметров форматирования текстового объекта).
*'''textHeight''' - высота текущего текста в текстовом объекте в px.

== Пример применения ==

[[Файл:Text3.PNG|800px|thumb|center]]

[[Файл:Ex3.PNG|800px|thumb|center]]

== Примечания и дополнения ==

* Если у одного текстового ID слишком много страниц или же они должны меняться в запутанном порядке, то лучше создать несколько тестовых ID и по очереди присваивать их одному текстовому объекту с помощью машины состояний: команда ''set'', параметры ''obj''(текстовый объект), ''par''(txtID), ''val_txt''(текстовый ID, перетаскивается кнопкой мыши из редактора текстов).
* Отображать и делать невидимым текст можно несколькими способами, например, менять общие параметры vis или al, но целесообразней использовать состояния текстового объекта ''start'' и ''close''.
* Разделение строк в текстовой базе символом ''#'' можно использовать, если страниц 2(3). В этом случае для смены страниц используют состояние ''next''. Если страниц больше 2(3), лучше создать несколько текстовых ID и присваивать их текстовому объекту с помощью машины состояний.
* Значения временных параметров по умолчанию:
:время до открытия - 0,
:время открытия - 500,
:время закрытия - 500,
:буквы - 30,
:слова - 30,
:страницы - 500.
:Другими словами такие значения параметров равносильны нулю.
'''Для постепенного открытия (закрытия) текста следует указывать временные параметры отличные от значений по умолчанию.'''

=== Картинка в тексте ===

----

:Иконка будет вставлена в текст, если будет символы - $id167$al0.5$dx5.

:Расшифровка:
::$ - карявка для определения, что впереди что-то есть
::id167 - указываем отрисовать картинку с id==167 ( картинка должна присутствовать на этом экране, иначе не покажется; Если картинки нету в ресурсной базе - будет выполнено два пробела);
::$al0.5 - указываем альфу картинки;
::$dx5 - указываем что картинку смещаем на 5-ть пикселей вправо от точки вставки;

:Примечание:
::1) Если не указываем $al0.5 или $dx5, то берём стандартное значение ( к примеру $id167 - означает картинка 167 с альфой==1 и без смещения (dx==0));
::2) al и dx могут могут быть в любом порядке.
::3) Записывать в текст спец. символы можно и через переменную;
::4) Текст по высоте будет смещён на половину высоты самой большой картинки в строке ( если половина высоты больше размера шрифта);
::5) иконка вставляемая в текст должна быть без лишней альфы ( при отступах учитывается ширина и высота картинки).

:Пример:

[[Файл:Viewer 2.jpg]]

[[Файл:Viewer 3.jpg]]

[[Файл:Viewer.jpg]]

=== Цветной текст ===

----

:Текстовый объект, если встретит в тексте символы $c0xFF46FF26 ( обязательно пробел до символов и после), то последующий текст будет перекрашен в указанный цвет.
'''!!! Нельзя указывать вначале текстовой ячейки или сразу после #.'''
'''После перекрашивания не ставим пробел, должен быть символ ( нельзя так : "текст $c0xFF46FF26 текст2")'''

:Расшифровка:
::$c0xFF46FF26
::$ - карявка для определения, что впереди что-то есть
::с - типа color
::0xFF46FF26 - код цвета 0xFF46FF26 ( 0x - обязательно ( указываем 16-тиричную систему исчисления), FF - альфа, 46 - число по Red каналу, FF - Green канал, 26 - Blue канал).
[[Файл:Select Color.jpg]]

:Пример:
::Текст_1 $c0xFF46FF26 Текст_2
::Текст_1 - будет цветом указанным в текстовом объекте, а Текст_2 - будет зелёным.
[[Файл:Viewer 4.jpg]]

[[Category:Main objects]]

Economics

2021-08-02T09:03:15Z

Dopryshko:

[[Object|Объект]] '''Economics''' служит для реализации сложной игровой механики типа "ферма". Он осуществляет связь между игровыми локациями, накопленным опытом, текущим количеством энергии, денег и кристаллов (можно использовать и другие названия ресурсов), а также управляет объектами коллекций, магазина, инвентаря и игровых заданий.

= Свойства =

*'''предметы''' - Объект типа [[eitems]].
*'''задачи''' - Объект типа [[taskorganizer]].

==Параметры==
===Основные параметры===
*'''disable''' - выключена ли экономика, если 1 - то экономика не реагирует на состояния и не сейвится в опции. Чтобы изменить параметр, меняем его и вызываем сост. "init"
*'''Сдвиг уровней''' ( ''levels_shift'' ) - число на которое сдвинется анлок уровней в economics setup; после задания параметра нужно проинитить экономику;
*'''Уровни''' - опыт, необходимый для перехода на следующий уровень. Последовательность чисел через запятую.
*'''Уровни парабола''' - Три числа через запятую, задающие коэффициенты параболы, которые определяют необходимый опыт после уже перечисленных уровней.
*'''Энергия''' - максимум энергии на каждом из уровней. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Энергия прибавка''' - Число определяющее прибавку к максимуму энергии после уже перечисленных уровней.
*'''Ресурс 1''' - количество ресурса 1 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Ресурс 2''' - количество ресурса 2 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Перезарядка''' - время за которое восстанавливается единица энергии в ms.
*'''нач. ресурс 1''' - Начальное значение ресурса 1.
*'''нач. ресурс 2''' - Начальное значение ресурса 2.
*'''время напоминания''' - время напоминания о задачах на каждом из уровней. Записывается в виде последовательности чисел через запятую. Последнее значение будет зациклено для всех последующих уровней. Время изменяется в часах.
*'''напоминание об энергии''' - уведомление перетаскивается с текстового редактора, представляет собой напоминание о том что энергия восстановилась. Например, "Ваше энергия полностью восстановлена". (устанавливается, когда энергии становится меньше 30%).
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32 битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние
*'''перегрузить очки из опций''' - если поле не пустое - будут взяты очки из поля опций текущего пользователя, указаного в этой строке.
*'''во временные отправлять''' - какие очки будут отправлены во временные лидерборды esocial'ом. При выборе '''кастомное заполнение''' будут отправлены очки из поля temporary_lb_score в опциях текущего пользователя (p0.temporary_lb_score например). Кастомные очки нужно добавлять вручную, по окончанию периода они будут обнулены автоматически.
*'''округление res1 и т.п. до кратных 5''' ( ''bonusroundup'' ) - нужно ли округлять бонусные монеты и опыт для локации до кратных 5.

===Основные счетчики===
Этот раздел содержит необходимые объекты для подсчета (counter, timer, progressbar).

*'''Уровень''' - счетчик текущего уровня игрока.
*'''Прогресс в уровне (счетчик)''' - Набранный на этом уровне опыт и остаток до следующего уровня (счетчик).
*'''Прогресс в уровне (бар)''' - Набранный на этом уровне опыт и остаток до следующего уровня (прогрессбар).
*'''Опыта до уровня''' - счетчик показывающий сколько опыта необходимо для перехода с текущего уровня на следующий.
*'''Текущая энергия''' - прогрессбар текущей энергии.
*'''Максимальная энергия''' - счетчик, который отображает значение максимальной энергии.
*'''Таймер энергии''' - таймер отображающий время до восстановления единицы энергии.
*'''Таймер всей энергии''' - таймер, который отображает время до восстановления всей энергии.
*'''Ресурс 1''' - счетчик первого ресурса (денег).
*'''Ресурс 2''' - счетчик второго ресурса (кристаллов).
*'''анимация рес.1''' - Анимационный объект награды в ресурсе 1. Должен иметь состояние show.
*'''анимация рес.2''' - Анимационный объект награды в ресурсе 2. Должен иметь состояние show.
*'''анимация опыт''' - Анимационный объект награды в опыте. Должен иметь состояние show.

===Окно перед локацией===
Настройка окна, которое всплывает перед посещением локации. В этом окне отображается информация о локации которую мы хотим посетить.

*'''Окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояния ''open'' - открыта, ''open_lvl'' - не хватает лвл, ''open_buy'' - разница в уровнях позволяет нам купить анлок, ''open_item'' - не хватает предмета для анлока, ''open_unlock'' - состояние вызываемое окну перед локацией после успешной покупки предмета для анлока, ''open_energy'' - состояние вызываемое окну перед локацией в случае нехватки энергии, ''open_need_item'' - состояние, вызываемое окну перед локацией в случае нехватки предмета, ''open_need_item_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''' - счетчик, отображающий количество призовых денег.
*'''бонусный ресурс 1''' - счетчик дополнительной награды res1, которая дается за амулеты.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''бонусный опыт''' - счетчик дополнительного опыта, который дается за амулеты.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''иконка предмета''' - картинка, которая отображает предмет необходимый для игры с монстром.
*'''нужно предметов''' - счетчик, который отображает необходимое количество предметов.
*'''есть предметов''' - счетчик, который отображает текущее количество предметов, находящееся в наличии.
*'''суммарная стоимость''' - счетчик, который отображает суммарную стоимость недостающих предметов.
*'''кнопка купить''' - кнопка, по нажатию которой, происходит покупка недостающих предметов.
*'''кнопка прогнать''' - кнопка, по нажатию которой, можно прогнать монстра не играя в игру, эту кнопку можно не задавать.

===Окно после монстра===

*'''окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние open.
*'''превью монстра''' - картинка, отображающая превью монстра.
*'''название монстра''' - текстовый объект, показывающий название монстра.
*'''описание монстра''' - текстовый объект, показывающий описание монстра.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''бонусный ресурс 1''' - счетчик дополнительной награды res1, которая дается за амулеты.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''бонусный опыт''' - счетчик дополнительного опыта, который дается за амулеты.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''ничего не найдено''' - любой объект, сообщающий игроку, так или иначе, что он не нашел ничего ценного на данной локации.

===Окно коллекций===

*'''Шаблон коллекции''' - ссылка на объект типа 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_setup мы укажем монстру в поле награда опыт - 0, то экономика начислять опыт не будет).

*'''локация энергия''' - стоимость энергии на игру хидн или монстр;
*'''локация опыт''' - награда за успешное прохождение локации/монстра ( при условии что для монстра в поле награды не стоит 0 );
*'''коллекция опыт min''' - минимальный опыт за успешную сдачу коллекции;
*'''коллекция опыт max''' - максимальный опыт за успешную сдачу коллекции;
*'''коллекция монеты min''' - минимальная награда за успешную сдачу коллекции;
*'''коллекция монеты max''' - максимальная награда за успешную сдачу коллекции;

==Поле economics setup==
По клику на "..." открывается редактор экономикса. В этом редакторе можно задать все настройки локациям и коллекциям, которые используются в игре.

[[Файл:Economics 1.jpg|500px]]

Economics setup содержит 11 вкладок : локация хидден, коллекция, предметы, окошко когда не хватает чарджера (чарджер), нехватка ресурсов на чарджер, монстр, летающий объект, аномалия, сдача коллекции, временный эффект, достижение.
Вверху можно увидеть ряд кнопок для добавления и удаления: справа для локаций, слева для уровней мастерства.

----

===Локация хидден===

Форма редактора экономикса разделена на 4 колонки. В первой колонке мы видим список локаций, используемых в игре. Имена локаций можно изменять. Добавляются новые локации по нажатию на кнопку ''Добавить локацию'', удаляются кнопкой ''Удалить локацию''. Во второй колонке отображаются свойства выделенной локации.

[[Файл:Economics 2.jpg|right]]
*'''Объект на карте''' - это объект ведущий в локацию с карты. Должен иметь как минимум состояния open и closed, которые ему будет вызывать экономикс.
*'''индиктор уровня''' - каунтер, который будет отображать номер уровня, начиная с которого локация доступна.
*'''Экран''' - экран, в котором расположен локация.
*'''Превью локации''' - графический ресурс для отображения превью локации из базы ресурсов.
*'''Имя локации''' - название локации, перетаскивается из текстовой базы.
*'''Описание локации''' - описание, перетаскивается из текстовой базы.
*'''Уровень''' - уровень требуемый для того, чтобы играть в локацию.
*'''Результат''' - имя поля в опциях, куда локацией будет занесен результат. Расчитываем найти там число.
*'''Связанный хидден лист''' - хидден-лист, связанный с локацией.
*'''необходимый предмет''' - предмет необходимый для входа в локацию. Может быть как коллекционным, так и инвентарным.
*'''разница в уровнях''' - разница в уровнях, при которой можно купить доступ в локацию.
*'''цена ресурс 1''' - если наш уровень ниже необходимого на разницу из верхнего поля, мы можем разлочить локацию за деньги.
*'''цена ресурс 2''' - если наш уровень ниже необходимого на разницу из верхнего поля, мы можем разлочить локацию за кристаллы.
*'''достижение''' - достижение, которое будет открываться по мере игры в эту локацию.
*'''процент''' - проценты достижения из предыдущего поля.
*'''объект для музыки''' ('''musObj''') - объект которому в поле "location_music" будет записан id музыки из поля "музыка", при запуске локации;
*'''музыка''' ('''musId''') - id музыки локации;

В третей колонке записываются уровни мастерства. Их можно переименовать. Добавляются кнопкой ''Добавить уровень мастерства''. Удаляются кнопкой ''Удалить уровень мастерства''. В четвертой колонке настраивается выделенный уровень мастерства.

[[Файл:Economics 3.jpg|right]]
====Уровень мастерства====
*'''энергия''' - энергия требуемая для того, чтобы играть в локацию.
*'''ресурс 1''' - деньги даваемые за прохождение локации.
*'''ресурс 2''' - кристаллы даваемые за прохождение локации.
*'''опыт''' - опыт даваемый за прохождение локации.
*'''кол-во объектов''' - максимальное количество доступных для поиска объектов в одной игровой сессии.
*'''время игры''' - общее время игры (если -1, то игнорируется).
*'''время игры (блиц)''' - время игры с аномалией "блиц".
*'''время игры (аном)''' - время игры с остальными аномалиями.
*'''режим игры''' - режим игры: 0 - случайный, 1- слова, 2 - силуэты, 3 - поиск отличий;
*'''использовать различия''' - да - будут генирироватся режим поиска отличий, нет - не будут; Для корректной работы, следующей за сценой с хидн предметами, должна находиться пустая сцена с такими же параметрами как и у сцены с хидн предметами. Также между двумя сценами ( хидн и fake-сценой) должна быть связь по тасканию;
*'''аномалия''' - вероятность возникновения аномалии в локациях.
*'''доступные аномалии''' - перечень доступных на данном уровне мастерства аномалий. Записываются в виде чисел через запятую. Доступные значения 0, 1, 2, 3, 4.
*'''множитель''' - коэффициент, на который умножаются набранные очки. при расчете перехода на следующий уровень. Может быть меньше 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 - предмет после покупки не пропадает, если 3 - предмет покупается один раз, остальные разы только применяется

*'''res1''' - цена предмета в ресурсе 1.

*'''res2''' - цена предмета в ресурсе 2.

*'''sres1''' - продажа - цена предмета в ресурсе 1.

*'''sres2''' - продаже - цена предмета в ресурсе 2.

*'''en''' - восстанавливает энергии единовременно.

*'''tm''' - длительность действия в секундах. Если поставить "-1", то действие предмета будет вечным, отображаться в таблице амулетов он не будет. Можно активировать сколько угодно раз. "-2" - действие предмета будет вечным, но активно не более одной копии.

*'''dTm''' - уменьшение времени восстановления энергии в %.

*'''dFnd''' - увеличение вероятности нахождения предмета в %.

*'''dExp''' - увеличение начисляемого опыта в %.

*'''dRes1''' - увеличение полученного ресурса 1 в %.

*'''dRes2''' - увеличение полученного ресурса 2 в %.

*'''dOvP''' - увеличение перегруженной вероятности нахождения предметов в %.

*'''dMaxEn''' - увеличение максимума энергии в %.

*'''dBonus1''' - накопительный монетный бонус (в случае, если предмет дает ежедневный денежный прирост). Суммируется (от всех предметов имеющих это поле отличное от 0) и записывается в поле total_amulet_bonus1 экономикса. Автоматически не начисляется.

*'''dBonus1''' - накопительный кристальный бонус (в случае, если предмет дает ежедневный денежный прирост). Суммируется (от всех предметов имеющих это поле отличное от 0) и записывается в поле total_amulet_bonus2 экономикса. Автоматически не начисляется.

*'''dPurchase''' - к каждой покупке предмета добавляется еще столько таких же предметов. Актуально в тех случаях, когда приобретение предмета активирует акцию 1+1.

*'''dIsomover''' - ускорение взаимодействия изомуверов в %. (Каждому изомуверу, на который должно распространяться действие, нужно включить флаг "использовать бонусы ко времени").

*'''область применения''' - область, в которой будет учитываться бонус от предмета (везде, локация, монстр).

*'''KOfflineRep''' - пока действует предмет, меняем KOffline репутации (настраивается в свойствах экономики в группе репутации) на этот параметр. Область действия от -1 до 1. Поэтому дефолтное значение этого параметра "-2".

*'''dHdnConst''' - Увеличение значения поля постоянный прирост в %

*'''num''' - число предметов в сундуке. Выбираются случайно из следующего поля. При 0 - следующее поле не используется.

*'''items''' - предметы, которые можно найти в сундуке. Перетаскиваются из текстовой базы.

*'''use_id''' - задание этого поля говорит о том, что данный предмет является оптовым пучком для предмета указанного у этом поле. Num, в этом случае, - количество.

*'''объект''' - связанный объект, будет добавляться в инвентарь.

*'''достижение''' - достижение, которое будет открываться по мере применения подобный предметов.

*'''процент''' - процент достижения их предыдущего поля.

*'''владелец''' - на данный момент - номер правильной кнопки в окне угадайки (если -1. то игнорируется).

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

*'''обработчик конца действия''' - объект, обработчик конца действия амулета.

*'''состояние обработчика''' - состояние обработчика конца действия амулета (объект из поля выше будет переведен в это состояние по окончанию действия амулета).

*'''дарить с уровня''' - уровень с которого возможно дарить этот предмет

*'''кнопка применить - поле в опциях''' ( '''btn_use_field''' ) - для применяемого предмета, указываем поле для проверки значения, если условие истинно - кнопка применить будет доступна; иначе - выключена ("disable");
*'''кнопка применить - значение''' ( '''btn_use_val''' ) - значение для проверки условия, в поле '''кнопка применить - поле в опциях''';
*'''кнопка применить - НЕ''' ( '''btn_use_not''' ) - от результата сравнения взять обратное;

====Создание предметов (крафт)====

В третьей колонке можно добавлять ингридиенты из которых состоит предмет. Ингридиенты сами по себе являются также инвентарными предметами. В четвертой колонке указывается текстовый id ингридиента и необходимое количество данного ингридиента.

===Окошко когда не хватает чарджера===
Позволяет добавлять окна. Окно добавляется кнопкой "Добавить локацию", окно можно переименовывать, удаляется кнопкой "Удалить локацию".

*'''название''' - текстовый объект в который вкладывается название чарджера.
*'''иконка''' - иконка чарджера.
*'''описание''' - текстовый объект в который вкладывается название чарджера.
*'''купить''' - кнопка покупка чарджера, передает economics состояние buy_charger.
*'''искать''' - кнопка поиска чарджера, передает economics состояние search_charger.
*'''есть''' - счетчик, который показывает сколько чарджеров есть сейчас.
*'''нужно''' - счетчик, который показывает сколько чарджерова необходимо для сдачи коллекции.
*'''цена ресурса 1''' - счетчик, который показывает цену чарджера в ресурсе 1.
*'''цена ресурса 2''' - счетчик, который показывает цену чарджера в ресурсе 2.
*'''достаточно''' - объект, который отображается вместо кнопки, в тот момент, когда чарджеров достаточное количество.

===Нехватка ресурсов на чарджер===
Позволяет изменить состояние выбранному объекту при нехватке ресурсов на чарджер. Добавляется кнопкой "Добавить локацию", можно переименовывать, удаляется кнопкой "Удалить локацию".

===Монстр===
В первой колонке добавляется монстр, добавляется кнопкой "Добавить локацию", если возможность переименовать, удаляется кнопкой "Удалить локацию"
Во второй колонке отображаются свойства выделенной колонки.

*'''Объект на карте''' - объект, который представляет монстра на карте. Как правило окно, которое должно иметь состояние hide (скрыт),show и disappear (прогнали).
*'''Имя монстра''' - текстовый id из которого берется иконка, имя и описание монстра.
*'''Экран''' - экран в котором расположена локация.
*'''min уровень''' - уровень, при достижении которого, появляется монстр.
*'''max уровень''' - уровень, при достижении которого, монстр исчезает.
*'''необходимый предмет''' - предмет необходимый для игры с духом.
*'''количество''' - количество предметов из поля "необходимый предмет".
*'''связанный баттл''' - поле в котором указывается связанный объект типа matchbattle.
*'''связанный матч''' - поле в котором указывается связанный матч.
*'''окно внутри монстра''' - объект, который покажем в экране с мини игрой в случае победы. Должен иметь состояния open - в случае обычной победы, open_win - если перешли на следующий уровень мастерства. Чтобы это окно перешло в одно из этих состояний передаем экономике состояние ''monster_win_wnd''.
*'''текст внутри монстра''' - текстовый объект, в который сложим поздравительный текст о переходе на следующий уровень мастерства.
*'''очищать statesmanager''' - 1 - при передаче экономике состояния monster_play для этого монстра все очереди statesmanager будут чиститься; 0 - не будут.

В третей колонке записываются уровни мастерства. Их можно переименовывать. Добавляются уровни кнопкой "Добавить уровень мастерства", удаляются кнопкой "Удалить уровень мастерства".
В четвертой колонке настраивается выделенный уровень мастерства.

*'''энергия''' - энергия необходимая для того, что бы можно было начать играть в локацию.
*'''ресурс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 - то для достижения может использоваться любая аномалия. 0 - текстовая аномалия, 1 - ночь, 2 - трансформация цвета, 3 - дым.

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

[[Файл:Economics 5.jpg|right]]
Перед вызовом некоторых состояний объекту economics необходимо передать параметр '''param''' и его значение. Например когда нам нужно открыть окно перед локацией мы передаем параметр номера этой локации в списке локаций (начиная с 0).

 
*'''idle''' - состояние по умолчанию.
*'''completed''' - передает состояние окончания исследования локации (необходим параметр номера локации), перед вызовом состояния, можно экономике заполнить поле '''additional_inv''' - перечнем инвентарных предметов которые хотим добавить пользователю ( поместить в таблицу + чтобы экономика поместила их в летающие объекты), через запятую (к примеру additional_inv="12345,25841") .
*'''exp''' - передает состояние начисления опыта (необходим параметр количества опыта). Нужен больше для тестирования, чем для самой игры.
*'''play''' - передает состояния перехода на локацию для исследования(при условии что хватит энергии и выполнены прочие условия).
*'''location''' - открывает окно перед локацией (необходим параметр номера локации).
*'''collection''' - заставляет экономикс заполнить таблицу коллекций. Лучше вызывать сразу перед открытием окна коллекций или во время его открытия. Для применения фильтрации коллекций перед вызовом состояния задать параметр ''collectionFilter'' (0 - все, 1 - все предметы, 2 - не хватает одного, 3 - новые). Для определения коллекции в категорию "новые" указать в настройках коллекции ''cnew'' (''новая'' - признак новизны для фильтра. >0 - новая).
*'''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''' - Добавить энергию (значение в параметре).
*'''energy_no_max''' - Добавить энергию перманентно - без ограничения перевала за максимум (значение в параметре).
*'''failed''' - текущая локация провалена (не дается опыта и прочих наград за прохождение локации). Требует параметра локации.
*'''item_effect''' - показать окошко предмета от таймэффекта. В param - номер эффекта.
*'''item_effect_last''' - показать окошко предмета от последнего активированного таймэффекта. У машины окошка должно быть состояние "open_last".
*'''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 необходимого предмета.
*'''copy''' - скопировать основные параметры (опыт, уровень, энергия) и количество предметов из одной экономики в другую. Перед вызовом указать в поле "param" id экономики куда перенесём значение. Если экономика в кот. копируем выключена по disable="1" - нужно с начало установить disable="0", вызвать сост. "init", а уже после в неё копировать.
*'''set_was_visited_flag''' - установить флаг посещаемости локации (loc%n%.wv="1") для календаря. В param должен быть указан id необходимого предмета.
*'''clear_was_visited_flag''' - снять флаг посещаемости локации (loc%n%.wv="0") для календаря.В param должен быть указан id необходимого предмета.
*'''srand_hidden''' - перетряхнуть связанный с хидденом генератор псевдослучайных чисел. Можно вызывать перед локацией, если возникает зацикливание хидденов. '''''КАТЕГОРИЧЕСКИ НЕЛЬЗЯ вызывать его при честном мультиплеере - в нем все определяется сидом от сервера'''''
*'''download_pack''' - попросить экономику скачать пак для локации из поля param (используется при использовании динамических паков - конфигов, [https://docs.google.com/document/d/13UUOKf_iJNzFx0PjU4JQIfYDX7NhK7dyfJAR3I-SWlQ/edit детальнее]).
*'''temporary_unlock''' - открывает доступ в хидден-локацию на время. Применение - передать это состояние экономике и одновременно запустить глобалтаймер, который по окончанию действия закроет эту локацию.
*'''clear_temporary_unlock''' - закрывает доступ в хидден-локацию, если она была открыта временно.
*'''search_task_only_open''' - вызываем из окна таска, откроет превью локации в которой можно найти требуемый предмет. Аналог search_task, но ищет только в открытых локациях;
*'''search_task_only_week''' - вызываем из окна таска, откроет превью локации в которой можно найти требуемый предмет. Аналог search_task, но ищет только в открытых локациях текущей недели (работа по календарю).

Календарь (локации заполняем в таблицу как календарь):
*'''unlock_for_today''' - попросить экономику разблокировать диапазон локации до конца текущего дня (диапазон указываем посредством полей "param" и "param2" - [param,param2]) .
*'''today_table''' - промотать таблицу до текущего дня.
*'''location_table_get_name''' - открыть превью локации, по нажатой ячейке таблицы календаря.
*'''clear_packs''' - очистить паки которые не использовались n-н дней (где n - параметр '''packDeleteDays''').

При начислении экономикой res1 и res2 во флурри отправляются события coins_get, diams_get. Для того чтобы источники монет/кристаллов (параметр source) в событии приходили с адекватными значениями, перед вызовом состояния начисления экономике нужно записать параметр "res_source" в соответствии со значениями в списке:

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, //!< использование предмета
SOURCE_PET_GOLD_COLLECTED = 16, //!< собрали бонус животного у пэта
SOURCE_PET_COLLECTION_GOT = 17, //!< сдача коллекции животных
SOURCE_SLOTMACHINE = 18, //!< слотмашина
SOURCE_RPGBATTLE = 19, //!< псевдоРПГ бой
SOURCE_SLOTFALLING = 20, //!< вторая слотмашина
SOURCE_MAP_CHEST = 21 //!< сундуки на карте
SOURCE_ADVERTISEMENT = 22, //!< реклама
SOURCE_CONTEST_PRIZE = 23 //!< соревнования

П.С. для мануального начисления (уникальный источник под каждый проект)
31 // игровая награда №1
32 // игровая награда №2
33 // игровая награда №3
34 // игровая награда №4
35 // игровая награда №5
36 // игровая награда №6
37 // игровая награда №7
38 // игровая награда №8
39 // игровая награда №9
40 // игровая награда №10

=Коды ошибок:=
При скачивании паков, посредством фоновой загрузки или через состояние "download_pack" могут возникать ошибки (которые можем словить через еррорменеджер):
*'''1''' - ошибка не классифицирована
*'''2''' - отсутствует соединение с интернетом
*'''3''' - отсутствуют ресурсы по данному запросу
*'''4''' - недостаточно оперативной памяти для загрузки
*'''5''' - недостаточно памяти в файловой системе для загрузки
*'''6''' - ошибка работы с файловой системой во время загрузки
*'''7''' - недостаточно оперативной памяти для распаковки
*'''8''' - недостаточно памяти в файловой системе для распаковки
*'''9''' - ошибка работы с файловой системой во время распаковки
*'''10''' - ошибка проверки распакованного пака
*'''11''' - ошибка распаковки

=Сопутствующие объекты=

Объекты, которые используются вместе с объектом 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].res1log''' - текущее значение ресурса_1 выраженное в логарифмической шкале;
*'''ecomics[id].res1logfl''' - текущее значение ресурса_1 выраженное в логарифмической шкале с учётом депозитов и биржи;
*'''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;
*'''amulets_bonus_res1''' - множитель монет за бонусы от амулетов, при начислении по сост. "res1";
*'''amulets_bonus_res2''' - множитель кристаллов за бонусы от амулетов, при начислении по сост. "res2";
*'''amulets_bonus_exp''' - множитель опыта за бонусы от амулетов, при начислении по сост. "exp";

Каждая экономика пишет в пользователя следующие параметры:
*'''public.EconomicsRes1''' - текущее количество ресурса_1;
*'''public.EconomicsRes2''' - текущее количество ресурса_2;
*'''public.EconomicsLevel''' - текущий уровень игрока;
*'''public.EconomicsEnergy''' - текущий уровень энергии;
*'''public.EconomicsTotalScore''' - количество заработанного опыта за все время игры;
*'''public.EconomicsCollectionsUniq''' - количество сданных коллекций ( значение повышается каждый раз при сдаче коллекции), пишется Экономикой только если поле - '''fbopt''' не пустое;

=Календарь и всё про него=
Данный режим позволяет создавать клонированные превью локаций и располагать локации по датам (одна локация - конкретная дата).
Визуально выглядит вот так:

[[Файл:Econom calendar viewer.png|400px|center]]

Настраивается рядом параметров (режим работы, визуальное оформление - таблица настраивается отдельно - )
[[Файл:Econom calendart.jpg|400px|right]]
*'''шаблон объекта на карте''' ('''tmplIco''') - превью локации - может быть как машинкой или "elocationpreview"(в этом случае, за превью локации берётся машинка из поля "иконка" - ей будут вызываться состояния и писаться параметры).
Должны быть подключены все состояния для машинки превью локации ("highlight","level_0","level_1"...) и дополнительно:
**'''apply''' - обновление имени локации (название дата) - в данном состоянии можно изменять параметры текста - выравнивание, размер шрифта и т.д.
**'''not_played''' - игрок заходил в день локации, но не играл в HG;
**'''not_visited''' - игрок не заходил в день локации;
**'''future''' - локация закрыта и находится в будущем;
Параметры которые пишутся в превью локации:
**'''season''' - сезон локации (0 - зима; 1 - Весна; 2 - Лето; 3 - Осень);
**'''in_past''' - находится локаций ранее текущей недели (0 - нет; 1 - да);
**'''cellShift''' - смещении локации от центрального элемента таблицы (знак "-" - влево; знак "+" - вправо);

*'''заглушка''' ('''tmplDummy''') - объект-заглушка, добавляется в начало и вконец таблицы - для правильной работы круговой таблицы;
*'''количество заглушек''' ('''tmplDummyNum''') - количество добавляемых заглушек;
*'''таблица''' ('''tableIco''') - таблица в которую будут складываться превью локации (должна иметь память - чтобы создались один раз);
*'''разлочить дней от текущего влево''' ('''daysunlock''') - указываем крайнее левое значение диапазона локаций текущей недели ( относительно, текущего, календарного дня);
*'''разлочить дней от текущего влево''' ('''daysunlockr''') - указываем крайнее правое значение диапазона локаций текущей недели( относительно, текущего, календарного дня);
*'''очищать все коллекционные предметы при смене дня''' ('''clearcollections''') - при смене календарного дня - очистить все полученные коллекционные предметы;
*'''прогресс загрузки''' ('''packProgress''') - прогресс загрузки пака, в окне перед локацией;

Формат даты (можно использовать переменные в тексте _day - число, _weekDay - день недели, _mon - полное название месяца, _short - сокращенное название месяца):
*'''формат даты центр''' ('''dateFormatCenter''') - текстовый ресурс, который будет помещён в имя локации (дата) центрального элемента таблицы;
*'''формат даты лево''' ('''dateFormatLeft''') - текстовый ресурс, который будет помещён в имя локации (дата) всем элементам левее центрального элемента таблицы;
*'''формат даты право''' ('''dateFormatRight''') - текстовый ресурс, который будет помещён в имя локации (дата) всем элементам правее центрального элемента таблицы;
*'''дни недели''' ('''dateWeekDays''') - перечень текстовых ресурсов, которые будут браться для каждого дня недели ( первый текст - понедельник, второй - вторник ...);
*'''месяцы''' ('''dateMonthes''') - перечень текстовых ресурсов для месяцев ( начинаем с января; sense0 - полное название, sense1 - короткое);

Фоновая прогрузка паков (при смене дня и при старте сессии):
*'''автозакачка паков влево''' ('''packNLeft''') - указываем крайную левую локацию диапазона;
*'''автозакачка паков вправо''' ('''packNRight''') - указываем крайную правую локацию диапазона;

*'''поправка на 29 февраля''' ('''tableFeb29Adjust''') - обрабатываем 29 Февраля или нет;
*'''начальная дата''' ('''startDate''') - Дата самой первой локации (unix time);
*'''удалять паки не используемые (дней)''' ('''packDeleteDays''') - количество дней,спустя которое пак считается устаревшим, при превышении - пак удалится с устройства при вызове состояния '''clear_packs'''. По сути это разница между текущей датой и датой последнего использования пака. Дата последнего использования пака обновляется после игры в локацию (через сост. "play") или при успешной распаковке пака.

=Динамические паки=
Функционал позволяет уменьшить размер приложения, посредством разбиения арта на паки, и в процессе игры их скачивания [https://docs.google.com/document/d/13UUOKf_iJNzFx0PjU4JQIfYDX7NhK7dyfJAR3I-SWlQ/edit# (см. документ)].

[[Category:Game mechanic]]
[[Category:Economics|*]]

Создание игры «Hidden Object Game»

2021-04-22T13:48:40Z

Dopryshko:

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

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

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

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

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7). (Одновременно можно выделять или копировать только объекты одного типа)

4. Вставить скопированные объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень с выводом количества очков, игрой на время и графикой.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

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

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «prog» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

=== Счетчик ===

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

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

=== Таймер ===

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

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

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

=== Прогресс ===

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

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

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

В HiddenList в разделе очковая система для сохранения данных в профиль необходимо указать '''id игры''' (например "hidden").
Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

== Настройка окна вывода ==

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла ([[Rectangle]]), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

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

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

=== Вывод итогов ===

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

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

Настройки для машины — '''star2'''
(если параметр accuracy=0)

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

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

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

Настройки для машины — '''win'''

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

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

'''(Подсказка)''' Для того, чтобы перезагрузить сцену с '''hiddenList''' и начать игру заново, в машине можно использовать команду '''set''' с параметром '''next_scr'''.

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

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2021-04-22T13:47:28Z

Dopryshko:

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

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

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

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

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7). (Одновременно можно выделять или копировать только объекты одного типа)

4. Вставить скопированные объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень с выводом количества очков, игрой на время и графикой.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

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

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

=== Счетчик ===

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

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

=== Таймер ===

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

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

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

=== Прогресс ===

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

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

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

В HiddenList в разделе очковая система для сохранения данных в профиль необходимо указать '''id игры''' (например "hidden").
Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

== Настройка окна вывода ==

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла ([[Rectangle]]), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

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

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

=== Вывод итогов ===

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

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

Настройки для машины — '''star2'''
(если параметр accuracy=0)

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

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

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

Настройки для машины — '''win'''

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

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

'''(Подсказка)''' Для того, чтобы перезагрузить сцену с '''hiddenList''' и начать игру заново, в машине можно использовать команду '''set''' с параметром '''next_scr'''.

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

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Редактор текстовых ресурсов

2021-04-22T13:42:31Z

Dopryshko:

{| width="100%"
| width="40%"|[[Движение машин: жучки, ключи и многое другое|Урок 5]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Создание игры «Hidden Object Game»|Урок 7]]
|}
----
{{TOC right}}
----
'''Цель:''' научится пользоваться редактором текстовых ресурсов на примере использования объекта типа "text"

'''Задачи:'''
* Cоздать новый экран и сцену для этого урока.
* Вывести на экран последовательно два текста с помощью двух текстовых объектов.
* Вывести на экран эти же тексты, но с помощью только одного текстового объекта.

== Объект Text ==

=== Подготовка ===

Начнём урок, как обычно, с открытия проекта lessons. В нём добавим новый экран lesson_6
со сценой stg_main, так как это было описано в предыдущем [[Создание экранов, сцен. Работа с кнопками|уроке]]. Поместим из редактора ресурсов на сцену любой фон из папки этого или предыдущего урока. Для примера далее используется "лунный пейзаж" (картинка '''bg''').

[[Файл:Lesson6_1.jpg|right]]
Поверх фона поместите на сцену картинку ввиде стрелки вправо. Назовите ее '''button_next'''. Выберите для нее тип '''machine'''. Кликая на сцене правой кнопкой мыши, выберете пункт из выпадающего меню "Создать объект в текущем элементе". Новый объект переименуйте в Text и выберите для него тип '''[[Text|Text]]'''.

=== Меняем текст машиной ===

Для того, чтобы было что менять, скопируем объект Text и вставим его в этой же сцене. Переименуем его в text2. Так как эти два объекта без графического ресурса, то на сцене мы можем их видеть как пустые рамки (зеленая рамка, если объет выделен, и красная - если не выделен).
[[Файл:Lesson6_2.jpg]]

[[Файл:Text_prop.png‎|right]]
Посмотрим на свойства объекта Text. В поле "текст" впишем "Первая часть текста". В поле "шрифт" в строке "цвет 1" выберем белый цвет. В свойствах объекта text2 в поле текст впишем "Вторая часть текста". Цвет шрифта поставим такой же. Таким образом, мы получили две текстовых надписей на сцене, которые располагаются одна поверх другой. Если мы сейчас сохраним проект и запустим, то обе надписи будут видны одновременно, что затруднит их читаемость. Для того, чтобы мы могли без проблем их прочитать, сделаем переключение текстов по нажатию на кнопку. На самом деле, '''button_next''' только выглядит как кнопка - это машина состояний. Пропишем для нее логику таким образом, чтобы при нажатии на машину, она по-очереди делала видимым то один текст, то другой. Создайте для этой машины следующие состояния.

[[Файл:Lesson6_4.jpg]]

За видимость объектов отвечает параметр '''vis'''. Если vis=0, то объект не видно, если 1 - видно. По клику осуществляется переход между состояниями. Сохраните проект и запустите этот экран. Вы видите, что по клику на кнопку текст изменяется.
[[Файл:Lesson6_5.jpg]]

Переключать текстовые объекты можно еще несколькими способами:

- менять параметр '''al''' (alpha); это позволит делать текст полупрозрачным (в отличии от '''vis''', параметр '''al''' может принимать промежуточные значения между 0 и 1);

- менять текстовому объекту состояние; как известно, у объекта [[Text#Состояния | text]] есть 3 состояния '''first''', '''next''', '''end''', чтобы текст стал видимым, достаточно передать ему состояние '''first''', чтобы текст исчез, достаточно передать ему состояние '''end'''.

== Создаем текстовую базу ==

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

Для вызова текстового редактора можно воспользоваться меню '''Tools -> [[Интерфейс TextEditor|Text Editor]]''', либо кнопкой быстрого запуска [[Файл:Text_base.png‎]].
Сначала текстовая база будет отсутствовать, поэтому ее нужно создать. Заходите в пункт меню '''file -> New'''. Появляется пустая база ресурсов, по умолчанию названная '''Untitled'''. Ее можно переименовать как вам удобней. Аналогично как в редакторе ресурсов слева вы видите дерево текстовых объектов. Нажимаем правой кнопкой по названию базы Untitled и выбираем ''add folder'''. Таким образом мы создали новую папку. Назовем ее lesson_6. Нажимая по папке правой кнопкой выбираем '''Add record'''. Каждый раз при добавлении новой текстовой записи редактор просит нас написать ее имя. Это имя можно будет изменить в любой момент. Запишем имя first_part. Создавать папки и записи можно также с помощью кнопок быстрого доступа на панели. Выделим папку lesson_6 и нажмем на значок "Add record". Запишем имя новой текстовой записи second_part.
[[Файл:Именитый.png|600px]]

Пока эти текстовые записи пустые. Для того чтобы заполнить их, выделим первую запись. Справа мы видим столбцы '''word''', '''sentence1''', '''sentence2''' и '''voice'''. В данном уроке нам понадобится только первый столбец '''word'''. Об остальных подробнее узнаете в следующем уроке. В строках записывается текст на разных языках. Запишем текст на русском и его перевод на английский в соответствующие поля. Для first_part - Первая часть текста (The first part of the text), для second_part - Вторая часть текста (The second part of the text). Запись на разных языках позволяет, в зависимости от локализации мобильного устройства, выбирать язык текстовых объектов.

Для того что бы добавить какой-либо язык в базу данных необходимо выполнить следующие действия:
1) Проходим путь Project/Properties/Select languages…

[[Файл:Добавление языка (1).png|600px]]

2) После этого необходимо выбрать языки которые вы хотите добавить

[[Файл:Добавление_языка_(2).png|400px]]

3) Можете похвалить себя

Если вы добавили языки, но они не видны, проверьте, не создали ли вы случайно свою папку в папке Untranslatable.

Чтобы корректно пользоваться текстовой базой после каждого ее изменения, ее необходимо сохранять. Можно воспользоваться кнопками быстрого доступа и нажать на значок дискеты. При первом сохранении текстовый редактор просит вас выбрать место сохранения и имя файла. Сохраним его в папку с проектом lessons и назовем text_base. Также текстовую базу нужно подвязать к базе ресурсов. Для этого заходим в пункт меню '''Resource -> Choose Resource File'''. Выбираем папку, в которая является базой ресурсов проекта и выбираем файл с расширением '''.sirx''' . Вернемся теперь к редактору сцен.
В пункте меню '''Project -> Project options''' выбираем вкладку '''Text database''' и указываем путь к нашей текстовой базе '''text_base.xml''' .

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Во время роботы в редакторе, когда вы создаете новый проект, автоматически создается и текстовая база. В данном уроке вам лишь нужно внести изменения в уже существующую базу '''File -> Open -> \\....\\text.xml'''.
</blockquote>

Каждый объект текстовой базы имеет свой уникальный '''id'''. Мы можем вызывать текст из текстовой базы меняя текстовому объекту на сцене этот id с помощью кнопки или машины состояний.

Давайте сделаем это на примере нашего проекта.
Так как теперь мы будем пользоваться только одним текстовым объектом на сцене, то второй text2 можно удалить. В объекте text удалим из пункта текст запись "Первая часть текста". Перепишем также немного состояния нашей машины. В поле '''val_txt''' мы записываем id текста путем перетаскивания его из текстовой базы.

[[Файл:Lesson6_7.jpg]]

Теперь в состояниях машины мы присваиваем нашему объекту text только текстовые id из текстовой базы. Сохраняем проект и запускаем. Результат тот же, что и в первом случае. Заметим, что на сцене стало на один объект меньше, а состояния машины сократились на одну строчку. Может это не существенно в таком маленьком проекте, но в больших проектах количество объектов и величина исполняемого файла может стать решающей причиной к упрощению кода.

== Упражнения ==

* Добавьте в текстовую базу еще несколько записей.
* Расширьте состояния машины, чтобы последовательно вывести на экран все текстовые записи.
* Поменяйте язык приложения, используя объект '''[[Options|Options]]'''.
До сих пор мы изучали объекты и их свойства для каждого определенного экрана. Рассмотрим возможность изменять параметры всего приложения.
Будем изменять язык приложения. Для этого необходимо ознакомится с объектом Options.

'''Options''' — объект, который используется для хранения и управления глобальными параметрами приложения. Также Options позволяет хранить и использовать параметры записанные в него другими объектами.

В проекте lessons создаем новый экран, для которого в свойствах устанавливаем глобальный

[[Файл:Глобальный.PNG]]

В экране '''opt''' создадим сцену '''opt'''. Создадим на сцене opt новый объект, переименуем его в '''Options'''. Поменяем ему тип на option (Option → option).

[[Файл:Опции.PNG]]

Создадим в проекте новый экран '''lessons_6_1''' со сценой '''6_1'''. В сцену из проекта '''lessons_6''' копируем объекты '''bg_1''', '''button_next''', Text не изменяя их параметры. Перенесем на сцену из редактора ресурсов, из папки lessons_2, объекты: '''arrow_lf_norm''' и '''arrow_rt_norm'''. Переименуем, arrow_lf_norm в '''en''', arrow_rt_norm в '''ru''', и сделаем их машинами. Добавляем ниже на сцену новый объект, изменяем ему тип на '''[[Groupset|Groupset]]''' и имя на '''groupset'''. Щелкаем в свойствах по имени правой кнопкой мыши, добавляем в свойства объект, из списка объектов выбираем Text.

[[Файл:Группа.PNG]]

'''Описание объекта Groupset'''

'''Groupset (группа)''' позволяет передавать состояния и параметры множеству объектов, которые являются участниками группы. Участником группы является любой объект, указанный в в объекте Groupset.

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

Объекты принадлежащие одной группе могут быть разного типа и разноименными.

Команды применимые к группе:

• ''set'' — группе можно установить состояние st и параметр (значение) par(val);

• ''drop'' — на группу (объекты принадлежащие группе) можно отпустить объект.

Для каждой из добавленных машин запишем состояния.

Машина en:

[[Файл:En.PNG]]

Машина ru

[[Файл:Ru.PNG]]

Как видно, в состоянии on, каждой машины, задается lang (язык) в глобальном объекте Options. В состояние r Groupset передается состояние init (инициализация объекта).

Сохраняем и запускаем вьювер.

[[Файл:Вьювер.PNG]]

На экране расположено три кнопки и текст. При нажатие кнопки вперед язык текста меняется — на русский, при нажатие назад — на английский, желтая кнопка вперед меняет сам текст.
----
{| width="100%"
| width="40%"|[[Движение машин: жучки, ключи и многое другое|Урок 5]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Создание игры «Hidden Object Game»|Урок 7]]
|}

[[Category:Learning]]

Checkbox как машина состояний

2021-04-22T13:39:09Z

Dopryshko:

{| width="100%"
| width="40%"|[[Создание экранов, сцен. Работа с кнопками|Урок 2]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Взаимодействие машин: «Лампочка» и «Светофор»|Урок 4]]
|}
----
{{TOC right}}

'''Цель:''' изучить понятие машины состояний на примере объекта Checkbox

'''Задачи:'''
* Cоздать новый экран и сцену для этого урока.
* При помощи объекта Checkbox заставит слонёнка поворачивать голову.
* Воспроизвести этого же слонёнка при помощи машины состояний.
* Добавить разнообразия в поведении слонёнка.
* Создать эмоциональную рожицу.

== Checkbox ==

=== Подготовка ===

Начнём урок, как обычно, с открытия проекта lessons. В нём добавим новый экран lesson_3
со сценой stg_main, так как это было описано в предыдущем [[Создание экранов, сцен. Работа с кнопками|уроке]]. Поместим из редактора ресурсов на сцену любой фон из папки этого или предыдущего урока. Для примера далее используется "лунный пейзаж" (картинка '''bg''').

[[файл:lesson_3_chk1.png|right]]
Поверх фона перетащите из редактора ресурсов тело слонёнка (ресурс '''body''')
и затем его голову '''head_1'''. Расположите их так, чтобы получился примерно целый слонёнок.
Переименуйте эти 2 объекта в '''elephant_body''' и '''elephant_head_chk'''
(помним о необходимости осмысленности в именах объектов?). Чтобы голова и тело стали "целым" существом, стоит в дереве проекта (Layout) перетащить голову на тело, сделав её подобъектом.
Теперь, если на сцене начать таскать тело слоненка, то голова будет послушно следовать за ним.
Хотя, если схватить за голову, то её легко можно оторвать. Так, что будьте со слоненком поласковее.

'''Внимание!!!''' Подобъект наследует все модификации своего родителя. Если, к примеру, изменить '''scale x''' и '''scale y''' родительскому объекту, у дочернего точно также изменится '''scale x''' и '''scale y'''.
Более того, изменения могут накладываться друг на друга. Если дочерний объект был, как вариант, уменьшен с помощью тех же '''scale x''' и '''scale y''', а потом вы уменьшили родительский, то дочерний объект рискует уменьшиться еще сильнее. '''Будьте внимательны!'''

=== Создание чекбокса ===

[[файл:lesson_3_chk.png|right]]
Зайдем в свойство головы '''elephant_head_chk''' и изменим её тип на '''[[Checkbox|checkbox]]'''.
Раскроем треугольнички возле свойств "'''не отмечена (внешний вид)'''" и "'''отмечена (внешний вид)'''". Поля '''не отмечена (внешний вид)''' и '''отмечена (внешний вид)''' содержат по три ресурса (<tt>up, down и over</tt>).

'''Не отмечена (внешний вид):'''
<tt>up</tt> - так выглядит чекбокс, пока мы на него не нажали;
<tt>down</tt> - так выглядит чекбокс, если мы на него нажмём, но не откликнем в не нажатом состоянии;
<tt>over</tt> – так выглядит чекбокс, если мы на него наведём мышкой, в не нажатом состоянии.

'''Отмечена (внешний вид):'''
<tt>up</tt> - так выглядит чекбокс, когда мы на него нажали;
<tt>down</tt> - так выглядит чекбокс, если мы на него нажмём, но не откликнем в нажатом состоянии;
<tt>over</tt> – так выглядит чекбокс, если мы на него наведём мышкой, в нажатом состоянии.
Разместим поверх окна редактор ресурсов и перетащим в поле '''up''' первой группы (не отмечена) картинку '''head_1''', а в такое же поле второй группы (отмечена) картинку '''head_2'''.
Делается это также, как и формирование внешнего вида кнопки из предыдущего [[Создание экранов, сцен. Работа с кнопками|урока]].

Сохраняем проект и запускаем вьювер. При клике на голову слонёнка она должна туда-сюда поворачиваться. Вы узнали в этом поведении чекбокс?
Обычно чекбоксы (сheckbox) это такие квадратики в которых ставят или убирают галочку.
Конечно и в игровом приложении может понадобиться подобный чекбокс.
В этом случае необходимо будет подготовить соответствующие картинки.
Простые игровые объекты (типа подобной головы) часто могут находиться в двух состояниях (выбран, не выбран). Они не похожи на чекбокс внешним видом, но являются им в силу правил своего поведения.

Теперь наша задача состоит в воспроизведении поведения чекбокса при помощи объекта
другого типа - '''[[Machine|машины состояний]]'''. Мы не только повторим вращающего головой слоненка,
но и придадим его поведению новые функции.

== Машины состояний ==

=== Немного теории ===

''Машина состояний (state machine)'' является универсальным инструментом для программирования в редакторе сцен сложного поведения объектов. Логика поведения машины состояний разбивается на отдельные узлы (состояния). Объект всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на объект, либо в результате окончания некоторых процессов протекающих внутри объекта.

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. Настоятельно рекомендуется рисовать такие графы в процессе проектирования машины, а лишь затем переходить к их описанию в окне редактора состояний. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

=== Проектирование машины ===

Перейдем теперь от нудной теории к веселой практике. Посмотрим внимательно на поведение головы слоненка, которая является чекбоксом. На самом деле это типичная машина состояний с двумя состояниями. Назовём их '''left''' и '''right''' по направлению ориентации головы слонёнка. Сначала слоненок находится в состоянии left (смотрит влево). Когда мы кликаем в голову, машина переходит в новое состояние right (голова поворачивается вправо). Это поведение жестко запрограммированно внутри объекта checkbox. Попробуем добиться того же эффекта, используя универсальный игровой объект "машина состояний".

Прежде всего не поленимся нарисовать весёлый граф состояний и переходов между ними:

[[файл:lesson_3_states.png|center|300px]]

Теперь, когда на бумаге всё стало ясно :), необходимо эту машину создать в редакторе.

=== Создание машины ===

Чтобы не тратить время на редактор ресурсов, скопируем уже существующего слонёнка.
Для этого станем в дереве проекта на его тело (elephant_body) и правой кнопкой мыши вызовем меню.
В нём выбираем пункт Copy. Затем повторяем операцию, но выбираем уже пункт вставить ("''Paste after curent object''"). В дереве проекта появятся два слоненка. Причем оба будут иерархичной веткой,
состоящей из "тела" (elephant_body) и подобъекта "голова" (elephant_head).
А вот на сцене редактора видимых изменений не произойдет.
Мы помним, что при копировании объектов копируются также все их свойства.
Поэтому на сцене, на самом деле, два слоненка, но они имеют одинаковые координаты.
Поэтому хватаемся за тело и тащим его правее на свободное место:

[[файл:lesson_3_2elephants.png|600px]]

Левого слона оставим чекбоксом, а голову правого превратим в [[Machine|машину состояний]].
Для этого кликаем в голову и меняем её тип с checkbox на '''machine''' (поле '''тип''' в панели Properties). Поменяем также имя головы, укоротив его до "'''elephant_head'''".

Можно попробовать посмотреть, что у нас получилось. Сохраняем проект и запускаем вьювер.
Упс... Голова исчезла, а вверху экрана появилось малопонятное ругательство,
из которого можно заключить, что у объекта elephant_head состояний то и нет.

Таким образом, не достаточно создать машину, её еще необходимо научить ездить.
Поэтому закрываем окно вьювера и начинаем заниматься программированием.

=== Программирование состояний ===

Сделаем активной голову правого слонёнка, которая стала машиной состояний.
В панели её свойств кликаем на поле '''states''', а затем на появившиеся в нём три точки (помним [[Введение в AppSalute Сreator|первый урок]]?). Также открыть машину состояний, можно двойным щелчком левой клавиши мыши. В результате этих действий, выскочит окошко в котором мы будем создавать состояния
и их программировать. Два раза нажмём кнопку '''Добавить состояние''' в левом нижнем углу окна:

[[файл:lesson_3_states1.png]]

В результате появилось две области, каждая из которых будущее состояние головы.
Зададим имена состояний, введя названия left и right в полях '''имя''' каждой области.
Затем станем мышкой на поле '''имя''' левого состояния и нажмём правую кнопку мышки.
Появится большое меню, в котором кликнем на первый пункт "''draw - внешний вид''":

[[файл:lesson_3_states2.png]]

В левом состояни под его именем добавится команда '''draw'''.
Эта команда управляет способом отрисовки машины в данном состоянии.
Нам потребуется ещё одна команда '''click''', которую добавим аналогичным
образом (правая кнопка мыши на команде draw).

В команды необходимо добавить параметры, определяющие их свойства.
Для этого кликнем справа от draw и затем ещё раз на появившиеся три точки.
В выскочившем диалоговом окне поставим галочку возле пункта "''графический ресурс''"
и нажмем кнопку Ok:

[[файл:lesson_3_states_dlg.png]]

Аналогично кликаем на команду '''click''' и добавляем ей параметр "''go - новое состояние''".
Те же действие проделываем с правым состоянием. В результате должно получиться:

[[файл:lesson_3_states3.png]]

Осталось заполнить поля команд. В поле go команды click левого состояния пишем '''right''',
а в тоже поле правого состояния пишем '''left'''. Это означает, что при клике машина должна перейти в то состояние, которое указано в поле go. Имена состояний вводятся с клавиатуры руками,
поэтому необходимо следить за правильностью их написания.

Теперь откроем окно редактора ресурсов. Сделав активным значение поля '''res''' команды draw левого состояния, перетащим в него из ресурсов картинку '''head_1'''. В аналогичное поле правого состояния перетащим картинку '''head_2'''. Делается это точно так, как мы задавали поля внешнего вида кнопки или чекбокса в панели Properties. Финальный результат наших действий
приводит к следующей машине (мы не будем больше приводить всё окно редактирования состояний):

[[файл:lesson_3_states4.png]]

Насладимся результатами нашей работы. Закроем окно с состояниями (крестик в правом верхнем углу).
Сохраним проект и запустим вьювер (для ускорения можно не закрывать окно состояний, а кликнуть на иконки сохранения и запуска вьювера внизу этого окна).
В результате, во вьювере оба слоненка должны вести себя абсолютно одинаково.

=== Ускорение работы и отладка ===

При программировании состояний машины можно использовать некоторые приёмы
ускоряющие процесс. Так, в примере с головой, команды обоих состояний выглядят одинаково.
Поэтому имеет смысл сначала создать одно состояние (left),
наполнить его командами и параметрами. Затем нажать кнопку "Скопировать состояние".
Состояние продублируется и останется только подправить его параметры.

Машины состояний, как и другие объекты, можно копировать вместе со всеми их состояниями. Поэтому, если уже есть машина, похожая на ту, которую надо создать, мы её просто копируем и подправляем команды и их параметры.

Если машина создается из картинки, изменением типа, то не стоит глазами искать слово '''machine''' в списке типов. Необходимо на клавиатуре нажать клавишу '''M''' и затем '''Enter'''.
Вообще, активнее пользуйтесь горячими клавишами. Например, если в дереве проекта (Layout)
активна машина, то нажатие '''Ctrl+M''' приведет к открытию окна редактирования состояний.

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

:'''Важно''' !!! Чтобы отладочная информация отображалась нужно для каждого наблюдаемого объекта (машины), поставить в поле отладка значение '''вкл'''.

Запустим вьювер и нажмём кнопку "'''F1'''". Появится небольшое меню с командами, которое гасится повторным нажатием F1. Кнопка "'''S'''" (на клавиатуре) выводит список всех активных объектов на сцене. Если текст информации совпадает с текстом фона, то эта информация будет плохо видна. В этом случае необходимо несколько раз нажать клавишу "'''C'''", меняя по кругу цвет текста.

Первые две колонки отладочной информации, это имя сцены и объекта. В колонке state видно текущее состояние. Понажимайте на голову слоненка, наблюдая как его состояние меняется с left на right и наоборот.

Запустите теперь во вьювере экран первого урока и нажмите "'''S'''".
Покликайте на слоненка, его голову и солнышко, наблюдая как изменяется информация об этих машинах.
Так как внутри состояний могут происходить некоторые процессы, их
можно затормозить, нажав '''пробел''' (в этот момент солнышко остановится). Повторное нажатие пробела, снова запустит все процессы.

=== Немного нравоучений ===

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

При работе над проектами, некоторые машины иногда повторяются. Их конечно можно копировать, подправляя соответствующие поля команд. Однако, на определенном этапе, возможно, стоит начать дергать руководство и С++ программистов, чтобы они оформили эту "типовую" машину в виде отдельного игрового объекта. Как это, например, сделано с чекбоксом или кнопкой.

Если Вы пытаетесь сделать что-то при помощи машины состояний, но получается очень громоздкий объект (куча состояний, переходов, команд), значит Вы делаете что-то не так.
Либо машина плохо спроектирована, либо вообще эту задачу не стоит решать при помощи машин.
Возможно это уже миниигра и необходимо подключать C++ программистов для её реализации.

Стоит также помнить, что работа над проектом это коллективный процесс.
Спустя некоторое время Вашу работу может подправлять другой человек.
Да и Вы к этому моменту станете другим человеком и все забудете.
Поэтому относитесь максимально ответственно к процессу документирования.
Это означает выбор осмысленных имен объектов и заполнение поля "'''описание'''",
находящееся у большинства сложных объектов в Properties.
Для машин это поле находится в окне редактирования состояний, сразу под состояниями.
Например, в нашем случае текст документации может выглядеть примерно так: "''При клике на голову она поворачивается влево или в право''".
<blockquote>
'''Правильно работающий незадокументированный проект - это плохой проект.'''
</blockquote>

== Усложняем машину ==

=== Непослушный слоненок ===

Реабилитируем немного нашу деятельность по воспроизводству стандартного чекбокса при помощи машины состояний.
Для этого придадим голове правого слонёнка дополнительное поведение, которым чекбокс не обладает.
Пусть правый слоненок нежно относится к левому и не хочет на долго от него отворачиваться.
Поэтому, повернувшись после клика вправо, он затем сам снова поворачивается влево.

Для реализации этого поведения добавим в состояние '''right''' команду '''wait''' c параметром '''t''', равным 1000 миллисекундам (что равно одной секунде) и параметром '''go'''=left
В результате должна получиться такая машина:

[[файл:lesson_3_states5.png]]

До сих пор, переход из одного состояния в другое происходил в результате клика на машину.
Это было внешнее воздействие.
Однако, переход между состояниями может происходить в результате некоторых процессов внутри состояния.
В нашем случае, при заходе в правое состояние начинает работать команда '''wait'''. Она
ждет в течении времени, определяемом полем '''t'''. Затем, если задано поле '''go''', машина сама инициирует переход в соответствующее состояние.

Сохраните и запустите во вьювере этот проект. Кликая на головы обоих слонят,
сравните их поведение.

=== Сумашедший слоненок ===

В заключение, поиздеваемся немного над слоненком, сделав его голове
такую машину состояний:

[[файл:lesson_3_states6.png]]

В результате слонёнок начнет нерегулярно крутит головой то влево, то вправо.
В каждом состоянии он будет находиться случайное время от 1-й до 3-х секунд.
Это определяется параметрами '''t''' и '''dt''', которые задают
интервал времени от t-dt до t+dt.

Заметим, что, не смотря на самовольное вращение головой,
слоненок по-прежнему реагирует на клики мышки.

== Машина эмоций ==

Выше мы рассмотрели несколько машин состояний, не сильно отличающихся
от бездушного чекбокса.
Приведем теперь пример машины, которую и машиной неловко назвать.
Это существо, обладающее целым спектром эмоций и реакций на внешнее воздействие:

[[файл:smiles.png]]

Разберемся, что нарисовано на картинке. Каждая рожица - это отдельное состояние,
отражающее настроение нашего существа. Стрелки - переходы между состояниями
по командам '''click''' и '''wait'''.

Начинает работать существо из состояния [[файл:s1.png|24px]].
Как и любые существа, Оно любит внимание.
Поэтому, при клике переходит в более жизнерадостное состояние [[файл:s2.png|24px]].
Если больше на него не кликать, Оно опять вернется в начальное состояние,
а спустя еще какое то время начнет плакать [[файл:s5.png|24px]], из-за полного отсутствия
внимания. Впрочем, небольшой клик - и Оно снова довольно жизнью.

Обратим внимание на последовательность состояний [[файл:s3.png|24px]], переходящих в
недовольную гримасу [[файл:s4.png|24px]]. Излишнее внимание также вредно, как
и его отсутствие.

В качестве упражнения, попробуйте создать такую машину состояний,
самостоятельно найдя в интернете или нарисовав соответствующие картинки.
Вы можете также вытащить картинки рожиц из этого урока, кликнув на них для увеличения, а затем нажав правую кнопку мышки, сохранить их на диске.
Как загрузить картинки в редактор ресурсов было описано в конце предыдущего [[Введение в AppSalute Сreator|урока]].
Естественно, Вы можете изменить эмоциональное поведение, сделав его более реалистичным :).

В заключение, несколько общих замечаний:
* Если машина имеет более двух состояний, её необходимо сначала проектировать на бумаге. Именно на диаграмме состояний отчетливо проявляется логика поведения машины.
* Обычно не должно быть тупиковых состояний, из которых ни куда попасть нельзя. В эмоциональной машине с рожицами таких состояний нет.
* Всегда необходимо выделять начальное состояние в котором машина начинает своё существование.
* Памятью машины состояний не обладают, однако имитация памяти может быть реализована при помощи цепочки состояний, как было сделано выше с состояниями счастливой рожицы.

== Упражнения ==

* Уменьшите в 2 раза размер слонят (параметр scale в модификаторах свойств). Для этого достаточно поменять масштаб у тела, т.е. его scale распространится и на подобъект.
* Копированием создайте третьего слонёнка.
* Запрограммируйте его голову как машину, состоящую из 3-х состояний. В качестве картинки третьего состояния возьмите солнышко из первого урока. Пусть состояния при клике прокручиваются по кругу (left, right, sun,left,...)
* Добавьте четвертого слонёнка с тремя состояниями и сделайте с ним что хотите.
* Создайте эмоциональную рожицу
* Посмотрите снова на описание машин состояний из первого урока. Стало ли понятнее их поведение?

----
{| width="100%"
| width="40%"|[[Создание экранов, сцен. Работа с кнопками|Урок 2]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Взаимодействие машин: «Лампочка» и «Светофор»|Урок 4]]
|}

[[Category:Learning]]

Настройка миниигр

2021-04-22T10:02:34Z

Dopryshko:

{| width="100%"
| width="40%"|[[Создание игры «Hidden Object Game»|Урок 7]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Работа с эффектами|Урок 9]]
|}
----
{{TOC right}}

'''Цель:''' изучить настройки объектов, реализующих различные минигры.

'''Задачи:'''
* создать уровень игры с объектом, содержащим тип механики Puzzle
* создать уровень игры с объектом, содержащим тип механики Patchwork

== Puzzle ==

=== Создание экрана и сцены в игровом проекте ===

Запускаем SceneEditor. Открываем наш учебный проект lessons.seproj.

Создаём экран lesson_8, а в нём сцены 08 и Buttons (стараемся делать это по памяти или подсматриваем в прошлых уроках), куда добавляем необходимые графические ресурсы из папки этого урока в Resources Editor: в экран 08 отправляем картинку level_01 (наш будущий пазл), а в Buttons (думаю, уже догадались) - будущие кнопки - hint_normal и ico_r_normal2.

На экране кнопочкам подбираем симпатичное и удобное расположение.

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

=== Настройка объектов, создание машин состояний ===

Меняем тип картинки '''level_01''' с '''image''' на [[Puzzle|puzzle]] (в папке Game mechanic) и устанавливаем следующие настройки:

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

В сцене '''08''' создаём ещё один объект. Даём ему имя '''applause''', тип '''machine''' (прописываем 2 состояния '''on''' и '''off''').

В состоянии '''on''' добавляем команду '''play''' (проиграть звук) и в списке выбираем '''snd''' (короткий звук), который подгружаем с помощью базы ресурсов (если подходящего звукового файла в уроке не обнаружилось, его необходимо добавить самостоятельно).

Возвращаемся к общим настройкам и устанавливаем стартовое состояние '''off'''.

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

Переходим к сцене '''Buttons''' и меняем тип обоих графических файлов на '''button'''. Общий вид лейаута на этом этапе получится примерно следующий:

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

В настройках кнопок перетянем из базы ресурсов картинки с внешним видом нажатых и отжатых кнопок.

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

Кнопка '''R''' (переиграть) — кнопка, запускающая игру Puzzle сначала.

Нам необходимо, чтобы кнопка '''R''' перемешивала части нашего пазла. Для этого в настройках кликаем правой кнопкой мыши и выбираем '''клик:изменить состояние объекта'''. В появившейся в настройках вкладке выбираем в качестве объекта наш пазл ('''level_01''') и состояние '''mix''', которое перемешает части исходной картинки.

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

Пусть кнопка '''hint''' (подсказка) по клику показывает нам картинку в собранном виде. Для этого повторяем процедуру с добавлением настройки '''клик:изменить состояние объекта''', только теперь для кнопки '''hint'''. Выбираем объектом наш '''level_01''' и состояние для него '''hint'''.

<pre>
На заметку. Если возникает необходимость добавить 2 и более настройки при помощи правой кнопки мыши,
то лучше из кнопки сделать машину состояний и все состояния создать уже там.
</pre>

Любуемся результатом своих стараний, сохранив проект и запустив его с помощью Viewer`а.

=== Упражнения ===

Копируем экран '''lesson_8''' и переименовываем его в '''lesson_8_1''', а сцену '''08''' в '''08_01'''.

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

В новом экране вносим все изменения самостоятельно. Необходимо:

a) заменить звук аплодисментов другим аудиофайлом, имеющимся в базе ресурсов;

b) в пазле изменить количество разбиваемых частей на шесть (3х2), добавить сетку, изменить перестановку ячеек на смешивание по alpha, изменить время смешивания на 500 миллисекунд;

c) при нажатии hint (подсказки) изменить время показа подсказки на 2 секунды, изменить время финального показа пазла на 3 секунды, установить время закрытия пазла 500 миллисекунд.

=== Store ===

В реальной игре нам может понадобиться счётчик подсказок, который даёт возможность совершать покупки подсказок за реальные деньги. Для его реализации необходим объект '''[[Store|Store]]'''.

Создадим новый экран '''lesson_8_1_1'''. Добавим в него сцены '''08_1''' и '''Button_8_1'''. В сцену '''08_1''' поместим из экрана '''lesson_8_1''' объекты '''level_01''' и '''applause''', оставим их без изменения.

В сцену '''Button_8_1''' скопируем из '''lesson_08_1''' кнопки '''hint_normal''' и '''ico_R_normal2''' и создадим новый объект, поменяв ему тип на '''counter''' (счетчик) и назовём его '''hint'''. Добавим ресурс из базы ресурсов – анимацию c цифрами из прошлого урока. Счётчик '''hint''' будет считывать купленные подсказки.

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

В '''hint_normal''' добавим подобъект, сделаем его машиной и назовем '''hint_m'''.

Щёлкнув правой кнопкой мыши на сцену '''Button_8_1''' создадим новые сцены '''store''' и '''error''', которые, соответственно, будут предназначены для совершения покупок — начисления подсказок и окна с ошибкой при невозможности купить подсказку.

В сцену store добавим две машины: '''buy''' и '''store'''; в error - машину '''error'''.

[[Файл:809.PNG]]

В машине '''store''' зададим считывания со счётчика и прозрачность экрана:

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

Машина '''error''' будет отвечать за вывод ошибки при неудачной покупке, то есть задаёт прозрачность экрана с ошибкой.

[[Файл:811.PNG]]

Для машины '''buy''' зададим состояния, при которых она начисляет купленную подсказку либо вызывает окно ошибки.

[[Файл:812.PNG]]

Вернёмся к машине '''hint_m''' сцены '''Button_8_1''' и пропишем для неё состояния. Машина отвечает за начисление подсказки при удачной покупке

[[Файл:813.PNG]]

Для того, чтобы вызывать машину '''hint_m''' в нашей игре, откроем кнопку '''hint_normal''' и в добавляемом свойстве '''изменить состояние объекта''' в качестве объекта выберем машину '''hint_m''', и пропишем ей состояние '''check'''.

'''Совершение покупки (настройка Store)'''

Для того чтобы покупку можно было совершить, необходимо задать в глобальных свойствах возможность совершения покупки. Для этого на сцене в глобальном экране opt добавим новый элемент, которому изменим тип на store (в папке Options).

<pre>
На заметку. Store в проекте может быть только один.
</pre>

[[Файл:814.PNG]]

Дважды клацнув на объект (так же, как на машину состояний), мы попадаем в окно настроек '''store'''.

[[Файл:815.PNG]]

Нажимаем на плюсик и создаём покупку. Вводим для неё id и изменяем указанные настройки, как на картинке.

[[Файл:816.PNG]]

И тут должен возникнуть вопрос. Почему среди перечня доступных объектов нет необходимого нам '''buy'''? Прежде чем читать дальше, предлагаю попробовать найти ответ на этот вопрос самостоятельно.

Для удобства использования, а также во избежание различных ошибок, в объектах экрана можно обращаться только к объектам этого же экрана. Исключением будут объекты глобальных экранов (вспоминаем прошлые уроки и смотрим на наш глобальный экран '''opt''').

Поэтому, чтобы получить доступ к объекту '''buy''', мы временно делаем экран '''lesson_8_1_1''' глобальным и завершаем настройку объекта '''store'''. Позже, на этапе проверки при помощи Viewer`а можем поэкспериментировать и проверить, будет ли работать проект корректно, когда мы в настройках глобальности экрана '''lesson_8_1_1''' снова поставим '''нет'''.

<pre>
На заметку. Когда мы обращаемся к объекту, то в layout.xml
прописывается ссылка на этот объект в виде его id.
Когда убираем глобальность экрана и делаем его снова обычным,
выбранный объект мы в редакторе больше не видим,
но его id в лэйауте всё равно остаётся.
</pre>

'''Описание объекта Store'''

Объект '''Store''' необходим для описания InApp покупок (позволяют продавать отдельные бонусы, паки и т.п.) в игре.

Основные параметры объекта Store

''id покупки'' – внутренний id покупки.

''расходуемая'' – 1 – покупка расходуемая, 0 – покупка раз и навсегда; если параметр не указан, по-умолчанию покупка – одноразовая.

''объект (restore)'' – объект - Слушатель восстановления покупки. Этому объекту будет сообщено об успехе восстановления этой покупки покупки.
состояние (restore) – это состояние будет установлено объекту при успешном восстановлении этой покупки.

'''Для того, чтобы объект Store работал во Viewer, необходимо подкорректировать файл app.icf'''

1. Найти файл app.icf в папке с вашим проектом.

2. Открыть его и найти тег [Game].

3. В теге Game добавить строку purchaseEverything=1.

4. Сохранить файл

<pre>

[Game]
purchaseEverything=1
DispFixRot="Landscape"
# comments and whitespace stripped by deployment tool
debug="Absolutist-2253"
show_build_date=1
AppTitle="Viewer"
DebuggerIP="127.0.0.1"
DebuggerPort=5322

</pre>

'''Оформление'''

Теперь перейдём к оформлению. Для того чтобы на экране появлялось окно с предложением о покупке подсказки, необходимо его создать. В начальный момент окно должно быть невидимым и прокликиваем, это состояние задано в машине '''store'''. Создадим в ней 5 подобъектов.

Первые два переименуем в '''black''' и '''rec''', изменим им тип на '''[[Rectangle|Rectangle]]'''.

Откроем объект '''black''', пропишем ему свойства, оставив пустой рамку, цвет фона – чёрный.

Для объекта '''rec''' зададим рамку и текстуру заливки. Для этого из базы ресурсов мышкой перетащим соответствующие элементы. Ресурсы для графики находятся в предыдущем уроке. Чтобы прямоугольник отображался правильно, задайте ему ненулевые размеры. Настройки '''rec''' (имена файлов могут отличаться):

[[Файл:817.PNG]]

Третьему элементу поменяем тип на '''text''' с текстом "Купить подсказку?"

Четвёртый объект сделаем машиной и назовём её '''ok'''. Она будет в глазах пользователя совершать покупку. Для внешнего вида машины в '''res''' перетянем изображение зелёного света светофора из 4 урока. В модификаторах можно задать '''scale''' по х и по у 0.5.
Опишем следующие состояния машины:

[[Файл:818.PNG]]

Все действия, связанные с совершением и провалом покупки, управляемые этой машиной, мы уже указали в '''store'''.

Пятый объект будет кнопкой '''no'''. Она по клику изменяет состояние ('''close''') объекта ('''store'''). Для внешнего вида кнопки в '''res''' перетянем изображение красного света светофора из 4 урока. В модификаторах тоже можно задать '''scale''' по х и по у 0.5.

Так же поступим со сценой '''error'''. В ней создадим четыре объекта: два '''rectangle''': '''rec_error''' – пустой, '''black_error''' — их можно скопировать из предыдущей сцены; кнопку '''buy''', которая будет переводить '''error''' в состояние '''i'''; текстовый объект '''text_error''' с текстом «error!». Общий вид этого задания в лейауте примерно следующий:

[[Файл:819.PNG]]

Разместим все объекты так, что бы картинка хорошо смотрелась. Сохраним все изменения и запустим Viewer. Сейчас при покупке подсказки количество покупок не имеет лимита (благодаря нашим изменениям в '''app.icf'''), поэтому вывод ошибки мы не получим.

== Patchwork ==

=== Создание экрана и сцены в игровом проекте ===

1. Запустить SceneEditor.

2. В меню Проект → Загрузить → Learning.seproj.

3. Кликнув правой кнопкой мыши по ранее созданному экрану Lesson_08.1, создать экран Lesson_08.2.

[[Файл:Lesson8_1.jpg|right]]

4. В экране Lesson_08.2 создать новую сцену 08, в которую (через ResourcesEditor) добавить графические ресурсы (bg_game, panel_down, btb_replay_normal) из папки Sources\Lesson_08 (см. подготовка к работе «Создание проекта»). В редактор ресурсов добавить графику нашего будущего Patchwork: level_17, level_17_mask.

Если в папке урока отсутствует изображение panel_down, то скачать любое изображение боковой панели самостоятельно и использовать ее в проекте.

=== Настройка объектов ===

1. Создадим на сцене 08 еще два объекта. Для этого нажмем правой кнопкой мыши по сцене и выберем "Создать объект в текущем элементе".

[[Файл:Lesson8_2.jpg]]

2. Переименуем один из созданных объектов в Patchwork, а другой в table.

[[Файл:Lesson8_3.jpg]]

[[Файл:Lesson8_4.jpg|right]]

3. Теперь будем изменять тип объектов на сцене, чтобы получить нужные нам элементы. Графические ресурсы bg_game и panel_down оставляем без изменений. Ресурсу btb_replay_normal изменяем тип на button. Объекту Patchwork меняем тип на patchwork, table изменяем на тип table.
4. Теперь объекты нужно разместить на сцене. Обратим внимание на то, что два последних объекта которые мы добавили без графического ресурса. По умолчанию, создаваемые на сцене объекты имеют размер 100х100 пикселей. Увеличим размер таблицы по высоте до 450 пикселей и перетащим ее влево, поместив над объектом panel_down.

[[Файл:Lesson8_5.jpg]]

Кнопку поместим в левый нижний угол. Добиваемся такого расположения объектов, как показанно на рисунке.

[[Файл:Lesson8_6.jpg]]

5. Настроим наши объекты. Для кнопки btb_replay_normal в поле "перейти на" укажите текущий экран Lesson_8.2.

[[Файл:правка_намба_1.png|200px]]

Для таблицы измените следующие параметры

[[Файл:lesson8_table_setup.png|200px]]

Для Patchwork устанавливаем следующие настройки. Обратите внимание, что поля "карт.спереди" и "шаблон" заполняются перетаскиванием графического ресурса из редактора ресурсов.

[[Файл:Lesson8_9.jpg]]

6. Для корректной работы вашего Patchwork необходимо, чтобы таблица находилась выше Patchwork по дереву объектов.

[[Файл:Lesson8_10.jpg]]

7. Проверьте выполнение задачи с помощью проигрывателя сцен Viewer.

[[Файл:Lesson8.3.Fin.png]]

=== Упражнения ===

1. Щелкнув правой кнопкой мыши по экрану Lesson_08.2, создать новый экран Lesson_08.3

2. Создать новую сцену с названием game.

3. Скопировать все объекты из сцены 08 (экрана Lesson_08.2).

4. Вставить скопированые объекты в новую сцену game (экрана Lesson_08.3).

5. В новой сцене постарайтесь сами прописать состояния и команды в измененную задачу. Сделайте так, чтобы:

a) заменить картинку пэчворка и маски на другую, имеющуюся в базе ресурсов;

b) изменить настройки кнопки рестарта таким образом, чтобы не переходить на экран Lesson_08.3, а сразу передавать пэчворку состояние mix.
----
{| width="100%"
| width="40%"|[[Создание игры «Hidden Object Game»|Урок 7]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Работа с эффектами|Урок 9]]
|}

[[Category:Learning]]