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

Leaderboardsitem

2018-05-24T14:06:21Z

Vgolob: /* Основные параметры */

Шаблон для помещения в таблицу лидербордов.

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

*'''место''' - Счетчик, в который будет занесено место игрока
*'''имя''' - Текстовый объект куда будет занесено имя игрока
*'''objectId''' - Текстовый объект куда будет занесен objectId игрока
*'''иконка''' - Иконка игрока
*'''очки''' - Счетчик, в который будут занесены очки игрока
*'''уровень''' - Счетчик, в который будет занесен уровень игрока
*'''список желаний''' - объект-таблица, в который сложим желаемые предметы пользователей. Должна иметь 1 ряд
*'''кнопка invite''' - не используется, потому что уже не можем получить сведения с фб о неиграющих друзьях
*'''кнопка info'''
*'''кнопка подарить энергию'''
*'''кнопка подарить монеты'''
*'''кнопка подарить вип'''
*'''машина для играющих''' - машина должна иметь два состояния - player и invitable. Может менять в них внешний вид окна
*'''кнопка пригласить в друзья''' - кнопка для приглашения в игрока из глобальных лидербордов в абс-друзья. Передает клауду состояние “parse_friend_request_lb”. Эта кнопка видна только в глобальных лидербордах у игроков, которые не являются друзьями.
*'''кнопка удалить из друзей''' - кнопка удаления игрока из абс-друзей. Передает клауду состояние parse_friend_request_public и parse_friend_delete_public. Автоматически появляется для всех игроков, которые являются abs-друзьями.
*'''кнопка play''' - кнопка play для Hidden Battle
*'''счетчики 1-7''' - Для заполнения значений счетчиков 1-7 нужно в опции записать желаемые параметры в поля public.lbtemplate.val(%d), где (%d) - номер счетчика, и вызвать cloud состояние parse_save.
*'''иконка соцсети''' - Иконка соцсети. Должна иметь ресурс с двумя кадрами: 0 - фейсбук, 1 - гугл
*'''иконка страны''' - Иконка флага. Попытаюсь взять айдишник ресурса для нее из public.flagRes
*'''иконка vip''' - Иконка vip. Попытаюсь взять айдишник ресурса для нее из public.vipRes
*'''счетчик приза res1'''
*'''счетчик приза res2'''
*'''иконка приза предмет'''
*'''счетчик приза предмет'''
*'''кнопка получения награды'''
*'''слушатель движения''' - слушатель движения ячейки. Должен иметь состояния moveStart и moveFinish
*'''placeholder друга''' - Картинка, которая будет использоваться вместо отсутствующих аватарок
*'''online''' - индикатор онлайна игрока, должен иметь состояния online и offline
*'''selected''' - указанный в этом поле объект будет показываться по vis для ячейки, которой вызвали "user" и прятаться для остальных
*'''lastObjectId''' - objectId игрока, которому будет проявляться объект selected. Чтобы выключить всем игрокам selected, нужно в этот параметр передать 0
*'''lastUserIco''' - айди иконки последнего кликнутого юзера
*'''lastUserName''' - имя последнего кликнутого юзера

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

*'''user''' - записывает в поля lastUserIco и lastUserName этого же объекта (leaderboardsitem) соотв. айди клипа и имя последнего кликнутого юзера
*'''user_param''' - проявляет по vis объект selected. Перед этим нужно объекту ledaerboardsitem передать параметр param, который соответствует номеру ячейки, в которой нужно проявить selected

Leaderboardsitem

2018-05-24T13:59:49Z

Vgolob: /* Основные параметры */

Шаблон для помещения в таблицу лидербордов.

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

*'''место''' - Счетчик, в который будет занесено место игрока
*'''имя''' - Текстовый объект куда будет занесено имя игрока
*'''objectId''' - Текстовый объект куда будет занесен objectId игрока
*'''иконка''' - Иконка игрока
*'''очки''' - Счетчик, в который будут занесены очки игрока
*'''уровень''' - Счетчик, в который будет занесен уровень игрока
*'''список желаний''' - объект-таблица, в который сложим желаемые предметы пользователей. Должна иметь 1 ряд
*'''кнопка invite''' - не используется, потому что уже не можем получить сведения с фб о неиграющих друзьях
*'''кнопка info'''
*'''кнопка подарить энергию'''
*'''кнопка подарить монеты'''
*'''кнопка подарить вип'''
*'''машина для играющих''' - машина должна иметь два состояния - player и invitable. Может менять в них внешний вид окна
*'''кнопка пригласить в друзья''' - кнопка для приглашения в игрока из глобальных лидербордов в абс-друзья. Передает клауду состояние “parse_friend_request_lb”. Эта кнопка видна только в глобальных лидербордах у игроков, которые не являются друзьями.
*'''кнопка удалить из друзей''' - кнопка удаления игрока из абс-друзей. Передает клауду состояние parse_friend_request_public и parse_friend_delete_public. Автоматически появляется для всех игроков, которые являются abs-друзьями.
*'''кнопка play''' - кнопка play для Hidden Battle
*'''счетчики 1-7''' - Для заполнения значений счетчиков 1-7 нужно в опции записать желаемые параметры в поля public.lbtemplate.val(%d), где (%d) - номер счетчика, и вызвать cloud состояние parse_save.
*'''иконка соцсети''' - Иконка соцсети. Должна иметь ресурс с двумя кадрами: 0 - фейсбук, 1 - гугл
*'''иконка страны''' - Иконка флага. Попытаюсь взять айдишник ресурса для нее из public.flagRes
*'''иконка vip''' - Иконка vip. Попытаюсь взять айдишник ресурса для нее из public.vipRes
*'''счетчик приза res1'''
*'''счетчик приза res2'''
*'''иконка приза предмет'''
*'''счетчик приза предмет'''
*'''кнопка получения награды'''
*'''слушатель движения''' - слушатель движения ячейки. Должен иметь состояния moveStart и moveFinish
*'''placeholder друга''' - Картинка, которая будет использоваться вместо отсутствующих аватарок
*'''online''' - индикатор онлайна игрока, должен иметь состояния online и offline
*'''selected''' - указанный в этом поле объект будет показываться по vis для ячейки, которой вызвали "user" и прятаться для остальных
*'''lastObjectId''' - objectId игрока, которому будет проявляться объект selected. Чтобы выключить всем игрокам selected, нужно в этот параметр передать 0

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

*'''user''' - записывает в поля lastUserIco и lastUserName этого же объекта (leaderboardsitem) соотв. айди клипа и имя последнего кликнутого юзера
*'''user_param''' - проявляет по vis объект selected. Перед этим нужно объекту ledaerboardsitem передать параметр param, который соответствует номеру ячейки, в которой нужно проявить selected

Cloud

2018-05-23T14:39:10Z

Vgolob: /* parse друзья и подарки */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа [[Leaderboardsitem]] для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон [[Leaderboardsitem]];
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок. !!! если выбрано "да", то параметр опций parse_friends_num учитывает только неодаренных друзей; чтобы узнать общее количество друзей, использовать parse_friends_all
*'''сохранять первых ячеек''' - сколько первых ячеек таблицы сохранять при очистке

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа [[Leaderboardsitem]].

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Economics

2018-05-22T06:02:21Z

Vgolob: /* Предметы */

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

= Свойства =

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

==Параметры==
===Основные параметры===
*'''disable''' - выключена ли экономика, если 1 - то экономика не реагирует на состояния и не сейвится в опции. Чтобы изменить параметр, меняем его и вызываем сост. "init"
*'''Сдвиг уровней''' ( ''levels_shift'' ) - число на которое сдвинется анлок уровней в economics setup; после задания параметра нужно проинитить экономику;
*'''Уровни''' - опыт, необходимый для перехода на следующий уровень. Последовательность чисел через запятую.
*'''Уровни парабола''' - Три числа через запятую, задающие коэффициенты параболы, которые определяют необходимый опыт после уже перечисленных уровней.
*'''Энергия''' - максимум энергии на каждом из уровней. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Энергия прибавка''' - Число определяющее прибавку к максимуму энергии после уже перечисленных уровней.
*'''Ресурс 1''' - количество ресурса 1 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Ресурс 2''' - количество ресурса 2 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Перезарядка''' - время за которое восстанавливается единица энергии в ms.
*'''нач. ресурс 1''' - Начальное значение ресурса 1.
*'''нач. ресурс 2''' - Начальное значение ресурса 2.
*'''время напоминания''' - время напоминания о задачах на каждом из уровней. Записывается в виде последовательности чисел через запятую. Последнее значение будет зациклено для всех последующих уровней. Время изменяется в часах.
*'''напоминание об энергии''' - уведомление перетаскивается с текстового редактора, представляет собой напоминание о том что энергия восстановилась. Например, "Ваше энергия полностью восстановлена".
*'''опции для 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''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''иконка предмета''' - картинка, которая отображает предмет необходимый для игры с монстром.
*'''нужно предметов''' - счетчик, который отображает необходимое количество предметов.
*'''есть предметов''' - счетчик, который отображает текущее количество предметов, находящееся в наличии.
*'''суммарная стоимость''' - счетчик, который отображает суммарную стоимость недостающих предметов.
*'''кнопка купить''' - кнопка, по нажатию которой, происходит покупка недостающих предметов.
*'''кнопка прогнать''' - кнопка, по нажатию которой, можно прогнать монстра не играя в игру, эту кнопку можно не задавать.

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

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

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

*'''Шаблон коллекции''' - ссылка на объект типа ecollection который будет использоваться в качестве исходного для всех коллекций.
*'''Таблица''' - таблица, куда по ссылке будут добавлены шаблоны коллекции.
*'''алерт''' - некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окно с информацией о предмете всплывает в окне с коллекциями.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.
*'''цифры''' - фреймовая анимация содержащая в себе цифры. Последний фрейм анимации - отметка много.

===Окошко коллекционного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.

===Окошко поздравления со сдачей коллекции===

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

===Окошко инвентарного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.

===Окошко поздравления с получением уровня===

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

===Окошко поздравления с получением уровня и открытием локации===

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

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

*'''энергия''' - счетчик, отображающий количество энергии, которая прибавляется к максимуму.

*'''ресурс 1''' - счетчик, отображающий количество денег.

*'''ресурс 2''' - счетчик, отображающий количество кристаллов.

*'''иконка локации''' - картинка, отображающая иконку локации, которая стала доступна

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

===Окошко получения уровня на локации===

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

===Окошко, когда не хватает чарджера (общее) ===

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

===Окошко, которое выезжает когда найден коллекционный предмет ===

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

===Окошко покупки артефакта===

Кратко об артефактах. Артефакты это инвентарные предметы, которые можно найти либо купить. Они необходимы для того, чтобы была возможность играть в связанную локацию. Связанная локация - локация, которая имеет свой уникальный порядковый номер в списке локаций, но тем не менее логически привязана к локации с другим порядковым номером. Когда все артефакты, необходимые для игры в связанную локацию собраны, то при вызове состояния ''location'' объекту economics локация выбирается случайным образом между оригинальной и связанной. При этом есть возможность сменить локацию (ротация между оригинальной и связанной локацией) вызвав состояние ''location_switch''. Чтобы сменить локацию нужен предмет, который перетаскивается в поле "предмет переключения" настроек локации.

*'''окно''' - Некая машина, олицетворяющая собой само окошко покупки. Должна иметь состояние show
*'''таблица''' - Таблица должна иметь две строки и заполнение по столбцам. В верхнюю попадут иконки артефактов, в нижнюю - кнопки купить
*'''кнопка 1''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 2''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 3''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 4''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact

===Дополнительные достижения ===

В этом разделе указаны некоторые достижение, которые отправляются объектом economics в gamecenter.

*'''достижение на трату ресурса 1''' - id достижения, отправляемого за трату ресурса 1 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 1''' - сумма ресурса 1, которую необходимо потратить для получения достижения.
*'''достижение на трату ресурса 2''' - id достижения, отправляемого за трату ресурса 2 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 2''' - сумма ресурса 2, которую необходимо потратить для получения достижения.
*'''достижение на число открытых локаций''' - id достижения, отправляемого за открытия количества локаций из следующего поля (при открытии нужного количества локаций отправляется 100% достижения).
*'''количество локаций''' - кол-во локаций, которое необходимо открыть для получения достижения.
*'''достижение за покупки чего-либо''' - id достижения, отправляемого за совершенное количество покупок из следующего поля (при покупке нужного количества отправляется 100% достижения).
*'''количество покупок''' - количество покупок, которое необходимо свершить для получения достижения.

===Покупка рандомного предмета===

При вызове объекту economics состояния ''buy_random_col'' покупается случайный коллекционный предмет. Визуализацией покупки служит выпадающий на сцену объект из вкладки настроек "Летающий объект"

*'''res1''' - цена предмета в ресурсе 1.
*'''исключения''' - id предметов, которые не попадут в случайный выбор. Перетаскиваются из текстовой базы.
*'''каунтер''' - объект типа counter в который сложится цена предмета.

=== Статус ===
Статус - дополнительный экономический параметр игрока, который зависит от внутриигровых действий. Статус определяется кол-вом статусных очков, которые начисляются за совершение in-app покупки и при достижении нового уровня (exp).

Тесно связан с [[Wallet|Wallet]].

*'''очки для повышения''' - массив чисел, указываем через запятую. Обозначает нужное кол-во очков статуса для перехода на следующий уровень. Пример: 0, 150, 3850. Изначальный уровень уже получен при инициализации экономики. Для перехода на следующий (2-й) нужно получить 150 очков. На 3-й - 3850 и т.д.
*'''множитель статуса при покупке''' - массив чисел, указываем через запятую. Обозначает коэф., на который домножим базовое значение статусных очков при покупке. Зависит от текущего статуса. Пример: 1,2,3. Базовое значение за покупку - 18 очков статуса. При совершении покупки, имея 1-й статус - получаем 18 очков. Имея второй статус - 36, третий - 54.
*'''множитель монет при покупке''' - Аналогично предыдущему пункту.
*'''прибавка за уровень''' - массив чисел, указываем через запятую. Показывает сколько статусных очков будет получено при достижении уровня exp, учитывая текущий статус.
*'''множитель дейли-бонуса''' - массив чисел, указываем через запятую. Множитель, который можно использовать при начислении ежедневного бонуса. Зависит только от текущего статуса.

'''Поля в опциях'''
* ecomics%d.stlev - текущий уровень статуса (начиная с 0!)
* ecomics%d.stpoints - поинты внутри текущего уровня
* comics%d.stdaily - множитель для дейли бонуса
* ecomics%d.stmult - множитель для монеток

=== Настройки симуляции ===

*'''время''' - время симуляции, измеряется в секундах.

*'''минимум в локации''' - нижняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.

*'''максимум в локации''' - верхняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.
*'''порог покупки''' - число, указывающее какую долю, от ресурсов игрока, должна составлять цена локации, что бы он решился её купить.
*'''порог покупки предмета''' - число, указывающее какую долю,от ресурсов игрока, должна составлять цена предмета, что бы он решился его купить.
*'''вероятность задачи''' - число, отображающее вероятность того, что симуляция будет выбирать не из всех доступных локаций, а из связанных с заданиями.
*'''вероятность матча''' - число, отображающее вероятность того, что симуляция будет играть в матч.
*'''изначально хинтов''' - изначальное количество хинтов.
*'''предметов на хинт''' - на сколько найденных предметов игрок израсходует хинт.
*'''цена хинта монеты''' - сколько монет (ресурс 1), стоит некий усредненный хинт.
*'''цена хинта кристаллы''' - сколько кристаллов (ресурс 2), стоит некий усредненный хинт.
*'''хидденов подряд''' - игрок будет пытаться пройти не менее данного числа хидденов подряд.
*'''восстановить энергии''' - некое усредненное количество энергии для восстановления.
*'''цена энергии монеты''' - сколько монет стоит энергия (цена в ресурсе 1).
*'''цена энергии кристаллы''' - сколько кристаллов стоит энергия (цена в ресурсе 2).
*'''вероятность победы в матче'' - число, отображающее вероятность победы в матче.
*'''время в матче''' - условное время пребывания в матче.
*'''вероятность покупки за реал''' - каждый раз когда игроку не хватает денег или кристаллов - проверяем эту вероятность.
*'''цена монеты в деньгах''' - цена монеты в деньгах.
*'''количество монет в покупке''' - количество монет в покупке.
*'''цена кристаллов в деньгах''' - цена кристаллов деньгах.
*'''количество кристаллов в покупке''' - количество кристаллов в покупке.

=== Настройки равномерной экономики ===

Нужно в случае, если мы хотим давать за локации и монстров одинаковую награду (опыт, затрата энергии, вне зависимости от настроек в economics_setup). Награда может отличаться только для монстров (если в economics_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", то действие предмета будет вечным, отображаться в таблице амулетов он не будет.

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

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

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

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

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

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

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

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

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

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

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

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

*'''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 - то для достижения может использоваться любая аномалия.

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

[[Файл: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 детальнее]).
*'''search_task_only_open''' - вызываем из окна таска, откроет превью локации в которой можно найти требуемый предмет. Аналог 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|*]]

Cloud

2018-05-18T08:09:40Z

Vgolob: /* parse друзья и подарки */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа [[Leaderboardsitem]] для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон [[Leaderboardsitem]];
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок. !!! если выбрано "да", то параметр опций parse_friends_num учитывает только неодаренных друзей; чтобы узнать общее количество друзей, использовать parse_friends_all

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа [[Leaderboardsitem]].

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Taskorganizer

2018-05-15T12:12:34Z

Vgolob: /* Taskorganizer setup */

{{TOC right}}
[[Object|Объект]] Taskorganizer - Менеджер задач и квестов

=Свойства=
[[Файл:Task.jpg|250px|thumb|right]]
[[Файл:Task_1.jpg|250px|thumb|right]]
=== Общие параметры ===
*'''economics''' - Объект типа экономикс.
*'''предметы''' - Объект типа eitems.
*'''таблица''' - Таблица куда будут помещены иконки заданий. При тапе на таблицу объекту Taskorganizer вызывается состояние show. Иконки подтягиваются из текстовой базы (icon1).
*'''добавлять иконки''' - 1 - добавлять в таблицу иконки, 0 - тексты из текстового id (поле word).
*'''шаблон предмета''' - Объект типа etaskitem будет использоваться при показе превью задания.
*'''фильтрация''' - Категория, которые должны будут отобразиться в таблице логов при вызове состояния logbook. Пустая строка - все.
*'''таблица логов''' - Таблица куда будут помещены записи логбука.
*'''новая запись''' - Объект, которому будет вызвано состояние show при добавлении новой записи в логбук.
*'''новое задание''' - Графический ресурс, который будет отмечать новые задания. Смещение должно достигаться пивотом.
*'''прочитанное задание''' - Графический ресурс, который будет отмечать прочитанные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе).
*'''выполненное задание''' - Графический ресурс, который будет отмечать выполненные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе)
*'''уведомление''' - Текстовый айди заголовка связанных с задачами уведомлений (Должно быть заполнено поле sense 4 - т.к. рандомно его будет постить).
*'''вероятность уведомления''' - Подменная вероятность нахождения предмета нужного для задания по уведомлению с которого мы пришли. 0 - использовать значение по умолчанию.
*'''выполнять непрочитанные''' - 1 - выполнять непрочитанные таски, 0 - нет.
*'''хронологический порядок''' - 1 - записывать задачи в хронологическом порядке, 0 - нет.
*'''картинки в логбук''' - Расположение картинки до или после текста.
*'''сдвиг уровней''' - число на которое сдвинутся требования к уровню игрока в taskorganizer_setup для каждой задачи;
*'''refresh при показе окна''' - 0 - нет, 1 - да. Ставим = 0 ( "нет" ), если хотим чтобы при тапе по таблице отложить сортировку и обновление статуса таска ( в определённый момент ( к примеру, когда открылось окно таска), передаём состояние '''refresh''' и таблица обновится).
*'''использовать накопление ошибки''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы нахождение предметов в хиддене, по таску не превышало n-раз ( к примеру p= 0.5 (1/0.5=2 , т.е. предмет должны найти не более чем за две игры в хидн), если количество сыгранных игр >= максимальному по вероятности, то предмет попадает в таблицу ( мы его нашли)). Если стоит - 0 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.
*'''etasktemplate''' - объект типа [[Etasktemplate|etasktemplate]]
*'''только одна подкрутка за раз''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы за один проход хиддена выполнялся один таск.
*'''таблица для шаблонов''' - таблица, в которую сложим шаблоны из предыдущего поля
*'''помещать генерируемые в шаблоны''' - помещать в шаблоны генерируемые таски
*'''уменьшать предметы при сдаче коллекции''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), то при сдаче коллекции будет выполнен декремент количества предметов необходимых чтобы задание выполнилось ( параметр таски s0 в опциях).

<pre>
Для огранизации логбука необходимо текст поместить в sentenсe 1. Картинка, что будет отображаться с этим текстом, должна быть icon 2. Также есть возможность использовать эту картинку в качестве фона. Тогда текст, который будет отображаться поверх этой картинки, нужно разместить в sentenсe 2.
</pre>

=== Группа угадайка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать угадайку.
*'''с уровня''' - Угадайка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''иконка''' - Объект, в который сложим иконку предмета.
*'''иконка для таблицы''' - Иконка соответствующая угадайке в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
=== Группа рулетка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать рулетку.
*'''с уровня''' - Рулетка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show.
*'''иконка для таблицы''' - Иконка соответствующая рулетке в таблице задач.
=== Группа генерируемые ===

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

