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

Wordsearch

2020-10-07T14:04:06Z

Astepin: /* Шаблон ячейки */

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.
*'''сброс выделения''' - автоматически ли снимать выделения после MouseUp
*'''очки за незагаданные слова''' - начислять ли очки за незагаданные слова в режиме Разбора
*'''подсвещать букву''' - подсвещать ли случайную ячейку каждого слова в режиме Разбора

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.
*'''автохинт исчезновение''' - после указанного времени скрывается автохинт (мс)
*'''между выделением букв (autocomplete)''' - с заданной паузой открываются буквы при autocomplete(мс)
*'''между выделением слов (autocomplete)''' - с заданной паузой открываются слова при autocomplete(мс)
*'''длительность ожидания выделения''' - длительность ожидания выделения (мс) после которой вызовется обработчик add_wait_over. Функционал отключен при значении -1

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле
*'''ожидание выделения закончилось''' - изменить состояние объекта когда ожидание выделения завершилось
*'''повторный выбор слова из словаря''' - изменить состояние объекта когда повторно выбрано слово из словаря
*'''неправильно найденое слово''' - изменить состояние объекта когда неправильным путем выбрано правильное слово
*'''найдено незагаданное слово''' - изменить состояние объекта когда найдено незагаданное слово из словаря

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле
*''hint_letter'' - вызов побуквенного хинта для текущего режима
*''next_level'' - переход к следующему уровню
*''game_after_lose'' - доигрывание после проигрыша с добавлением времени
*''shuffle'' - перемешивание
*''swap" desc'' - обмен буквами между 2мя ячейками
*''swap_fly"'' - перелет при обмене буквами между 2мя ячейками
*''win_1" desc="поле разобрано в режиме игры 1 (разбор)
*''refill"'' - перезаполнить поле буквами
*''highlight_first'' - в этом состоянии все буквы, кроме первых для каждого слова перейдут в состояние remove. Первые буквы каждого слова перейдут в состояние highlight
*''autocomplete'' - состояние автозаполнения
*''sel_clr'' - снять выделение
*''sel_clr_next'' - снять выделение со следующего хода (начать строить новую последовательность)
*''start_in_place'' - особое состояние старта (буквы не осыпаются сверху, а появляются уже на своих местах)

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]

*Для работы шаблона нужно обязательно указать в состоянии set для параметра var "cell_size" ваш объект wordsearch, которому и задаются размеры ячейки.
[[Файл:Wordsearch obj.png]]

Wordsearch

2020-10-07T13:10:22Z

Astepin: /* Шаблон ячейки */

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.
*'''сброс выделения''' - автоматически ли снимать выделения после MouseUp
*'''очки за незагаданные слова''' - начислять ли очки за незагаданные слова в режиме Разбора
*'''подсвещать букву''' - подсвещать ли случайную ячейку каждого слова в режиме Разбора

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.
*'''автохинт исчезновение''' - после указанного времени скрывается автохинт (мс)
*'''между выделением букв (autocomplete)''' - с заданной паузой открываются буквы при autocomplete(мс)
*'''между выделением слов (autocomplete)''' - с заданной паузой открываются слова при autocomplete(мс)
*'''длительность ожидания выделения''' - длительность ожидания выделения (мс) после которой вызовется обработчик add_wait_over. Функционал отключен при значении -1

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле
*'''ожидание выделения закончилось''' - изменить состояние объекта когда ожидание выделения завершилось
*'''повторный выбор слова из словаря''' - изменить состояние объекта когда повторно выбрано слово из словаря
*'''неправильно найденое слово''' - изменить состояние объекта когда неправильным путем выбрано правильное слово
*'''найдено незагаданное слово''' - изменить состояние объекта когда найдено незагаданное слово из словаря

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле
*''hint_letter'' - вызов побуквенного хинта для текущего режима
*''next_level'' - переход к следующему уровню
*''game_after_lose'' - доигрывание после проигрыша с добавлением времени
*''shuffle'' - перемешивание
*''swap" desc'' - обмен буквами между 2мя ячейками
*''swap_fly"'' - перелет при обмене буквами между 2мя ячейками
*''win_1" desc="поле разобрано в режиме игры 1 (разбор)
*''refill"'' - перезаполнить поле буквами
*''highlight_first'' - в этом состоянии все буквы, кроме первых для каждого слова перейдут в состояние remove. Первые буквы каждого слова перейдут в состояние highlight
*''autocomplete'' - состояние автозаполнения
*''sel_clr'' - снять выделение
*''sel_clr_next'' - снять выделение со следующего хода (начать строить новую последовательность)
*''start_in_place'' - особое состояние старта (буквы не осыпаются сверху, а появляются уже на своих местах)

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]

*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - ваш объект wordsearch, которому и задаются размеры ячейки.
[[Файл:Wordsearch obj.png]]

Wordsearch

2020-10-07T13:09:48Z

Astepin: /* Шаблон ячейки */

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.
*'''сброс выделения''' - автоматически ли снимать выделения после MouseUp
*'''очки за незагаданные слова''' - начислять ли очки за незагаданные слова в режиме Разбора
*'''подсвещать букву''' - подсвещать ли случайную ячейку каждого слова в режиме Разбора

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.
*'''автохинт исчезновение''' - после указанного времени скрывается автохинт (мс)
*'''между выделением букв (autocomplete)''' - с заданной паузой открываются буквы при autocomplete(мс)
*'''между выделением слов (autocomplete)''' - с заданной паузой открываются слова при autocomplete(мс)
*'''длительность ожидания выделения''' - длительность ожидания выделения (мс) после которой вызовется обработчик add_wait_over. Функционал отключен при значении -1

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле
*'''ожидание выделения закончилось''' - изменить состояние объекта когда ожидание выделения завершилось
*'''повторный выбор слова из словаря''' - изменить состояние объекта когда повторно выбрано слово из словаря
*'''неправильно найденое слово''' - изменить состояние объекта когда неправильным путем выбрано правильное слово
*'''найдено незагаданное слово''' - изменить состояние объекта когда найдено незагаданное слово из словаря

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле
*''hint_letter'' - вызов побуквенного хинта для текущего режима
*''next_level'' - переход к следующему уровню
*''game_after_lose'' - доигрывание после проигрыша с добавлением времени
*''shuffle'' - перемешивание
*''swap" desc'' - обмен буквами между 2мя ячейками
*''swap_fly"'' - перелет при обмене буквами между 2мя ячейками
*''win_1" desc="поле разобрано в режиме игры 1 (разбор)
*''refill"'' - перезаполнить поле буквами
*''highlight_first'' - в этом состоянии все буквы, кроме первых для каждого слова перейдут в состояние remove. Первые буквы каждого слова перейдут в состояние highlight
*''autocomplete'' - состояние автозаполнения
*''sel_clr'' - снять выделение
*''sel_clr_next'' - снять выделение со следующего хода (начать строить новую последовательность)
*''start_in_place'' - особое состояние старта (буквы не осыпаются сверху, а появляются уже на своих местах)

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]

*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - ваш объект wordsearch, которому и задаются размеры ячейки. [[Файл:Wordsearch obj.png]]

Файл:Wordsearch obj.png

