Створити

Jotunn [2.30.0]

  • Valheim — Jotunn [2.30.0]
Автор:
ValheimModding
Розмір:
495.37 kB
Дата:
Вчора, 13:47
Завантажень:
0
0.0 / 10
Ще ніхто не оцінив файл

Jötunn, бібліотека Valheim.

Фундаментальна програмна бібліотека та фреймворк для Valheim, створена на основі об'єднання напрацювань JötunnLib та ValheimLib. Бібліотека виступає універсальним шаром абстракції між постійно оновлюваним внутрішнім кодом гри та сторонніми модифікаціями, звільняючи розробників від необхідності переписувати код під кожен патч. Платформа забезпечує мережеву сумісність клієнтів із сервером, надає зручні абстракції сутностей, глобальні менеджери систем, синхронізацію конфігурацій на льоту та обширний набір інструментів для додавання будь-якого користувацького контенту.

Сутності та абстракції контенту (Entities):

  • CustomCreature — створення нових тварин, монстрів, босів та неігрових персонажів (NPC).
  • CustomItem — додавання кастомної зброї, броні, інструментів, стріл та витратних предметів (зілля, їжа).
  • CustomItemConversion — єдина абстракція для рецептів переробки сировини на кулінарній стійці (Cooking Station), у бродильній бочці (Fermenter), плавильні (Smelter) та сміттєзвалищі (Incinerator).
  • CustomLocalization — інтеграція мовних файлів та власних рядків локалізації для мода.
  • CustomLocation — впровадження в генерацію світу нових структур та локацій: від простих кам'яних кіл до повноцінних поселень та сіл.
  • CustomPiece — додавання нових будівельних деталей, стін, підлог та декоративних об'єктів.
  • CustomPieceTable — додавання кастомних будівельних меню (столів верстаків) з підтримкою власних вкладок та категорій.
  • CustomRecipe — створення та редагування рецептів крафту та модернізації предметів на верстках та ковальнях.
  • CustomStatusEffect — програмування статусних ефектів: баффів, дебаффів, стихійного урону зброї та сил Давніх (Guardian Powers).
  • CustomVegetation — додавання рослинності в біоми: збирані ресурси, ягоди, трави та декоративні дерева/кусти.
  • KitbashObject — збірка нових складних 3D-об'єктів прямо з готових компонентів та деталей оригінальних префабів гри.
  • Mocks — створення «фіктивних» посилань на оригінальні префаби гри всередині кастомних асетів в Unity, які Jötunn автоматично пов'язує з реальними об'єктами під час виконання гри.
  • Config classes — готові класи конфігурацій для швидкої прив'язки гарячих клавіш, консольних команд, вмінь та налаштувань.

Менеджери підсистем (Managers):

  • Command Manager — реєстрація та виконання користувацьких консольних команд.
  • CreatureManager — впровадження нових істот або клонування та модифікація параметрів ванільних мобів.
  • GUI Manager — динамічне створення, виклик та відображення користувацьких інтерфейсів (UI) прямо з коду.
  • Input Manager — стандартизований інтерфейс переназначення клавіш через систему ZInput з автоматичним виводом контекстних підказок.
  • Item Manager — абстрагування конфігурацій та логіки додавання предметів, суттєво спрощуючи реєстрацію нового луту.
  • Kitbash Manager — менеджер збору комбінованих асетів з елементів оригінальних моделей.
  • KeyHint Manager — створення контекстних екранних підказок з управління для зброї, інструментів та активних будівельних деталей.
  • Localization Manager — завантаження мовних даних різними методами та можливість додавання перекладів на мови, які не підтримуються офіційно.
  • Minimap Manager — модифікація даних карти світу та накладення кастомних графічних шарів поверх мінікарти.
  • Piece Manager — управління реєстрацією будівельних блоків, деталей та прив'язаних рецептів будівництва.
  • Prefab Manager — централізований кеш усіх зареєстрованих у грі префабів для швидкого звернення з сторонніх модів.
  • Render Manager — вбудована черга рендеру 3D-об'єктів у плоскі 2D-спрайти для автоматичної генерації красивих іконок предметів.
  • Skill Manager — створення та реєстрація зовсім нових прокачуваних навичок персонажа.
  • Undo Manager — глобальна черга скасування та повтору дій (Undo/Redo) для модифікацій.
  • Zone Manager — впровадження користувацьких локацій, зон та рослинності в алгоритми глобальної процедурної генерації світу.

Допоміжні утиліти (Utilities):

  • Network Compatibility — перевірка версій модів на стороні сервера та підключених клієнтів; дозволяє гнучко налаштовувати допуск гравців з різними збірками на рівні кожного плагіна.
  • Config Synchronisation — синхронізація значень конфігурації від адміністратора сервера до всіх підключених гравців в реальному часі.
  • Bone Reorderer — автоматичне виправлення порядку кісток у компонентах SkinnedMeshRenderer для моделей, перенесених в Unity.
  • Asset Helpers — набір допоміжних методів для швидкого пошуку, адресації та завантаження асетів з бандлів.
  • Mod Registry — реєстр для відстеження та програмних запитів доданого контенту кожним конкретним модом.
  • SimpleJSON — вбудована бібліотека SimpleJSON (під ліцензією MIT), що звільняє сторонні моди від підключення зайвої залежності.

Інструкція з встановлення:

  1. Встановіть базовий завантажувач BepInEx (BepInExPack_Valheim) у кореневу папку гри:
    <Steam>\steamapps\common\Valheim\.
  2. Скачайте архів з бібліотекою Jötunn та розпакуйте його на комп'ютері.
  3. Помістіть усе вміст архіву в папку плагінів:
    <Steam>\steamapps\common\Valheim\BepInEx\plugins\Jotunn\.
  4. Запустіть гру через Steam.
