===== Типичные скрипты =====

Примеры использования JavaScript в заданиях. Их необходимо вставлять в поле **"Скрипт Задания"** (в настройках конкретного уровня).

==== Скрыть Коды ====
<code JavaScript>
$('#out_codes').hide();
</code>

==== Скрыть бонусы ====
<code JavaScript>
$('#out_bonuses').hide();
</code>

==== Скрыть глобальные (сквозные) бонусы ====
<code JavaScript>
$('#out_global_bonuses').hide();
</code>

==== Вместо оригинального текста результата ввода кодов показывать свои сообщения ====
<code JavaScript>
$('#answer_result_right_out').text('Вроде верно');
$('#answer_result_repeat_out').text('Было уже');
$('#answer_result_wrong_out').text('Что-то не так');
</code>

==== На месте таймера автоперехода отображать время, проведенное на задании ====
<code JavaScript>
show_time_on_task();
</code>
*Примечание: Работает только в том случае, если на уровне не настроен автопереход.*

==== Заменить слово 'Автопереход' на другое название ====
<code JavaScript>
$('span#out_end_time').each(function(){$(this).html($(this).html().replace('Автопереход', 'Время до закрытия зоны'));});
</code>

==== Заменить слово 'Подсказка' на другое название ====
<code JavaScript>
$('span.hint_name').each(function(){$(this).html($(this).html().replace('Подсказка', 'Возможное время до закрытия зоны'));});
</code>

==== Заменить текст на кнопке 'Купить подсказку' ====
<code JavaScript>
$('div#out_hints').each(function(){$(this).html($(this).html().replaceAll('Взять подсказку', 'Купить задание'));});
</code>

==== Реализация "Олимпийки" (сетка плей-офф) ====
  - В текст задания пропишите специальный маркер: **''[olymp]''** (он автоматически заменится на сетку-таблицу во время игры).
  - В скрипт задания пропишите: **''olymp('8.2')'';**
     * Вместо `'8.2'` можно использовать `'4.2'`, `'16.2'`, `'32.2'`, `'64.2'`, `'128.2'`, `'256.2'`, `'9.3'`, `'27.3'`, `'81.3'`, `'16.4'`, `'64.4'` (где первое число — количество начальных кодов олимпийки, а второе — количество объединяемых ячеек в последующих этапах).
     * Если вы хотите оставить отображение номеров в кодах, используйте: **''olymp_with_numbers('8.2')'';**
  - Чтобы отображать вместо правильно вбитого слова какое-то другое кастомное значение:
     * Создайте бонус с тем же кодом.
     * В поле **"Текст после решения"** бонуса в режиме исходного кода (Source) вставьте скрипт:
<code HTML>
<script>olymp_value(n, 'html')</script>
</code>
     * Где ''n'' — номер поля олимпийки, а ''html'' — текст или HTML-код, который будет показан в соответствующей ячейке (например: ''olymp_value(3, 'Храмище')'').

[[https://qeng.org/game.php?jump_to&gid=3493&task_id=42715|Пример олимпийки]] | [[https://qeng.org/game.php?jump_to&gid=3493&task_id=49134|Пример олимпийки со стартовыми ячейками]]

==== Отображение набранных штурмовых баллов непосредственно в задании ====
Вставьте в текст задания:
<code>
Всего баллов: !bonus!
</code>

==== Кастомный обработчик ввода ответа ====
Вы можете перехватывать и изменять вводимый игроками ответ на клиенте перед его отправкой на сервер. Например, автоматически дописать префикс ''p_'':
<code JavaScript>
window.submitAnswerCallback = function(answer) {
  return 'p_' + answer;
}
</code>
*Если функция вернет пустую строку, отправка ответа на сервер будет заблокирована.*

[[https://qeng.org/game.php?jump_to&gid=3493&task_id=52080|Пример перехватчика в игре]]

===== Скрипты в бонусах и подсказках =====
Эти сценарии должны вставляться в поле текста решения бонусов/подсказок в режиме **"Источник"** (Source):

==== Автоматический ввод кода при открытии подсказки/бонуса ====
<code HTML>
<script>enter('Код который надо вбить')</script>
</code>

==== Составные коды в бонусах/штрафных подсказках ====
Если код состоит из частей, разбросанных по разным подсказкам или бонусам:
<code HTML>
<script>code_part(номер_составного_кода, 'частькода', число_составных_частей)</script>
</code>
  * **''номер_составного_кода''** — порядковый номер составного кода, если их в игре несколько (если он один — ставьте ''0'').
  * **'''частькода'** — строка/часть кода (обязательно в кавычках).
  * **''число_составных_частей''** — общее количество составных частей, которое нужно собрать.

<note important>
**Важно:** Обязательно добавьте на уровень итоговый собранный код в качестве обычного кода, иначе у игроков страница будет постоянно обновляться в цикле, пытаясь отправить несуществующий код.
</note>

===== Системные события: Вызов скрипта при обновлении задания =====
Если вам нужно автоматически запускать определенный JavaScript каждый раз, когда задание перезагружается (обновляется) на клиенте, пропишите в **"Общий HTML заголовок игры"**:
<code JavaScript>
<script>
document.addEventListener("DOMContentLoaded", function() {
  function common_task_script() {
    console.log('уровень обновился');
  }    
  let old_task_script = task_script;
  task_script = function() {
    old_task_script();
    common_task_script();
  };
  common_task_script();
});
</script>
</code>

===== Автоматический редирект в штурмовых играх (Не показывать закрытые задания) =====
Чтобы при попадании на уже закрытое (пройденное) штурмовое задание игрока сразу перенаправляло на главную страницу игры с картой/списком уровней, пропишите в **"Общий HTML заголовок игры"**:
<code HTML>
<script>
document.addEventListener("DOMContentLoaded", function() {
  if ($('.closed-level').length > 0) {
    window.location = 'game.php?gid=' + game_id;
  }
});
</script>
</code>