2020-10-07T13:08:49Z

Astepin: Настройка шаблона

Настройка шаблона

Wordsearch

2020-10-07T13:05:29Z

Astepin: Актуализация параметров и состояний

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.
*'''сброс выделения''' - автоматически ли снимать выделения после MouseUp
*'''очки за незагаданные слова''' - начислять ли очки за незагаданные слова в режиме Разбора
*'''подсвещать букву''' - подсвещать ли случайную ячейку каждого слова в режиме Разбора

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.
*'''автохинт исчезновение''' - после указанного времени скрывается автохинт (мс)
*'''между выделением букв (autocomplete)''' - с заданной паузой открываются буквы при autocomplete(мс)
*'''между выделением слов (autocomplete)''' - с заданной паузой открываются слова при autocomplete(мс)
*'''длительность ожидания выделения''' - длительность ожидания выделения (мс) после которой вызовется обработчик add_wait_over. Функционал отключен при значении -1

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле
*'''ожидание выделения закончилось''' - изменить состояние объекта когда ожидание выделения завершилось
*'''повторный выбор слова из словаря''' - изменить состояние объекта когда повторно выбрано слово из словаря
*'''неправильно найденое слово''' - изменить состояние объекта когда неправильным путем выбрано правильное слово
*'''найдено незагаданное слово''' - изменить состояние объекта когда найдено незагаданное слово из словаря

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле
*''hint_letter'' - вызов побуквенного хинта для текущего режима
*''next_level'' - переход к следующему уровню
*''game_after_lose'' - доигрывание после проигрыша с добавлением времени
*''shuffle'' - перемешивание
*''swap" desc'' - обмен буквами между 2мя ячейками
*''swap_fly"'' - перелет при обмене буквами между 2мя ячейками
*''win_1" desc="поле разобрано в режиме игры 1 (разбор)
*''refill"'' - перезаполнить поле буквами
*''highlight_first'' - в этом состоянии все буквы, кроме первых для каждого слова перейдут в состояние remove. Первые буквы каждого слова перейдут в состояние highlight
*''autocomplete'' - состояние автозаполнения
*''sel_clr'' - снять выделение
*''sel_clr_next'' - снять выделение со следующего хода (начать строить новую последовательность)
*''start_in_place'' - особое состояние старта (буквы не осыпаются сверху, а появляются уже на своих местах)

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]
*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - объект wordsearch, которому и задаются размеры ячейки.

Wordsearch

2020-10-07T12:33:44Z

Astepin: /* Времена */ актуализация

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.
*'''сброс выделения''' - автоматически ли снимать выделения после MouseUp
*'''очки за незагаданные слова''' - начислять ли очки за незагаданные слова в режиме Разбора
*'''подсвещать букву''' - подсвещать ли случайную ячейку каждого слова в режиме Разбора

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.
*'''автохинт исчезновение''' - после указанного времени скрывается автохинт (мс)
*'''между выделением букв (autocomplete)''' - с заданной паузой открываются буквы при autocomplete(мс)
*'''между выделением слов (autocomplete)''' - с заданной паузой открываются слова при autocomplete(мс)
*'''длительность ожидания выделения''' - длительность ожидания выделения (мс) после которой вызовется обработчик add_wait_over. Функционал отключен при значении -1

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик.
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]
*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - объект wordsearch, которому и задаются размеры ячейки.

Wordsearch

2020-10-07T11:47:53Z

Astepin: /* Правила игры */

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.
*'''сброс выделения''' - автоматически ли снимать выделения после MouseUp
*'''очки за незагаданные слова''' - начислять ли очки за незагаданные слова в режиме Разбора
*'''подсвещать букву''' - подсвещать ли случайную ячейку каждого слова в режиме Разбора

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик.
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]
*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - объект wordsearch, которому и задаются размеры ячейки.

Wordsearch

2020-10-07T10:59:21Z

Astepin: уточнение (актуализация ) и исправление орфографических ошибок

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим аркада (с досыпанием).

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик.
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]
*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - объект wordsearch, которому и задаются размеры ячейки.

Wordsearch

2020-10-07T10:56:27Z

Astepin: /* Добавляемые свойства */

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим с досыпанием.

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик.
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опустился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле

=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]
*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - объект wordsearch, которому и задаются размеры ячейки.

Wordsearch

2020-10-07T10:55:32Z

Astepin: /* Шаблон ячейки */

{{TOC right}}
[[Файл:Words example.jpg|300px|thumb|Пример игрового интерфейса]] 
[[Object|Объект]] '''Wordsearch''' дает возможность организовать ряд игр поиска слов на поле в виде сетки. Игра на данный момент имеет два настраиваемых режима: режим разбора поля и режим с досыпанием.

=Словарь=
*'''Ссылка на словарь''' - ссылка на файл словаря. Словарь должен быть в формате json.
*'''Язык''' - язык слов. На данный момент доступно 5 языков: русский, английский, французский, немецкий, испанский.

''Пример словаря:'' 
<code>[["АГА", "АКР", "АКТ", "АРТ"], ["АВВА", "АВТО", "АЖУР", "АЗОТ", "АИСТ"], ["АББАТ", "АБВЕР", "АБЗАЦ", "АБОРТ", "АБРЕК", "АБРИС"]]</code>

=Уровни=
*'''Ссылка на файл уровней''' - для каждого уровня должен быть свой файл, поэтому в этом поле указывается имя файла (например: lvl/level.txt), к которому в последствии будет прибавлен номер уровня. Т.е. в папке 'lvl' будут лежать файлы level0.txt, level1.txt и т.д. Если это поле не заполнено, то настройки будут браться по умолчанию из полей ниже. 
Файлы уровней удобней править в специальной утилите.
*'''Номер''' - номер уровня. Передается параметром перед инициализацией.

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

