Конфигурация категорий

Категории хранятся отдельными YAML-файлами в папке categories.

Полный пример

id: gathering
name: "Добыча"
description: "Осваивайте добычу ресурсов."
icon: minecraft:iron_pickaxe
order: 10
direction: left-to-right
enabled: true

choices:
  gathering-path:
    limit: 1
    nodes:
      - stone-path
      - wood-path

nodes:
  mining-basics:
    style: key
    name: "Основы добычи"
    description: "Первый шаг шахтёра."
    icon: minecraft:iron_pickaxe
    costs: [1, 2, 3]
    effects:
      - permission: varryal.mining
      - modifier:
          key: mining-speed
          operation: add
          value: 0.1
          per-rank: true
    actions:
      - event:
          id: talent.mining.rank
          payload: ""
    layout:
      group: basics
      order: 10

  stone-path:
    name: "Каменный путь"
    icon: minecraft:stone
    cost: 2
    requires: mining-basics
    layout:
      group: paths
      order: 20

  wood-path:
    name: "Древесный путь"
    icon: minecraft:oak_log
    cost: 2
    requires: mining-basics
    layout:
      group: paths
      order: 30

Поля категории

Поле	Назначение
id	Уникальный ID категории.
name	Отображаемое название. Если не указано, используется ID.
description	Описание. Одна строка или список строк.
icon	Иконка категории.
order	По сути приоритет категории в интерфейсе.
direction	Направление дерева: left-to-right, right-to-left, top-to-bottom или bottom-to-top.
enabled	Включает категорию. Отключённая категория скрыта и не принимает покупки.
accent-color	Дополнительный цвет категории для интерфейса.
access-when	Условие для отображения таланта (и его показа соответственно).
choices	Группы, в которых можно выбрать ограниченное число узлов.
nodes	Узлы категории.

Поля узла

Поле	Назначение
name	Отображаемое название.
description	Описание. Одна строка или список строк.
icon	Иконка узла.
style	Только внешний вид: normal или key.
cost	Один ранг с указанной стоимостью.
costs	Несколько рангов; каждое число — цена соответствующего ранга.
ranks	Подробное описание каждого ранга.
requires	Одна или несколько простых зависимостей.
requirements	Расширенные правила зависимостей.
access-when	Единое условие показа и покупки.
effects	Постоянные бонусы узла.
actions	Одноразовые операции после покупки каждого ранга.
layout.group	Визуальная группа узла.
layout.order	Порядок узла внутри дерева.

Узел обязан использовать ровно один вариант стоимости.

Один ранг

cost: 2

ИЛИ Несколько рангов

costs: [1, 2, 3]

ИЛИ Подробные ранги

ranks:
  - cost: 1
    effects:
      - tag: novice
  - cost: 3
    access-when:
      progression: chapter-two
    effects:
      - tag: expert
    actions:
      - event:
          id: talent.mastery
          payload: rank-2

Иконки

Краткая форма:

icon: minecraft:iron_pickaxe

Расширенная форма:

icon:
  type: texture
  id: minecraft:nether_star
  model: varryal:talent_mastery

Поддерживаются типы vanilla, texture, mythic, nexo и обычный пользовательский идентификатор.

Группы выбора

choices:
  gathering-path:
    limit: 1
    nodes:
      - stone-path
      - wood-path

Узел может входить только в одну группу. Он считается выбранным после покупки хотя бы одного ранга. Группа не является отдельным узлом и не создаёт зависимость между своими участниками.