Jotunn — библиотека Valheim

Йотунн, библиотека Вальхейма
Jötunn (/ˈjɔːtʊn/, «великан») — библиотека для Valheim, созданная с целью облегчить творчество разработчиков, объединить усилия сообщества по решению проблем и повысить продуктивность разработчиков, собрав библиотеку общих вспомогательных утилит. Кроме того, она предоставляет конкретные интерфейсы и абстракции, которые способствуют совместимости модов, согласованности сетевого геймплея и устраняют необходимость поддержания кода, зависящего от конкретной версии Valheim, выступая в качестве интерфейса между разработчиком и изменяющимися внутренними механизмами игры.

Jötunn — это не JotunnLib, и это не ValheimLib
Йотунн был создан в результате совместных усилий, чтобы объединить JotunnLibи ValheimLibв единую библиотеку, чтобы использовать лучшее из обоих миров. Можно использовать все три библиотеки одновременно, так что все текущие моды продолжат работать. Но настоятельно рекомендуется перенести ваш мод на эту новую библиотеку, так как две другие больше не будут активно развиваться.

Использование
Пожалуйста, обратитесь к нашему документация. Мы приложили все усилия, чтобы обеспечить наличие обширной документации, способствующей обучению разработчиков.


Установка

Если вы используете установщик модов, этот раздел, скорее всего, можно пропустить.
Для более подробного руководства по установке, пожалуйста, обратитесь к Руководство по ручной установке в нашей документации.
Однако вот краткий обзор:

• Установите BepInEx:
  Скачать BepInEx, извлеките всё внутри

  BepInEx_Valheim

  в вашу папку Valheim (обычно

  C:\<ПутьДоВашейSteamБиблиотеки>\steamapps\common\Valheim

  ).
• Установите Jötunn:
  Скачайте с любого из них Нексус / Thunderstore, извлеките ZIP-архив и поместите всё содержимое в

  BepInEx/plugins/Jotunn

  вашего экземпляра Valheim.

Вот и всё, запускай игру и ставь моды!

Особенности
JVL предоставляет три отдельные группы функций. Сущности, которые абстрагируют игровые сущности в простые в использовании интерфейсы. Менеджеры, которые действуют как интерфейсы между сущностями и встроенными коллекциями или подсистемами. Утилиты, которые существуют для помощи в общих/типовых функциях, охватывающих множество различных областей.

Сущности
- CustomCreature - Представляет пользовательских животных, врагов и NPC.
- КастомныйПредмет - Представляет внутриигровые предметы, такие как оружие, инструменты и расходуемые материалы.
- CustomItemConversion - Представляет внутриигровые преобразования предметов для CookingStation, Fermenter и Smelter в одной абстракции.
- CustomLocalization - Представляет пользовательские локализации для вашего мода.
- Пользовательское местоположение - Представляет пользовательские локации — от простых каменных кругов до целых деревень.
- Кастомная деталь - Представляет игровые строительные элементы.
- CustomPieceTable - Представляет игровые таблицы зданий. Включена поддержка пользовательских категорий.
- Особый рецепт - Представляет внутриигровые рецепты для управления созданием и улучшением предметов.
- ПользовательскоеСтатусЭффект - Представляет внутриигровые эффекты статуса: от эффектов удара оружием до сил стража.
- CustomVegetation - Представляет растительность, распространённую по всем биомам, — от собираемых предметов до декоративных элементов.
- ОбъектСборки - Представляет пользовательский объект, собранный из компонентов различных других префабов.
- Насмешки - Подделывайте любой ванильный префаб и используйте его в своих пользовательских ассетах — Jötunn разрешает ссылки на ванильные объекты во время выполнения.
- Классы конфигурации - Помимо основных сущностей существует множество других абстракций, которые позволяют легко создавать такие вещи, как привязки клавиш, пользовательские команды, навыки и многое другое.

