{{indexmenu_n>30}}
====== Інвентар гравця ======

Движок QEng підтримує систему віртуального інвентарю команд або одиночних гравців. Це дозволяє реалізовувати квести з пошуком та використанням предметів (ключів, інструментів, валюти).

===== Що таке інвентар? =====
В інтерфейсі ігрового вікна інвентар відображається як список предметів із зображеннями, коротким описом та кнопкою дії.

{{ :authors_main:inventory.png?800 |Приклад відображення інвентарю на рівні}}

Кожен предмет являє собою унікальний текстовий ідентифікатор (ключ), який можна додавати, видаляти або "активувати" (використовувати).

===== Як відобразити інвентар на рівні =====

  - У тексті завдання (в режимі **"Джерело"**) вставте HTML-блок, де повинен відображатися список предметів:
<code HTML>
<div id="inventory_container">Завантаження інвентарю...</div>
</code>
  - У скрипт завдання (поле скрипта внизу рівня) додайте JS-виклик:
<code JavaScript>
showInventoryItems('inventory_container');
</code>

===== Керування предметами =====

==== Додавання предмета до інвентарю ====
Додавання предметів прив'язане до вирішення бонусів (або наскрізних бонусів).
  - Створіть бонус на рівні (наприклад, "Знайти молоток").
  - У полі **"Текст після вирішення"** бонусу в режимі **"Джерело"** (Source) вставте скрипт:
<code HTML>
<script>
addInventoryItem('hammer123');
</script>
</code>
Після того як команда введе правильну відповідь для цього бонусу, предмет із ключем ''hammer123'' з'явиться в їхньому інвентарі.

==== Зображення предметів ====
Для коректного відображення предмета ''hammer123'' завантажте на cdn гри два файли картинок із точними назвами:
  * **''item_hammer123.jpg''** — прев'ю предмета, що показується в списку інвентарю.
  * **''item_hammer123_big.jpg''** — детальне зображення, що показується при кліку по значку ока (детальний перегляд).

==== Видалення предмета з інвентарю (Використання/Втрата) ====
Щоб забрати предмет у команди (наприклад, при віддачі персонажу або використанні для відкриття дверей):
  - Створіть бонус, який активується при проходженні.
  - У його **"Текст після вирішення"** в режимі **"Джерело"** пропишіть:
<code HTML>
<script>
removeInventoryItem('hammer123');
</script>
</code>

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

==== Кнопка "Використовувати" ====
При кліку гравцем по кнопці **"Використовувати"** у предмета в інвентарі, движок автоматично намагається ввести код, який збігається з ідентифікатором предмета.
* Наприклад, при використанні предмета ''hammer123'' в поле введення відповідей автоматично відправиться код ''hammer123''.

===== Демонстрація =====
Робочий приклад рівня з інвентарем та кодом можна подивитися в [[https://qeng.org/game.php?gid=3493&tid=68367|Демо-грі для авторів]].