Назва та опис файлу були перекладені Показати оригінал (RU)Показати переклад (UK)
Jotunn [2.30.0]

Jötunn, the Valheim Library.

Фундаментальная программная библиотека и фреймворк для Valheim, созданный на основе объединения наработок JötunnLib и ValheimLib. Библиотека выступает универсальным слоем абстракции между постоянно обновляемым внутренним кодом игры и сторонними модификациями, избавляя разработчиков от необходимости переписывать код под каждый патч. Платформа обеспечивает сетевую совместимость клиентов с сервером, предоставляет удобные абстракции сущностей, глобальные менеджеры систем, синхронизацию конфигураций на лету и обширный набор инструментов для добавления любого пользовательского контента.

Сущности и абстракции контента (Entities):

  • CustomCreature — создание новых животных, монстров, боссов и неигровых персонажей (NPC).
  • CustomItem — добавление кастомного вооружения, брони, инструментов, стрел и расходуемых предметов (зелья, еда).
  • CustomItemConversion — единая абстракция для рецептов переработки сырья на кулинарной стойке (Cooking Station), в бродильной бочке (Fermenter), плавильне (Smelter) и мусоросжигателе (Incinerator).
  • CustomLocalization — интеграция языковых файлов и собственных строк локализации для мода.
  • CustomLocation — внедрение в генерацию мира новых структур и локаций: от простых каменных кругов до полноценных поселений и деревень.
  • CustomPiece — добавление новых строительных деталей, стен, полов и декоративных объектов.
  • CustomPieceTable — добавление кастомных строительных меню (столов верстаков) с поддержкой собственных вкладок и категорий.
  • CustomRecipe — создание и редактирование рецептов крафта и модернизации предметов на верстаках и наковальнях.
  • CustomStatusEffect — программирование статусных эффектов: баффов, дебаффов, стихийного урона оружия и сил Древних (Guardian Powers).
  • CustomVegetation — добавление растительности в биомы: собираемые ресурсы, ягоды, травы и декоративные деревья/кусты.
  • KitbashObject — сборка новых сложных 3D-объектов прямо из готовых компонентов и деталей оригинальных префабов игры.
  • Mocks — создание «фиктивных» ссылок на оригинальные префабы игры внутри кастомных ассетов в Unity, которые Jötunn автоматически связывает с реальными объектами во время выполнения игры.
  • Config classes — готовые классы конфигураций для быстрой привязки горячих клавиш, консольных команд, умений и настроек.

Менеджеры подсистем (Managers):

  • Command Manager — регистрация и исполнение пользовательских консольных команд.
  • CreatureManager — внедрение новых существ или клонирование и модификация параметров ванильных мобов.
  • GUI Manager — динамическое создание, вызов и отрисовка пользовательских интерфейсов (UI) прямо из кода.
  • Input Manager — стандартизированный интерфейс переназначения клавиш через систему ZInput с автоматическим выводом контекстных подсказок.
  • Item Manager — абстрагирование конфигураций и логики добавления предметов, существенно упрощающее регистрацию нового лута.
  • Kitbash Manager — менеджер сборки комбинированных ассетов из элементов оригинальных моделей.
  • KeyHint Manager — создание контекстных экранных подсказок по управлению для оружия, инструментов и активных строительных деталей.
  • Localization Manager — загрузка языковых данных различными методами и возможность добавления переводов на языки, не поддерживаемые официально.
  • Minimap Manager — модификация данных карты мира и наложение кастомных графических слоев поверх миникарты.
  • Piece Manager — управление регистрацией строительных блоков, деталей и привязанных рецептов строительства.
  • Prefab Manager — централизованный кэш всех зарегистрированных в игре префабов для быстрого обращения из сторонних модов.
  • Render Manager — встроенная очередь рендера 3D-объектов в плоские 2D-спрайты для автоматической генерации красивых иконок предметов.
  • Skill Manager — создание и регистрация совершенно новых прокачиваемых навыков персонажа.
  • Undo Manager — глобальная очередь отмены и повтора действий (Undo/Redo) для модификаций.
  • Zone Manager — внедрение пользовательских локаций, зон и растительности в алгоритмы глобальной процедурной генерации мира.

Вспомогательные утилиты (Utilities):

  • Network Compatibility — проверка версий модов на стороне сервера и подключённых клиентов; позволяет гибко настраивать допуск игроков с разными сборками на уровне каждого плагина.
  • Config Synchronisation — синхронизация значений конфигурации от администратора сервера ко всем подключённым игрокам в реальном времени.
  • Bone Reorderer — автоматическое исправление порядка костей в компонентах SkinnedMeshRenderer для моделей, перенесённых в Unity.
  • Asset Helpers — набор вспомогательных методов для быстрого поиска, адресации и загрузки ассетов из бандлов.
  • Mod Registry — реестр для отслеживания и программных запросов добавленного контента каждым конкретным модом.
  • SimpleJSON — встроенная библиотека SimpleJSON (под лицензией MIT), избавляющая сторонние моды от подключения лишней зависимости.

Инструкция по установке:

  1. Установите базовый загрузчик BepInEx (BepInExPack_Valheim) в корневую папку игры:
    <Steam>\steamapps\common\Valheim\.
  2. Скачайте архив с библиотекой Jötunn и распакуйте его на компьютере.
  3. Поместите всё содержимое архива в папку плагинов:
    <Steam>\steamapps\common\Valheim\BepInEx\plugins\Jotunn\.
  4. Запустите игру через Steam.

Корисні посилання:

Коментарі 0