Менеджеры
- Командный менеджер - Упрощает реализацию методов, которые можно регистрировать как исполняемые команды консоли.
- Менеджер существ - Добавляйте новых существ или копируйте и изменяйте ванильных.
- Менеджер интерфейса - Позволяет вызывать UI-префабы на лету через код.
- Менеджер ввода - Обеспечивает интерфейс для привязки клавиш через ZInput единообразным способом, облегчая создание пользовательских подсказок по клавишам.
- Менеджер предметов - Абстрагирует детали реализации конфигураций, применяемых к предметам/рецептам, обеспечивая единообразный опыт разработчика при добавлении новых предметов. Короче говоря, добавлять предметы — легко!
- Kitbash Manager - Создавайте собственные ассеты из отдельных частей стандартных префабов.
- Менеджер подсказок клавиш - Создавайте собственные подсказки клавиш для вашего оружия и инструментов, вплоть до выбранного элемента.
- Менеджер по локализации - 提供多种将本地化数据加载到游戏中的方法，并暴露接口以添加额外语言，从而为不支持的本地化语言提供翻译支持。
- Менеджер миникарты - 修改地图数据或为地图创建覆盖层。
- Менеджер фигур - Очень похоже на Менеджер предметов, абстрагируя детали реализации конфигураций для частей/рецептов.
- Менеджер префабов - Предоставляет кэш префабов, зарегистрированных через другие менеджеры; в основном разработчики будут только запрашивать кэш для префабов, добавленных через другие менеджеры.
- Менеджер рендеринга - Предоставляет пользовательскую очередь рендеринга для отображения визуальных игровых объектов в Sprite - Полезно для создания иконок ваших собственных предметов.
- Менеджер навыков - Упрощает получение дополнительных уникальных навыков.
- Менеджер зоны - Создавайте собственные локации и растительность для добавления в генерацию мира.

Утилиты
- Помощники ассетов - Методы для упрощения ссылок и загрузки ресурсов.
- Переупорядочивание костей - Исправление проблем с порядком костей у [code single]SkinnedMeshRenderer[/code], которые были извлечены и импортированы в Unity.
- Совместимость с сетью - Позволяет плагинам задавать собственные требования к версиям для клиентов, подключённых к серверу. Обеспечивает настраиваемый уровень совместимости с клиентами, имеющими различные конфигурации модов, в разрезе каждого плагина.
- Синхронизация конфигурации - Позволяет администраторам настраивать значения конфигурации через внутриигровое меню. Настройки конфигурации синхронизируются с подключенными клиентами.
- Мод-реестр - 按模组查询新增内容。
- SimpleJSON - Мы импортировали SimpleJSON в нашу библиотеку по запросу разработчиков, которые предпочли бы, чтобы эта зависимость уже была учтена. Мы используем лицензию MIT. SimpleJSON

Ошибки, Поддержка, Вклад
Пожалуйста, обратитесь к нашему документация перед запросом Поддержка через DiscordЕсли у разработчиков возникнут какие-либо проблемы с совместимостью модов (не только эксклюзивные проблемы JVL), мы хотим узнать о них! Если мы можем улучшить совместимость модов, предоставив общий интерфейс или открыв доступ к нативным объектам Valheim, включая созданную вами утилиту, пожалуйста, не стесняйтесь создать новую запрос функции или запрос на включение изменений.

Дорожная карта
Проверьте наши проекты Более актуальный список функций, находящихся в разработке, или предложите свои идеи для добавления, создав новый запрос функции

Список изменений
Увидеть всё Список изменений.

Вкладчики в Jötunn, библиотеку Valheim
Эти люди сыграли ключевую роль в выпуске JVL, и без них мы бы не добились и половины этого. Пожалуйста, отблагодарите их на GitHub, Thunderstore и Nexus.

Ядро:
- IDeathHD#7866: github, thunderstore
- Algorithman#6741: GitHub
- Жюль#7950: github
- Quaesar#5604: github
- radu#0571: GitHub, thunderstore, Нексус
- paddy#1337: github, thunderstore, Нексус
- Margmas#9562: github, thunderstore, Нексус

Авторы:
- Cinnabun#0451: github
ЗолотойИуда#8965 GitHub, Нексус
- zarboz#7828: github, thunderstore, Нексус
- MarcoPogo#6095: github, Нексус
- blaxxun#9098: github
- Tekla#1012: github
- JoeyParrish#8644: GitHub, thunderstore, Нексус
- Nosirrom#2626: github
- Серика: github, thunderstore
- OrianaVenture: github, thunderstore