=Ячейка сетки=
*'''размер ячейки''' - размер ячейки в пикселях. Размер поля формируется как сумма размеров ячеек и отступов между ними. Поэтому заранее установить фиксированный размер не получится
*'''отступ между ячейками''' - отступ между ячейками
*'''размер буквы относительно ячейки''' - размер буквы, помещаемой в ячейку. Измеряется от 0 до 1
*'''графика ячейки''' - графика ячейки это анимация минимум из 5 кадров. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом
**'''прямоугольной''' - ссылка на графический ресурс (анимация) ячейки прямоугольной формы
**'''шестиугольной''' - ссылка на графический ресурс (анимация) ячейки шестиугольной формы
*'''графика блока ячейки''' - ссылка на графический ресурс, которым будет помечена залоченная ячейка. Ячейка может быть залоченной несколько раз. Этот ресурс помещается с левой стороны ячейки и с небольшим интервалом копируется столько раз сколько раз залочена ячейка. Не очень удобная реализация
*'''графика опадающей ячейки''' - ссылка на графический ресурс предмета, который нужно опустить вниз
*'''шаблон ячейки''' - машина, олицетворяющая собой ячейку, которая потом будет расклонирована. Нужна для создания всяких красивостей. Подробнее [[Wordsearch#Шаблон ячейки|тут]]
*'''ячейка без графики''' - в случае отсутствия графики для ячеек этими цветами они заливаются по умолчанию. 1 - графика в нормальном состоянии, 2 - графика выделенной ячейки, 3 - правильно отгаданное слово, 4 - неправильно отгаданное слово, 5 - слово выделенное хинтом

=Настройки сложности=
*'''длины слов''' - массив чисел через запятую, которые означают процентное соотношение слов разной длины. Например строка ''30,35,35'' означает, что слов с 3-я буквами будет 30%, слов с 4-я буквами 35% и с 5ю 35%
*'''ключевое слово''' - на поле размещается слово, по буквам которого формируются другие слова (начальные буквы слов)
*'''заполненность поля''' - процент заполненности поля словами. Работает только для досыпания. В режиме Разбора всегда 100% заполнено поле

=Таблица и хинты=
*'''таблица''' - ссылка на объект таблицы, в которую будут заносится слова
*'''доп. таблица''' - ссылка на дополнительную таблицу в случае если 2 игрока
*'''использование таблицы''' - настройки отображения слов. Такие режимы:
**Не показывать слова - слова не будут отображаться в таблице
**Показывать только найденные слова (по нахождению заносить а таблицу) - актуально для режима Аркады. Заносить в таблицу правильно найденные слова
**Показывать искомые слова в таблице (по нахождению отмечать) - актуально для Разбора. Слова уже находятся в таблице, а по нахождению зачеркиваются
**Показывать искомые слова в таблице (по нахождению удалять) -актуально для Разбора. Слова уже находятся в таблице, а по нахождению удаляются
*'''графика отметки''' - отмечает графикой найденное слово в таблице

=Правила игры=
*'''режим игры''' - выбор режима игры. На данный момент есть 2 режима: аркада (с досыпанием) и разбор
*'''диагональные соединения''' - возможность выделять ячейки по диагонали
*'''несмежные соединения''' - возможность выделять несмежные ячейки
*'''условия окончания''' - условия при которых игра закончится. На момент написания есть 2 условия окончания: на время (есть фиксированное время за которое нужно успеть), на разблокировку (игра закончится, когда будут разблокированы все ячейки)
*'''досыпание''' - досыпать или не досыпать ячейки при удалении слова
*'''автоудаление''' - автоматически удалять слово при нахождении.

=Времена=
*'''опадание''' - время, за которое ячейки упадут на свои места при старте игры. Т.е. заполнится поле. Реализация опадания такова, что фактически из этого времени возьмется только 0.65 (если в настройках стоит 1000мс, то падать будут 650мс). Поэтому этот факт важно учитывать
*'''досыпание''' - время, за которое досыпятся ячейки в случае удаления найденного слова
*'''задержка перед досыпом''' - задержка перед досыпанием для показа различных красивостей удаления. Нужно в связке с шаблоном ячейки
*'''перемешивания''' - время за которое ячейки переместятся на свои позиции при использовании перемешивания (''shuffle'')
*'''swap''' - время, за которое 2 ячейки поменяются местами при использовании ''swap''
*'''уровень''' - количество секунд на уровень. По истечению времени наступает проигрыш по времени
*'''после проигрыша''' - это количество секунд добавляется после проигрыша при вызове состояния ''game_after_lose''
*'''автохинт''' - время бездействия игрока, по истечению которого начинают подсвечиваться правильные слова.

=Перемешивание=
Настройки перемешивания ячеек
*'''номер easing-а''' - номер изинга, который берем для красивостей движения ячеек при перемешивании. Мне нравится 6 номер. Какие есть изинги можно найти [[Animation#Easing|тут]].
{| class="article-table mw-collapsible mw-collapsed" "
!Изинги
|-
| 1 || QUAD_IN_EASING
|-
| 2 || QUAD_OUT_EASING
|-
| 3 || QUAD_INOUT_EASING
|-
| 4 || BACK_IN_EASING
|-
| 5 || BACK_OUT_EASING
|-
| 6 || BACK_INOUT_EASING
|-
| 7 || SINE_IN_EASING
|-
| 8 || SINE_OUT_EASING
|-
| 9 || SINE_INOUT_EASING
|-
| 10 || CUBIC_IN_EASING
|-
| 11 || CUBIC_OUT_EASING
|-
| 12 || CUBIC_INOUT_EASING
|-
| 13 || QUART_IN_EASING
|-
| 14 || QUART_OUT_EASING
|-
| 15 || QUART_INOUT_EASING
|-
| 16 || QUINT_IN_EASING
|-
| 17 || QUINT_OUT_EASING
|-
| 18 || QUINT_INOUT_EASING
|-
| 19 || EXPO_IN_EASING
|-
| 20 || EXPO_OUT_EASING
|-
| 21 || EXPO_INOUT_EASING
|-
| 22 || ELASTIC_IN_EASING
|-
| 23 || ELASTIC_OUT_EASING
|-
| 24 || ELASTIC_INOUT_EASING
|-
| 25 || BOUNCE_IN_EASING
|-
| 26 || BOUNCE_OUT_EASING
|-
| 27 || BOUNCE_INOUT_EASING
|-
| 28 || CIRC_IN_EASING
|-
| 29 || CIRC_OUT_EASING
|-
| 30 || CIRC_INOUT_EASING
|}

*'''deltha''' - разброс по времени между стартом перемещения ячеек

=Звуки=
Для различных игровых действий можно вставлять звуки. Список доступных действий:
*'''выбор ячейки'''
*'''неверный выбор слова'''
*'''найдено слово'''
*'''хинт'''
*'''перемешивание'''
*'''swap'''

=Шрифты=
В этом разделе настраиваются шрифты для отображения букв на поле в случае если не указан шаблон ячейки. В нем почему-то всего 3 настройки: шрифт невыделенной ячейки, шрифт выделенной ячейки и шрифт правильно выделенной ячейки.

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

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

=Добавляемые свойства=
Тут в основном находятся обработчики различных игровых событий
*'''игра окончена - закончилось время''' - в случае игры на время этот обработчик сработает, если время закончилось
*'''победа в режиме Разбора''' - все слова на поле в режиме разбора найдены
*'''если хинт не находит слово в режиме Аркада''' - обработчик сработает, если после нажатия хинта не удалось найти на поле слово. В этом случае есть смысл вызвать состояние 'shuffle'
*'''на поле не осталось залоченных ячеек''' - все залоченные ячейки разлочены
*'''на поле не осталось опадающих предметов''' - в случае если на поле кроме букв есть еще другие предметы (в рамках механики "опусти предмет вниз"), то этот обработчик сработает, когда все ячейки с такими предметами будут опущены вниз и выведены с игрового поля
*'''найдено слово''' - сработает, когда правильно нашли слово
*'''хинт успешно сработает''' - после вызова состояния 'hint' если есть что подсвечивать, то вызовется этот обработчик.
*'''хинт невозможен''' - после вызова состояния 'hint' если нечего подсвечивать, то вызовется этот обработчик.
*'''ячейка разлочена''' - реакция на разлочку ячейки
*'''падающий предмет достиг нижней строки''' - один из предметов опцстился вниз
*'''добавить цвет отгаданной ячейки''' - это дополнительные цвета для окраски правильно отгаданных слов для того, чтобы отгаданные слова не сливались и их можно было различить на поле
=Состояния=
*''init'' - объект подтягивает все заданные параметры, но отрисовка поля не происходит
*''start'' - отрисовка поля, старт таймера
*''game'' - вызывается механикой после start и в остальных необходимых случаях. Например после успеха вызова состояния ''hint''
*''pause'' - поле прячется, таймер становится на паузу
*''resume'' - поле появляется, таймер продолжает время
*''shuffle'' - перемешивания букв на поле
*''swap'' - перестановка двух букв местами
*''game_after_lose'' - доигрывание с добавлением N секунд, где N параметр из вкладки Времена
*''next_level'' - запуск следующего уровня
*''hint'' - подсветка правильного слова на поле

=Шаблон ячейки=
Отдельного описания заслуживает шаблон ячейки.
Чтобы ячейки в игре красиво анимировались существует шаблон ячейки. Это машина состояний, которую объект wordsearch клонирует и помещает в нужную ячейку сетки поля, вызывает ей соответствующее состояние и записывает ей ряд параметров.
Состояния, которые обязательно должны быть в шаблоне ячейки:
*''init'' - в это состояние объект машинку не переводит, но в этом состоянии она будет находится сразу после клонирования, поэтому тут можно задать какие-то начальные значения параметров, например альфу, скейл и т.д.
*''set'' - в это состояние wordsearch переводит шаблон после клонирования. В этом состоянии устанавливаются такие параметры как графика подложки ячейки, буква, вес буквы, иконка перемещаемого предмета. Чтобы была возможность установить эти параметры подобъектам шаблона ячейки, то в него все эти параметры записываются.
Параметры:
**''ico_bg'' - id графики подложки ячейки. Это та анимация, которая указана в параметрах "графика ячейки".
**''char'' - буква, которую положим в текстовый объект
**''weight'' - вес буквы. Его сложим в каунтер. Желательно сделать проверку на отличие от нуля и в зависимости от этого показывать каунтер или нет
**''item_ico'' - id графики перемещаемого вниз предмета. Если -1, то предмета нет
*''normal'' - ячейка в нормальном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать нулевой кадр анимации графики ячейки
*''selected'' - ячейка в выделенном состоянии. В этом состоянии можно перекрасить шрифт буквы, перекрасить счетчик с весом буквы, указать 1й кадр анимации графики ячейки. Также можно сделать простую анимацию в виде пошатывания или скейла.
*''true'' - ячейка в состоянии правильно отгаданного слова. Можно поменять цвета шрифтов. Для того чтобы перекрашивать правильно выделенную ячейку в разные цвета в шаблон передается параметр ''ico_num''. Этот параметр отвечает за номер кадра анимации. Т.е. в нашей графике ячейки может быть не 5 кадров, а больше. Все что после первых 5-и кадров - это дополнительные цвета для правильно выделенной ячейки. Если таких цветов нет, то номер кадра будет 2. ВАЖНО! Количества дополнительных кадров должно быть не меньше чем количество дополнительных цветов в добавляемых параметрах wordsearch.
*''false'' - ячейка в состоянии неправильного выделения. Можно перекрасить шрифты, проанимировать. Поменять кадр графики на номер 3.
*''hint'' - ячейка в состоянии подсветки хинтом. Можно менять цвета, анимировать. Номер кадра 4
*''shuffle'' - ячейка в состоянии перемещения. Перед попаданием в это состояние wordsearch переводит ее в состояние ''set''
*''swap'' - ячейка в состоянии свапа.
*''remove'' - ячейка находится в состоянии удаления после правильного нахождения слова. В этом состоянии можно проанимировать схлопывание и перевести самостоятельно в состояние ''destroy''
*''destroy'' - в этом состоянии у ячейки

Шаблон ячейки должен содержать минимум такие объекты как:
# картинка или машинка для отображения подложки ячейки
# текстовый объект для отображения буквы
# счетчик для отображения веса буквы
# картинка или машинка для отображения предмета, который нужно переместить вниз

Пример машинки шаблона [[Файл:Item cell words.zip]]
*Для работы шаблона нужно обязательно указать в состоянии set для параметра var(5) - объект wordsearch, которому и задаются размеры ячейки.

Collapse

2020-10-05T07:39:58Z

Astepin: /* Создание простейшего коллапса (классика) */

[[Object|Объект]] «Collapse» дает возможность организовать ряд игр, основанных на 3х "модах". 
Все эти механики являются играми на поле, основой, которого является регулярная решетка. Игра происходит при помощи фишек, расположенных в ячейках поля. 

[[Файл:27-12-2013 14-15-18.png|150px|thumb|right]]
[[Файл:27-12-2013 16-18-35.png|250px|thumb|right]]

=Свойства=
'''Общие параметры'''
*'''Слушатель''' - Объект типа matchbattle.
*'''Время партии''' - Время игры. По окончанию которого будет засчитано поражение.

=Перегруженные правила=
*'''Типов фишек''' - Число разновидностей типов фишек.
*'''Номер в фишках'''(''numTokenNums'') - Число номеров в фишках которые (для текущего уровня). Включая статические.
*'''макс. номеров в фишках'''(''numTokenNumsMax'') - Максимальное число номеров в фишках. Включая статические.
*'''Номер бомбы''' - Номер фишки, который соответствует бомбе. Не будет генерироваться сам по себе.
*'''Номер крестобомбы''' - Номер фишки, который соответствует крестобомбе, не будет генерироваться сам по себе.
*'''Статический номер''' - Номер фишки, которую нельзя добавить к пометке. Используется, например, для игры, в которой необходимо спустить статические объекты вниз, очистив при этом поле.
*'''Типов узлов''' - Число разновидностей типов нормальных узлов графа.
*'''Условия пометки''' - Условия для вхождения фишек в пометку. 0 - любые фишки, 1 - должен совпадать номер, 2 - должен совпадать цвет, 3 - должен совпадать номер и цвет фишек.
*'''Монотонность''' - Должны ли номера в первой пометке быть монотонной последовательностью.
*'''Мин.пометка''' - Минимальное число фишек помечаемых в первой пометке.
*'''Макс.пометка''' - Максимальное число фишек помечаемых в первой пометке.
*'''Время пометки''' - Пометка завершается спустя заданное в этом поле время.
*'''Переставлять''' - Фишки первой пометки переставляются.
*'''Уменьшать''' - Фишки первой пометки уменьшают свой номер.
*'''Удалять''' - Удалять ячейки первой пометки.
*'''Условие удаления''' - Условия для удаления фишек: 0 - не удалять, 1 - должен совпадать тип, 2 - должен совпадать номер, 3 - должен совпадать тип ИЛИ номер, 4 - должен совпадать тип И номер.
*'''Тип удаления''' - Тип удаления. 0 - заливка, 1 - вертикальные и горизонтальные линии, 2 - только сама пометка.
*'''Мин.удаление''' - Минимальное число фишек, которое можно удалить.
*'''Генерация без мачей''' - При генерации поля избегать готовых совпадений.
*'''Проверка после осыпания''' - После осыпания фишек ещё раз перепроверить возможные комбинации ходов.
*'''Добавление'''(''needBirth'') - Нужно ли добавлять фишки на поле. Или игра на разбор; Можно перегрузить настройками уровня (результирующее значение будет в парамметре "needBirthLevel");
*'''Схлопывание'''(''needCollapse'') - Нужно ли схлопывание (Ликвидация пустых столбцов);Можно перегрузить настройками уровня;
*'''Менять тип узла''' - Увеличить ли тип нормальной ячейки, если над ней произошла трансформация фишек.
*'''Поддерживать число ходов''' - При осыпании фишек проверить поле на то, чтоб обязательно был возможный ход.
*'''Тащить фишку''' - Тащить первую фишку пометки за пальцем.
*'''Завершать пометку''' - Не ждать отпускания пальца для завершения пометки - актуально в тех случаях, когда в ней всегда одинаковое число фишек.
*'''Перемешивать при 0 ходов''' - если нет больше ходов на поле, да - поле перемешивать, нет - проигрыш.

=Перегруженные цели=
*'''Очистить поле''' - Уничтожить соотв. % фишек. Не стоит комбинировать с досыпанием.
*'''Перекрасить поле''' - Перекрасить все ячейки поля в базовый тип.
*'''Уронить статические''' - Уронить все статические фишки на дно поля.
*'''Уничтожить фишек''' - Уничтожить фишек, количество через запятую.

=Внешний вид=
*'''Картинка''' - Графический ресурс картинки пазла.
*'''Фишки''' - Не рекомендуется использовать. Заменено на добавляемые параметр, см.ниже.
*'''Ячейки''' - Графический ресурс ячейки.
*'''Курсор''' - Курсор для выделения фишек.
*'''Колонок''' - Число колонок на которые разбивается пазл.
*'''Строк''' - Число строк на которые разбивается пазл.
*'''Авторазмер''' - Если 1, то для расчета размера ячеек используется картинка. 0 - размер ячейки = размер паззла / число ячеек
*'''Сетка?''' - Если 1, то будет показана сетка при разрезке картинки на блоки. При 0 - сетки не будет.
*'''Счетчик статических''' - Счетчик статических. Объект типа каунтер.
*'''Прогресс статических''' - Прогресс-бар статических. Объект типа progress.
*'''стиль'''(''style'') - стиль фишек (перегрузка арта фишек; артом из файла уровня); Стиль указанный в настройках уровня перебьёт стиль объекта; Получается вот такой приоритет (Арт из объекта -> Стиль указанный в объекте -> Стиль указанный в уровне);
*'''анимация рождения'''(''dropBorn'') - тип рождения фишек объектом (скалирование/падение сверху), может быть перегруженно файлом уровня;
*'''бомбы''' - Прогресс-бар статических. Объект типа progress.

=Времена этапов=
*'''невидимости''' - Начальная пауза перед откртыием пазлы.
*'''открытия''' - Время открытия исходной картинки (проявляется по alpha).
*'''показа''' - Время показа исходной картинки (после проявления).
*'''перемешивания''' - Время визуализации процесса перемешивания ячеек.
*'''финала''' - Время финального показа пазлы после её разбора, перед переходом к закрытию.
*'''закрытия''' - Время закрытия пазлы (в состояниия close, исчезает по alpha).

=Времена игры=
*'''перестановки''' - Время перестановки двух ячеек местами при их выборе.
*'''движения''' - Время движения фишек от одного узла к соседнему.
*'''движения верх''' - Время движения фишек от одного узла к соседнему при отскоке.
*'''отскока''' - Время движения фишек вверх при отскоке. Т.о. при дефолтных значениях фишка отскакивает на 200 / 600 треть высоты фишки"
*'''рождения и удаления''' - Время рождения и удаления фишки.
*'''поворота''' - Время поворота ячейки при повторном клике на нее.
*'''паузы''' - Время паузы перед началом перестановки или поворота.
*'''подсказки1''' - Время за которое проявляется исходная картинка в состоянии hint.
*'''подсказки2''' - Время в течении которого показывается после проявления исходная картинка в состоянии hint.
*'''подсказки3''' - Время в течении которого закрывается после показа исходная картинка в состоянии hint.

=Хинт при бездействии=
*'''время задержки''' - Время бездействия, после которого следует показывать хинт.
*'''машина''' - Объект, который будет установлен между двумя фишками.

=Генерация поля=
*'''min размер кластера''' - min размер кластера из фишек одного типа
*'''max размер кластера''' - max размер кластера из фишек одного типа

=Звуки=
*'''нажатие на фишку''' - Звук нажатия на фишку.
*'''добавление фишки в выделение''' - Звук при выделении фишки (режим dots); звук воспроизводится с 2-й фишки.
*'''перемещение фишки''' - Звук перемещения фищки.
*'''возврат фишки''' - Звук возврата фищки при неудачном перемещении.
*'''падение фишки''' - Звук для падения фишки.
*'''применение крестовой бомбы'''(''sndcross'') - звук при применении крестовой бомбы;
*'''применение горизонтальной бомбы'''(''sndhor'') - звук при применении горизонтальной бомбы;
*'''применение вертикальной бомбы'''(''sndver'') - звук при применении вертикальной бомбы.

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

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

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

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

===[[Файл:+.png]] Изменить состояние объекта - клик на одиночную===
- изменить состояние объекта в случае клика на одиночную ячейку: открывает машину в которой необходимо объекту "Коллапс" установить состояние "del_last"

===[[Файл:+.png]] Изменить состояние объекта - запланирована новая линия в аркаде===
- изменить состояние объекта при старте отсчёта времени для генерации следующей линии в режиме Аркада (в объект пишется перечень фишек(nextLine), которые будут добавлены и время до их добавления (currentDt))

===[[Файл:+.png]] Звук фишки===
- Удаление, появление.

===[[Файл:+.png]] Уровень сложности===
- Номеров в фишках, Мин.размер кластера и Макс.размер кластера.

===[[Файл:+.png]] Графика фишки===
- Обычная: графический ресурс перетаскивается из редактора ресурсов.

===[[Файл:+.png]] Эффект===
- Объект, который будет вызываться при взрыве фишек. Должен иметь состояние beg.

===[[Файл:+.png]] Эффект бомбы===
- Объект, который при взрыве фишек посредством бонуса бомба(цветная или обычная) будет склонирован и будет передано состояние "beg".
Данному объекту будет записано параметры:
*'''effectOriginX,effectOriginY''' - координаты бонуса, который вызвал схлопывание(в координатах объекта); Эффект самой бомбы (которая взорвалась) получает координаты (0;0);
*'''additionalNum''' - номер фишки; (для удобства, бонусы смещены до 100 номера(первый бонус иммет номер 100(первая цветная бомба)));
П.С. данный эффект генерируется только при взрыве бомбы из поля (бонусы запущенные через matchbattle - не создают эффект);

===[[Файл:+.png]] Эффект крестобомбы===
- Эффект, который будет использоваться при взрыве крестобомбы. Должен иметь состояние beg.

=Состояния=
*'''beg''' - пауза перед open
*'''open''' - появляется по alpha-каналу
*'''start''' - запустить новую игру (объект применяет все данные из лейаута + из файла уровней);
*'''pause''' - поставить объект на паузу ("заморозить объект");
*'''resume''' - снять объект с паузы ("разморозить объект");

*'''sel1''' - ждем окончания первой пометки
*'''sel1_end''' - показываем окончание первой пометки
*'''sel1_transf1''' - первая трансформация первой пометки
*'''sel1_transf2''' - вторая трансформация первой пометки
*'''sel2''' - ждем окончания второй пометки
*'''sel2_end''' - показываем окончание второй пометки
*'''sel2_trands1''' - первая трансформация второй пометки
*'''sel2_trands2''' - вторая трансформация второй пометки

*'''born''' - рождение фишек
*'''move''' - перемещаем фишки
*'''aftermatch''' - проверяем, не случилось ли чего-то после движения/добавления фишек
*'''close''' - исчезает по alpha-каналу
*'''end''' - недоступна, невидима
*'''rotate_left''' - повернуть влево на 90 градусов
*'''rotate_right''' - повернуть вправо на 90 градусов
*'''undo''' - отменить один ход
*'''remove_color'''
*'''remove_single'''
*'''shuffle_cols'''
*'''remove_last''' - удалить последнюю кликнутую ячейку (покупное удаление одиночных)

=Нумерация фишек объектом=
Фишки которые использует объект, нумеруются от 0 до N. Данная нумерация зависит от количества цветов. Последовательность выглядит как:
*'''0''' - обычная цветная фишка (рандомного цвета - при запуске игры изменится на цветную фишку в диапазоне [1,numTokenNums])
*'''[1;n]''' - цветные фишки (n==numTokenNumsMax, максимальное количество цветов);
*'''[n+1;n+n]''' - цветные бомбы;
*'''n+n+1''' - обычная бомба;
*'''n+n+2''' - горизонтальная бомба;
*'''n+n+3''' - вертикальная бомба;
*'''n+n+4''' - крестовая бомба;
*'''n+n+5''' - ячейка-Хамелеон;

=Вычитаемые параметры=
*'''tokenStyle''' - перечень основных клипов для фишек ("," -разделитель;клипы фишек "norm");
*'''bombClips''' - перечень клипов бонусов (по порядку "нумерации фишек"; первый клип - первая цветная бомба);
*'''nextLine''' - перечень номеров фишек следующего ряда для режима Аркада ("," - разделитель; все номера бонусов смещены и начинаются с 100 (для удобства чтения); т.е. первая цветная бомба имеет номер 100, дальше по порядку);
*'''currentDt''' - время между генерациями следующего ряда(режим Аркада);
*'''chameleonColors''' - номера цветных фишек, используемых для ячейки-Хамелеон;
*'''level_cols''' - количество строчек поля текущего уровня;
*'''level_rows''' - количество колонок поля текущего уровня;
*'''lastMouseDnX,lastMouseDnY''' - координаты X,Y последнего нажатия мыши в координатах родительского объекта;
*'''goal_any''' - текущее значение цели - выбить N фишек;
*'''goal_lines''' - текущее значение цели - выжить N генераций линий(Аркада);
*'''goal_locks''' - текущее значение цели - убрать N замков;
*'''goal_num_%N%''' - текущее значение цели - выбить m фишек N-го цвета (%N% - номер цвета фишки (нумерация с 0));
*'''randomSize''' - размер "мешка" со случайными числами для досыпаний фишек. По умолчанию равен 100* на кол-во цветов фишек. Мешок генерируется в формате 0,1,2,0,1,2,0,1,2... затем перемешивается. Кастомный размер мешка не должен быть меньше, чем кол-во цветов фишек.
*'''randomShuffles''' - число перемешиваний "мешка" для досыпаний. По умолчанию число перемешиваний равно размеру "мешка" (т.е. проходимся по каждой фишке и меняем ее с рандомной). Если кол-во перемешиваний меньше размера мешка, то игра усложнится (подсыпания приблизятся к последовательности 0,1,2,0,1,2... и будет сложнее матчить. Если кол-во перемешиваний = размеру мешка, то получаем полное перемешивание, т.е. абсолютно рандомную последовательность фишек. Ставить кол-во перемешиваний больше размера мешка нет смысла.

=Файл уровней=
Объект умеет загружать настройки из файла уровней, для этих целей у объекта должны быть заданы:
*'''файл уровня'''(levelFile) - путь к xml файлу уровней;
*'''номер уровня'''(levelNum) - id уровня из файла уровней;

На текущий момент объект вычитывает уровень из файла только при старте, т.е. чтобы сменить уровень нужно или сменить экран или проинитить сцену с коллапсом.

==Структура файла==

<levels>

<style id="3">
<tokens norm="355"/>
<tokens norm="356"/>
</style>

<level id="1" rows="2" cols="2" numTokenNums="2" >
<field>
0,0,
0,0
</field>
</level>
<level id="2" rows="2" cols="2" numTokenNums="2" >
<field>
0,0,
0,0
</field>
</level>
</levels>

Где <style> - стиль в котором перечисляем настройки фишек (resID);
<level> - один игровой уровень
<field> - стартовая настройка поля

==Поле==
Поле указывается в файле уровня:
<level><field>NTKXY,NTKXY,NTKXY,NTKXY</field></level>

Поле объекта - это строка которая имеет разделитель фишек ","(пробелы,табуляции и символы переноса игнорируются).
Код каждой фишки может состоять от 1-го до 5-ти символов ("NTKXY").
Т.е. объект воспринимает поле как последовательность "NTKXY,NTKXY,NTKXY,NTKXY".

Значение символов:
*'''N''' - индекс фишки объекта ( стартует с "0");
**'''0''' - рандомная цветная фишка (цвет получится в диапазоне [1;numTokenNums]);
**'''[1;m]''' - цветная фишка;
**'''*''' - "дырка" (пустая ячейка) которая никогда не заполнится;
**'''#''' - "разовая дырка" (пустая ячейка) которая может заполнится (для Аркады);
**'''B''' - маркер который говорит, что данная фишка является бомбой, номер бомбы указывается в следующем поле('''T'''):
***'''0''' - цветная бомба 1-го цвета;
***'''[1;m-1]''' - цветная бомба с 2-го по (m-1) цвета;
***'''m''' - обычная бомба (взрывает всё в радиусе);
**'''Z''' - маркер который говорит, что данная фишка является бонусом, после цветных бомб, номер бомбы указывается в следующем поле ('''T'''):
***'''0''' - обычная бомба (взрывает всё в радиусе);
***'''1''' - горизонтальная бомба;
***'''2''' - вертикальная бомба;
***'''3''' - крестовая бомба;
***'''4''' - ячейка-Хамелеон;
*'''T''' - используется как дополнительное поле, для поля предыдущего поля ('''N''');
*'''K''' - покраска фона (фон имеет жизнь, и при каждом матчинге, уменьшает её, при этом меняет меняется клип):
**'''0''' - нет покраски;
*'''X''' - специальный функционал:
**'''0''' - обычная ячейка;
**'''Z''' - замок с жизнью(ячейка залочена, не даём на неё нажимать если есть жизнь), при каждом матчинге жизнь уменьшается, количество жизней задаётся параметром '''Y'''(если параметр не указан, считаем == 1):
***'''0''' - нет жизни (но смысла в этом мало);
***'''[1;n]''' - количество жизней;
*'''Y''' - используется как дополнительное поле, для поля '''X''';

==Цели==
Важно указать в самом объекте флаг "перегрузка целей"(override_goal) и зануляем все параметры в теге "перегруженные цели" - чтобы не добавлялись цели которые нам не нужны (уронить статические, очистить поле).
*'''goalAny''' - выбить N фишек (у объекте параметр '''goal_any''');
*'''goalLines''' - выжить N генераций линий, для Аркады (у объекта параметр '''goal_lines''');
*'''goalLocks''' - убрать N замков (у объекта параметр '''goal_locks''');
*'''goalTokens''' - выбить N фишек конкретного цвета (последовательность через запятую для каждого нужного цвета); Объект пишет N параметров в себя '''goal_num_%N%''', где %N% - номер фишки (нумерация с 0);Важно задавать количество цветов '''numTokenNums''' не меньшим чем количество целей - иначе уровень нельзя будет пройти;

==Основные параметры==
*'''id''' - id уровня (объект возьмёт первый уровень который совпадёт по id);
*'''cols''' - высота поля;
*'''rows''' - ширина поля;
*'''numTokenNums''' - количество цветов которые будет генерировать объект(если у вас режим дотсы - будьте бдительны, статическая фишка тоже считается цветом, и по-умолчанию она будет первой фишкой);

==Дополнительные параметры==
*'''needCollapse''' - схлопывание фишек при пустой вертикальной линии;
*'''needBirth''' - досыпание фишек (для аркады можно не указывать);
*'''style''' - id стиля, применит указанный стиль (применит настройки фишек из стиля и запишет в себя строку '''tokenStyle''' (resID фишек через запятую));

==Бонусы==
===Бонус Хамелеон===
Ячейка Хамелеон - это цветная фишка, которая периодически меняет свой цвет. Настраивается параметрами:
*'''chameleonTime''' - время изменения фишки-Хамелеон (у объекта параметр '''currentDt''');
*'''chameleonColors''' - перечень цветов, которые будет менять фишка-Хамелеон (у объекта параметр '''chameleonColors''');

===Стартовая генерация бонусов===
Для того чтобы стартово на поле были бонусы (рандомное место положение), мы указываем следующие настройки:
startBomb'''N'''="'''4'''";
где '''N''' - номер бонуса ( нумерация с "0"(первая цветная бомба));
'''4''' - требуемое количество;

===Генерация бонусов при досыпании===
Для уровней с досыпанием (режим аркада, тоже считается с досыпанием), мы можем указать перечень бонусов и вероятность их генерации:
*'''bombProbArray''' - перечень бонусов через ","(нумерация с "0"(первая цветная бомба));
*'''bombProb''' - общая вероятность генерации бонусов (бонус будет выбран из списка '''bombProbArray''' рандомно);

==Аркада==
Режим в котором ряд фишек добавляется снизу через время со сдвигом поля вверх. При этом проигрышь случается в случае когда мы не можем добавить ряд (размер поля увеличивается). В данном режиме очень не желательно использовать отмену действия (состояние undo).
*'''dt0''' - если больше 0 - включается режим аркады;
*'''n''' - количество линий через которое время уменьшиться на множитель;
*'''mult''' - множитель на которое уменьшиться время;

При работе режима, объект записывает строку ('''nextLine''') в которой указан добавляемый ряд (цифры эквиваленты индексу фишки) и пинает обработчик - "запланирована новая линия в аркаде".

=Пример=
S:\!MOBILE\!!!EditorGames\Wiki_sample\test_collaps.zip

[[Category:Game mechanic]]

=Создание простейшего коллапса (классика)=

Коллапс - самостоятельный обьект, и для создания простейшего коллапса не нужно никаких дополнительных обьектов. Создайте новый проект, и на сцену поместите пустой обьект, измените тип на коллапс.

[[Файл:Tree.JPG]]

Графику для игры коллапс можно скачать здесь: [[Media:Fishki.rar]]

Установите правила игры коллапс.

[[Файл:Коллапс.png]]

Сначала стоит рассчитать размеры поля. При создании обычного коллапса поле делают квадратным, а сверху добавляют еще один ряд для статических обьектов. Соответственно, размерность коллапса составит х*(х+1). Размер поля в пикселях должен соответствовать размеру фишки, умноженной на количество строк/столбцов.
Создадим поле размером 12х13. Размеры нашей фишки в пикселях составляют 58х58, соответственно, размер нашего поля в пикслях составит 696*754.

[[Файл:Size.JPG]]
[[Файл:Size2.JPG]]

Устанавливаем параметр "авторазмер" - авто.

'''ОБРАТИТЕ ВНИМАНИЕ: Не надо загружать текстуры фишек в поле "фишки" во внешнем виде! Это делается отдельно в добавляемом свойстве "Графика фишки" отдельно для каждой фишки'''

[[Файл:Grafika_fishki.JPG]]

Добавьте графику для ваших фишек (один цвет - одна фишка), а также графику для статической фишки (которая будет находиться в верхнем ряду).

== Перегрузка правил ==

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

[[Файл:Rules_classic.JPG]]

Разберем поподробнее некоторые установленные параметры:

* перегрузка - да
:- для перегрузки правил необходимо уставить этот флаг;
* номеров в фишках - 5
:- это количество цветов и статических фишек, что у нас есть
* номер бомбы/крестобомбы - -1
:- будьте внимательны - изначально это значение стоит на 0, изза этого первый цветной блок у вас будет считаться бомбой, и при клике уничтожать все фишки своего цвета!
:- ''в классическом коллапсе вообще не используются бомбы''
* статический номер - 0
:- это номер фишки, которая будет лежать на самом верхнем ряду, и которые надо опустить вниз
'''Все, что касается пометки, не требуется для классического коллапса, так как в нем не нужно отмечать фишки.'''

При установке номеров фишек для бомб и статических учтите, как нумеруется графика фишек.

[[Файл:Graphics_num.JPG]]

Самый верхний добавленный ресурс будет иметь номер 0, следующий за ним - 1 и далее по возрастанию.

Перегрузим также и условия победы в нашей игре:

[[Файл:Celi.JPG]]

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

[[Файл:Win.JPG]]

== Внешний вид ==

Настроим внешний вид нашей игры.

[[Файл:Vneshniy.JPG]]

Некоторые параметры мы уже рассмотрели, немного об остальных:
* сетка? - работает по каким-то собственным алгоритмам, поэтому иногда выглядит странно, можно ее просто не показывать
* таймер - подключает таймер (можно установить ограничения по времени для решения коллапса)
* счетчик статических - подключаем счетчик, который ведет учет статических элементов, которые еще не опущены ко дну коллапса
* бомбы - в классическом коллапсе не используются

Со временами всяких анимаций и появлений можете поэксперементировать сами или использовать вот эти:

[[Файл:Vremena.JPG]]

При генерации коллапс устанавливает блоки одинаковых фишек рядом, подчиняясь этим правилам:

[[Файл:Generation.JPG]]

Запустим получившуюся игру:

[[Файл:Game.JPG]]

Более глубокие механики и условия попробуйте проработать сами с помощью машин, меняйте состояния для коллапса с помощью кнопок и создавайте красивые игры!

Файл:Коллапс.png

2020-10-05T07:39:04Z

Astepin:

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

2020-09-25T12:24:36Z

Astepin: /* Настройка окна вывода */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

уровень: last_game.score30_total

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

уровень: last_game.score30_time

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

уровень: last_game.score30_accuracy

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

уровень: last_game.ecmbRowMax

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

уровень: last_game.score30_level

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

----

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

[[Category:Learning]]

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

2020-09-25T12:17:35Z

Astepin: /* Настройка окна вывода */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

уровень: last_game.score30_total

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

уровень: last_game.score30_time

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

уровень: last_game.score30_accuracy

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

уровень: last_game.ecmbRowMax

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

уровень: last_game.score30_level

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

----

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

[[Category:Learning]]

Файл:Counters.png

2020-09-25T12:16:35Z

Astepin:

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

2020-09-25T12:01:51Z

Astepin: /* Настройка полноценной системы подсчета очков */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

уровень: last_game.score30_total

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

уровень: last_game.score30_time

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

уровень: last_game.score30_accuracy

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

уровень: last_game.ecmbRowMax

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

уровень: last_game.score30_level

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

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

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

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

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

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

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

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

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

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

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

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

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

----

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

[[Category:Learning]]

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

2020-09-25T12:01:16Z

Astepin: /* Упражнения */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

уровень: last_game.score30_total

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

уровень: last_game.score30_time

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

уровень: last_game.score30_accuracy

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

уровень: last_game.ecmbRowMax

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

уровень: last_game.score30_level

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

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

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

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

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

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

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

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

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

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

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

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

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

----

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

[[Category:Learning]]

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

2020-09-25T11:58:19Z

Astepin: /* Прогресс */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

уровень: last_game.score30_total

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

уровень: last_game.score30_time

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

уровень: last_game.score30_accuracy

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

уровень: last_game.ecmbRowMax

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

уровень: last_game.score30_level

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

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

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

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

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

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

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

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

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

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

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

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

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

----

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

[[Category:Learning]]

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

2020-09-25T11:57:47Z

Astepin: /* Прогресс и окно вывода */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

уровень: last_game.score30_total

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

уровень: last_game.score30_time

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

уровень: last_game.score30_accuracy

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

уровень: last_game.ecmbRowMax

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

уровень: last_game.score30_level

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

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

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

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

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

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

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

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

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

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

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

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

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

----

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

[[Category:Learning]]

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

2020-09-25T11:51:29Z

Astepin: /* ПРОГРЕСС И ОКНО ВЫВОДА */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

=== Счетчик ===

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

=== Таймер ===

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

=== Прогресс и окно вывода===

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T11:50:57Z

Astepin: /* ТАаймер */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

=== Счетчик ===

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

=== Таймер ===

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T11:50:51Z

Astepin: /* ТАЙМЕР */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

=== Счетчик ===

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

=== ТАаймер ===

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T11:50:17Z

Astepin: /* Счетчик */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

=== Счетчик ===

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T11:49:35Z

Astepin: /* СЧЕТЧИК */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== Счетчик ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T11:48:47Z

Astepin: /* Упражнения */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Настройка полноценной системы подсчета очков ==

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Файл:444.png

2020-09-25T11:46:08Z

Astepin: Astepin загрузил новую версию Файл:444.png

Создание игры «Hidden Object Game»

2020-09-25T11:40:39Z

Astepin: /* Упражнение № 6 */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T11:12:32Z

Astepin: /* ПРОГРЕСС И ОКНО ВЫВОДА */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Файл:HOL Final.png

2020-09-25T11:04:47Z

Astepin:

Файл:HOL Time.png

2020-09-25T10:42:55Z

Astepin: Astepin загрузил новую версию Файл:HOL Time.png

Файл:HOL Time.png

2020-09-25T10:41:28Z

Astepin: Astepin загрузил новую версию Файл:HOL Time.png

Файл:HOL Time.png

2020-09-25T10:39:57Z

Astepin: Astepin загрузил новую версию Файл:HOL Time.png

Файл:HOL Time.png

2020-09-25T10:38:33Z

Astepin: Astepin загрузил новую версию Файл:HOL Time.png

Создание игры «Hidden Object Game»

2020-09-25T10:35:37Z

Astepin: /* ТАЙМЕР */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:1010.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Файл:HOL Time.png

2020-09-25T10:35:17Z

Astepin:

Создание игры «Hidden Object Game»

2020-09-25T10:27:54Z

Astepin: /* СЧЕТЧИК */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL_time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:1010.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T10:26:12Z

Astepin: /* СЧЕТЧИК */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Symb.png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL_time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:1010.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T10:25:29Z

Astepin: /* СЧЕТЧИК */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL_time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:1010.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Файл:Count 9.png

2020-09-25T10:25:20Z

Astepin:

Файл:Count 8.png

2020-09-25T10:24:52Z

Astepin:

Файл:Count 7.png

2020-09-25T10:24:36Z

Astepin:

Файл:Count 6.png

2020-09-25T10:24:16Z

Astepin:

Файл:Count 5.png

2020-09-25T10:23:42Z

Astepin:

Файл:Count 4.png

2020-09-25T10:23:15Z

Astepin:

Файл:Count 3.png

2020-09-25T10:22:52Z

Astepin:

Файл:Count 2.png

2020-09-25T10:22:22Z

Astepin:

Файл:Count 1.png

2020-09-25T10:21:49Z

Astepin:

Файл:Count 0.png

2020-09-25T10:21:19Z

Astepin:

Создание игры «Hidden Object Game»

2020-09-25T10:04:05Z

Astepin: /* Упражнения */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Coun (5).png]] ‎[[Файл:Coun (6).png]] [[Файл:Coun (7).png]] [[Файл:Coun (8).png]] ‎[[Файл:Coun (9).png]] [[Файл:Coun_(10).png]] ‎[[Файл:Coun (11).png]] ‎[[Файл:Coun (1).png]] ‎‎[[Файл:Coun (2).png]] ‎[[Файл:Coun (3).png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL_time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:1010.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2020-09-25T10:03:50Z

Astepin: /* Упражнения */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]
5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Coun (5).png]] ‎[[Файл:Coun (6).png]] [[Файл:Coun (7).png]] [[Файл:Coun (8).png]] ‎[[Файл:Coun (9).png]] [[Файл:Coun_(10).png]] ‎[[Файл:Coun (11).png]] ‎[[Файл:Coun (1).png]] ‎‎[[Файл:Coun (2).png]] ‎[[Файл:Coun (3).png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL_time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:1010.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

[[Файл:Example.jpg]]

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

После создания счетчиков и установки уровней добавляем 5 текстовых объектов, которые описывают значения, выводящиеся счетчиками в конце игры в окне результатов (игровые очки, бонус за время и т.д.).

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

Включаем вьювер и наблюдаем как автоматически включается таймер, за каждый собранный предмет вам начисляются очки, прогресс показывает прохождение игры, в конце игры появляется окно с выводом результатов набранных очков с звездами.

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]