*'''активных задач''' - Эти задачи будут генерироваться, когда активных задач столько или меньше.
*'''с уровня''' - Эти задачи будут генерироваться только начиная с данного уровня.
*'''максимально''' - Будет сгенерированно случайное количество задач от 1 до n.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''название''' - Текстовый объект, в который будет сложено название локации.
*'''превью''' - Объект, в который сложим превью локации для генерируемой задачи.
*'''иконка для таблицы''' - Иконка соответствующая генерируемому таску в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
*'''текст для etasktemplate''' - будет в поле name etasktemplate. Это название задачи на прохождение локации, которая генерируется автоматически и использует шаблон etasktemplate. Текст используется из Текстовой Базы Ресурсов. Например, "Исследовать локацию".
*'''номер кнопки для etasktemplate''' - номер кнопки для etasktemplate. [[Button|Кнопка]], которая используется для данной задачи. Например, "Исследовать".

<pre>
Если перед генерацией случайного таска на исследование локации указать параметру gen_loc значение от 0 до n, то ближайшая генерируемая задача будет для конкретной локации под указанным номером. После генерации параметр gen_loc становится -1.
</pre>

<pre>
Если перед генерацией случайного таска от персонажа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
Если указать gen_face="-2", то таскорганайзер попытается с генерировать задачу с персонажем так, чтобы номер локации совпадал с персонажем, при условии что номер локации будет меньше максимальному числу персонажей ( char_num).
</pre>

=== Группа угадаечные задачи ===

В этой группе указываем диапазоны для генерации тасков-викторин и способ генерации.

*'''стандартная генерация''':
::'''нет''' - особая генерация задач, при которой с начало генерируем задачи из _очереди 1_, потом задачи из _очереди 2_ ( Если в первой очереди мы не можем сгенерировать задачу, пытаемся сгенерировать из второй очереди). Если мы не сгенерировали задачу из обоих очередей, то мы обнуляем все таски из обоих очередей ( и сразу генерим из _очереди 1_ задачу);
::'''да''' - стандартная генерация одной угадайки ( начинаем сверху вниз генерить;
*'''очередь 1''' - Основная очередь, пытаемся из неё сгенерировать задачу, при получении Taskorganizer сост. _generate_guess_, если в предыдущем поле стоит '''нет'''. Каждая задача из этой очереди имеет условия для появления ( прохождение сюжетного таска к примеру);
*'''очередь 2''' - Очередь затычка, задачи из этой очереди без условий. Предназначена когда в первой очереди нету доступных тасков для генерации;

<pre>
У таскорганайзера есть поле disabled, если при каждом запуске приложения после конца туториала писать туда 1 - это приведет к удалению старого сейва и несозданию нового. Несколько килобайт выгоды в опциях + использовать только для туториального таскорганайзера, когда он отработает.
</pre>

=Taskorganizer setup=
[[Файл:Task_2.jpg|600px|thumb|right]]

*'''id''' - Идентификатор задания. Используется в других заданиях. По общей концепции - строковый айди. Перетаскивается из текстовой базы.
'''Для каждого задания(записи в logbook) должен быть свой уникальный id.'''
*'''хинт''' - Список строк-подсказок для задачи. Перетаскиваются из текстовой базы. Таким образом, добавив несколько записей из базы, увидим выпадающий список.
*'''название (объект)''' - Текстовый объект, в который мы сложим название задания. Описание подтягивается из текстовой базы из первого столбика (word) текстового id задания.
*'''машина''' - Объект, которому при активации задания будет вызвано состояние show, а при повторном открытии задания show_old.
*'''портрет''' - Объект, которому при активации задания будет устанорвлен графический ресурс рожи.
*'''таблица''' - Таблица куда будут помещены темплейты предметов данного задания.
*'''описание (объект)''' - Текстовый объект, в который мы сложим описание задания. Описание подтягивается из текстовой базы из второго столбика (sentence1) текстового id задания.
*'''награда (ресурс 1)''' - Счетчик отображающий награду в ресурсе 1 за выполнение задания.
*'''награда (ресурс 2)''' - Счетчик отображающий награду в ресурсе 2 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.
*'''reusable''' - 0 - задача появится 1 раз, 1 - будет появляться каждый раз при выполнении ее условий.
*'''приоритетная''' - чем больше число, тем выше в таблице тасков.
*'''умножать цену пропуска''' - нужно в случае, если мы хотим давать юзеру возможность моментально выполнить задачу за цену, которая зависит от количества нехватающих коллекционных предметов (цена пропуска*количество отсутствующих предметов).
*'''отображать выполненным в шаблонах''' - "да" - таск будет оставаться в таблице шаблонов после выполнения/
*'''видимые кнопки''' - номера видимых кнопок в [[Etasktemplate#Дополнительные кнопки|Etasktemplate]] через запятую. Отображает кнопки, используемые для данной задачи.

'''Необходимое для логбука'''

*'''для журнала''' - 0 - задача предназначена для списка задач, 1 - задача предназначена для журнала.
*'''категория''' - Категория к которой относится задача/запись. Пока используется только задачами для логбука.

'''Критерии появления'''

*'''уровень''' - Минимальный уровень, при котором может появиться задание.
*'''аномалия''' - В какой-либо локации присутствует аномалия данного типа. -1 - не учитывать условие.
*'''локация''' - Локация для которой будем проверять мастерство. -1 - не учитывать условие.
*'''мастерство''' - Уровень мастерства, который должен быть достигнут в локиции. -1 - не учитывать условие.
*'''завершены до''' - Задания, которые должны быть завершены до появления этого.
*'''получены до''' - Задания, которые должны быть получены до появления этого.
*'''не завершены до''' - Задания, которые должны быть НЕ завершены до появления этого.
*'''объект до''' - Объект, который должен находиться в состоянии_до для появления задания.
*'''состояние до''' - Состояние объекта_до, в котором вызывается генерация задания.
*'''коллекционные''' - Коллекционные предметы, которые должны быть найдены для появления задания.
*'''вероятность нужного''' - Когда мы будем проходить локации, в которых есть предметы необходимые для задания - мы будем подменять вероятность из локации вот этой вероятностью. 0 - использовать дефолтную.

'''Критерии завершения'''

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

'''Награда'''

*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''репутация''' - репутация, даваемая за выполнение задания.
*'''штраф репутации''' - штраф репутации за провал таймерного задания. Должен быть отрицательным.
*'''перевести объект''' - При выполнении задания этот объект будет переведен в новое состояние.
*'''в состояние''' - Состояние для объекта из предыдущего поля.

==Подзадача предмет==
В опции суммарно будет записываться значение два параметра:

:'''iN''' - "item need" - необходимое количество предметов, по всем "подзадачам предмет";
:'''iH''' - "item have" - имеющееся количество предметов, по всем "подзадачам предмет";
:'''i0..i666''' - требующийся предмет, пишется для задач из коллекций;

*'''сгенерировать предмет''' - определить необходимый предмет из коллекции;
::'''нет''' - просто требовать предмет;
::'''да''' - сгенерировать предмет из доступных локаций (календарь);
::'''сегодня''' - с генерировать предмет из коллекции, для локации текущего дня (календарь);
::'''неделя''' - с генерировать предмет из коллекции, для локаций текущей недели (календарь);
*'''из коллекции''' - указать txtID коллекции из которой будут браться id предметов;

==Подзадача экспертиза==

*'''предмет''' - в поле предмет записываем id объекта, который нужен для проведения экспертизы. Предмет берем из текстовой базы ресурсов. Иконка предмета до начала и во время проведения экспертизы в icon1, иконка предмета после проведения экспертизы в icon2.
*'''время''' - изначальная длительность экспертизы в секундах.
*'''стоимость''' - стоимость экспертизы, используется res3.
*'''стоимость ускорения''' - стоимость ускорения экспертизы, используется res2.
*'''описание''' - описание подзадачи
*'''владелец''' - здесь используем число для указания типа экспертизы. Например, 1 - это экспертизы одного типа, 2 - это второй тип экспертиз
*'''уведомление''' - текстовый id для уведомления. Генерируется при старте. Имя уведомления записать в поле word, текст уведомления в sentence1, картинку уведомления в sentence2.

<pre>
Картинку для уведомления положить в конфиги, рядом с файлом platform.icf для каждой платформы.
К примеру, путь может выглядеть так: C:\Editor\Projects\Crime_City\conf\base\project\platforms\google
</pre>

[[Файл:Taskorganizer_eanalysis.png|600px|thumb|right]]

==Задача cross promo==

У таска можно включить флаг:
*'''cross promo''' - идентификатор задачи типа ''cross promo'' (1 - да, 0 - нет)

в этом случае он
а) сгенерится, если есть кросс промо И выполнены остальные условия его появления;
б) выполнится, если установлено приложение И выполнине остальные условия его выполнения;
в) вызвав состояние '''cross_promo''' -открыть урл связанный с crosspromo задачей - таскорганайзеру можно открыть урл, которые приехал из конфига.
У задачи должно быть уникакльное окно, в котором в объект указанный в ''портрет'' будет помещен баннер.

==Изменить состояние объекта - новое задание==

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

==Изменить состояние объекта - таймаут==

