Uma sandbox de fantasia com elementos de sobrevivência. É possível jogar sozinho ou com outras pessoas, explorando o mundo e coletando recursos, encontrando e... Saiba mais
Jotunn [2.30.0]
-
Baixar (495.37 kB)14 de setembro de 2026, 13:47jotunn-2-30-0_1789382821_735355.zip
Jötunn, a Biblioteca de Valheim.
Uma biblioteca de software fundamental e framework para Valheim, criada a partir da fusão dos desenvolvimentos de JötunnLib e ValheimLib. A biblioteca atua como uma camada de abstração universal entre o código interno da jogo, que é constantemente atualizado, e as modificações de terceiros, liberando os desenvolvedores da necessidade de reescrever o código para cada patch. A plataforma garante a compatibilidade de rede entre clientes e servidores, fornece abstrações convenientes para entidades, gerenciadores globais de sistemas, sincronização de configurações em tempo real e um conjunto abrangente de ferramentas para adicionar qualquer conteúdo personalizado.
Entidades e abstrações de conteúdo (Entities):
- CustomCreature — criação de novos animais, monstros, chefes e personagens não jogáveis (NPC).
- CustomItem — adição de armas, armaduras, ferramentas, flechas e itens consumíveis personalizados (poções, comida).
- CustomItemConversion — uma única abstração para receitas de reciclagem de materiais na estação de culinária (Cooking Station), no barril de fermentação (Fermenter), na fornalha (Smelter) e no incinerador (Incinerator).
- CustomLocalization — integração de arquivos de idiomas e strings de localização personalizadas para o mod.
- CustomLocation — implementação de novas estruturas e locais na geração do mundo: desde círculos de pedra simples até assentamentos e vilarejos completos.
- CustomPiece — adição de novos componentes de construção, paredes, pisos e objetos decorativos.
- CustomPieceTable — adição de menus de construção personalizados (mesas de trabalho) com suporte para abas e categorias próprias.
- CustomRecipe — criação e edição de receitas de crafting e upgrade de itens em mesas de trabalho e bigornas.
- CustomStatusEffect — programação de efeitos de status: buffs, debuffs, dano elemental de armas e poderes dos Antigos (Guardian Powers).
- CustomVegetation — adição de vegetação em biomas: recursos coletáveis, frutas, ervas e árvores/bushes decorativos.
- KitbashObject — montagem de novos objetos 3D complexos a partir de componentes e detalhes de prefabs originais do jogo.
- Mocks — criação de referências "fictícias" para os prefabs originais do jogo dentro de ativos personalizados no Unity, que o Jötunn vincula automaticamente a objetos reais durante a execução do jogo.
- Classes de Configuração — classes de configuração prontas para rápida vinculação de teclas de atalho, comandos de console, habilidades e configurações.
Gerenciadores de subsistemas (Managers):
- Command Manager — registro e execução de comandos de console personalizados.
- CreatureManager — introdução de novas criaturas ou clonagem e modificação de parâmetros de mobs padrão.
- GUI Manager — criação dinâmica, chamada e renderização de interfaces de usuário (UI) diretamente do código.
- Input Manager — interface padronizada para remapeamento de teclas através do sistema ZInput com exibição automática de dicas contextuais.
- Item Manager — abstração de configurações e lógica de adição de itens, simplificando significativamente o registro de novos loot.
- Kitbash Manager — gerenciador de montagem de ativos combinados a partir de elementos de modelos originais.
- KeyHint Manager — criação de dicas contextuais na tela sobre controle para armas, ferramentas e componentes de construção ativos.
- Localization Manager — carregamento de dados de idiomas por vários métodos e possibilidade de adicionar traduções para idiomas não oficialmente suportados.
- Minimap Manager — modificação de dados do mapa do mundo e sobreposição de camadas gráficas personalizadas sobre o minimapa.
- Piece Manager — gerenciamento do registro de blocos de construção, componentes e receitas de construção vinculadas.
- Prefab Manager — cache centralizado de todos os prefabs registrados no jogo para acesso rápido a partir de mods de terceiros.
- Render Manager — fila de renderização embutida de objetos 3D em sprites 2D planos para geração automática de ícones bonitos de itens.
- Skill Manager — criação e registro de habilidades totalmente novas que podem ser aprimoradas pelo personagem.
- Undo Manager — fila global de desfazer e refazer ações (Undo/Redo) para modificações.
- Zone Manager — implementação de locais, zonas e vegetação personalizadas nos algoritmos de geração procedural global do mundo.
Utilitários auxiliares (Utilities):
- Network Compatibility — verificação de versões de mods do lado do servidor e dos clientes conectados; permite configurar flexivelmente a permissão de jogadores com diferentes builds em nível de cada plugin.
- Config Synchronisation — sincronização de valores de configuração do administrador do servidor para todos os jogadores conectados em tempo real.
- Bone Reorderer — correção automática da ordem dos ossos em componentes SkinnedMeshRenderer para modelos transferidos para o Unity.
- Asset Helpers — conjunto de métodos auxiliares para busca, endereçamento e carregamento rápido de ativos de pacotes.
- Mod Registry — registro para rastreamento e solicitações programáticas de conteúdo adicionado por cada mod específico.
- SimpleJSON — biblioteca embutida SimpleJSON (sob licença MIT), que livra mods de terceiros da necessidade de conectar dependências desnecessárias.
Instruções de instalação:
- Instale o carregador básico BepInEx (BepInExPack_Valheim) na pasta raiz do jogo:
<Steam>\steamapps\common\Valheim\. - Baixe o arquivo da biblioteca Jötunn e extraia-o em seu computador.
- Coloque todo o conteúdo do arquivo na pasta de plugins:
<Steam>\steamapps\common\Valheim\BepInEx\plugins\Jotunn\. - Inicie o jogo através do Steam.
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), избавляющая сторонние моды от подключения лишней зависимости.
Инструкция по установке:
- Установите базовый загрузчик BepInEx (BepInExPack_Valheim) в корневую папку игры:
<Steam>\steamapps\common\Valheim\. - Скачайте архив с библиотекой Jötunn и распакуйте его на компьютере.
- Поместите всё содержимое архива в папку плагинов:
<Steam>\steamapps\common\Valheim\BepInEx\plugins\Jotunn\. - Запустите игру через Steam.
Links úteis:
