====== Usage ======

===== Использование Магазина =====

На этой странице расположены заметки по использованию магазина и его функциональным особенностям. Перед прочтением ознакомьтесь с другими разделами и произведите настройку магазина, процесс которой описан в статье [[store:management|Управление Магазином]]. Учтите что конфигурация и товары в магазине (включая текстуры) синхронизируются с игроками автоматически и обновляются при открытии меню магазина (заметка для владельцев серверов).

Магазин использует исключительно цифровую валюту Oxygen и поддерживает её настройку. По умолчанию используется валюта "Осколки" или Shards [index 1]. Вы можете изменить валюту череез конфиг, используя параметр "store_currency_index". Об экономике и видах валют читайте тут [[core:economy|Экономика]]

==== Открытие Меню Магазина ====

По умолчанию открыть меню можно в любой момент используя клавишу "." (по умолчанию). Дополнительно существует команда для клиента "/oxygenc store", так же открывающая меню.

Однако при необходимости доступ в меню магазина можно ограничить, установив значение "enable_store_access_clientside" на "false" в файле конфигурации "store.json". Это запретит открытие меню клавишей или командой со стороны клиента. Открыть меню можно будет лишь с помощью команды "/oxygenop store -open-menu {target}" (см. раздел [[store:commands|Команды]]). При этом на использование меню (операции в магазине) будет наложен таймаут, наступающий по истечению времени, указанного параметром "store_menu_operations_timeout_millis" (4 минуты по умолчанию). Таймаут сбрасывается при открытии меню командой, и не даёт пользоваться меню в обход ограничений.

Так же существует привилегия "store:storeAccess" [1700] (boolean) управляющая доступом к магазину (см. раздел [[store:privileges|Привелегии]]).

==== Покупка в Магазине ====

Покупки совершаются в меню магазина в разделе "Предложения". Если в качестве товара используются предметы, то они будут добавлены в инвентарь игрока сразу после покупки. При этом покупка будет совершена только если у игрока в инвентаре столько же (или больше) свободных слотов, сколько различных товаров содержится в сделке.

На покупки могут быть наложены ограничения в виде индивидуального лимита покупок одного товара на игрока или кулдаун при покупке (см. раздел [[store:management|Управление Магазином]]. Лимит и кулдаун распространяется и на подарки от других игроков.

==== Подарки ====

Система подарков активна по умолчанию ("enable_gifts" в конфиге "store.json").

Если при покупке товара в диалоговом окне подтверждения можно выбрать опцию "Купить в Подарок" (см. раздел [[store:management|Управление Магазином]], опция "can_be_gifted") то этот товар можно подарить другому игроку. Полученные и возвращённые подарки храняться в разделе "Подарки". У подарков, ожидающих получения есть срок хранения ("gift_expire_time_hours" в конфиге "store.json"), по истечении которого они возвращаюся отправителю со статусом "Возврат".

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

Количество подарков, ожидающих получения или возвращённых, которое одновременно может иметь игрок ограничено ("gifts_inventory_size" в конфиге "store.json"). При возврате подарки игнорируют этот лимит, однако получение новых подарков от игроков по его достижению будет невозможно.