Позволяет изменить состояние объекта если какая-то задача кончилась таймаутом, находится в taskorganizer setup. Создан для таймерных заданий, которые работают через [[Etasktemplate|Etasktemplate]]. Указываем '''эффект выполнения fail''' из [[Etasktemplate#Реализация таймерных тасков|Etasktemplate]]. Эффект используется, когда задание завершилось провалом по истечению времени.

=Состояния=

*'''show''' - При вызове этого состояния из таблицы с иконками заданий открывается соответствующая машина задания, прописанная в группе '''задание'''.
*'''check''' - При вызове проверяется выполнение текущих заданий(заданий добавленных в таблицу). Для того чтобы таскорганайзер добавил таски в таблицу после загрузки приложения ему нужно передать refresh.
*'''generate''' - При вызове подбирается подходящее задание в зависимости от прогресса игрока.
*'''generate_plot''' - При вызове генерится задача с персонажем ( поле генерируемые с персонажами), если перед этим передать в поле gen_face номер персонажа, то сгенерируем с указанным персонажем, после параметр обнулится ( значение -1 ). Перед вызовом данного состояния, '''обязательнo''' в поле _param_ вбить "1".
*'''log_check''' - При вызове состояния проверяется доступны ли новые записи в логбук.
*'''log_show''' - Заполняет таблицу логбука записями с текущим фильтром.
*'''refresh''' - Удаляет иконку выполненного задания из таблицы. Лучше всего вызывать после Check.
*'''cancel''' - Удаляет задание без награды, которое указано как ID в параметре param таскорганайзера, т.е. объекту Taskorganizer в param указываем ID таска (например 1933 - берется из options.xml или текстовой базы), а потом вызываем состояние cancel.
*'''add_hint''' - Добавляет в таблицу хинтов следующий текстовый ID из поля хинты текущего таска. Если все хинты показаны, то в опции записывается параметр haveHints=0.
*'''task_prev''' - Используется, если открыта машина-шаблон текущего задания. В этом состоянии показывается предыдущее по списку таблицы задание.
*'''task_next''' - Показывает следующее по списку таблицы задание.
<pre>
Состояния task_prev и task_next работают циклически, после первой задачи показывают последнюю и наоборот.
</pre>
*'''show_id''' - Показать окно задачи, взяв ее id из параметра.
*'''show_complete_id''' - показать окно после задачи, взяв ее id из param (делалось для одноразовых задач, повторяемые могут не работать);
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''skip_id_no_effect''' - изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.
*'''add_hint_hidden''' - Вызов подсказки для 1 (первой по списку в таскорганайзере) скрытой задачи.
*'''add_hint_hidden_all''' - Вызов подсказки для всех активных скрытых задач (по списку в таскорганайзере).
*'''calc_active_preset''' - Посчитать количество активных задач по конкретному "preset" (перед вызовом в поле "param" указать номер интересующей категории preset). После вызова, таскорганайзер заполнит параметр "preset_tasks".

Состояния для работы с тасками-угадайками по типу викторины ( в taskorganizer_setup - тип = "угадайка"):
*'''answer''' - ответить на открытую угадайку ( в поле '''param''' должно находиться число, номер нажатой кнопки от 0 до 3 ). Вешаем на кнопки варианты-ответа ( пишем param = 0 - 3 , после передаёт _answer_);
*'''generate_guess''' - сгенерировать угадайку-викторину ( выберет доступные задачи из диапазона указанном в очередях ( 1 и 2) поле _угадаечные задачи_ taskorganizer). При открытии угадайки, в поле _cur_guess_answer_ объекта Taskorganizer записывается номер кнопки где лежит правильный ответ ( от 0 до 3 );

ПРИМЕЧАНИЕ: при проверке задач для логбука для последней выполненной будет перезаписано поле filter автоматически.

При кажом refresh таскорганайзер заполняет у себя поля:
*'''tasks_in_table''' - задач в таблице
*'''tasks_total''' - задач в таблице + скрытых задач

Изменение состояния объекта в логе выводится как:
I/GTaskOrganizer GTaskOrganizer::state() state from 0 to 5 through object eco_checker (2543);

<pre>
Состояния из кода:
0 "idle", // Состояние по умолчанию
1 "refresh", // Обновить таблицу с иконками задач
2 "refresh_templates", // Обновить "ленту" задач
3 "generate", // Сгенерировать новую задачу (выбрать одну из доступных по условиям) И обновить таблицу с иконками задач
4 "show", // Показать окно задачи в зависимости от выделенной ячейки в таблице
5 "check", // Проверить задачи на выполнение. После этого автоматически вызовется рефреш
6 "log_check", // Проверить, не стали ли доступны новые записи в логе
7 "log_show", // Заполнить таблицу логбука записями с текущим фильтром
8 "task_next", // Следующий таск в таблице
9 "task_prev", // Предыдущий таск в таблице
10 "add_hint", // Добавить подсказку
11 "task_reward", // Вручить награду за задание - нужно, чтобы разделить выполнение задания и окно получения уровня
12 "show_id", // Показать окно задачи, взяв ее id из параметра
13 "guess", // Ответить на текущую угадайку, взяв ответ из параметра
14 "add_hint_last", // Добавить подсказку последней добавленной задаче
15 "add_hint_top", // Добавить подсказку верхней задаче в таблице
16 "guess_who_reward", // Начислить награду за последнюю угадайку
17 "roulette_complete", // состояние, вызываемое при выполнении текущей задачи "рулетка"
18 "cheat_complete", // читерское завершение задачи
19 "generate_plot", // сгенерировать новых "сюжетных задач"
20 "eraser_start", // принудительно стартовать стирачку
21 "eraser_complete", // вручить награду за нее
22 "cancel", // отменить задание из param
23 "guess_year", // попытаться угадать год (param)
24 "guess_year_reward", // Дать награду за угадывание года
25 "show_last_plot", // Открыть последнюю сгенерированную сюжетную задачу
26 "skip", // Пропустить задачу для которой открыто окно за кристаллы
27 "add_hint_id", // Добавить хинт задаче по id, если она активна
28 "add_hint_hidden", // Добавить хинт первой скрытой задаче
29 "add_hint_hidden_all", // Добавить хинт всем скрытым задачам
30 "time_to_activate", // Пришло событие об активации задачи
31 "time_to_timeout", // Пришло событие о таймауте задачи
32 "check_multiple", // Проверить выполнение задач не выходя из проверки после первой найденной
33 "answer", // Ответить на новую (январь 2015) угадайку. Номер кнопки в param
34 "generate_guess", // Сгенерировать новую угадайку
35 "show_random", // Показать окно случайной активной задачи
36 "show_eraser", // Показать окно стирачки
37 "calc_active_preset", // Посчитать активные задачи по заданному пресету
38 "show_case", // Найти активный кейс и заполнить его поля
39 "scroll_to_task", // Промотать на таск из param таблицу
40 "reactivate", // Повторно активировать таск из param
41 "generate_loc", // Сгенерировать генерируемых (извиняюсь) тасков, количество в param
42 "copy", // Скопировать общие данные в другой таскорганайзер
43 "cross_promo", // Открыть урл связанный с crosspromo задачей
44 "show_complete_id", // Показать окно после задачи независимо от ее состояния, взяв ее id из параметра
45 "skip_id_no_effect", // Изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
46 "clear_shown_templates" // Убрать выполненные таски для которых показан эффект из таблицы шаблонов
</pre>

=Запись в опции=

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

"tasks(id таскорганайзера в проекте).t(id текстового объекта - идентификатора задания).s".

Возможные значения:
* '''0''' - таск не активен (не добавлен путем вызова generate таскорганайзеру);
* '''1''' - таск сгенерирован ;
* '''2''' - таск прочитан (вызвано состояние show);
* '''3''' - таск выполнен;
* '''4''' - отложенное состояние таска (условия появления выполнены, но время его появления еще не прийшло);
* '''5''' - таск выполнен, но награда ещё не забиралась ( таск будет оставаться в таблице, если таски не выполняются автоматически);
* '''7''' - таск выполнен, награда получена, таск остался в таблице;

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры:=
Каждая таскорганайзер пишет в пользователя следующие параметры:
*'''public.TaskOrganizerCompletedTasks''' - количество выполненных одноразовых задач;
*'''public.TaskOrganizerCompletedTasksAll''' - количество выполненных задач с учётом повторяемых;

=Механизм многоуровневых достижений=
С помощью таскорганайзера можно организовать систему многоуровневых достижений. Для этого используется [[Etasktemplate|темплейт задачи]]. Данные темплейты складываются в таблицу темплейтов таскорганайзера. При этом в самом таскорганайзере должна быть указанна таблица для иконок задач, хоть она и не используется (желательно вынести за границы экрана).

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

Часть контента для достижения задается чрез текстовый объект - id таска. В текстовом объекте указываем название (word), описание невыполненной (sentence1) и выполненной (sentence2) ачивки. А также ресурс иконки ачивки (ico1), ресурс звезд для невыполненной (ico2) и выполененной (ico3) задачи.
Награду за достижения ачивки указываем как награду за выполнение таска. Также с помощью обработчика завершения задачи можем запустить анимацию получения ачивки.

Для заполнения таблицы темплейтов нужно вызвать состояние '''refresh_templates''', при вызове '''check''' задача, условия которой были выполнены изменит свое состояние, при этом будут переключены ресурсы звезд, описание ачивки и спрятана кнопка темплейта '''btn'''.

Для контроля того, какая задача будет вызвана при вызове '''check''' можно использовать следующий способ. К задаче добавляем еще одну подзадачу на опции. Когда прогресс по первой подзадаче на опции будет >= требуемого значения для задачи будет отображаться кнопка темплейта '''btn'''. При нажатии на эту кнопку, которая должна вызывать '''take''' темплейту задачи, в него пишется параметр clicked_task_id, по этому параметру определяем у какой задачи нужно выполнить вторую подзадачу на опции и вызываем '''check''' таскорганайзеру.

Пример
S:\!MOBILE\!!!EditorGames\Wiki_sample

Complex_achievements.zip

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

=Равномерная экономика (Preset)=
[[Файл:1499422858929.jpg|300px|thumb|right]]
Работает, при включении в объекте Economic равномерной экономики (задание не нулевых значений).
Настройка позволяет давать диапазонную награду конкретной группе задач("preset").
Настройка награды для всех задач, у которых не указан параметр "preset" (т.е. =="-1"), осуществляется, группой параметров объекта Taskorganizer:

Настройки конкретного preset вынесены в отдельную вкладку "Taskorganizer_setup":
[[Файл:Photo hidden 365 Scene Editor build Wed Jul 5 151607 2017 -(single-user) DProjectsEDITOR Game Hidden 365Photo hidden 365Photo hidden 365.seproj.jpg|600px|right]]
[[Category:Economics]]

Taskorganizer

2018-05-15T11:13:03Z

Vgolob: /* Taskorganizer setup */

{{TOC right}}
[[Object|Объект]] Taskorganizer - Менеджер задач и квестов

=Свойства=
[[Файл:Task.jpg|250px|thumb|right]]
[[Файл:Task_1.jpg|250px|thumb|right]]
=== Общие параметры ===
*'''economics''' - Объект типа экономикс.
*'''предметы''' - Объект типа eitems.
*'''таблица''' - Таблица куда будут помещены иконки заданий. При тапе на таблицу объекту Taskorganizer вызывается состояние show. Иконки подтягиваются из текстовой базы (icon1).
*'''добавлять иконки''' - 1 - добавлять в таблицу иконки, 0 - тексты из текстового id (поле word).
*'''шаблон предмета''' - Объект типа etaskitem будет использоваться при показе превью задания.
*'''фильтрация''' - Категория, которые должны будут отобразиться в таблице логов при вызове состояния logbook. Пустая строка - все.
*'''таблица логов''' - Таблица куда будут помещены записи логбука.
*'''новая запись''' - Объект, которому будет вызвано состояние show при добавлении новой записи в логбук.
*'''новое задание''' - Графический ресурс, который будет отмечать новые задания. Смещение должно достигаться пивотом.
*'''прочитанное задание''' - Графический ресурс, который будет отмечать прочитанные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе).
*'''выполненное задание''' - Графический ресурс, который будет отмечать выполненные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе)
*'''уведомление''' - Текстовый айди заголовка связанных с задачами уведомлений (Должно быть заполнено поле sense 4 - т.к. рандомно его будет постить).
*'''вероятность уведомления''' - Подменная вероятность нахождения предмета нужного для задания по уведомлению с которого мы пришли. 0 - использовать значение по умолчанию.
*'''выполнять непрочитанные''' - 1 - выполнять непрочитанные таски, 0 - нет.
*'''хронологический порядок''' - 1 - записывать задачи в хронологическом порядке, 0 - нет.
*'''картинки в логбук''' - Расположение картинки до или после текста.
*'''сдвиг уровней''' - число на которое сдвинутся требования к уровню игрока в taskorganizer_setup для каждой задачи;
*'''refresh при показе окна''' - 0 - нет, 1 - да. Ставим = 0 ( "нет" ), если хотим чтобы при тапе по таблице отложить сортировку и обновление статуса таска ( в определённый момент ( к примеру, когда открылось окно таска), передаём состояние '''refresh''' и таблица обновится).
*'''использовать накопление ошибки''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы нахождение предметов в хиддене, по таску не превышало n-раз ( к примеру p= 0.5 (1/0.5=2 , т.е. предмет должны найти не более чем за две игры в хидн), если количество сыгранных игр >= максимальному по вероятности, то предмет попадает в таблицу ( мы его нашли)). Если стоит - 0 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.
*'''etasktemplate''' - объект типа [[Etasktemplate|etasktemplate]]
*'''только одна подкрутка за раз''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы за один проход хиддена выполнялся один таск.
*'''таблица для шаблонов''' - таблица, в которую сложим шаблоны из предыдущего поля
*'''помещать генерируемые в шаблоны''' - помещать в шаблоны генерируемые таски
*'''уменьшать предметы при сдаче коллекции''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), то при сдаче коллекции будет выполнен декремент количества предметов необходимых чтобы задание выполнилось ( параметр таски s0 в опциях).

<pre>
Для огранизации логбука необходимо текст поместить в sentenсe 1. Картинка, что будет отображаться с этим текстом, должна быть icon 2. Также есть возможность использовать эту картинку в качестве фона. Тогда текст, который будет отображаться поверх этой картинки, нужно разместить в sentenсe 2.
</pre>

=== Группа угадайка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать угадайку.
*'''с уровня''' - Угадайка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''иконка''' - Объект, в который сложим иконку предмета.
*'''иконка для таблицы''' - Иконка соответствующая угадайке в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
=== Группа рулетка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать рулетку.
*'''с уровня''' - Рулетка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show.
*'''иконка для таблицы''' - Иконка соответствующая рулетке в таблице задач.
=== Группа генерируемые ===

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

*'''активных задач''' - Эти задачи будут генерироваться, когда активных задач столько или меньше.
*'''с уровня''' - Эти задачи будут генерироваться только начиная с данного уровня.
*'''максимально''' - Будет сгенерированно случайное количество задач от 1 до n.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''название''' - Текстовый объект, в который будет сложено название локации.
*'''превью''' - Объект, в который сложим превью локации для генерируемой задачи.
*'''иконка для таблицы''' - Иконка соответствующая генерируемому таску в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
*'''текст для etasktemplate''' - будет в поле name etasktemplate. Это название задачи на прохождение локации, которая генерируется автоматически и использует шаблон etasktemplate. Текст используется из Текстовой Базы Ресурсов. Например, "Исследовать локацию".
*'''номер кнопки для etasktemplate''' - номер кнопки для etasktemplate. [[Button|Кнопка]], которая используется для данной задачи. Например, "Исследовать".

<pre>
Если перед генерацией случайного таска на исследование локации указать параметру gen_loc значение от 0 до n, то ближайшая генерируемая задача будет для конкретной локации под указанным номером. После генерации параметр gen_loc становится -1.
</pre>

<pre>
Если перед генерацией случайного таска от персонажа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
Если указать gen_face="-2", то таскорганайзер попытается с генерировать задачу с персонажем так, чтобы номер локации совпадал с персонажем, при условии что номер локации будет меньше максимальному числу персонажей ( char_num).
</pre>

=== Группа угадаечные задачи ===

В этой группе указываем диапазоны для генерации тасков-викторин и способ генерации.

*'''стандартная генерация''':
::'''нет''' - особая генерация задач, при которой с начало генерируем задачи из _очереди 1_, потом задачи из _очереди 2_ ( Если в первой очереди мы не можем сгенерировать задачу, пытаемся сгенерировать из второй очереди). Если мы не сгенерировали задачу из обоих очередей, то мы обнуляем все таски из обоих очередей ( и сразу генерим из _очереди 1_ задачу);
::'''да''' - стандартная генерация одной угадайки ( начинаем сверху вниз генерить;
*'''очередь 1''' - Основная очередь, пытаемся из неё сгенерировать задачу, при получении Taskorganizer сост. _generate_guess_, если в предыдущем поле стоит '''нет'''. Каждая задача из этой очереди имеет условия для появления ( прохождение сюжетного таска к примеру);
*'''очередь 2''' - Очередь затычка, задачи из этой очереди без условий. Предназначена когда в первой очереди нету доступных тасков для генерации;

<pre>
У таскорганайзера есть поле disabled, если при каждом запуске приложения после конца туториала писать туда 1 - это приведет к удалению старого сейва и несозданию нового. Несколько килобайт выгоды в опциях + использовать только для туториального таскорганайзера, когда он отработает.
</pre>

=Taskorganizer setup=
[[Файл:Task_2.jpg|600px|thumb|right]]

*'''id''' - Идентификатор задания. Используется в других заданиях. По общей концепции - строковый айди. Перетаскивается из текстовой базы.
'''Для каждого задания(записи в logbook) должен быть свой уникальный id.'''
*'''хинт''' - Список строк-подсказок для задачи. Перетаскиваются из текстовой базы. Таким образом, добавив несколько записей из базы, увидим выпадающий список.
*'''название (объект)''' - Текстовый объект, в который мы сложим название задания. Описание подтягивается из текстовой базы из первого столбика (word) текстового id задания.
*'''машина''' - Объект, которому при активации задания будет вызвано состояние show, а при повторном открытии задания show_old.
*'''портрет''' - Объект, которому при активации задания будет устанорвлен графический ресурс рожи.
*'''таблица''' - Таблица куда будут помещены темплейты предметов данного задания.
*'''описание (объект)''' - Текстовый объект, в который мы сложим описание задания. Описание подтягивается из текстовой базы из второго столбика (sentence1) текстового id задания.
*'''награда (ресурс 1)''' - Счетчик отображающий награду в ресурсе 1 за выполнение задания.
*'''награда (ресурс 2)''' - Счетчик отображающий награду в ресурсе 2 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.
*'''приоритетная''' - чем больше число, тем выше в таблице тасков.
*'''умножать цену пропуска''' - нужно в случае, если мы хотим давать юзеру возможность моментально выполнить задачу за цену, которая зависит от количества нехватающих коллекционных предметов (цена пропуска*количество отсутствующих предметов).
*'''отображать выполненным в шаблонах''' - "да" - таск будет оставаться в таблице шаблонов после выполнения
*'''видимые кнопки''' - номера видимых кнопок в [[Etasktemplate#Дополнительные кнопки|Etasktemplate]] через запятую. Отображает кнопки, используемые для данной задачи.

'''Необходимое для логбука'''

*'''для журнала''' - 0 - задача предназначена для списка задач, 1 - задача предназначена для журнала.
*'''категория''' - Категория к которой относится задача/запись. Пока используется только задачами для логбука.

'''Критерии появления'''

*'''уровень''' - Минимальный уровень, при котором может появиться задание.
*'''аномалия''' - В какой-либо локации присутствует аномалия данного типа. -1 - не учитывать условие.
*'''локация''' - Локация для которой будем проверять мастерство. -1 - не учитывать условие.
*'''мастерство''' - Уровень мастерства, который должен быть достигнут в локиции. -1 - не учитывать условие.
*'''завершены до''' - Задания, которые должны быть завершены до появления этого.
*'''получены до''' - Задания, которые должны быть получены до появления этого.
*'''не завершены до''' - Задания, которые должны быть НЕ завершены до появления этого.
*'''объект до''' - Объект, который должен находиться в состоянии_до для появления задания.
*'''состояние до''' - Состояние объекта_до, в котором вызывается генерация задания.
*'''коллекционные''' - Коллекционные предметы, которые должны быть найдены для появления задания.
*'''вероятность нужного''' - Когда мы будем проходить локации, в которых есть предметы необходимые для задания - мы будем подменять вероятность из локации вот этой вероятностью. 0 - использовать дефолтную.

'''Критерии завершения'''

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

'''Награда'''

*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''репутация''' - репутация, даваемая за выполнение задания.
*'''штраф репутации''' - штраф репутации за провал таймерного задания. Должен быть отрицательным.
*'''перевести объект''' - При выполнении задания этот объект будет переведен в новое состояние.
*'''в состояние''' - Состояние для объекта из предыдущего поля.

==Подзадача предмет==
В опции суммарно будет записываться значение два параметра:

:'''iN''' - "item need" - необходимое количество предметов, по всем "подзадачам предмет";
:'''iH''' - "item have" - имеющееся количество предметов, по всем "подзадачам предмет";
:'''i0..i666''' - требующийся предмет, пишется для задач из коллекций;

*'''сгенерировать предмет''' - определить необходимый предмет из коллекции;
::'''нет''' - просто требовать предмет;
::'''да''' - сгенерировать предмет из доступных локаций (календарь);
::'''сегодня''' - с генерировать предмет из коллекции, для локации текущего дня (календарь);
::'''неделя''' - с генерировать предмет из коллекции, для локаций текущей недели (календарь);
*'''из коллекции''' - указать txtID коллекции из которой будут браться id предметов;

==Подзадача экспертиза==

*'''предмет''' - в поле предмет записываем id объекта, который нужен для проведения экспертизы. Предмет берем из текстовой базы ресурсов. Иконка предмета до начала и во время проведения экспертизы в icon1, иконка предмета после проведения экспертизы в icon2.
*'''время''' - изначальная длительность экспертизы в секундах.
*'''стоимость''' - стоимость экспертизы, используется res3.
*'''стоимость ускорения''' - стоимость ускорения экспертизы, используется res2.
*'''описание''' - описание подзадачи
*'''владелец''' - здесь используем число для указания типа экспертизы. Например, 1 - это экспертизы одного типа, 2 - это второй тип экспертиз
*'''уведомление''' - текстовый id для уведомления. Генерируется при старте. Имя уведомления записать в поле word, текст уведомления в sentence1, картинку уведомления в sentence2.

<pre>
Картинку для уведомления положить в конфиги, рядом с файлом platform.icf для каждой платформы.
К примеру, путь может выглядеть так: C:\Editor\Projects\Crime_City\conf\base\project\platforms\google
</pre>

[[Файл:Taskorganizer_eanalysis.png|600px|thumb|right]]

==Задача cross promo==

У таска можно включить флаг:
*'''cross promo''' - идентификатор задачи типа ''cross promo'' (1 - да, 0 - нет)

в этом случае он
а) сгенерится, если есть кросс промо И выполнены остальные условия его появления;
б) выполнится, если установлено приложение И выполнине остальные условия его выполнения;
в) вызвав состояние '''cross_promo''' -открыть урл связанный с crosspromo задачей - таскорганайзеру можно открыть урл, которые приехал из конфига.
У задачи должно быть уникакльное окно, в котором в объект указанный в ''портрет'' будет помещен баннер.

==Изменить состояние объекта - новое задание==

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

==Изменить состояние объекта - таймаут==

Позволяет изменить состояние объекта если какая-то задача кончилась таймаутом, находится в taskorganizer setup. Создан для таймерных заданий, которые работают через [[Etasktemplate|Etasktemplate]]. Указываем '''эффект выполнения fail''' из [[Etasktemplate#Реализация таймерных тасков|Etasktemplate]]. Эффект используется, когда задание завершилось провалом по истечению времени.

=Состояния=

*'''show''' - При вызове этого состояния из таблицы с иконками заданий открывается соответствующая машина задания, прописанная в группе '''задание'''.
*'''check''' - При вызове проверяется выполнение текущих заданий(заданий добавленных в таблицу). Для того чтобы таскорганайзер добавил таски в таблицу после загрузки приложения ему нужно передать refresh.
*'''generate''' - При вызове подбирается подходящее задание в зависимости от прогресса игрока.
*'''generate_plot''' - При вызове генерится задача с персонажем ( поле генерируемые с персонажами), если перед этим передать в поле gen_face номер персонажа, то сгенерируем с указанным персонажем, после параметр обнулится ( значение -1 ). Перед вызовом данного состояния, '''обязательнo''' в поле _param_ вбить "1".
*'''log_check''' - При вызове состояния проверяется доступны ли новые записи в логбук.
*'''log_show''' - Заполняет таблицу логбука записями с текущим фильтром.
*'''refresh''' - Удаляет иконку выполненного задания из таблицы. Лучше всего вызывать после Check.
*'''cancel''' - Удаляет задание без награды, которое указано как ID в параметре param таскорганайзера, т.е. объекту Taskorganizer в param указываем ID таска (например 1933 - берется из options.xml или текстовой базы), а потом вызываем состояние cancel.
*'''add_hint''' - Добавляет в таблицу хинтов следующий текстовый ID из поля хинты текущего таска. Если все хинты показаны, то в опции записывается параметр haveHints=0.
*'''task_prev''' - Используется, если открыта машина-шаблон текущего задания. В этом состоянии показывается предыдущее по списку таблицы задание.
*'''task_next''' - Показывает следующее по списку таблицы задание.
<pre>
Состояния task_prev и task_next работают циклически, после первой задачи показывают последнюю и наоборот.
</pre>
*'''show_id''' - Показать окно задачи, взяв ее id из параметра.
*'''show_complete_id''' - показать окно после задачи, взяв ее id из param (делалось для одноразовых задач, повторяемые могут не работать);
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''skip_id_no_effect''' - изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.
*'''add_hint_hidden''' - Вызов подсказки для 1 (первой по списку в таскорганайзере) скрытой задачи.
*'''add_hint_hidden_all''' - Вызов подсказки для всех активных скрытых задач (по списку в таскорганайзере).
*'''calc_active_preset''' - Посчитать количество активных задач по конкретному "preset" (перед вызовом в поле "param" указать номер интересующей категории preset). После вызова, таскорганайзер заполнит параметр "preset_tasks".

Состояния для работы с тасками-угадайками по типу викторины ( в taskorganizer_setup - тип = "угадайка"):
*'''answer''' - ответить на открытую угадайку ( в поле '''param''' должно находиться число, номер нажатой кнопки от 0 до 3 ). Вешаем на кнопки варианты-ответа ( пишем param = 0 - 3 , после передаёт _answer_);
*'''generate_guess''' - сгенерировать угадайку-викторину ( выберет доступные задачи из диапазона указанном в очередях ( 1 и 2) поле _угадаечные задачи_ taskorganizer). При открытии угадайки, в поле _cur_guess_answer_ объекта Taskorganizer записывается номер кнопки где лежит правильный ответ ( от 0 до 3 );

ПРИМЕЧАНИЕ: при проверке задач для логбука для последней выполненной будет перезаписано поле filter автоматически.

При кажом refresh таскорганайзер заполняет у себя поля:
*'''tasks_in_table''' - задач в таблице
*'''tasks_total''' - задач в таблице + скрытых задач

Изменение состояния объекта в логе выводится как:
I/GTaskOrganizer GTaskOrganizer::state() state from 0 to 5 through object eco_checker (2543);

<pre>
Состояния из кода:
0 "idle", // Состояние по умолчанию
1 "refresh", // Обновить таблицу с иконками задач
2 "refresh_templates", // Обновить "ленту" задач
3 "generate", // Сгенерировать новую задачу (выбрать одну из доступных по условиям) И обновить таблицу с иконками задач
4 "show", // Показать окно задачи в зависимости от выделенной ячейки в таблице
5 "check", // Проверить задачи на выполнение. После этого автоматически вызовется рефреш
6 "log_check", // Проверить, не стали ли доступны новые записи в логе
7 "log_show", // Заполнить таблицу логбука записями с текущим фильтром
8 "task_next", // Следующий таск в таблице
9 "task_prev", // Предыдущий таск в таблице
10 "add_hint", // Добавить подсказку
11 "task_reward", // Вручить награду за задание - нужно, чтобы разделить выполнение задания и окно получения уровня
12 "show_id", // Показать окно задачи, взяв ее id из параметра
13 "guess", // Ответить на текущую угадайку, взяв ответ из параметра
14 "add_hint_last", // Добавить подсказку последней добавленной задаче
15 "add_hint_top", // Добавить подсказку верхней задаче в таблице
16 "guess_who_reward", // Начислить награду за последнюю угадайку
17 "roulette_complete", // состояние, вызываемое при выполнении текущей задачи "рулетка"
18 "cheat_complete", // читерское завершение задачи
19 "generate_plot", // сгенерировать новых "сюжетных задач"
20 "eraser_start", // принудительно стартовать стирачку
21 "eraser_complete", // вручить награду за нее
22 "cancel", // отменить задание из param
23 "guess_year", // попытаться угадать год (param)
24 "guess_year_reward", // Дать награду за угадывание года
25 "show_last_plot", // Открыть последнюю сгенерированную сюжетную задачу
26 "skip", // Пропустить задачу для которой открыто окно за кристаллы
27 "add_hint_id", // Добавить хинт задаче по id, если она активна
28 "add_hint_hidden", // Добавить хинт первой скрытой задаче
29 "add_hint_hidden_all", // Добавить хинт всем скрытым задачам
30 "time_to_activate", // Пришло событие об активации задачи
31 "time_to_timeout", // Пришло событие о таймауте задачи
32 "check_multiple", // Проверить выполнение задач не выходя из проверки после первой найденной
33 "answer", // Ответить на новую (январь 2015) угадайку. Номер кнопки в param
34 "generate_guess", // Сгенерировать новую угадайку
35 "show_random", // Показать окно случайной активной задачи
36 "show_eraser", // Показать окно стирачки
37 "calc_active_preset", // Посчитать активные задачи по заданному пресету
38 "show_case", // Найти активный кейс и заполнить его поля
39 "scroll_to_task", // Промотать на таск из param таблицу
40 "reactivate", // Повторно активировать таск из param
41 "generate_loc", // Сгенерировать генерируемых (извиняюсь) тасков, количество в param
42 "copy", // Скопировать общие данные в другой таскорганайзер
43 "cross_promo", // Открыть урл связанный с crosspromo задачей
44 "show_complete_id", // Показать окно после задачи независимо от ее состояния, взяв ее id из параметра
45 "skip_id_no_effect", // Изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
46 "clear_shown_templates" // Убрать выполненные таски для которых показан эффект из таблицы шаблонов
</pre>

=Запись в опции=

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

"tasks(id таскорганайзера в проекте).t(id текстового объекта - идентификатора задания).s".

Возможные значения:
* '''0''' - таск не активен (не добавлен путем вызова generate таскорганайзеру);
* '''1''' - таск сгенерирован ;
* '''2''' - таск прочитан (вызвано состояние show);
* '''3''' - таск выполнен;
* '''4''' - отложенное состояние таска (условия появления выполнены, но время его появления еще не прийшло);
* '''5''' - таск выполнен, но награда ещё не забиралась ( таск будет оставаться в таблице, если таски не выполняются автоматически);
* '''7''' - таск выполнен, награда получена, таск остался в таблице;

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры:=
Каждая таскорганайзер пишет в пользователя следующие параметры:
*'''public.TaskOrganizerCompletedTasks''' - количество выполненных одноразовых задач;
*'''public.TaskOrganizerCompletedTasksAll''' - количество выполненных задач с учётом повторяемых;

=Механизм многоуровневых достижений=
С помощью таскорганайзера можно организовать систему многоуровневых достижений. Для этого используется [[Etasktemplate|темплейт задачи]]. Данные темплейты складываются в таблицу темплейтов таскорганайзера. При этом в самом таскорганайзере должна быть указанна таблица для иконок задач, хоть она и не используется (желательно вынести за границы экрана).

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

Часть контента для достижения задается чрез текстовый объект - id таска. В текстовом объекте указываем название (word), описание невыполненной (sentence1) и выполненной (sentence2) ачивки. А также ресурс иконки ачивки (ico1), ресурс звезд для невыполненной (ico2) и выполененной (ico3) задачи.
Награду за достижения ачивки указываем как награду за выполнение таска. Также с помощью обработчика завершения задачи можем запустить анимацию получения ачивки.

Для заполнения таблицы темплейтов нужно вызвать состояние '''refresh_templates''', при вызове '''check''' задача, условия которой были выполнены изменит свое состояние, при этом будут переключены ресурсы звезд, описание ачивки и спрятана кнопка темплейта '''btn'''.

Для контроля того, какая задача будет вызвана при вызове '''check''' можно использовать следующий способ. К задаче добавляем еще одну подзадачу на опции. Когда прогресс по первой подзадаче на опции будет >= требуемого значения для задачи будет отображаться кнопка темплейта '''btn'''. При нажатии на эту кнопку, которая должна вызывать '''take''' темплейту задачи, в него пишется параметр clicked_task_id, по этому параметру определяем у какой задачи нужно выполнить вторую подзадачу на опции и вызываем '''check''' таскорганайзеру.

Пример
S:\!MOBILE\!!!EditorGames\Wiki_sample

Complex_achievements.zip

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

=Равномерная экономика (Preset)=
[[Файл:1499422858929.jpg|300px|thumb|right]]
Работает, при включении в объекте Economic равномерной экономики (задание не нулевых значений).
Настройка позволяет давать диапазонную награду конкретной группе задач("preset").
Настройка награды для всех задач, у которых не указан параметр "preset" (т.е. =="-1"), осуществляется, группой параметров объекта Taskorganizer:

Настройки конкретного preset вынесены в отдельную вкладку "Taskorganizer_setup":
[[Файл:Photo hidden 365 Scene Editor build Wed Jul 5 151607 2017 -(single-user) DProjectsEDITOR Game Hidden 365Photo hidden 365Photo hidden 365.seproj.jpg|600px|right]]
[[Category:Economics]]

Taskorganizer

2018-05-15T11:08:29Z

Vgolob: /* Taskorganizer setup */

{{TOC right}}
[[Object|Объект]] Taskorganizer - Менеджер задач и квестов

=Свойства=
[[Файл:Task.jpg|250px|thumb|right]]
[[Файл:Task_1.jpg|250px|thumb|right]]
=== Общие параметры ===
*'''economics''' - Объект типа экономикс.
*'''предметы''' - Объект типа eitems.
*'''таблица''' - Таблица куда будут помещены иконки заданий. При тапе на таблицу объекту Taskorganizer вызывается состояние show. Иконки подтягиваются из текстовой базы (icon1).
*'''добавлять иконки''' - 1 - добавлять в таблицу иконки, 0 - тексты из текстового id (поле word).
*'''шаблон предмета''' - Объект типа etaskitem будет использоваться при показе превью задания.
*'''фильтрация''' - Категория, которые должны будут отобразиться в таблице логов при вызове состояния logbook. Пустая строка - все.
*'''таблица логов''' - Таблица куда будут помещены записи логбука.
*'''новая запись''' - Объект, которому будет вызвано состояние show при добавлении новой записи в логбук.
*'''новое задание''' - Графический ресурс, который будет отмечать новые задания. Смещение должно достигаться пивотом.
*'''прочитанное задание''' - Графический ресурс, который будет отмечать прочитанные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе).
*'''выполненное задание''' - Графический ресурс, который будет отмечать выполненные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе)
*'''уведомление''' - Текстовый айди заголовка связанных с задачами уведомлений (Должно быть заполнено поле sense 4 - т.к. рандомно его будет постить).
*'''вероятность уведомления''' - Подменная вероятность нахождения предмета нужного для задания по уведомлению с которого мы пришли. 0 - использовать значение по умолчанию.
*'''выполнять непрочитанные''' - 1 - выполнять непрочитанные таски, 0 - нет.
*'''хронологический порядок''' - 1 - записывать задачи в хронологическом порядке, 0 - нет.
*'''картинки в логбук''' - Расположение картинки до или после текста.
*'''сдвиг уровней''' - число на которое сдвинутся требования к уровню игрока в taskorganizer_setup для каждой задачи;
*'''refresh при показе окна''' - 0 - нет, 1 - да. Ставим = 0 ( "нет" ), если хотим чтобы при тапе по таблице отложить сортировку и обновление статуса таска ( в определённый момент ( к примеру, когда открылось окно таска), передаём состояние '''refresh''' и таблица обновится).
*'''использовать накопление ошибки''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы нахождение предметов в хиддене, по таску не превышало n-раз ( к примеру p= 0.5 (1/0.5=2 , т.е. предмет должны найти не более чем за две игры в хидн), если количество сыгранных игр >= максимальному по вероятности, то предмет попадает в таблицу ( мы его нашли)). Если стоит - 0 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.
*'''etasktemplate''' - объект типа [[Etasktemplate|etasktemplate]]
*'''только одна подкрутка за раз''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы за один проход хиддена выполнялся один таск.
*'''таблица для шаблонов''' - таблица, в которую сложим шаблоны из предыдущего поля
*'''помещать генерируемые в шаблоны''' - помещать в шаблоны генерируемые таски
*'''уменьшать предметы при сдаче коллекции''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), то при сдаче коллекции будет выполнен декремент количества предметов необходимых чтобы задание выполнилось ( параметр таски s0 в опциях).

<pre>
Для огранизации логбука необходимо текст поместить в sentenсe 1. Картинка, что будет отображаться с этим текстом, должна быть icon 2. Также есть возможность использовать эту картинку в качестве фона. Тогда текст, который будет отображаться поверх этой картинки, нужно разместить в sentenсe 2.
</pre>

=== Группа угадайка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать угадайку.
*'''с уровня''' - Угадайка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''иконка''' - Объект, в который сложим иконку предмета.
*'''иконка для таблицы''' - Иконка соответствующая угадайке в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
=== Группа рулетка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать рулетку.
*'''с уровня''' - Рулетка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show.
*'''иконка для таблицы''' - Иконка соответствующая рулетке в таблице задач.
=== Группа генерируемые ===

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

*'''активных задач''' - Эти задачи будут генерироваться, когда активных задач столько или меньше.
*'''с уровня''' - Эти задачи будут генерироваться только начиная с данного уровня.
*'''максимально''' - Будет сгенерированно случайное количество задач от 1 до n.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''название''' - Текстовый объект, в который будет сложено название локации.
*'''превью''' - Объект, в который сложим превью локации для генерируемой задачи.
*'''иконка для таблицы''' - Иконка соответствующая генерируемому таску в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
*'''текст для etasktemplate''' - будет в поле name etasktemplate. Это название задачи на прохождение локации, которая генерируется автоматически и использует шаблон etasktemplate. Текст используется из Текстовой Базы Ресурсов. Например, "Исследовать локацию".
*'''номер кнопки для etasktemplate''' - номер кнопки для etasktemplate. [[Button|Кнопка]], которая используется для данной задачи. Например, "Исследовать".

<pre>
Если перед генерацией случайного таска на исследование локации указать параметру gen_loc значение от 0 до n, то ближайшая генерируемая задача будет для конкретной локации под указанным номером. После генерации параметр gen_loc становится -1.
</pre>

<pre>
Если перед генерацией случайного таска от персонажа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
Если указать gen_face="-2", то таскорганайзер попытается с генерировать задачу с персонажем так, чтобы номер локации совпадал с персонажем, при условии что номер локации будет меньше максимальному числу персонажей ( char_num).
</pre>

=== Группа угадаечные задачи ===

В этой группе указываем диапазоны для генерации тасков-викторин и способ генерации.

*'''стандартная генерация''':
::'''нет''' - особая генерация задач, при которой с начало генерируем задачи из _очереди 1_, потом задачи из _очереди 2_ ( Если в первой очереди мы не можем сгенерировать задачу, пытаемся сгенерировать из второй очереди). Если мы не сгенерировали задачу из обоих очередей, то мы обнуляем все таски из обоих очередей ( и сразу генерим из _очереди 1_ задачу);
::'''да''' - стандартная генерация одной угадайки ( начинаем сверху вниз генерить;
*'''очередь 1''' - Основная очередь, пытаемся из неё сгенерировать задачу, при получении Taskorganizer сост. _generate_guess_, если в предыдущем поле стоит '''нет'''. Каждая задача из этой очереди имеет условия для появления ( прохождение сюжетного таска к примеру);
*'''очередь 2''' - Очередь затычка, задачи из этой очереди без условий. Предназначена когда в первой очереди нету доступных тасков для генерации;

<pre>
У таскорганайзера есть поле disabled, если при каждом запуске приложения после конца туториала писать туда 1 - это приведет к удалению старого сейва и несозданию нового. Несколько килобайт выгоды в опциях + использовать только для туториального таскорганайзера, когда он отработает.
</pre>

=Taskorganizer setup=
[[Файл:Task_2.jpg|600px|thumb|right]]

*'''id''' - Идентификатор задания. Используется в других заданиях. По общей концепции - строковый айди. Перетаскивается из текстовой базы.
'''Для каждого задания(записи в logbook) должен быть свой уникальный id.'''
*'''хинт''' - Список строк-подсказок для задачи. Перетаскиваются из текстовой базы. Таким образом, добавив несколько записей из базы, увидим выпадающий список.
*'''название (объект)''' - Текстовый объект, в который мы сложим название задания. Описание подтягивается из текстовой базы из первого столбика (word) текстового id задания.
*'''машина''' - Объект, которому при активации задания будет вызвано состояние show, а при повторном открытии задания show_old.
*'''портрет''' - Объект, которому при активации задания будет устанорвлен графический ресурс рожи.
*'''таблица''' - Таблица куда будут помещены темплейты предметов данного задания.
*'''описание (объект)''' - Текстовый объект, в который мы сложим описание задания. Описание подтягивается из текстовой базы из второго столбика (sentence1) текстового id задания.
*'''награда (ресурс 1)''' - Счетчик отображающий награду в ресурсе 1 за выполнение задания.
*'''награда (ресурс 2)''' - Счетчик отображающий награду в ресурсе 2 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.
*'''умножать цену пропуска''' - нужно в случае, если мы хотим давать юзеру возможность моментально выполнить задачу за цену, которая зависит от количества нехватающих коллекционных предметов (цена пропуска*количество отсутствующих предметов).
*'''отображать выполненным в шаблонах''' - "да" - таск будет оставаться в таблице шаблонов после выполнения
*'''видимые кнопки''' - номера видимых кнопок в [[Etasktemplate#Дополнительные кнопки|Etasktemplate]] через запятую. Отображает кнопки, используемые для данной задачи.

'''Необходимое для логбука'''

*'''для журнала''' - 0 - задача предназначена для списка задач, 1 - задача предназначена для журнала.
*'''категория''' - Категория к которой относится задача/запись. Пока используется только задачами для логбука.

'''Критерии появления'''

*'''уровень''' - Минимальный уровень, при котором может появиться задание.
*'''аномалия''' - В какой-либо локации присутствует аномалия данного типа. -1 - не учитывать условие.
*'''локация''' - Локация для которой будем проверять мастерство. -1 - не учитывать условие.
*'''мастерство''' - Уровень мастерства, который должен быть достигнут в локиции. -1 - не учитывать условие.
*'''завершены до''' - Задания, которые должны быть завершены до появления этого.
*'''получены до''' - Задания, которые должны быть получены до появления этого.
*'''не завершены до''' - Задания, которые должны быть НЕ завершены до появления этого.
*'''объект до''' - Объект, который должен находиться в состоянии_до для появления задания.
*'''состояние до''' - Состояние объекта_до, в котором вызывается генерация задания.
*'''коллекционные''' - Коллекционные предметы, которые должны быть найдены для появления задания.
*'''вероятность нужного''' - Когда мы будем проходить локации, в которых есть предметы необходимые для задания - мы будем подменять вероятность из локации вот этой вероятностью. 0 - использовать дефолтную.

'''Критерии завершения'''

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

'''Награда'''

*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''репутация''' - репутация, даваемая за выполнение задания.
*'''штраф репутации''' - штраф репутации за провал таймерного задания. Должен быть отрицательным.
*'''перевести объект''' - При выполнении задания этот объект будет переведен в новое состояние.
*'''в состояние''' - Состояние для объекта из предыдущего поля.

==Подзадача предмет==
В опции суммарно будет записываться значение два параметра:

:'''iN''' - "item need" - необходимое количество предметов, по всем "подзадачам предмет";
:'''iH''' - "item have" - имеющееся количество предметов, по всем "подзадачам предмет";
:'''i0..i666''' - требующийся предмет, пишется для задач из коллекций;

*'''сгенерировать предмет''' - определить необходимый предмет из коллекции;
::'''нет''' - просто требовать предмет;
::'''да''' - сгенерировать предмет из доступных локаций (календарь);
::'''сегодня''' - с генерировать предмет из коллекции, для локации текущего дня (календарь);
::'''неделя''' - с генерировать предмет из коллекции, для локаций текущей недели (календарь);
*'''из коллекции''' - указать txtID коллекции из которой будут браться id предметов;

==Подзадача экспертиза==

*'''предмет''' - в поле предмет записываем id объекта, который нужен для проведения экспертизы. Предмет берем из текстовой базы ресурсов. Иконка предмета до начала и во время проведения экспертизы в icon1, иконка предмета после проведения экспертизы в icon2.
*'''время''' - изначальная длительность экспертизы в секундах.
*'''стоимость''' - стоимость экспертизы, используется res3.
*'''стоимость ускорения''' - стоимость ускорения экспертизы, используется res2.
*'''описание''' - описание подзадачи
*'''владелец''' - здесь используем число для указания типа экспертизы. Например, 1 - это экспертизы одного типа, 2 - это второй тип экспертиз
*'''уведомление''' - текстовый id для уведомления. Генерируется при старте. Имя уведомления записать в поле word, текст уведомления в sentence1, картинку уведомления в sentence2.

<pre>
Картинку для уведомления положить в конфиги, рядом с файлом platform.icf для каждой платформы.
К примеру, путь может выглядеть так: C:\Editor\Projects\Crime_City\conf\base\project\platforms\google
</pre>

[[Файл:Taskorganizer_eanalysis.png|600px|thumb|right]]

==Задача cross promo==

У таска можно включить флаг:
*'''cross promo''' - идентификатор задачи типа ''cross promo'' (1 - да, 0 - нет)

в этом случае он
а) сгенерится, если есть кросс промо И выполнены остальные условия его появления;
б) выполнится, если установлено приложение И выполнине остальные условия его выполнения;
в) вызвав состояние '''cross_promo''' -открыть урл связанный с crosspromo задачей - таскорганайзеру можно открыть урл, которые приехал из конфига.
У задачи должно быть уникакльное окно, в котором в объект указанный в ''портрет'' будет помещен баннер.

