Repository navigation
Rewards Management RU
При первом запуске игры в папке "./minecraft/config/oxygen/data/server/daily rewards/" будут сгенерированы файлы для настройки наград для каждого месяца. По умолчанию в качестве награды за каждый день используется изумруд.
Структура файла:
Файл с данными наград представляет собой массив json объектов. Количество объектов зависит от длинны месяца, для февраля их 29. Порядок наград определяется индексом объекта в массиве (поле "day" не учитывается, оно создано для удобства).
Свойства объекта награды:
-
"day" (integer) - день месяца за который будет выдаваться награда
-
"type" (string) - тип награды
Доступны: "ITEM", "CURRENCY" и "COMMANDS".
- "description" (string) - подпись под иконкой награды
Подпись создана для краткого описания награды ("предмет" или "валюта") для простоты восприятия. В качестве подписи может использоваться конкретное значение ("Item") или ключ локализации ("oxygen_dailyrewards.description.item").
-
"amount" (long) - количество/сумма награды (не используется для награды типа "COMMAND")
-
"special" (boolean) - флаг "уникальной" награды
Флаг может использоваться для демонстрации ценности награды (если "true", то в правом верхнем углу виджета награды будет отображаться звезда).
- "itemstack" (json object)(только для наград типа "ITEM") - json объект содержащий данные предмета
Данные любого предмета могут быть получены в игре с помощью команды "/oxygenc core -item -to-json {название файла (в одно слово, без .json)}". Файл будет создан в папке ".minecraft/config/oxygen/data/client/core/itemstack/".
-
"currency_index" (integer)(только для наград типа "CURRENCY") - индекс валюты
-
"tooltip" (string) (только для наград типа "COMMAND") - текст, который будет отображаться при наведении на иконку награды
-
"icon" (string) (только для наград типа "COMMAND") - имя файла (с ".png") с изображением, которые будет использоваться в качестве иконки награды
Ширина изображения должна быть кратна 48 пикселям (малый виджет) или 96 пикселям (большой виджет). Чем выше разрешение, тем лучше качество. Изображения должны находится в папке ".minecraft/config/oxygen/data/server/daily rewards/icons/". Текстуры могут быть расположены во вложенных папках, тогда название дополнительно должно содержать каталог (прим. "june/reward_7.png"). При отсутствии файла будет использована стандартная текстура "MISSING_TEXTURE".
- "commands" (string) (только для наград типа "COMMAND") - команды для консоли
Команды должны начинаться со слэша "/" и быть разделены точкой с запятой ";". Указатели: "@p" - ник игрока, "@pX" - координата игрока по X, "@pY" - координата игрока по Y, "@pZ" - координата игрока по Z, "@dim" - идентификатор измерения (целое число).
Для работы некоторых команд требуется включить командные блоки
- "script" (string) (только для наград типа "SCRIPT") - название скрипта
Скрипт должен быть расположен в папке ".minecraft/config/oxygen/data/server/daily rewards/". Скрипты могут быть расположены во вложенных папках, тогда название дополнительно должно содержать каталог (прим. "misc/misc_1.ts"). Скрипт должен возвращать boolean значение "true" при успешном выполнении для успешного завершения операции выдачи награды.
Примечание: Поддержка скриптов обеспечивается аддонами Scripting Adapter (WIP), однако Core имеет встроенный адаптер для ECMAScript (TypeScript, JavaScript) и для его активации нужно установить значение "enable_ecmascript_adapter: true" в конфиге "core.json".