Project MMO: Iron's Spellbooks Compat

О модификации

Этот мод совместимости позволяет устанавливать требования к уровню навыков для заклинаний с использованием датапаков. Если у игрока недостаточный уровень навыков, он не сможет применить соответствующее заклинание. Также можно настраивать требования отдельно для каждого уровня заклинания. Эти настройки могут применяться только при использовании свитков, книг заклинаний и/или мечей. Дополнительно можно заблокировать вообще вписывание заклинания в книгу заклинаний до выполнения требований.

Также в конфигурации есть опция начисления опыта игроку, чьё заклинание исцелило другого участника. Эта возможность позволяет игрокам, выбравшим роль лекаря или жреца, прокачивать навыки во время оказания помощи союзникам.

Руководство по настройке

Самый простой способ начать — зайти в нужный мир и выполнить команду:

/pmmo_irons_compat genSpellData

Эта команда создаст датапак с настройками по умолчанию для всех доступных в Iron's Spells and Spellbooks заклинаний. Вы можете изменить этот датапак, а затем удалить JSON файлы для тех заклинаний, которые не нужно настраивать. Команду можно запускать в любое время для обновления списка заклинаний, при этом уже существующие JSON файлы не будут затронуты.

После выполнения команды и создания датапака я изменил файл fireball.json следующим образом:

{
  "requirements": {
    "1": {},
    "2": { "magic":  5}
  },
  "default_requirements": {
    "magic": 10,
    "charisma": 2
  },
  "sources": [
    "scroll",
    "spellbook",
    "sword",
    "inscribe"
  ],
  "replace": true
}

Параметр "default_requirements" добавляет требования для всех уровней заклинания "огненный шар". В данном случае для применения огненного шара любого уровня потребуется магия 10 уровня и харизма 2 уровня.

Раздел "requirements" позволяет устанавливать требования для конкретных уровней заклинания. В этом примере огненный шар 1 уровня не требует никаких условий для применения, что переопределяет "default_requirements" для этого уровня. Огненный шар 2 уровня понадобит магию 5 уровня. Все остальные уровни заклинания будут требовать магию 10 уровня и харизму 2 уровня.

Секция "sources" указывает, когда применять эти ограничения. В текущей настройке огненный шар нельзя применять со свитков, из книг заклинаний или мечей. Также нельзя записать заклинание в книгу, пока не выполнены требования. Если нужно разрешить применение заклинания, например, со свитков, достаточно убрать "scroll" из списка "sources".

Параметр "replace" предназначен для разрешения конфликтов между датапаками. Если несколько датапаков содержат требования для одного заклинания, то датапак с "replace": true перезапишет параметры в датапаках с false. При наличии нескольких датапаков с "replace": true будет использоваться самый последний загруженный.

Все параметры необязательны. Если нужно добавить требование только для определённого уровня заклинания, можно не включать "default_requirements". Чтобы установить общие требования для всех уровней, используйте только "default_requirements", удалив "requirements". Если не указывать "sources", требования вообще не будут действовать — в этом случае файл можно смело удалить.

Благодарности

Огромная благодарность Caltinor и команде Project MMO за постоянную помощь и доступ к исходному коду проекта. Также спасибо разработчикам Iron's Spells and Spellbooks за возможность объединить несколько PR для вызова событий, что позволило обойтись без использования миксинов для работы этой совместимости.