==Изменить состояние объекта - новое задание==

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

==Изменить состояние объекта - таймаут==

Позволяет изменить состояние объекта если какая-то задача кончилась таймаутом, находится в taskorganizer setup. Создан для таймерных заданий, которые работают через [[Etasktemplate|Etasktemplate]]. Указываем '''эффект выполнения fail''' из [[Etasktemplate#Реализация таймерных тасков|Etasktemplate]]. Эффект используется, когда задание завершилось провалом по истечению времени.

=Состояния=

*'''show''' - При вызове этого состояния из таблицы с иконками заданий открывается соответствующая машина задания, прописанная в группе '''задание'''.
*'''check''' - При вызове проверяется выполнение текущих заданий(заданий добавленных в таблицу). Для того чтобы таскорганайзер добавил таски в таблицу после загрузки приложения ему нужно передать refresh.
*'''generate''' - При вызове подбирается подходящее задание в зависимости от прогресса игрока.
*'''generate_plot''' - При вызове генерится задача с персонажем ( поле генерируемые с персонажами), если перед этим передать в поле gen_face номер персонажа, то сгенерируем с указанным персонажем, после параметр обнулится ( значение -1 ). Перед вызовом данного состояния, '''обязательнo''' в поле _param_ вбить "1".
*'''log_check''' - При вызове состояния проверяется доступны ли новые записи в логбук.
*'''log_show''' - Заполняет таблицу логбука записями с текущим фильтром.
*'''refresh''' - Удаляет иконку выполненного задания из таблицы. Лучше всего вызывать после Check.
*'''cancel''' - Удаляет задание без награды, которое указано как ID в параметре param таскорганайзера, т.е. объекту Taskorganizer в param указываем ID таска (например 1933 - берется из options.xml или текстовой базы), а потом вызываем состояние cancel.
*'''add_hint''' - Добавляет в таблицу хинтов следующий текстовый ID из поля хинты текущего таска. Если все хинты показаны, то в опции записывается параметр haveHints=0.
*'''task_prev''' - Используется, если открыта машина-шаблон текущего задания. В этом состоянии показывается предыдущее по списку таблицы задание.
*'''task_next''' - Показывает следующее по списку таблицы задание.
<pre>
Состояния task_prev и task_next работают циклически, после первой задачи показывают последнюю и наоборот.
</pre>
*'''show_id''' - Показать окно задачи, взяв ее id из параметра.
*'''show_complete_id''' - показать окно после задачи, взяв ее id из param (делалось для одноразовых задач, повторяемые могут не работать);
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''skip_id_no_effect''' - изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.
*'''add_hint_hidden''' - Вызов подсказки для 1 (первой по списку в таскорганайзере) скрытой задачи.
*'''add_hint_hidden_all''' - Вызов подсказки для всех активных скрытых задач (по списку в таскорганайзере).
*'''calc_active_preset''' - Посчитать количество активных задач по конкретному "preset" (перед вызовом в поле "param" указать номер интересующей категории preset). После вызова, таскорганайзер заполнит параметр "preset_tasks".

Состояния для работы с тасками-угадайками по типу викторины ( в taskorganizer_setup - тип = "угадайка"):
*'''answer''' - ответить на открытую угадайку ( в поле '''param''' должно находиться число, номер нажатой кнопки от 0 до 3 ). Вешаем на кнопки варианты-ответа ( пишем param = 0 - 3 , после передаёт _answer_);
*'''generate_guess''' - сгенерировать угадайку-викторину ( выберет доступные задачи из диапазона указанном в очередях ( 1 и 2) поле _угадаечные задачи_ taskorganizer). При открытии угадайки, в поле _cur_guess_answer_ объекта Taskorganizer записывается номер кнопки где лежит правильный ответ ( от 0 до 3 );

ПРИМЕЧАНИЕ: при проверке задач для логбука для последней выполненной будет перезаписано поле filter автоматически.

При кажом refresh таскорганайзер заполняет у себя поля:
*'''tasks_in_table''' - задач в таблице
*'''tasks_total''' - задач в таблице + скрытых задач

Изменение состояния объекта в логе выводится как:
I/GTaskOrganizer GTaskOrganizer::state() state from 0 to 5 through object eco_checker (2543);

<pre>
Состояния из кода:
0 "idle", // Состояние по умолчанию
1 "refresh", // Обновить таблицу с иконками задач
2 "refresh_templates", // Обновить "ленту" задач
3 "generate", // Сгенерировать новую задачу (выбрать одну из доступных по условиям) И обновить таблицу с иконками задач
4 "show", // Показать окно задачи в зависимости от выделенной ячейки в таблице
5 "check", // Проверить задачи на выполнение. После этого автоматически вызовется рефреш
6 "log_check", // Проверить, не стали ли доступны новые записи в логе
7 "log_show", // Заполнить таблицу логбука записями с текущим фильтром
8 "task_next", // Следующий таск в таблице
9 "task_prev", // Предыдущий таск в таблице
10 "add_hint", // Добавить подсказку
11 "task_reward", // Вручить награду за задание - нужно, чтобы разделить выполнение задания и окно получения уровня
12 "show_id", // Показать окно задачи, взяв ее id из параметра
13 "guess", // Ответить на текущую угадайку, взяв ответ из параметра
14 "add_hint_last", // Добавить подсказку последней добавленной задаче
15 "add_hint_top", // Добавить подсказку верхней задаче в таблице
16 "guess_who_reward", // Начислить награду за последнюю угадайку
17 "roulette_complete", // состояние, вызываемое при выполнении текущей задачи "рулетка"
18 "cheat_complete", // читерское завершение задачи
19 "generate_plot", // сгенерировать новых "сюжетных задач"
20 "eraser_start", // принудительно стартовать стирачку
21 "eraser_complete", // вручить награду за нее
22 "cancel", // отменить задание из param
23 "guess_year", // попытаться угадать год (param)
24 "guess_year_reward", // Дать награду за угадывание года
25 "show_last_plot", // Открыть последнюю сгенерированную сюжетную задачу
26 "skip", // Пропустить задачу для которой открыто окно за кристаллы
27 "add_hint_id", // Добавить хинт задаче по id, если она активна
28 "add_hint_hidden", // Добавить хинт первой скрытой задаче
29 "add_hint_hidden_all", // Добавить хинт всем скрытым задачам
30 "time_to_activate", // Пришло событие об активации задачи
31 "time_to_timeout", // Пришло событие о таймауте задачи
32 "check_multiple", // Проверить выполнение задач не выходя из проверки после первой найденной
33 "answer", // Ответить на новую (январь 2015) угадайку. Номер кнопки в param
34 "generate_guess", // Сгенерировать новую угадайку
35 "show_random", // Показать окно случайной активной задачи
36 "show_eraser", // Показать окно стирачки
37 "calc_active_preset", // Посчитать активные задачи по заданному пресету
38 "show_case", // Найти активный кейс и заполнить его поля
39 "scroll_to_task", // Промотать на таск из param таблицу
40 "reactivate", // Повторно активировать таск из param
41 "generate_loc", // Сгенерировать генерируемых (извиняюсь) тасков, количество в param
42 "copy", // Скопировать общие данные в другой таскорганайзер
43 "cross_promo", // Открыть урл связанный с crosspromo задачей
44 "show_complete_id", // Показать окно после задачи независимо от ее состояния, взяв ее id из параметра
45 "skip_id_no_effect", // Изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
46 "clear_shown_templates" // Убрать выполненные таски для которых показан эффект из таблицы шаблонов
</pre>

=Запись в опции=

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

"tasks(id таскорганайзера в проекте).t(id текстового объекта - идентификатора задания).s".

Возможные значения:
* '''0''' - таск не активен (не добавлен путем вызова generate таскорганайзеру);
* '''1''' - таск сгенерирован ;
* '''2''' - таск прочитан (вызвано состояние show);
* '''3''' - таск выполнен;
* '''4''' - отложенное состояние таска (условия появления выполнены, но время его появления еще не прийшло);
* '''5''' - таск выполнен, но награда ещё не забиралась ( таск будет оставаться в таблице, если таски не выполняются автоматически);
* '''7''' - таск выполнен, награда получена, таск остался в таблице;

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры:=
Каждая таскорганайзер пишет в пользователя следующие параметры:
*'''public.TaskOrganizerCompletedTasks''' - количество выполненных одноразовых задач;
*'''public.TaskOrganizerCompletedTasksAll''' - количество выполненных задач с учётом повторяемых;

=Механизм многоуровневых достижений=
С помощью таскорганайзера можно организовать систему многоуровневых достижений. Для этого используется [[Etasktemplate|темплейт задачи]]. Данные темплейты складываются в таблицу темплейтов таскорганайзера. При этом в самом таскорганайзере должна быть указанна таблица для иконок задач, хоть она и не используется (желательно вынести за границы экрана).

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

Часть контента для достижения задается чрез текстовый объект - id таска. В текстовом объекте указываем название (word), описание невыполненной (sentence1) и выполненной (sentence2) ачивки. А также ресурс иконки ачивки (ico1), ресурс звезд для невыполненной (ico2) и выполененной (ico3) задачи.
Награду за достижения ачивки указываем как награду за выполнение таска. Также с помощью обработчика завершения задачи можем запустить анимацию получения ачивки.

Для заполнения таблицы темплейтов нужно вызвать состояние '''refresh_templates''', при вызове '''check''' задача, условия которой были выполнены изменит свое состояние, при этом будут переключены ресурсы звезд, описание ачивки и спрятана кнопка темплейта '''btn'''.

Для контроля того, какая задача будет вызвана при вызове '''check''' можно использовать следующий способ. К задаче добавляем еще одну подзадачу на опции. Когда прогресс по первой подзадаче на опции будет >= требуемого значения для задачи будет отображаться кнопка темплейта '''btn'''. При нажатии на эту кнопку, которая должна вызывать '''take''' темплейту задачи, в него пишется параметр clicked_task_id, по этому параметру определяем у какой задачи нужно выполнить вторую подзадачу на опции и вызываем '''check''' таскорганайзеру.

Пример
S:\!MOBILE\!!!EditorGames\Wiki_sample

Complex_achievements.zip

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

=Равномерная экономика (Preset)=
[[Файл:1499422858929.jpg|300px|thumb|right]]
Работает, при включении в объекте Economic равномерной экономики (задание не нулевых значений).
Настройка позволяет давать диапазонную награду конкретной группе задач("preset").
Настройка награды для всех задач, у которых не указан параметр "preset" (т.е. =="-1"), осуществляется, группой параметров объекта Taskorganizer:

Настройки конкретного preset вынесены в отдельную вкладку "Taskorganizer_setup":
[[Файл:Photo hidden 365 Scene Editor build Wed Jul 5 151607 2017 -(single-user) DProjectsEDITOR Game Hidden 365Photo hidden 365Photo hidden 365.seproj.jpg|600px|right]]
[[Category:Economics]]

Leaderboardsitem

2018-05-10T14:46:56Z

Vgolob: /* Основные параметры */

Leaderboardsitem

2018-05-10T14:45:03Z

Vgolob: /* Основные параметры */

Шаблон для помещения в таблицу лидербордов.

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

*'''место''' - Счетчик, в который будет занесено место игрока
*'''имя''' - Текстовый объект куда будет занесено имя игрока
*'''objectId''' - Текстовый объект куда будет занесен objectId игрока
*'''иконка''' - Иконка игрока
*'''очки''' - Счетчик, в который будут занесены очки игрока
*'''уровень''' - Счетчик, в который будет занесен уровень игрока
*'''список желаний''' - объект-таблица, в который сложим желаемые предметы пользователей. Должна иметь 1 ряд
*'''кнопка invite''' - не используется, потому что уже не можем получить сведения с фб о неиграющих друзьях
*'''кнопка info'''
*'''кнопка подарить энергию'''
*'''кнопка подарить монеты'''
*'''кнопка подарить вип'''
*'''машина для играющих''' - машина должна иметь два состояния - player и invitable. Может менять в них внешний вид окна
*'''кнопка пригласить в друзья''' - кнопка для приглашения в игрока из глобальных лидербордов в абс-друзья. Передает клауду состояние “parse_friend_request_lb”. Эта кнопка видна только в глобальных лидербордах у игроков, которые не являются друзьями.
*'''кнопка удалить из друзей''' - кнопка удаления игрока из абс-друзей. Передает клауду состояние "parse_friend_delete_public". Автоматически появляется для всех игроков, которые являются abs-друзьями.
*'''кнопка play''' - кнопка play для Hidden Battle
*'''счетчики 1-7''' - Для заполнения значений счетчиков 1-7 нужно в опции записать желаемые параметры в поля public.lbtemplate.val(%d), где (%d) - номер счетчика, и вызвать cloud состояние parse_save.
*'''иконка соцсети''' - Иконка соцсети. Должна иметь ресурс с двумя кадрами: 0 - фейсбук, 1 - гугл
*'''иконка страны''' - Иконка флага. Попытаюсь взять айдишник ресурса для нее из public.flagRes
*'''иконка vip''' - Иконка vip. Попытаюсь взять айдишник ресурса для нее из public.vipRes
*'''счетчик приза res1'''
*'''счетчик приза res2'''
*'''иконка приза предмет'''
*'''счетчик приза предмет'''
*'''кнопка получения награды'''
*'''слушатель движения''' - слушатель движения ячейки. Должен иметь состояния moveStart и moveFinish
*'''placeholder друга''' - Картинка, которая будет использоваться вместо отсутствующих аватарок
*'''online''' - индикатор онлайна игрока, должен иметь состояния online и offline

Absolutist Framework

2018-05-10T12:40:02Z

Vgolob: /* Global score */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]
* [[Внешние утилиты]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[Отладка на флеше]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Kub.png]] - [[Statistic]] - объект для отправки событий статистики.
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс Bubble игр включая механику Снукер (Новый)
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Planet]] - игра "Планетки"
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Kub.png]] - [[AtomicPuzzle]] - механика игры Atomic puzzle
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
*** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
*** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
** [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
** [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры
*[[Файл:Kub.png]] - [[Leaderboardsitem]] - Шаблон для помещения в таблицу лидербордов.

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Cloud

2018-05-10T12:37:47Z

Vgolob: /* Обработчики для временных лидербордов (соревнований) */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа [[Leaderboardsitem]] для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон [[Leaderboardsitem]];
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок.

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа [[Leaderboardsitem]].

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Cloud

2018-05-10T12:37:21Z

Vgolob: /* Обработчики для лидербордов */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа [[Leaderboardsitem]] для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон [[Leaderboardsitem]];
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок.

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа leaderboardsitem.

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Cloud

2018-05-10T12:36:29Z

Vgolob: /* parse друзья и подарки */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа [[Leaderboardsitem]] для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон [[Leaderboardsitem]];
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок.

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа leaderboardsitem для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа leaderboardsitem.

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Cloud

2018-05-10T12:36:08Z

Vgolob: /* parse leaderboards */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа [[Leaderboardsitem]] для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон leaderbordsitem;
*'''шаблон''' - объект типа leaderboardsitem для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок.

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа leaderboardsitem для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа leaderboardsitem.

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Cloud

2018-05-10T12:35:38Z

Vgolob: /* parse leaderboards */

Объект необходим для синхронизации приложения с облаком.

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

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
*'''esocial''' - объект типа esocial для получения списка друзей.
*'''повторять лоад раз''' - количество повторов parse_load при неуспехе, если не отсутствие интернета.
*'''автолоад''' - автоматически вызывать parse_load при логине в социальной сети.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы
*'''всегда запрашивать''' - запрашивать лидерборды даже если есть кешированные данные (нет=0, да=1)
*'''дефолтное имя''' - если у нас все еще нет имени человека, вместо него будет эта строка
*'''специальная сортировка''' ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
*'''анимация смены мест''' - анимация смены мест игроком (нет=0, да=1)

*'''периодический лидерборд''' - Периодический лидерборд в parse
*'''(периодический) таблица''' - объект-таблица, в который сложим очки за текущий период. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) таблица предыдущая''' - объект-таблица, в который сложим очки предыдущего периода. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон"
*'''(периодический) шаблон''' - объект типа [[Leaderboardsitem]] для помещения в таблицу текущего лидерборда
*'''(периодический) шаблон предыдущий''' - объект типа leaderboardsitem для помещения в таблицу предыдущего лидерборда
*'''(периодический) свое место''' - каунтер в котором будет место игрока
*'''(периодический) свои очки''' - каунтер в котором будут очки игрока
*'''(периодический) своя иконка''' - иконка игрока
*'''(периодический) таймер''' - иконка игрока
*'''(периодический) запрашивать записей''' - сколько записей запросить из таблицы
*'''(периодический) анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)
*'''(периодический) в предыдущую таблицу только себя''' - в предыдущую таблицу только себя (нет=0, да=1)
*'''(периодический) таблица наград''' - объект-таблица, в который сложим шаблоны наград
*'''(периодический) шаблон награды''' - объект типа rewarditem

==parse голосовалка==

*'''таблица''' - объект-таблица, в который сложим ответы;
*'''шаблон''' - объект типа pollitem для помещения в таблицу;
*'''название''' - текстовый объект, куда мы сложим название опроса;
*'''таблица пред.''' - объект-таблица, в который сложим ответы;
*'''шаблон пред.''' - объект типа pollitem для помещения в таблицу;
*'''название пред.''' - текстовый объект, куда мы сложим название опроса;
*'''время''' - объект типа таймер, куда мы сложим оставшееся время опроса;
*'''текст шаринга''' - текст шаринга.

==parse друзья и подарки==

*'''таблица''' - объект-таблица, в который сложим шаблон leaderbordsitem;
*'''шаблон''' - объект типа leaderboardsitem для помещения в таблицу;
*'''добавить приглашаемых''' - "сколько приглашаемых друзей добавить к играющим друзьям;
*'''прятать одаренных''' - нет - в таблице все друзья; да - в таблице скрыты те, кому дарили подарок.

==parse запросы дружбы==

*'''текст запроса дружбы''' - Текстовый айди для исходящего запроса дружбы;
*'''окно''' - Само окно. Должно иметь состояние show;
*'''иконка''' - Портрет приглашающего;
*'''имя''' - Имя приглашающего;
*'''таблица инвайтов''' - таблица, в которую сложим все инвайты;
*'''шаблон инвайта (inviteitem)''' - Шаблон инвайта для помещения в таблицу.

==parse окно обгона в таблице лидеров==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==parse окно обгона для периодических лидербордов==

*'''кого leaderboardsitem''' - кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem
*'''машина''' - собственно машина окна (или просто обработчик обгона). Должна иметь состояния show_up и show_down, соответственно при обгоне вверх и вниз.

==Приглашение в мультиплеер==
*'''multiplayer''' - объект мультиплеера
*'''информация''' - информация о приглашающем, объект типа leaderboardsitem

==Боты для лидербордов==
*'''конфиг''' - файл с настройками ботов
*'''имена ботов в оффлайне''' - имена ботов, если они генерятся в оффлайне
*'''имена игрока в оффлайне''' - имя игрока в оффлайне

Файл конфига умеет создавать "economicalCycle" (пока только боты для локаций, ModeWorkEconomicalCycle="2" + указываем нужное количество ботов - "bot_loc=k_sc0=1.077#k_scMax=0.71#name=bot1").

=Добавляемые свойства=

==Обработчики для синхронизации==

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

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

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

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id'', показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

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

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id), показываем игроку окно с предложением синхронизироваться. В окне 2 кнопки: синхронизировать - ''parse_apply_server'', не синхронизировать - ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

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

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

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

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

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

==Обработчики голосования==

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

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

==Обработчики для лидербордов==

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

[[Файл:+.png]] '''невозможно загрузить лидерборды из-за objectId''' - обработчик неуспеха ''parse_leaderboards'', ''parse_leaderboards_friends'' и ''parse_leaderboards_friends_param'', которая происходит из-за неуспешного ''parse_load'' (в этом случае ''parse_load'' необходимо повторить)
*'''объект''' - объект, состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

[[Файл:+.png]] '''добавляемые лидерборды''' - дополнительная группа настроек визуализации лидербордов, используется для смены таблиц при вызове лидербордов по локациям, монстрам и т.д.
*'''id''' - Идентификатор набора интерфейсных элементов, указывать нужно '''default''' для таблицы, в которую помещаются общие лидеры, для остальных не нужно
*'''имя лидербордов''' - Имя лидербордов, соотв. конфигу. Будет применено, если строка не пустая. Это имя задается в param при вызове ''parse_leaderbords_friends_param''
*'''таблица''' - объект-таблица, в который сложим очки
*'''шаблон''' - объект типа leaderboardsitem для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''своя иконка''' - иконка игрока
*'''кого leaderboardsitem''' - кого leaderboardsitem" hint="кого leaderboardsitem
*'''кто leaderboardsitem''' - кто leaderboardsitem" hint="кто leaderboardsitem
*'''машина''' - собственно машина окна. Должна иметь состояние show
*'''анимация смены мест''' - Анимация смены мест игроком (нет=0, да=1)

==Обработчики для друзей и подарков==

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

[[Файл:+.png]] '''отправлен запрос дружбы''' - обработчик успеха ''parse_friend_request_lb'', ''parse_friend_request_public'', ''parse_friend_request_param'', показываем информационное окно
*'''объект''' - объект - состояние которого меняем,
*'''состояние''' - состояние - значение нового состояния.

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

==Обработчики для временных лидербордов (соревнований)==

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

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

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

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

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

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

[[Файл:+.png]] '''индикатор награды за временные лидерборды''' - визуализация награды за временные лидерборды
*'''res1''' - счетчик - награда за лидерство в res1,
*'''res2''' - счетчик - награда за лидерство в res2,
*'''item''' - иконка предмета - награды за лидерство,
*'''item num''' - счетчик предмета - награды за лидерство.

[[Файл:+.png]] '''лидеры предыдущего этапа временных лидербордов''' - визуализация лидеров предыдущего этапа временных лидербордов (пъедестал)
*'''leaderboardsitem''' - объект типа leaderboardsitem.

[[Файл:+.png]] '''периодические лидерборды''' - добавляемые периодические лидерборды используются для разделения игроков по группам в соответствии с уровнем опыта из экономики
*'''имя''' - Периодический лидерборд в parse (название таблицы)
*'''min''' - Минимальный уровень экономики
*'''max''' - Максимальный уровень экономики

==Общие обработчики==

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

==Обработчики для мультиплеера==

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

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

=Особенности использования=

Для пользователей, которые не логиняться в социальные сети и соответственно не сохраняют в игре свои имя и аватарку, существует система присвоения дефолтных имен и иконок. Это происходит при вызове ''parse_load''. В этом случае человек попадает в таблицы лидербордов (ранее игроки без имени и без иконки отфильтровывались).

=Состояния=

*'''0 - local_device_synchronization''' - синхронизация параметров между приложениями одного устройства;

*'''1 - parse_resolve''' - ресолвим конфликт и ждем подтверждения;

*'''2 - parse_idle''' - состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - parse_load''' - загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - parse_save''' - сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - parse_leaderboards''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - parse_leaderboards_friends''' - загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - parse_submit''' - заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - parse_apply''' - применить скачанные опции;

*'''9 - parse_get_public_lb''' - скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - parse_poll''' - получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - parse_poll_prev''' - получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - parse_vote''' - проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - parse_share_poll''' - зашарить результаты текущего опроса;

*'''14 - parse_forced_save''' - сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - parse_apply_server''' - применить опции и отправить ресолв;

*'''16 - parse_clear_notifications''' - отписаться от уведомлений;

*'''17 - parse_add_notification''' - добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - parse_time''' - запросить время;

*'''19 - parse_friends''' - заполнить таблицу всех друзей (новые подарки);

*'''20 - parse_isolate''' - отказаться от слияния аккаунтов;

*'''21 - parse_un_isolate''' - отменить изоляцию;

*'''22 - parse_cancel_apply''' - отменить синхронизацию и разрешить сейвы;

*'''23 - scroll_friends_to_lb''' - проскролить таблицу друзей на юзера кликнутого в таблице лидербордов;

*'''24 - '''номер зарезервирован

*'''25 - '''номер зарезервирован

*'''26 - '''номер зарезервирован

*'''27 - parse_flush_notifications''' - принудительно зафлушить нотификейшены, если мы этого не делали ранее;

*'''28 - parse_all_leaderboards''' - получение информации по всем лидербордам, возможное обнуление текущих очков.

*'''29 - parse_submit_temporary''' - сабмит очков в temporary лидерборд;

*'''30 - parse_leaderboards_temporary''' - получение таблицы temporary лидерборда;

*'''31 - parse_leaderboards_temporary_prev''' - получение таблицы результатов предыдущего периода в temporary лидерборде;

*'''32 - parse_leaderboards_claim''' - начисление награды по кнопке получения награды в шаблоне лидерборда за предыдущий период в temporary лидерборде;

*'''33 - parse_leaderboards_animation''' - старт анимации перемещения ячеек таблицы в temporary лидерборде;

*'''34 - parse_friend_request_param''' - приглашение дружить, в param указать object_id;

*'''35 - parse_friend_request_lb''' - приглашение дружить по кнопке пригласить в друзья из шаблона лидербордов;

*'''36 - parse_friend_confirm''' - подтверждение дружбы из окна ''parse запросы дружбы'';

*'''37 - parse_friend_cancel''' - отмена дружбы из окна ''parse запросы дружбы'';

*'''38 - parse_friend_confirm_table''' - подтверждение дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''39 - parse_friend_cancel_table''' - отмена дружбы из таблицы инвайтов ''parse запросы дружбы'';

*'''40 - parse_friend_request_public''' - запрос дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''41 - parse_friend_delete_public''' - запрос на отмену дружбы из окна Инфо (parse_get_public_lb), проверять параметр ''selected_public.cloud_is_friend'' у объекта cloud: 0 - я сам, 1 - не друг, 2 - друг (для показа-прятания кнопок);

*'''42 - parse_friend_check_requests''' - проверить входящие запросы (инвайты, подарки...);

*'''43 - parse_leaderboards_friends_param''' - показать лидерборд по друзьям, предварительно изменив контролы для отображения таблицы лидербордов и т.п.;

*'''44 - parse_get_public_fr''' - скопировать паблик данные кликнутого юзера из таблицы парсовых друзей из лидербордов в доступную область;

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

*'''46 - parse_bots_info''' - получить информацию о ботах отдельно от периодических лидербордов.

*'''47 - get_country''' - получить страну

*'''48 - parse_scroll_default_on_me''' - промотать таблицу default на меня

*'''49 - parse_info''' - получить инфо о пользователе взяв objectId из param

*'''50 - parse_invitable''' - заполнить таблицу приглашаемых друзей

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или станет в очередь или выполниться следующим тиком), state = 3 - это состояние в котором сейчас находиться объект.

==Коды ошибок:==

*'''6''' - опрос закончился;
*'''7''' - ошибка версионности;
*'''1000''' - отсутсвие интернета.
В прочих случаях код ошибки будет '''2000 + номер состояния''', т.е. для лоада, например ошибка будет 2000 + 3 = 2003

Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек):
'''4000 + номер состояния''', т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

[[Category:Options|*]]

Leaderboardsitem

2018-05-10T12:30:25Z

Vgolob: Новая страница: «Шаблон для помещения в таблицу лидербордов. ==Основные параметры== *'''место''' - Счетчик, в…»

Шаблон для помещения в таблицу лидербордов.

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

*'''место''' - Счетчик, в который будет занесено место игрока
*'''имя''' - Текстовый объект куда будет занесено имя игрока
*'''objectId''' - Текстовый объект куда будет занесен objectId игрока
*'''иконка''' - Иконка игрока
*'''очки''' - Счетчик, в который будут занесены очки игрока
*'''уровень''' - Счетчик, в который будет занесен уровень игрока
*'''список желаний''' - объект-таблица, в который сложим желаемые предметы пользователей. Должна иметь 1 ряд
*'''кнопка invite''' - не используется, потому что уже не можем получить сведения с фб о неиграющих друзьях
*'''кнопка info'''
*'''кнопка подарить энергию'''
*'''кнопка подарить монеты'''
*'''кнопка подарить вип'''
*'''машина для играющих''' - машина должна иметь два состояния - player и invitable. Может менять в них внешний вид окна
*'''кнопка пригласить в друзья''' - кнопка для приглашения в игрока из глобальных лидербордов в абс-друзья. Передает клауду состояние “parse_friend_request_lb”
*'''кнопка удалить из друзей''' - кнопка удаления игрока из абс-друзей. Передает клауду состояние "parse_friend_delete_public". Автоматически появляется для всех игроков, которые являются abs-друзьями.
*'''кнопка play''' - кнопка play для Hidden Battle
*'''счетчики 1-7''' - Для заполнения значений счетчиков 1-7 нужно в опции записать желаемые параметры в поля public.lbtemplate.val(%d), где (%d) - номер счетчика, и вызвать cloud состояние parse_save.
*'''иконка соцсети''' - Иконка соцсети. Должна иметь ресурс с двумя кадрами: 0 - фейсбук, 1 - гугл
*'''иконка страны''' - Иконка флага. Попытаюсь взять айдишник ресурса для нее из public.flagRes
*'''иконка vip''' - Иконка vip. Попытаюсь взять айдишник ресурса для нее из public.vipRes
*'''счетчик приза res1'''
*'''счетчик приза res2'''
*'''иконка приза предмет'''
*'''счетчик приза предмет'''
*'''кнопка получения награды'''
*'''слушатель движения''' - слушатель движения ячейки. Должен иметь состояния moveStart и moveFinish
*'''placeholder друга''' - Картинка, которая будет использоваться вместо отсутствующих аватарок
*'''online''' - индикатор онлайна игрока, должен иметь состояния online и offline

Eanalysis

2018-05-04T07:50:42Z

Vgolob: /* Уведомления */

{{TOC right}}
[[Object|Объект]] Eanalysis - предназначен для проведения экспертизы предмета по времени. Работа с объектом происходит с помощью создания задач на экспертизу предметов в [[Taskorganizer#Подзадача экспертиза|taskorganizer]].
Объект экспертизы сохраняет себя в [[Options|Options]] (везде первый %d - это id объекта экспертизы, второй - id предмета)
*'''eanalysis%d.i%d.c''' - 1 если экспертиза завершена
*'''eanalysis%d.i%d.t''' - если > 0 - экспертиза начата и, возможно завершена (см. предыдущий флаг)
[[Файл:Eanalysis_.png|400px|thumb|right]]
== Общие настройки ==

*'''taskorganizer''' - объект типа [[Taskorganizer|taskorganizer]]
*'''таблица''' - объект типа [[Table|таблица]], в который мы сложим шаблоны
=== Настройки экземпляра ===

*'''иконка''' - иконка предмета
*'''название''' - название предмета
*'''таймер''' - таймер
*'''стоимость''' - стоимость
*'''кнопка старт''' - кнопка старт
*'''кнопка ускорить''' - кнопка ускорить
*'''кнопка информации''' - кнопка информации
=== Эффекты ===

*'''эффект завершения''' - эффект завершения, будет запущен в ячейке, где закончилась экспертиза
*'''эффект готового''' - эффект готового, будет запущен в ячейке с завершенной экспертизой после refresh
=== Окошко предмета ===

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

*'''окно''' - само окно, должно иметь состояние show
*'''иконка''' - иконка предмета
*'''описание''' - описание предмета
=== Окошко завершения ===

Окошко вызывается в момент завершения экспертизы в ячейке.

*'''окно''' - само окно, должно иметь состояние show
*'''иконка''' - иконка предмета
*'''описание''' - описание предмета
=== Окошко предмета в процессе ===

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

*'''окно''' - само окно, должно иметь состояние show
*'''иконка''' - иконка предмета
*'''описание''' - описание предмета
*'''таймер''' - время до конца экспертизы
=== Окошко экспертиза не начата ===

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

*'''окно''' - само окно, должно иметь состояние show
*'''иконка''' - иконка предмета
*'''описание''' - описание предмета
=== Дополнительные параметры ===

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

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

'''Изменить состояние объекта''' - экспертиза закончена (при вызове проверочного состояния)
*'''объект''' - перевести объект в состояние из следующего поля
*'''состояние''' - новое состояние для объекта из предыдущего поля

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

*'''start''' - начать экспертизу
*'''boost''' - ускорить текущую экспертизу
*'''boost all''' - ускорить все экспертизы
*'''show''' - приводит к показу окошка для предмета из последней кликнутой ячейки в таблице экспертизы. Т.е. если show вызывается при клике на какую-то ячейку, то окошко будет для находящегося в ней предмета
*'''refresh''' - обновляет данные по экспертизам
*'''check''' - проверяется выполнение текущих экспертиз

== Типы улик ==

Есть возможность делать ячейки экспертиз разных типов. Для этого в [[Taskorganizer#Подзадача экспертиза|taskorganizer (подзадача экспертиза)]] заполнить поле "владелец" численным значением. Тип улик задавать в поле
<property name="владелец" id="owner" hint="Владелец предмета для угадайки. -1 - предмет не участвует" type="int" label="владелец" value="-1" colname="comp_cond_added"/>

Считать можно:
*из поля в опциях '''eanalysis%d.lastStartOwner''', где вместо %d - id объекта-экспертизы.
Информация в нем будет сохраняться независимо от прочих факторов.
*перед показом любого окна объект Eanalysis запишет себе (не в опции) '''currentOwner'''. Можно опираться и на это поле.

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

'''start_analysis''' - Параметр, который содержит информацию "есть ли сейчас доступные экспертизы для старта".

В поле количество не начатых (и при этом невыполненных, само собой) экспертиз.
Пишется в объект экспертизы.
Обновляется при refresh и любом сохранении данных.

== Уведомления ==

Можно отправлять уведомления игроку по завершению экспертизы. Уведомления шлются автоматически. Для этого используется поле в [[Taskorganizer#Подзадача экспертиза|taskorganizer (подзадача экспертиза)]]. Туда следует поместить текстовый id из текстовой базы.

'''Как найти уведомления в логах?'''
Например, уведомление, которое установлено в два часа дня с задержкой 15минут (900 секунд) выглядит так:
<pre>
19/01/18 13:59:47 00078341(2875268504:6804): I/GNotification state() state(ST_SET) getAccurateTime()/1000 = 1516363187 delay = 900
</pre>
Если уведомления отключены в настройках проекта, то строка примет вид:
<pre>
02-05 12:09:58.274 I/SDL/APP (11455): 05/02/18 12:09:58 00008978(2612762928:6508): I/GNotification state() state(ST_SET) - disabled
</pre>

== Статистика ==
При передаче состояния start отсылается ивент expert_start с параметрами:
*'''stat_time_min''' - сколько времени будет длиться экспертиза в мин
*'''stat_item_id''' - id исследуемого предмета
При окончании экспертизы отсылается ивент expert_end с параметрами:
*'''stat_time_min''' - сколько времени будет длиться экспертиза в мин
*'''stat_item_id''' - id исследуемого предмета
*'''stat_speed_up''' - 0- ускорили; 1- само закончилось
Недостающие параметры будут записаны в GData самого объекта экспертизы перед вызовом событий, оттуда их можно прочитать. Поэтому нужно, чтобы соответствующие события и параметры для них были заведены в объекте статистики.
"Имя объекта" для параметров этих событий - сам объект eanalysis.

== Другое ==

<pre>
Покупка ускорения всех экспертиз на некоторое время (например, 7 дней):
1) В экономику добавляем предмет eanalysis, и в нем указываем длительность действия в секундах (tm).
2) Покупка осуществляется через объект Store.
</pre>

Для примера использования представлено окно открытия экспертизы на отдельной сцене "экспертиза".
[[Файл:Wnd_expertise.png|600px|thumb|left]]

Edit

2018-05-04T06:42:45Z

Vgolob: /* Основные параметры */

{{TOC right}}[[Файл:Edit2.png|right]]
'''Edit''' - [[Object|объект]], который используется для ввода текста с клавиатуры.

Этот объект чаще всего используется для создания системы регистрации пользователей.

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

'''Шрифт'''
*'''имя''' (''fn'') - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).
*'''размер''' (''fs'') - Размер шрифта в пикселях.

'''Цвет текста'''
*'''норм.''' (''fc_n'') - Цвет текста без ошибок (черный по умолчанию)
*'''ошибка''' (''fc_err'') - Цвет текста с ошибкой (красный по умолчанию)

'''Фон текста'''
*'''res. норм.''' (''res_n'') - Графический ресурс для отображения фона текста, когда последний вводится корректно
*'''res. ошибка''' (''res_err'') - Графический ресурс для отображения фона текста, когда последний вводится с ошибками
*'''норм.''' (''bc_n'') - Цвет фона без ошибок (белый по умолчанию)
*'''ошибка.''' (''bc_e'') - Цвет фона с ошибками (белый по умолчанию)

'''Приветствие'''
*'''текстID''' (''txtID'') - Выводимый текст перетаскивается из ресурса тектстов.
*'''текст''' (''txt'') - Выводимый текст.

'''Форматирование'''
*'''dx''' (''dx'') - Бордюр (отступ текста слева и справа от границы прямоугольника объекта).
*'''dy''' (''dy'') - Бордюр (отступ текста сверху и снизу от границы прямоугольника объекта).
*'''shiftX''' (''shx'') - Сдвиг области текста по X
*'''shiftY''' (''shy'') - Сдвиг области текста по Y
*'''отступ''' (''skip'') - Вертикальное расстояние между строчками в пикселях
*'''поз. гориз.''' (''alH'') - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому
*'''поз. верт.''' (''alV'') - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему

'''min символов''' (''minCh'') - Минимальное количество вводимых символов

'''max символов''' (''maxCh'') - Максимальное количество вводимых символов

'''Разрешенные сиволы'''
*'''цифры''' (''chDig'') - цифры (нет=0,да=1)
*'''латинский алфавит''' (''chLat'') - латинский алфавит (нет=0,да=1)
*'''знаки препинания''' (''chInt'') - латинский алфавит (нет=0,да=1)
*'''кириллица''' (''chCyr'') - кириллица (нет=0,да=1)
*'''математические символы''' (''chMat'') - математические символы (нет=0,да=1)
*'''пробел''' (''chSp'') - пробел (нет=0,да=1)
*'''разрешенные символы''' (''chCustAllow'') - разрешенные символы перечисленные пользователем
*'''запрещенные символы''' (''chCustBan'') - запрещенные символы перечисленные пользователем (value="&"'<>~!@#$%^*()_+{}:\|?-=[];\\,./")

'''многострочн.''' (''mStr'') - Многострочность: 0 - однострочный; 1 - многострочный
*'''ключ''' (''tkey'') - ключ под которым будет сохранен текст после ввода
*'''вызывать обр. при пустом поле ввода''' (''enterOnEmpty'') - обработчик "нажат Enter" будет вызываться, даже если поле ввода пустое

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

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

[[Файл:+.png]] '''обработка - пустое поле ввода''' - Когда поле ввода станет пустым будет изменено состояние заданного объекта.
*'''объект''' - Когда поле ввода станет пустым, перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''обработка - НЕпустое поле ввода''' - Когда поле ввода станет непустым будет изменено состояние заданного объекта.
*'''объект''' - Когда поле ввода станет непустым, перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

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

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

[[Файл:+.png]] '''буфер обмена - нет текста''' - Если нет текста в буфере обмена перевести объект в состояние
*'''объект''' - объект, состояние которого меняем
*'''состояние''' - значение нового состояния." hint="Новое состояние для объекта из предыдущего поля

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

*'''show''' - показать клавиатуру

*'''hide''' - спрятать клавиатуру

*'''check_clipboard''' - проверить буфер обмена на наличие в нем текста (вызывается один из обработчиков: "буфер обмена - есть текст" или "буфер обмена - нет текста")

*'''paste_from_clipboard''' - вставить из буфера обмена в поле ввода

==Пример==
[[Файл:Tedit2.png|right]]

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

Пример, как с помощью поля Edit создавать профили игроков (используются объекты типа Options и Table)

В объекте Options в поле ''Поле ввода'' указываем объект Edit, в графе''Таблица'' указываем таблицу, в которую будут записываться данные из Edit.

На рисунке ниже изображен пример использования объекта типа Edit. На экране синее поле - это подложка поверх которой расположен объект Edit. Ниже поля ввода находится таблица, которая будет отображать все ранее созданные профили. Под таблицей находятся две кнопки: справа - кнопка которая создает новый профили или меняет на ранее созданный, слева - кнопка-отмена, которая осуществляет выход с экрана. Во время запуска приложения в поле ввода отображается приветствие.

После введения в поле edit имени игрока необходимо с помощью машины или кнопки передать объекту Options последовательно состояния add и update. Тогда новый игрок добавиться в таблицу (т.е. создастся новый профиль). Чтобы выбрать один из уже созданных профилей, необходимо выбрать его курсором в таблице, затем передать опциям состояния change и update последовательно. Тогда произойдет смена профиля, на один из тех, которые были созданы ранее.

'''В объект Text, в который будет выводиться имя пользователя, нужно ОБЯЗАТЕЛЬНО в поле text ввести строку "name" (без кавычек)!!!'''

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

[[Category:Options]]

Economics

2018-05-04T06:38:17Z

Vgolob: /* Монстр */

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

= Свойства =

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

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

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

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

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

*'''Окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояния ''open'' - открыта, ''open_lvl'' - не хватает лвл, ''open_buy'' - разница в уровнях позволяет нам купить анлок, ''open_item'' - не хватает предмета для анлока, ''open_unlock'' - состояние вызываемое окну перед локацией после успешной покупки предмета для анлока, ''open_energy'' - состояние вызываемое окну перед локацией в случае нехватки энергии.
*'''Превью локации''' - графический ресурс для отображения превью локации. В это поле можно поставить любую картинку для того, чтобы корректно разместить ее в "окне перед локацией". Далее экономикс сам будет подставлять нужные превью.
*'''Название локации''' - текстовый объект, в который будет подставляться название локации.
*'''Описание локации''' - текстовый объект, в который будет подставляться описание локации.
*'''Уровень мастерства''' - счетчик уровня мастерства.
*'''Прогрессбар уровня мастерства''' - прогрессбар, который отображает уровень мастерства.
*'''Текущий уровень''' - счетчик текущего уровня мастерства.
*'''Необходимая энергия''' - счетчик необходимой энергии.
*'''Аномальная энергия''' - счетчик, который отображает дополнительную энергию при наличии аномалии в локации.
*'''Призовой ресурс 1''' - счетчик призовых денег.
*'''Аномальный ресурс 1''' - счетчик, который отображает количество дополнительных призовых денег, которые даются за игру в локацию с наличием аномалии.
*'''Призовой ресурс 2''' - счетчик призовых кристаллов.
*'''Призовой опыт''' - счетчик призового опыта.
*'''Аномальный опыт''' - счетчик, который отображает значение дополнительного опыта, который дается за игру в локацию с наличием аномалии.
*'''Таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно найти в данной локации.

''для закрытой по уровню локации''
*'''Режим игры''' - машина, которой будут устанавливаться состояния в зависимости от режима игры (может быть смешанный, текст или силуэт). TODO пока обладает только режимом text и icon. Эта машина будет передавать настройки таблице, в которую помещаются поисковые объекты, поэтому важно, чтобы к этой таблице был доступ (например она может находится на глобальном экране).

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

''для локации c ценой''

*'''цена ресурс 1''' - Стоимость анлока локации в ресурсе 1.
*'''цена ресурс 2''' - Стоимость анлока локации в ресурсе 2.

''для локации c требуемым предметом''

*'''предмет''' - иконка необходимого для локации предмета.
*'''название предмета''' - в этом поле указывается название, необходимого для локации предмета.
*'''счетчик цены''' - счетчик, который отображает стоимость предмета.
*'''иконка цены''' - иконка цены предмета, представляет собой картинку, которая перетаскивается из базы ресурсов.
*'''кнопка купить''' - Будет видна, если предмет нужно купить. Передает экономиксу состояние unlock_item.
*'''кнопка искать''' - Будет видна, если предмет поисковый.
*'''блок аномалии''' - контейнер, представляющий собой машину, которая содержит всю информацию про аномалию. Должна содержать в себе состояния hide, show и remov (состояние после прогона аномалии, чтобы сделать красивые эффекты, после которого машина попадет в состояние hide).
*'''иконка аномалии''' - иконка аномалии.
*'''название аномалии''' - текстовый объект, который будет отображать название аномалии.
*'''описание аномалии''' - текстовый объект, который будет отображать описание аномалии.
*'''иконка предмета''' - иконка предмета, необходимого для того что бы прогнать аномалию.
*'''кнопка прогнать предметом''' - кнопка по нажатию которой, можно прогнать аномалию используя предмет.
*'''кнопка купить предмет''' - кнопка по нажатию которой, можно купить предмет для прогона аномалии.
*'''кнопка прогнать миниигрой''' - кнопка по нажатию которой, можно прогнать аномалию мини игрой.
*'''корневой объект''' - некая машина, олицетворяющая собой блок перехода в связанную локацию. Должно иметь состояния enable и disable.
*'''таблица артефактов''' - в таблицу будут сложены предметы, необходимы для переключения локации.
*'''галочка в таблице''' - графический ресурс поверх найденных предметов.
*'''иконка ключа''' - сюда сложим иконку предмета необходимого для переключения на альтернативную локацию.

===Окно после локации===

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

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

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

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

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

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

*'''Шаблон коллекции''' - ссылка на объект типа ecollection который будет использоваться в качестве исходного для всех коллекций.
*'''Таблица''' - таблица, куда по ссылке будут добавлены шаблоны коллекции.
*'''алерт''' - некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окно с информацией о предмете всплывает в окне с коллекциями.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.
*'''цифры''' - фреймовая анимация содержащая в себе цифры. Последний фрейм анимации - отметка много.

===Окошко коллекционного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.

===Окошко поздравления со сдачей коллекции===

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

===Окошко инвентарного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.

===Окошко поздравления с получением уровня===

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

===Окошко поздравления с получением уровня и открытием локации===

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

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

*'''энергия''' - счетчик, отображающий количество энергии, которая прибавляется к максимуму.

*'''ресурс 1''' - счетчик, отображающий количество денег.

*'''ресурс 2''' - счетчик, отображающий количество кристаллов.

*'''иконка локации''' - картинка, отображающая иконку локации, которая стала доступна

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

===Окошко получения уровня на локации===

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

===Окошко, когда не хватает чарджера (общее) ===

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

===Окошко, которое выезжает когда найден коллекционный предмет ===

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

===Окошко покупки артефакта===

Кратко об артефактах. Артефакты это инвентарные предметы, которые можно найти либо купить. Они необходимы для того, чтобы была возможность играть в связанную локацию. Связанная локация - локация, которая имеет свой уникальный порядковый номер в списке локаций, но тем не менее логически привязана к локации с другим порядковым номером. Когда все артефакты, необходимые для игры в связанную локацию собраны, то при вызове состояния ''location'' объекту economics локация выбирается случайным образом между оригинальной и связанной. При этом есть возможность сменить локацию (ротация между оригинальной и связанной локацией) вызвав состояние ''location_switch''. Чтобы сменить локацию нужен предмет, который перетаскивается в поле "предмет переключения" настроек локации.

*'''окно''' - Некая машина, олицетворяющая собой само окошко покупки. Должна иметь состояние show
*'''таблица''' - Таблица должна иметь две строки и заполнение по столбцам. В верхнюю попадут иконки артефактов, в нижнюю - кнопки купить
*'''кнопка 1''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 2''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 3''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact
*'''кнопка 4''' - Купить артефакт. Должна в param2 - номер артефекта и вызывать состояние экономике buy_artefact

===Дополнительные достижения ===

В этом разделе указаны некоторые достижение, которые отправляются объектом economics в gamecenter.

*'''достижение на трату ресурса 1''' - id достижения, отправляемого за трату ресурса 1 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 1''' - сумма ресурса 1, которую необходимо потратить для получения достижения.
*'''достижение на трату ресурса 2''' - id достижения, отправляемого за трату ресурса 2 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 2''' - сумма ресурса 2, которую необходимо потратить для получения достижения.
*'''достижение на число открытых локаций''' - id достижения, отправляемого за открытия количества локаций из следующего поля (при открытии нужного количества локаций отправляется 100% достижения).
*'''количество локаций''' - кол-во локаций, которое необходимо открыть для получения достижения.
*'''достижение за покупки чего-либо''' - id достижения, отправляемого за совершенное количество покупок из следующего поля (при покупке нужного количества отправляется 100% достижения).
*'''количество покупок''' - количество покупок, которое необходимо свершить для получения достижения.

===Покупка рандомного предмета===

При вызове объекту economics состояния ''buy_random_col'' покупается случайный коллекционный предмет. Визуализацией покупки служит выпадающий на сцену объект из вкладки настроек "Летающий объект"

*'''res1''' - цена предмета в ресурсе 1.
*'''исключения''' - id предметов, которые не попадут в случайный выбор. Перетаскиваются из текстовой базы.
*'''каунтер''' - объект типа counter в который сложится цена предмета.

=== Статус ===
Статус - дополнительный экономический параметр игрока, который зависит от внутриигровых действий. Статус определяется кол-вом статусных очков, которые начисляются за совершение in-app покупки и при достижении нового уровня (exp).

Тесно связан с [[Wallet|Wallet]].

*'''очки для повышения''' - массив чисел, указываем через запятую. Обозначает нужное кол-во очков статуса для перехода на следующий уровень. Пример: 0, 150, 3850. Изначальный уровень уже получен при инициализации экономики. Для перехода на следующий (2-й) нужно получить 150 очков. На 3-й - 3850 и т.д.
*'''множитель статуса при покупке''' - массив чисел, указываем через запятую. Обозначает коэф., на который домножим базовое значение статусных очков при покупке. Зависит от текущего статуса. Пример: 1,2,3. Базовое значение за покупку - 18 очков статуса. При совершении покупки, имея 1-й статус - получаем 18 очков. Имея второй статус - 36, третий - 54.
*'''множитель монет при покупке''' - Аналогично предыдущему пункту.
*'''прибавка за уровень''' - массив чисел, указываем через запятую. Показывает сколько статусных очков будет получено при достижении уровня exp, учитывая текущий статус.
*'''множитель дейли-бонуса''' - массив чисел, указываем через запятую. Множитель, который можно использовать при начислении ежедневного бонуса. Зависит только от текущего статуса.

'''Поля в опциях'''
* ecomics%d.stlev - текущий уровень статуса (начиная с 0!)
* ecomics%d.stpoints - поинты внутри текущего уровня
* comics%d.stdaily - множитель для дейли бонуса
* ecomics%d.stmult - множитель для монеток

=== Настройки симуляции ===

*'''время''' - время симуляции, измеряется в секундах.

*'''минимум в локации''' - нижняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.

*'''максимум в локации''' - верхняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.
*'''порог покупки''' - число, указывающее какую долю, от ресурсов игрока, должна составлять цена локации, что бы он решился её купить.
*'''порог покупки предмета''' - число, указывающее какую долю,от ресурсов игрока, должна составлять цена предмета, что бы он решился его купить.
*'''вероятность задачи''' - число, отображающее вероятность того, что симуляция будет выбирать не из всех доступных локаций, а из связанных с заданиями.
*'''вероятность матча''' - число, отображающее вероятность того, что симуляция будет играть в матч.
*'''изначально хинтов''' - изначальное количество хинтов.
*'''предметов на хинт''' - на сколько найденных предметов игрок израсходует хинт.
*'''цена хинта монеты''' - сколько монет (ресурс 1), стоит некий усредненный хинт.
*'''цена хинта кристаллы''' - сколько кристаллов (ресурс 2), стоит некий усредненный хинт.
*'''хидденов подряд''' - игрок будет пытаться пройти не менее данного числа хидденов подряд.
*'''восстановить энергии''' - некое усредненное количество энергии для восстановления.
*'''цена энергии монеты''' - сколько монет стоит энергия (цена в ресурсе 1).
*'''цена энергии кристаллы''' - сколько кристаллов стоит энергия (цена в ресурсе 2).
*'''вероятность победы в матче'' - число, отображающее вероятность победы в матче.
*'''время в матче''' - условное время пребывания в матче.
*'''вероятность покупки за реал''' - каждый раз когда игроку не хватает денег или кристаллов - проверяем эту вероятность.
*'''цена монеты в деньгах''' - цена монеты в деньгах.
*'''количество монет в покупке''' - количество монет в покупке.
*'''цена кристаллов в деньгах''' - цена кристаллов деньгах.
*'''количество кристаллов в покупке''' - количество кристаллов в покупке.

=== Настройки равномерной экономики ===

Нужно в случае, если мы хотим давать за локации и монстров одинаковую награду (опыт, затрата энергии, вне зависимости от настроек в economics_setup). Награда может отличаться только для монстров (если в economics_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", то действие предмета будет вечным, отображаться в таблице амулетов он не будет.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

*'''кнопка применить - поле в опциях''' ( '''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 - то для достижения может использоваться любая аномалия.

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

[[Файл: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 детальнее]).
*'''search_task_only_open''' - вызываем из окна таска, откроет превью локации в которой можно найти требуемый предмет. Аналог 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|*]]

Taskorganizer

2018-03-30T14:00:54Z

Vgolob: /* Запись в опции */

{{TOC right}}
[[Object|Объект]] Taskorganizer - Менеджер задач и квестов

=Свойства=
[[Файл:Task.jpg|250px|thumb|right]]
[[Файл:Task_1.jpg|250px|thumb|right]]
=== Общие параметры ===
*'''economics''' - Объект типа экономикс.
*'''предметы''' - Объект типа eitems.
*'''таблица''' - Таблица куда будут помещены иконки заданий. При тапе на таблицу объекту Taskorganizer вызывается состояние show. Иконки подтягиваются из текстовой базы (icon1).
*'''добавлять иконки''' - 1 - добавлять в таблицу иконки, 0 - тексты из текстового id (поле word).
*'''шаблон предмета''' - Объект типа etaskitem будет использоваться при показе превью задания.
*'''фильтрация''' - Категория, которые должны будут отобразиться в таблице логов при вызове состояния logbook. Пустая строка - все.
*'''таблица логов''' - Таблица куда будут помещены записи логбука.
*'''новая запись''' - Объект, которому будет вызвано состояние show при добавлении новой записи в логбук.
*'''новое задание''' - Графический ресурс, который будет отмечать новые задания. Смещение должно достигаться пивотом.
*'''прочитанное задание''' - Графический ресурс, который будет отмечать прочитанные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе).
*'''выполненное задание''' - Графический ресурс, который будет отмечать выполненные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе)
*'''уведомление''' - Текстовый айди заголовка связанных с задачами уведомлений (Должно быть заполнено поле sense 4 - т.к. рандомно его будет постить).
*'''вероятность уведомления''' - Подменная вероятность нахождения предмета нужного для задания по уведомлению с которого мы пришли. 0 - использовать значение по умолчанию.
*'''выполнять непрочитанные''' - 1 - выполнять непрочитанные таски, 0 - нет.
*'''хронологический порядок''' - 1 - записывать задачи в хронологическом порядке, 0 - нет.
*'''картинки в логбук''' - Расположение картинки до или после текста.
*'''сдвиг уровней''' - число на которое сдвинутся требования к уровню игрока в taskorganizer_setup для каждой задачи;
*'''refresh при показе окна''' - 0 - нет, 1 - да. Ставим = 0 ( "нет" ), если хотим чтобы при тапе по таблице отложить сортировку и обновление статуса таска ( в определённый момент ( к примеру, когда открылось окно таска), передаём состояние '''refresh''' и таблица обновится).
*'''использовать накопление ошибки''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы нахождение предметов в хиддене, по таску не превышало n-раз ( к примеру p= 0.5 (1/0.5=2 , т.е. предмет должны найти не более чем за две игры в хидн), если количество сыгранных игр >= максимальному по вероятности, то предмет попадает в таблицу ( мы его нашли)). Если стоит - 0 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.
*'''etasktemplate''' - объект типа [[Etasktemplate|etasktemplate]]
*'''только одна подкрутка за раз''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы за один проход хиддена выполнялся один таск.
*'''таблица для шаблонов''' - таблица, в которую сложим шаблоны из предыдущего поля
*'''помещать генерируемые в шаблоны''' - помещать в шаблоны генерируемые таски
*'''уменьшать предметы при сдаче коллекции''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), то при сдаче коллекции будет выполнен декремент количества предметов необходимых чтобы задание выполнилось ( параметр таски s0 в опциях).

<pre>
Для огранизации логбука необходимо текст поместить в sentenсe 1. Картинка, что будет отображаться с этим текстом, должна быть icon 2. Также есть возможность использовать эту картинку в качестве фона. Тогда текст, который будет отображаться поверх этой картинки, нужно разместить в sentenсe 2.
</pre>

=== Группа угадайка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать угадайку.
*'''с уровня''' - Угадайка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''иконка''' - Объект, в который сложим иконку предмета.
*'''иконка для таблицы''' - Иконка соответствующая угадайке в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
=== Группа рулетка ===

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

*'''показывать через''' - Через какое количество обычных задач показывать рулетку.
*'''с уровня''' - Рулетка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show.
*'''иконка для таблицы''' - Иконка соответствующая рулетке в таблице задач.
=== Группа генерируемые ===

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

*'''активных задач''' - Эти задачи будут генерироваться, когда активных задач столько или меньше.
*'''с уровня''' - Эти задачи будут генерироваться только начиная с данного уровня.
*'''максимально''' - Будет сгенерированно случайное количество задач от 1 до n.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''название''' - Текстовый объект, в который будет сложено название локации.
*'''превью''' - Объект, в который сложим превью локации для генерируемой задачи.
*'''иконка для таблицы''' - Иконка соответствующая генерируемому таску в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
*'''текст для etasktemplate''' - будет в поле name etasktemplate. Это название задачи на прохождение локации, которая генерируется автоматически и использует шаблон etasktemplate. Текст используется из Текстовой Базы Ресурсов. Например, "Исследовать локацию".
*'''номер кнопки для etasktemplate''' - номер кнопки для etasktemplate. [[Button|Кнопка]], которая используется для данной задачи. Например, "Исследовать".

<pre>
Если перед генерацией случайного таска на исследование локации указать параметру gen_loc значение от 0 до n, то ближайшая генерируемая задача будет для конкретной локации под указанным номером. После генерации параметр gen_loc становится -1.
</pre>

<pre>
Если перед генерацией случайного таска от персонажа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
Если указать gen_face="-2", то таскорганайзер попытается с генерировать задачу с персонажем так, чтобы номер локации совпадал с персонажем, при условии что номер локации будет меньше максимальному числу персонажей ( char_num).
</pre>

=== Группа угадаечные задачи ===

В этой группе указываем диапазоны для генерации тасков-викторин и способ генерации.

*'''стандартная генерация''':
::'''нет''' - особая генерация задач, при которой с начало генерируем задачи из _очереди 1_, потом задачи из _очереди 2_ ( Если в первой очереди мы не можем сгенерировать задачу, пытаемся сгенерировать из второй очереди). Если мы не сгенерировали задачу из обоих очередей, то мы обнуляем все таски из обоих очередей ( и сразу генерим из _очереди 1_ задачу);
::'''да''' - стандартная генерация одной угадайки ( начинаем сверху вниз генерить;
*'''очередь 1''' - Основная очередь, пытаемся из неё сгенерировать задачу, при получении Taskorganizer сост. _generate_guess_, если в предыдущем поле стоит '''нет'''. Каждая задача из этой очереди имеет условия для появления ( прохождение сюжетного таска к примеру);
*'''очередь 2''' - Очередь затычка, задачи из этой очереди без условий. Предназначена когда в первой очереди нету доступных тасков для генерации;

<pre>
У таскорганайзера есть поле disabled, если при каждом запуске приложения после конца туториала писать туда 1 - это приведет к удалению старого сейва и несозданию нового. Несколько килобайт выгоды в опциях + использовать только для туториального таскорганайзера, когда он отработает.
</pre>

=Taskorganizer setup=
[[Файл:Task_2.jpg|600px|thumb|right]]

*'''id''' - Идентификатор задания. Используется в других заданиях. По общей концепции - строковый айди. Перетаскивается из текстовой базы.
'''Для каждого задания(записи в logbook) должен быть свой уникальный id.'''
*'''хинт''' - Список строк-подсказок для задачи. Перетаскиваются из текстовой базы. Таким образом, добавив несколько записей из базы, увидим выпадающий список.
*'''название (объект)''' - Текстовый объект, в который мы сложим название задания. Описание подтягивается из текстовой базы из первого столбика (word) текстового id задания.
*'''машина''' - Объект, которому при активации задания будет вызвано состояние show, а при повторном открытии задания show_old.
*'''портрет''' - Объект, которому при активации задания будет устанорвлен графический ресурс рожи.
*'''таблица''' - Таблица куда будут помещены темплейты предметов данного задания.
*'''описание (объект)''' - Текстовый объект, в который мы сложим описание задания. Описание подтягивается из текстовой базы из второго столбика (sentence1) текстового id задания.
*'''награда (ресурс 1)''' - Счетчик отображающий награду в ресурсе 1 за выполнение задания.
*'''награда (ресурс 2)''' - Счетчик отображающий награду в ресурсе 2 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.
*'''умножать цену пропуска''' - нужно в случае, если мы хотим давать юзеру возможность моментально выполнить задачу за цену, которая зависит от количества нехватающих коллекционных предметов (цена пропуска*количество отсутствующих предметов).
*'''видимые кнопки''' - номера видимых кнопок в [[Etasktemplate#Дополнительные кнопки|Etasktemplate]] через запятую. Отображает кнопки, используемые для данной задачи.

'''Необходимое для логбука'''

*'''для журнала''' - 0 - задача предназначена для списка задач, 1 - задача предназначена для журнала.
*'''категория''' - Категория к которой относится задача/запись. Пока используется только задачами для логбука.

'''Критерии появления'''

*'''уровень''' - Минимальный уровень, при котором может появиться задание.
*'''аномалия''' - В какой-либо локации присутствует аномалия данного типа. -1 - не учитывать условие.
*'''локация''' - Локация для которой будем проверять мастерство. -1 - не учитывать условие.
*'''мастерство''' - Уровень мастерства, который должен быть достигнут в локиции. -1 - не учитывать условие.
*'''завершены до''' - Задания, которые должны быть завершены до появления этого.
*'''получены до''' - Задания, которые должны быть получены до появления этого.
*'''не завершены до''' - Задания, которые должны быть НЕ завершены до появления этого.
*'''объект до''' - Объект, который должен находиться в состоянии_до для появления задания.
*'''состояние до''' - Состояние объекта_до, в котором вызывается генерация задания.
*'''коллекционные''' - Коллекционные предметы, которые должны быть найдены для появления задания.
*'''вероятность нужного''' - Когда мы будем проходить локации, в которых есть предметы необходимые для задания - мы будем подменять вероятность из локации вот этой вероятностью. 0 - использовать дефолтную.

'''Критерии завершения'''

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

'''Награда'''

*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''перевести объект''' - При выполнении задания этот объект будет переведен в новое состояние.
*'''в состояние''' - Состояние для объекта из предыдущего поля.

==Подзадача предмет==
В опции суммарно будет записываться значение два параметра:

:'''iN''' - "item need" - необходимое количество предметов, по всем "подзадачам предмет";
:'''iH''' - "item have" - имеющееся количество предметов, по всем "подзадачам предмет";
:'''i0..i666''' - требующийся предмет, пишется для задач из коллекций;

*'''сгенерировать предмет''' - определить необходимый предмет из коллекции;
::'''нет''' - просто требовать предмет;
::'''да''' - сгенерировать предмет из доступных локаций (календарь);
::'''сегодня''' - с генерировать предмет из коллекции, для локации текущего дня (календарь);
::'''неделя''' - с генерировать предмет из коллекции, для локаций текущей недели (календарь);
*'''из коллекции''' - указать txtID коллекции из которой будут браться id предметов;

==Подзадача экспертиза==

*'''предмет''' - в поле предмет записываем id объекта, который нужен для проведения экспертизы. Предмет берем из текстовой базы ресурсов. Иконка предмета до начала и во время проведения экспертизы в icon1, иконка предмета после проведения экспертизы в icon2.
*'''время''' - изначальная длительность экспертизы в секундах.
*'''стоимость''' - стоимость экспертизы, используется res3.
*'''стоимость ускорения''' - стоимость ускорения экспертизы, используется res2.
*'''описание''' - описание подзадачи
*'''владелец''' - здесь используем число для указания типа экспертизы. Например, 1 - это экспертизы одного типа, 2 - это второй тип экспертиз
*'''уведомление''' - текстовый id для уведомления. Генерируется при старте. Имя уведомления записать в поле word, текст уведомления в sentence1, картинку уведомления в sentence2.

<pre>
Картинку для уведомления положить в конфиги, рядом с файлом platform.icf для каждой платформы.
К примеру, путь может выглядеть так: C:\Editor\Projects\Crime_City\conf\base\project\platforms\google
</pre>

[[Файл:Taskorganizer_eanalysis.png|600px|thumb|right]]

==Изменить состояние объекта - новое задание==

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

==Задача cross promo==

У таска можно включить флаг:
*'''cross promo''' - идентификатор задачи типа ''cross promo'' (1 - да, 0 - нет)

в этом случае он
а) сгенерится, если есть кросс промо И выполнены остальные условия его появления;
б) выполнится, если установлено приложение И выполнине остальные условия его выполнения;
в) вызвав состояние '''cross_promo''' -открыть урл связанный с crosspromo задачей - таскорганайзеру можно открыть урл, которые приехал из конфига.
У задачи должно быть уникакльное окно, в котором в объект указанный в ''портрет'' будет помещен баннер.

=Состояния=

*'''show''' - При вызове этого состояния из таблицы с иконками заданий открывается соответствующая машина задания, прописанная в группе '''задание'''.
*'''check''' - При вызове проверяется выполнение текущих заданий(заданий добавленных в таблицу). Для того чтобы таскорганайзер добавил таски в таблицу после загрузки приложения ему нужно передать refresh.
*'''generate''' - При вызове подбирается подходящее задание в зависимости от прогресса игрока.
*'''generate_plot''' - При вызове генерится задача с персонажем ( поле генерируемые с персонажами), если перед этим передать в поле gen_face номер персонажа, то сгенерируем с указанным персонажем, после параметр обнулится ( значение -1 ). Перед вызовом данного состояния, '''обязательнo''' в поле _param_ вбить "1".
*'''log_check''' - При вызове состояния проверяется доступны ли новые записи в логбук.
*'''log_show''' - Заполняет таблицу логбука записями с текущим фильтром.
*'''refresh''' - Удаляет иконку выполненного задания из таблицы. Лучше всего вызывать после Check.
*'''cancel''' - Удаляет задание без награды, которое указано как ID в параметре param таскорганайзера, т.е. объекту Taskorganizer в param указываем ID таска (например 1933 - берется из options.xml или текстовой базы), а потом вызываем состояние cancel.
*'''add_hint''' - Добавляет в таблицу хинтов следующий текстовый ID из поля хинты текущего таска. Если все хинты показаны, то в опции записывается параметр haveHints=0.
*'''task_prev''' - Используется, если открыта машина-шаблон текущего задания. В этом состоянии показывается предыдущее по списку таблицы задание.
*'''task_next''' - Показывает следующее по списку таблицы задание.
<pre>
Состояния task_prev и task_next работают циклически, после первой задачи показывают последнюю и наоборот.
</pre>
*'''show_id''' - Показать окно задачи, взяв ее id из параметра.
*'''show_complete_id''' - показать окно после задачи, взяв ее id из param (делалось для одноразовых задач, повторяемые могут не работать);
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''skip_id_no_effect''' - изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.
*'''add_hint_hidden''' - Вызов подсказки для 1 (первой по списку в таскорганайзере) скрытой задачи.
*'''add_hint_hidden_all''' - Вызов подсказки для всех активных скрытых задач (по списку в таскорганайзере).
*'''calc_active_preset''' - Посчитать количество активных задач по конкретному "preset" (перед вызовом в поле "param" указать номер интересующей категории preset). После вызова, таскорганайзер заполнит параметр "preset_tasks".

Состояния для работы с тасками-угадайками по типу викторины ( в taskorganizer_setup - тип = "угадайка"):
*'''answer''' - ответить на открытую угадайку ( в поле '''param''' должно находиться число, номер нажатой кнопки от 0 до 3 ). Вешаем на кнопки варианты-ответа ( пишем param = 0 - 3 , после передаёт _answer_);
*'''generate_guess''' - сгенерировать угадайку-викторину ( выберет доступные задачи из диапазона указанном в очередях ( 1 и 2) поле _угадаечные задачи_ taskorganizer). При открытии угадайки, в поле _cur_guess_answer_ объекта Taskorganizer записывается номер кнопки где лежит правильный ответ ( от 0 до 3 );

ПРИМЕЧАНИЕ: при проверке задач для логбука для последней выполненной будет перезаписано поле filter автоматически.

При кажом refresh таскорганайзер заполняет у себя поля:
*'''tasks_in_table''' - задач в таблице
*'''tasks_total''' - задач в таблице + скрытых задач

=Запись в опции=

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

"tasks(id таскорганайзера в проекте).t(id текстового объекта - идентификатора задания).s".

Возможные значения:
* '''0''' - таск не активен (не добавлен путем вызова generate таскорганайзеру);
* '''1''' - таск сгенерирован ;
* '''2''' - таск прочитан (вызвано состояние show);
* '''3''' - таск выполнен;
* '''4''' - отложенное состояние таска (условия появления выполнены, но время его появления еще не прийшло);
* '''5''' - таск выполнен, но награда ещё не забиралась ( таск будет оставаться в таблице, если таски не выполняются автоматически);
* '''7''' - таск выполнен, награда получена, таск остался в таблице;

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры:=
Каждая таскорганайзер пишет в пользователя следующие параметры:
*'''public.TaskOrganizerCompletedTasks''' - количество выполненных одноразовых задач;
*'''public.TaskOrganizerCompletedTasksAll''' - количество выполненных задач с учётом повторяемых;

=Механизм многоуровневых достижений=
С помощью таскорганайзера можно организовать систему многоуровневых достижений. Для этого используется [[Etasktemplate|темплейт задачи]]. Данные темплейты складываются в таблицу темплейтов таскорганайзера. При этом в самом таскорганайзере должна быть указанна таблица для иконок задач, хоть она и не используется (желательно вынести за границы экрана).

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

Часть контента для достижения задается чрез текстовый объект - id таска. В текстовом объекте указываем название (word), описание невыполненной (sentence1) и выполненной (sentence2) ачивки. А также ресурс иконки ачивки (ico1), ресурс звезд для невыполненной (ico2) и выполененной (ico3) задачи.
Награду за достижения ачивки указываем как награду за выполнение таска. Также с помощью обработчика завершения задачи можем запустить анимацию получения ачивки.

Для заполнения таблицы темплейтов нужно вызвать состояние '''refresh_templates''', при вызове '''check''' задача, условия которой были выполнены изменит свое состояние, при этом будут переключены ресурсы звезд, описание ачивки и спрятана кнопка темплейта '''btn'''.

Для контроля того, какая задача будет вызвана при вызове '''check''' можно использовать следующий способ. К задаче добавляем еще одну подзадачу на опции. Когда прогресс по первой подзадаче на опции будет >= требуемого значения для задачи будет отображаться кнопка темплейта '''btn'''. При нажатии на эту кнопку, которая должна вызывать '''take''' темплейту задачи, в него пишется параметр clicked_task_id, по этому параметру определяем у какой задачи нужно выполнить вторую подзадачу на опции и вызываем '''check''' таскорганайзеру.

Пример
S:\!MOBILE\!!!EditorGames\Wiki_sample

Complex_achievements.zip

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

=Равномерная экономика (Preset)=
[[Файл:1499422858929.jpg|300px|thumb|right]]
Работает, при включении в объекте Economic равномерной экономики (задание не нулевых значений).
Настройка позволяет давать диапазонную награду конкретной группе задач("preset").
Настройка награды для всех задач, у которых не указан параметр "preset" (т.е. =="-1"), осуществляется, группой параметров объекта Taskorganizer:

Настройки конкретного preset вынесены в отдельную вкладку "Taskorganizer_setup":
[[Файл:Photo hidden 365 Scene Editor build Wed Jul 5 151607 2017 -(single-user) DProjectsEDITOR Game Hidden 365Photo hidden 365Photo hidden 365.seproj.jpg|600px|right]]
[[Category:Economics]]

Builder

2018-03-17T07:19:27Z

Vgolob: /* Предмет для постройки\дополнительные условия для апгрейда */

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

==Основные параметры==
*'''economics''' - объект типа economics. Нужен для взаимодействия с балансом и предметами.
*'''builderitem''' - шаблон здания. Описание [[builderitem|тут]]. Если шаблон указан в этом поле, то он является общим для всех клонируемых объектов зданий. Если какие-либо из зданий мы хотим сделать уникальными, то для них шаблон указывается в builder setup.

==Окно подтверждения апгрейда==
Окно, которое открывается когда мы хотим построить или улучшить здание. Содержит общую информацию о локации, а также необходимые [[Buildercomponent|предметы]] для улучшения.
*'''иконка до''' - иконка здания до улучшения\постройки
*'''иконка после''' - иконка здания после улучшения\постройки
*'''название''' - ссылка на текстовый объект названия здания. Берется из текстового id здания (sense0), который указан в builder setup
*'''описание''' - ссылка на текстовый объект описания здания. Берется из текстового id здания (sense1), который указан в builder setup
*'''уровень до''' - ссылка на счетчик, в который складывается значение уровня здания до улучшения. Т.к. уровня начинаются с 0, то для непостроенного здания в этот счетчик попадет значение -1
*'''уровень после''' - ссылка на счетчик, в который складывается значение уровня здания после улучшения
*'''время улучшения''' - ссылка на таймер, в который складывается время необходимое на улучшение. Таймер не запускается, а просто служит в качестве форматного контейнера для времени
*'''опыт за улучшение''' - ссылка на счетчик, в который сложится разовый опыт за улучшение\постройку здания
*'''цена за все''' - ссылка на счетчик, в который сложится общая цена со скидкой на необходимые компоненты(предметы) для улучшения\постройки здания
*'''кнопка купить все''' - ссылка на кнопку, по нажатию на которую покупаются все недостающие предметы. Кнопка должна передать состояние \\TODO
*'''кнопка улучшить''' - ссылка на кнопку, которая должна передать билдеру состояние 'upgrade', предварительно записав в 'param' id здания
*'''таблица''' - ссылка на таблицу, в которую сложатся все шаблоны предметов, необходимых для постройки\апгрейда здания
*'''buildercomponent''' - ссылка на объект шаблона [[buildercomponent|компонента]] для постройки здания
*'''само окно''' - окно улучшения\постройки здания. Должно иметь состояние show

==builder setup==
[[Файл:Builder.jpg|600px|thumb|top|builder setup]]
В этом разделе содержатся настройки для каждого здания. Условно это окно можно разделить на 3 блока:
# строение и настройки для строения
# уровень улучшения и настройки уровня улучшения
# предмет для постройки и настройки предмета, а также дополнительные условия для апгрейда
Строение добавляется по нажатию на кнопку Add1 (Удаляется Delete1).
===Строение===
*'''id''' - текстовый id, уникальный идентификатор строения
*'''builderitem''' - в случае, если нужно использовать уникальный вид строения, то сюда помещается ссылка на шаблон здания [[builderitem]]
*'''parent''' - в случае, если это здание использует общий для всех шаблон [[builderitem]], то сюда помещается обект, в который после клонирования вложится этот шаблон. Этот объект необходим для размещения зданий на карте
*'''иконка(непостроенного)''' - ссылка на resID графики непостроенного здания. Т.е. его внешний вид до первого апгрейда
*'''иконка(строительства)''' - ссылка на resID графики процесса строительства\апгрейда
===Уровень улучшения===
*'''иконка''' - ссылка на resID графики здания на этом уровне
*'''время постройки''' - время в секундах, необходимое для улучшения на этот уровень с предыдущего
*'''время прибыли''' - время генерации прибыли в секундах
*'''мгновенная постройка res1''' - стоимость мгновенного завершения строительства в res1
*'''мгновенная постройка res2''' - стоимость мгновенного завершения строительства в res2
*'''опыт''' - опыт, даваемый разово за улучшение
*'''прибыль монеты''' - постоянно генерируемая прибыль зданием на этом уровне в res1
*'''прибыль кристаллы''' - постоянно генерируемая прибыль зданием на этом уровне в res2
===Предмет для постройки для апгрейда===
*'''id''' - текстовый id предмета, необходимого для улучшения на этот уровень
*'''num''' - количество предметов из поля выше
===Дополнительное условие для апгрейда===
*'''поле в опциях''' - название поля в опциях (автоматически ищет в текущем пользователе)
*'''значение''' - значение указанного выше поля в опциях необходимое для улучшения на этот уровень

==Состояния==
*'''update''' - вызывается для актуализации состояния зданий. Есть смысл делать при заходе на карту
*'''buy_component''' - вызывается из шаблона компонента [[buildercomponent]], по нажатию на соответствующую кнопку шаблона
*'''upgrade_wnd''' - вызывается из шаблона [[builderitem]], предварительно записав в param id здания. Открывает окно улучшения здания
*'''upgrade_instantly''' - вызывается из шаблона [[builderitem]], предварительно записав в param id здания. Мгновенно завершает строительство
==Пример==
[[Файл:Builder test.zip|Тестовый пример]]

Isomover

2017-12-06T07:24:50Z

Vgolob: /* Основные параметры */

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

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

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

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

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

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

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

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

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

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

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

===Пример===
Два изомувера (police_car и werewolf) совершают циклическое движение по определенному маршруту, заданному с помощью машин состояний (car_machine и werewolf_machine соответственно). Когда объекты оказываются в радиусе (достаточном для активации добавляемого параметра '''"Взаимодействие с другими объектами"'''), объект '''police_car''' начинает взаимодействовать с объектом '''werewolf'''. По истечению времени воздействия объект '''police_car''' переходит в состояние '''fail'''. Если кликнуть на процесс взаимодействия объектов, то объект '''police_car''' перейдет в состояние '''win'''.
*'''Пример:
S:\!MOBILE\!!!EditorGames\Wiki_sample\Isomap.rar

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

Timer

2017-11-10T12:35:41Z

Vgolob: /* Основные параметры и свойства таймера */

{{TOC right}}
== Общие сведения ==

Данный [[Object|объект]] предназначен для различных действий в игре связанных со временем. Например: длительность игры на каком-то из уровней, время между ходами и т.д. Он может использоваться в качестве таймера (время отнимается) и секундомера (время наращивается).

Таймер может управляться такими игровыми объектами как [[HiddenList]], а также другими игровыми объектами которые смогут передавать ему различные состояния.

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

[[Файл:Timer 01.jpg|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''z''' - параметр порядка рисования объекта. Сначала рисуются объекты с большим z, а под ними с меньшим
* '''память''' - если 1 - не обновляет свои параметры при последующем открытии экрана, 0 - обновляет . '''Если таймер подвязан к опциям''' и включена память, то таймер не будет перевычитывать значение из опций после получения состояний '''init''', '''run'''
* '''cостояние''' - начальное состояние таймера:
** '''beg''' - начальное состояние (таймер не идет)
** '''run''' - запуск таймера
** '''fast''' - таймер работает с ускорением( кооф. ускорения задаем в "ускорение" )
** '''pause''' - таймер перходит в состояние паузы. (снять с паузы состоянием - run, fast)
** '''add''' - добавление времени к таймеру
** '''del''' - отнимание времен из таймера
** '''end''' - конечное состояние таймера
** '''stop''' - останавливает таймер, если потом он будет запущен снова, то пойдет с нуля
** '''save''' - записывает текущее значение в опции под именем, указанным в ключе (игра, уровень)
* '''отладка''' - отображать в окне состояний текущий объект
* '''значение''' - начальное значение таймера в ms
* '''дельта''' - используется в состояниях add и del, количество времени которое будет добавлено или удалено из таймера (время в секундах)
* '''обратный ход''' - если "0" объект "таймер" работает, как секундомер (время увеличивается), если "1", то работает как таймер (время отнимается)
* '''отображать дни''' - параметр days (количество дней), необходим для настройки отображения таймера. Настраивается во "внешний вид".
* '''прогресс''' - прогрессбар, отображающий то же, что и таймер
* '''графика'''
** '''res''' - основной графический ресурс для таймера, в качестве графического ресурса подгружается анимация из 10 фреймов, на которых изображены числа от 0 до 9
** '''цифры нормальные''' - поле куда добавляется анимация цифр в нормальном виде (не обязательно заполнять, если таймер будет использоваться в одном режиме)
** '''цифры окончания''' - анимация цифр, которая будут показываться в том случае, когда время таймера будет истекать
** '''цифры при добавлении''' - анимация цифр, которая будет показываться в том случае, когда к таймеру было добавлено время
** '''цифры при удалении''' - анимация цифр, которая будет показываться в том случае, когда от таймера было отнято время
** '''двоеточие нормальное''' - графика двоеточия, которое разделяет секунды, минуты, подгражается обычный графический ресурс двоеточия
** '''двоеточие окончания''' - графика двоеточия, которое показывается в случае, когда у таймера истекает время
** '''двоеточие при добавлении''' - графика двоеточия, будет использовать при прибавлении время к таймеру
** '''двоеточие при удалении''' - графика двоеточия, будет использовать при удалении время от таймера
* '''шрифт'''
** '''имя''' - номер шрифта - целое число, начиная с 0 (порядковый номер шрифта), а если -1 то рисовать каунтер клипами
** '''размер''' - размер шрифта в пикселях
** '''цвет 1''' - цвет текста
* '''внешний вид'''
** '''дни''' - 0 - прятать, 1 - отображать, 2 - отображать всегда два разряда, 3 - отображать, когда дней больше, чем в days, 4 - отображать только дни, когда дней больше, чем в days
** '''часы''' - 0 - прятать, 1 - отображать, 2 - отображать, если время больше одного часа
** '''минуты''' - 0 - прятать, 1 - отображать
** '''секунды''' - 0 - прятать, 1 - отображать, 2 - отображать, если время меньше одного часа
** '''dx''' - сдвинуть все относительно подложки вдоль х
** '''dy''' - сдвинуть все относительно подложки вдоль y
** '''dx между цифрами''' - расстояние между цифрами внутри разряда, между hh или mm
** '''dx от ":"''' - расстояние между разрядами и клипом двоеточия (справа и слева от него)
** '''разделитель после дней''' - символ, который отображается после разряда дней. Если указан, двоеточие после разряда дней не отображается. Перетаскивается из текстового редактора
** '''разделитель после часов''' - символ, который отображается после разряда часов. Если указан, двоеточие после разряда часов не отображается. Перетаскивается из текстового редактора
** '''разделитель после минут''' - символ, который отображается после разряда минут. Если указан, двоеточие после разряда минут не отображается. Перетаскивается из текстового редактора
** '''разделитель после секунд''' - символ, который отображается после разряда секунд. Если указан, двоеточие после разряда секунд не отображается. Перетаскивается из текстового редактора
** '''ускорение''' - коэффициент ускорения, когда таймер находится в состоянии fast
** '''сохранять в профиль''' - если "0" - то не сохраняет значение в профиль, а значит значение будет глобальным
** '''игра''' - ключ (параметр), совместно с параметром '''уровень''' образует переменную, с помощью которой можно управлять таймерому
** '''уровень''' - совместно с параметром '''игра''' образует переменную, с помощью которой можно управлять таймером (Строит заметить, что при переходе объекта в состояние init - он автоматически считывает значение, записанное по адресу игра.уровень в [[Options|Options]]. При этом таймер не имеет состояния read, как [[Counter|Counter]])
* '''Время истекло: изменить состояние объекта''' - если достигнет нуля, то есть используется, как таймер, он изменит состояние какого-то объекта
* '''Время истекло: изменить параметр (свойство) объекта''' - если достигнет нуля, то есть используется, как таймер, он изменит параметр какого-то объекта

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

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

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

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

== Основные состояние ==

Следует помнить следующие основные состояния: '''run''', '''beg''', '''pause''', '''save''', '''stop''', '''fast''','''add''','''del'''. Эти состояния используется чаще всего. 
Состояния таймеру мы можем передавать с помощью любого игрового объекта который может менять состояние другому объекту. 
*'''run''' - состояние которое передаем таймеру для его запуска(если таймер был на паузе то снимет с нее) ( таймер подвязанный к опциям схватит время из опций, если не стоит память) 
*'''start''' - состояние которое передаем таймеру для его запуска(если таймер был на паузе то сбросит его и запустит заново) 
*'''pause''','''stop''' - состояние которое передаем таймеру для его остановки 
*'''save''' - если заполнены поля "игра и уровень" то таймер запишет свое значение в [[Options]] 
*'''fast''' - состояние ускоренного хода таймера, ускорение определяется параметром ускорение в настройках таймера, или можно передавать параметром(fast) с помощью другого объекта. 
*'''add''' - состояние добавления времени к таймеру, добавляемое время определяется параметром дельта в настройках таймера, или можно передать параметром(delta) с помощью другого объекта. 
*'''del''' - состояние вычитания времени из таймера, вычитаемое время определяется параметром дельта в настройках таймера, или можно передать параметром(delta) с помощью другого объекта. 
*'''value''' - состояние при котором таймер в своё поле "value" запишет текущее значение в мсек. (Если вызвать до инита объекта, может записать "левое число").

== Примеры применений ==
Благодаря разнообразию состояний таймера есть возможность гибкой их настройки под различные проекты. 
Например, можно считать время проведенное на уровне, время между двумя ходами, время затраченное на один ход, также если есть время, то можно высчитать и скорость и расстояние при наличии необходимых данных. Можно привязать игровое время в [[Flurry]] и отправлять количество минут проведенных в той или другой локации и т.д. 
Предположим, есть необходимость запустить таймер, для этого, с помощью какого-то объекта необходимо задать таймеру состояние '''run'''. 
Предварительно нужно настроить его в зависимости от того, в каком режиме нужно использовать его. 
Если нам необходимо поставить игру на паузу и нужно, чтобы таймер тоже стал на паузу, то нужно указать таймеру состояние '''pause'''. 
Чтобы продолжить игру нужно опять же указать ему состояние '''run'''. 
Если указать таймеру состояние '''beg''' или '''init''', то таймер сбросится в свое первоначальное значение. 
Чтобы оперировать значением таймера, необходимо сохранить его значение. Для этого ему нужно указать ключи: игра, уровень. А в нужный момент, когда нужно, чтобы таймер сохранил свое значение необходимо последовательно ему задать два состояния: сперва нужно поставить на паузу с помощью состояния '''pause''', а потом указать состояние '''save'''. В этом случае, таймер сохранит свое текущее значение в параметр, который образует ключ игра/уровень. 
Если указать таймеру состояние '''fast''', то он должен начать идти быстрее с коэффициентом ускорения указанным в соответствующем поле. (это бывает необходимо в тех случаях, когда игрок делает подряд необдуманные ходы и нужно показать ему, что нельзя наугад делать ходы, наказать игрока) 
Состояниями '''add''' либо '''del''' можно поощрять игрока за хорошую игру прибавлением времени к таймеру, или наказывать - вычитанием при беспорядочных кликах и т.д.

[[Файл:Timer11.jpg|1000px]]

Результат вьювера:

[[Файл:Timer21.jpg|600px]]

'''Проект с таймером и демонстрацией его состояний можно посмотреть: s:\!MOBILE\!!!EditorGames\Wiki_sample\'''

[[Category:Main objects]]

Isomover

2017-11-09T15:52:55Z

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

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

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

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

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

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

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

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

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

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

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

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

===Пример===
Два изомувера (police_car и werewolf) совершают циклическое движение по определенному маршруту, заданному с помощью машин состояний (car_machine и werewolf_machine соответственно). Когда объекты оказываются в радиусе (достаточном для активации добавляемого параметра '''"Взаимодействие с другими объектами"'''), объект '''police_car''' начинает взаимодействовать с объектом '''werewolf'''. По истечению времени воздействия объект '''police_car''' переходит в состояние '''fail'''. Если кликнуть на процесс взаимодействия объектов, то объект '''police_car''' перейдет в состояние '''win'''.
*'''Пример:
S:\!MOBILE\!!!EditorGames\Wiki_sample\Isomap.rar

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

Isomover

2017-11-09T12:43:20Z

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

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

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

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

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

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

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

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

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

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

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

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

===Пример===
Два изомувера (police_car и werewolf) совершают циклическое движение по определенному маршруту, заданному с помощью машин состояний (car_machine и werewolf_machine соответственно). Когда объекты оказываются в радиусе (достаточном для активации добавляемого параметра '''"Взаимодействие с другими объектами"'''), объект '''police_car''' начинает взаимодействовать с объектом '''werewolf'''. По истечению времени воздействия объект '''police_car''' переходит в состояние '''fail'''. Если кликнуть на процесс взаимодействия объектов, то объект '''police_car''' перейдет в состояние '''win'''.
*'''Пример:
S:\!MOBILE\!!!EditorGames\Wiki_sample\Isomap.rar

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

Timer

2017-11-09T12:39:47Z

Vgolob:

{{TOC right}}
== Общие сведения ==

Данный [[Object|объект]] предназначен для различных действий в игре связанных со временем. Например: длительность игры на каком-то из уровней, время между ходами и т.д. Он может использоваться в качестве таймера (время отнимается) и секундомера (время наращивается).

Таймер может управляться такими игровыми объектами как [[HiddenList]], а также другими игровыми объектами которые смогут передавать ему различные состояния.

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

[[Файл:Timer 01.jpg|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''z''' - параметр порядка рисования объекта. Сначала рисуются объекты с большим z, а под ними с меньшим
* '''память''' - если 1 - не обновляет свои параметры при последующем открытии экрана, 0 - обновляет . '''Если таймер подвязан к опциям''' и включена память, то таймер не будет перевычитывать значение из опций после получения состояний '''init''', '''run'''
* '''cостояние''' - начальное состояние таймера:
** '''beg''' - начальное состояние (таймер не идет)
** '''run''' - запуск таймера
** '''fast''' - таймер работает с ускорением( кооф. ускорения задаем в "ускорение" )
** '''pause''' - таймер перходит в состояние паузы. (снять с паузы состоянием - run, fast)
** '''add''' - добавление времени к таймеру
** '''del''' - отнимание времен из таймера
** '''end''' - конечное состояние таймера
** '''stop''' - останавливает таймер, если потом он будет запущен снова, то пойдет с нуля
** '''save''' - записывает текущее значение в опции под именем, указанным в ключе (игра, уровень)
* '''отладка''' - отображать в окне состояний текущий объект
* '''значение''' - начальное значение таймера в ms
* '''дельта''' - используется в состояниях add и del, количество времени которое будет добавлено или удалено из таймера (время в секундах)
* '''обратный ход''' - если "0" объект "таймер" работает, как секундомер (время увеличивается), если "1", то работает как таймер (время отнимается)
* '''отображать дни''' - параметр days (количество дней), необходим для настройки отображения таймера. Настраивается во "внешний вид".
* '''прогресс''' - прогрессбар, отображающий то же, что и таймер
* '''графика'''
** '''res''' - основной графический ресурс для таймера, в качестве графического ресурса подгружается анимация из 10 фреймов, на которых изображены числа от 0 до 9
** '''цифры нормальные''' - поле куда добавляется анимация цифр в нормальном виде (не обязательно заполнять, если таймер будет использоваться в одном режиме)
** '''цифры окончания''' - анимация цифр, которая будут показываться в том случае, когда время таймера будет истекать
** '''цифры при добавлении''' - анимация цифр, которая будет показываться в том случае, когда к таймеру было добавлено время
** '''цифры при удалении''' - анимация цифр, которая будет показываться в том случае, когда от таймера было отнято время
** '''двоеточие нормальное''' - графика двоеточия, которое разделяет секунды, минуты, подгражается обычный графический ресурс двоеточия
** '''двоеточие окончания''' - графика двоеточия, которое показывается в случае, когда у таймера истекает время
** '''двоеточие при добавлении''' - графика двоеточия, будет использовать при прибавлении время к таймеру
** '''двоеточие при удалении''' - графика двоеточия, будет использовать при удалении время от таймера
* '''шрифт'''
** '''имя''' - номер шрифта - целое число, начиная с 0 (порядковый номер шрифта), а если -1 то рисовать каунтер клипами
** '''размер''' - размер шрифта в пикселях
** '''цвет 1''' - цвет текста
* '''внешний вид'''
** '''дни''' - 0 - прятать, 1 - отображать, 2 - отображать всегда два разряда, 3 - отображать, когда дней больше, чем в days, 4 - отображать только дни, когда дней больше, чем в days
** '''часы''' - 0 - прятать, 1 - отображать, 2 - если время больше одного часа - отображать дни и часы, если время меньше одного часа - отображать минуты и секунды
** '''минуты''' - 0 - прятать, 1 - отображать
** '''секунды''' - 0 - прятать, 1 - отображать
** '''dx''' - сдвинуть все относительно подложки вдоль х
** '''dy''' - сдвинуть все относительно подложки вдоль y
** '''dx между цифрами''' - расстояние между цифрами внутри разряда, между hh или mm
** '''dx от ":"''' - расстояние между разрядами и клипом двоеточия (справа и слева от него)
** '''разделитель после дней''' - символ, который отображается после разряда дней. Если указан, двоеточие после разряда дней не отображается. Перетаскивается из текстового редактора
** '''разделитель после часов''' - символ, который отображается после разряда часов. Если указан, двоеточие после разряда часов не отображается. Перетаскивается из текстового редактора
** '''разделитель после минут''' - символ, который отображается после разряда минут. Если указан, двоеточие после разряда минут не отображается. Перетаскивается из текстового редактора
** '''разделитель после секунд''' - символ, который отображается после разряда секунд. Если указан, двоеточие после разряда секунд не отображается. Перетаскивается из текстового редактора
** '''ускорение''' - коэффициент ускорения, когда таймер находится в состоянии fast
** '''сохранять в профиль''' - если "0" - то не сохраняет значение в профиль, а значит значение будет глобальным
** '''игра''' - ключ (параметр), совместно с параметром '''уровень''' образует переменную, с помощью которой можно управлять таймерому
** '''уровень''' - совместно с параметром '''игра''' образует переменную, с помощью которой можно управлять таймером (Строит заметить, что при переходе объекта в состояние init - он автоматически считывает значение, записанное по адресу игра.уровень в [[Options|Options]]. При этом таймер не имеет состояния read, как [[Counter|Counter]])
* '''Время истекло: изменить состояние объекта''' - если достигнет нуля, то есть используется, как таймер, он изменит состояние какого-то объекта
* '''Время истекло: изменить параметр (свойство) объекта''' - если достигнет нуля, то есть используется, как таймер, он изменит параметр какого-то объекта

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

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

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

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

== Основные состояние ==

Следует помнить следующие основные состояния: '''run''', '''beg''', '''pause''', '''save''', '''stop''', '''fast''','''add''','''del'''. Эти состояния используется чаще всего. 
Состояния таймеру мы можем передавать с помощью любого игрового объекта который может менять состояние другому объекту. 
*'''run''' - состояние которое передаем таймеру для его запуска(если таймер был на паузе то снимет с нее) ( таймер подвязанный к опциям схватит время из опций, если не стоит память) 
*'''start''' - состояние которое передаем таймеру для его запуска(если таймер был на паузе то сбросит его и запустит заново) 
*'''pause''','''stop''' - состояние которое передаем таймеру для его остановки 
*'''save''' - если заполнены поля "игра и уровень" то таймер запишет свое значение в [[Options]] 
*'''fast''' - состояние ускоренного хода таймера, ускорение определяется параметром ускорение в настройках таймера, или можно передавать параметром(fast) с помощью другого объекта. 
*'''add''' - состояние добавления времени к таймеру, добавляемое время определяется параметром дельта в настройках таймера, или можно передать параметром(delta) с помощью другого объекта. 
*'''del''' - состояние вычитания времени из таймера, вычитаемое время определяется параметром дельта в настройках таймера, или можно передать параметром(delta) с помощью другого объекта. 
*'''value''' - состояние при котором таймер в своё поле "value" запишет текущее значение в мсек. (Если вызвать до инита объекта, может записать "левое число").

== Примеры применений ==
Благодаря разнообразию состояний таймера есть возможность гибкой их настройки под различные проекты. 
Например, можно считать время проведенное на уровне, время между двумя ходами, время затраченное на один ход, также если есть время, то можно высчитать и скорость и расстояние при наличии необходимых данных. Можно привязать игровое время в [[Flurry]] и отправлять количество минут проведенных в той или другой локации и т.д. 
Предположим, есть необходимость запустить таймер, для этого, с помощью какого-то объекта необходимо задать таймеру состояние '''run'''. 
Предварительно нужно настроить его в зависимости от того, в каком режиме нужно использовать его. 
Если нам необходимо поставить игру на паузу и нужно, чтобы таймер тоже стал на паузу, то нужно указать таймеру состояние '''pause'''. 
Чтобы продолжить игру нужно опять же указать ему состояние '''run'''. 
Если указать таймеру состояние '''beg''' или '''init''', то таймер сбросится в свое первоначальное значение. 
Чтобы оперировать значением таймера, необходимо сохранить его значение. Для этого ему нужно указать ключи: игра, уровень. А в нужный момент, когда нужно, чтобы таймер сохранил свое значение необходимо последовательно ему задать два состояния: сперва нужно поставить на паузу с помощью состояния '''pause''', а потом указать состояние '''save'''. В этом случае, таймер сохранит свое текущее значение в параметр, который образует ключ игра/уровень. 
Если указать таймеру состояние '''fast''', то он должен начать идти быстрее с коэффициентом ускорения указанным в соответствующем поле. (это бывает необходимо в тех случаях, когда игрок делает подряд необдуманные ходы и нужно показать ему, что нельзя наугад делать ходы, наказать игрока) 
Состояниями '''add''' либо '''del''' можно поощрять игрока за хорошую игру прибавлением времени к таймеру, или наказывать - вычитанием при беспорядочных кликах и т.д.

[[Файл:Timer11.jpg|1000px]]

Результат вьювера:

[[Файл:Timer21.jpg|600px]]

'''Проект с таймером и демонстрацией его состояний можно посмотреть: s:\!MOBILE\!!!EditorGames\Wiki_sample\'''

[[Category:Main objects]]