Hati Wolf Companion

Package 0.7.38 · Gameplay DLL 0.7.37 · Russian interface and dialogue · Install on the server and every client

Hey, Viking! Playing solo? Feeling lonely? Meet your wolf, Hati.

Hati is a large, off-white wolf companion: protection, hunting, gathering, fishing up to 4m deep, a 15-slot/150-weight pocket and saddle riding. Original situational dialogue; no Ollama, external AI service or API key is required.

Start here

Install this package with BepInEx and Jötunn. Enter a world, press F6 → «Позвать Хати». The first call creates your wolf; later calls find the existing one. Hati does not spawn automatically on login. Mark your home on accessible dry land after the first call; spawning in the wilderness does not create a base.

Controls

The game interaction/jump/crouch mappings are respected. No side mouse button? F6 → «Клавиши» lets you bind the wheel and panel to keyboard or mouse keys. Controller support is not claimed.

Aim before opening the wheel. Orders: Взять (attack), Рядом (follow), Место (wait at aimed ground), Дом здесь (mark home), Домой (return), Отойди (move aside), Искать (gather), Ловить рыбу (fish). Hover descriptions explain each order. Three Follow/Away orders within 5 seconds perform a safe dry-land teleport; a different order resets the sequence.

What Hati does

• Fishing pursues nearby real fish up to 4m deep, using native collision avoidance near visible water and while swimming. Supports separate native pickup prefabs and reports missing fish/cargo capacity. No pickup filters.

• Automatic native Wisp mist-clearing aura with 1.5 times the vanilla Wisp radius at rest. Movement adds bounded forward lead and up to double that radius; its force field stays enabled. Active including riding, downed and waiting for dawn; hidden with Hati when configured to wait outside a dungeon. No Wisp equipment or fuel required. Normal Wisp unchanged.

• Passive / protective / aggressive behaviour; direct hunting orders work in passive mode. Protection prioritises the owner and can defend tamed animals/Hati. Players and tamed creatures are not prey.

• Recorded owner peaks give double maximum health, armour and mounted stamina; injured bites use 1.5–2 times recorded mean weapon damage adjusted for the owner’s matching skill and another ×2 at night, with ±10% per-bite variation within a final 200 day / 300 night cap. Boss damage is halved (up to 100/150). Terrain and special NPC damage channels are excluded from the weapon record; native critical multipliers cannot exceed the bite curve. After upgrading, equip your best weapon again to re-record attack; HP/armour history is kept. Armour mitigation is capped at 65%.

• Successful bites apply capped bleeding. Lifesteal retains 2/3/5% injury tiers, scaled by enemy maximum health relative to Hati (×0.5–2); actual damage and missing health cap the result. Bleeding does not trigger additional healing.

• Animal food/eggs and explicitly selected trophies/bones can heal or revive. Three meal tiers: 10 HP/5s, 20 HP/5s, 30 HP/4s until full health. Out of combat, standing for 20 seconds enables 40 HP every 5 seconds; moving on land heals 10 HP every 5 seconds. Combat/damage resets the timer. The same rates apply at home and away.

• Downed Hati lies until the next sunrise; eligible food revives him before it. Dawn returns him home, or waits for the owner on dry land if unmarked. Calls do not revive him.

• Gathers ground loot except weapons/armour and supported berries/mushrooms, including grown mushrooms at base. Does not harvest carrots, turnips or grain, cut wood or mine ore. Catches real shallow fish and respects player fishing hooks. Cargo capacity and source ownership are checked before collection.

• Ground unloading only: no chest management. Full cargo cannot override point/home/away orders. Repeated calls do not create another wolf.

• Saddle recipe: 10 deer hides, 20 leather scraps and one full bone-fragment stack. Walk/run/swim are twice the owner's corresponding speeds; swim stamina is free. Hati swims behind ships, never boards or teleports to the deck. Following Hati enters dungeons at ordinary wolf size and cannot be ridden inside. Health, stats, cargo and saddle persist. Exit restores the large rideable body. F6 preferences: accompany (default) or protected waiting outside. Stay orders prevent transfers; use Follow to leave together. Changing to outside waiting while inside applies on the next entrance. Dungeon spacing is 2m; after 8s stuck outside combat he attempts a safe nearby landing.

• Original wolf habits, calm waiting/sleep, recovery, hidden dry-land catch-up, obstacle handling and air-threat evasion. Terrain is still subject to game physics; evasion is not invulnerability. Pack summoning is absent.

Полная русская инструкция

Викинг, играешь один и хочется спутника? Позови Хати через F6. Подробные кнопки, команды, точные бонусы, рацион, карман, седло и правила смерти — в руководстве игрока ниже. Краткая справка есть в F6 → «О Хати», а описания команд — под кругом при наведении.

Multiplayer, updates and limitations

Every player and the server need BepInEx, Jötunn and the same Hati version 0.7.37; patch-version checks are strict. Close the game/server before replacing the DLL and remove duplicate copies. Items persist in Hati's pocket. Take them and dismiss Hati before uninstalling; empty extra slots/reduce weight before downgrading to a smaller pocket.

Console optional (-console, F5; no devcommands): companion dog, dogfollow, dogstay, status, dismissdog. The command prefix is companion. F6 supports normal use without the console.

1723 local checks passed, including simulated native component/network tests and compilation against installed Valheim dependencies. Actual movement, animations, FPS, server delivery and other-mod compatibility require gameplay verification. This remains beta, not a verified 1.0 release. For bugs include the versions, solo/server setup, reproduction steps, other mods and relevant BepInEx/LogOutput.log errors. Test on a copy of your world.

Support Hati / Поддержать Хати

Поддержать разработку через ЮMoney / Support development

Хати бесплатный. Если путешествия с ним стали уютнее, можно добровольно поддержать дальнейшую разработку. Спасибо, викинг!

Hati is free. Donations are optional and support continued development. Thank you, Viking!

Credits and AI disclosure

Developed with substantial AI assistance for C# and documentation; the icon was generated with an AI image tool. No generative AI runs during gameplay. Wolf models, animations and game objects are obtained from installed Valheim; game assets and dependency DLLs are not included. BepInEx, Harmony and Jötunn are provided by their respective projects.

Russian guide

Начало игры

1. Установи мод через менеджер или положи одну DLL в BepInEx/plugins при закрытой игре. Нужны BepInEx и Jötunn.
2. На выделенном сервере мод и его зависимости должны стоять у сервера и каждого игрока; версия Хати у всех — 0.7.37.
3. Войди в мир, нажми F6 → «Позвать Хати». Первый вызов создаёт твоего волка, последующие зовут существующего. Консоль не нужна. Автоматического появления при входе нет.
4. На базе отметь «Дом здесь» или дом во вкладке «Дом», при желании — будку и место выгрузки. Отметка не строит будку. Место первого призыва не считается домом автоматически. Старые отметки сохраняются.

Кнопки

E, пробел и Ctrl — стандартные игровые назначения. Если ты менял их в Valheim, используй свои кнопки: подсказки учитывают назначения игры. Управление контроллером не заявлено.

Нет боковой кнопки мыши: F6 → «Клавиши» → изменить кнопку круга → нажать удобную клавишу. Клавиша панели тоже меняется; назначения сохраняются на этом компьютере. Esc и левая кнопка мыши зарезервированы; панели и кругу нужны разные кнопки. При закрытой игре сброс: PanelKey = F6, WheelKey = Mouse3 в BepInEx/config/com.aifriend.valheimaicompanion.cfg. Mouse3 означает четвёртую кнопку мыши.

Приказы

Описания показываются внизу экрана при наведении на сектор. Цель или точку выбери прицелом до открытия круга.

Три «Рядом» за 5 секунд: безопасный перенос к тебе, примерно на 2,5–5,5 м за спину. Три «Отойди»: перенос на 10–18 м с ожиданием там. Другая команда, смена мира/персонажа или отмена ожидающего запроса сбрасывает серию. Перенос требует свободной сухой точки; не переносит на палубу/в воду/подземелье и не поднимает раненого.

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

Бой и развитие

• Защита: видимые агрессивные существа в 5 м от хозяина; видимые враги, уже выбравшие тебя/Хати целью, до 200 м. При HP ниже 20% остаётся ближняя защита хозяина. Приручённые животные и другие Хати под атакой также защищаются; союзные игроки и NPC из модов в эту систему не включены.
• Агрессия: сам атакует видимых врагов и дикую дичь поблизости. Пассивность: сам не вступает в бой; «Взять» остаётся отдельным прямым приказом.
• Игроков и приручённых животных не выбирает в добычу. После защиты точки возвращается на неё, не отвлекаясь на ожидание лута у туши.
• Максимальные здоровье, защита и запас сил верхом — ×2 лучших замеченных значений хозяина. Рекорды не снижаются при смерти, снятии брони или окончании еды. Броня уменьшает входящий урон по формуле 100/(100 + броня), но не больше чем на 65%.
• Укус — ×1,5–2 лучшего замеченного среднего боевого урона оружия хозяина с учётом навыка: чем ниже HP, тем сильнее. Ночью ещё ×2. Итоговый укус ограничен 200 днём / 300 ночью, по боссам ×0,5 (до 100/150). Урон по дереву/камню и специальные NPC-каналы не входят в рекорд; скрытый удар/оглушение не разгоняют его дополнительно. После обновления возьми лучшее оружие в руки для нового рекорда атаки; здоровье и броня сохранены. В панели показаны текущий расчёт и потолок; сопротивления врага могут уменьшить реальный урон.
• Кровотечение: 3 тика с интервалом 2 секунды; всего 20% заданного урона укуса, максимум 12 HP. Повторный укус обновляет рану без сложения нескольких ран.
• Вампиризм: базовые 2/3/5% максимального HP Хати при здоровье ≥70% / 40–70% / ниже 40%. Множитель — максимальный HP жертвы / максимальный HP Хати, ограниченный ×0,5–2. Лечение не выше нанесённого урона или недостающего здоровья. Промах, блок, кровотечение, игроки и приручённые животные не лечат. Раненого вампиризм не поднимает.
• Хати скрытнее хозяина. Холод, замерзание, яд, сырость, горение, дым, смола и периодический урон духа/молнии не изнуряют его; прямые атаки ранят. Неизвестные эффекты других модов могут действовать.

Корм, отдых и поражение

Принимает сырое/готовое мясо, рыбу (включая пойманную), животные блюда по составу, яйца, хвосты шеек, потроха, мешки с кровью и гнилое мясо. По твоему явному выбору также ест трофеи существ, обломки костей, иссохшую и обугленную кость. Выбранный трофей/кость расходуется как еда; автоматическое кормление их не тратит.

Пищевой реген: 1 порция — 10 HP/5 с, 2 — 20 HP/5 с, 3 — 30 HP/4 с. Первое лечение сразу, затем до 100% HP; максимум 3 порции за цикл. Полностью здоровый Хати и активный третий уровень не тратят дополнительную еду. Смена приказа не отменяет пищевое лечение.

Хати получает только прямой урон от врагов. Лава, кипящее море, падения, дым и периодический урон не снимают HP. Иммунитет не распространяется на всадника.

Вне боя после 20 секунд стояния: +40 HP каждые 5 секунд. При движении по суше вне боя: +10 HP каждые 5 секунд. После остановки снова требуется 20 секунд для усиленного лечения. Дома и вне базы значения одинаковы. Бой, урон и плавание прерывают лечение. Лечение не превышает полное HP. Сон хозяина учитывается, если безопасно. Упавший сам не лечится.

«Домой»: через минуту покоя садится, ещё через две засыпает. «Место»: через минуту садится, через пять минут ожидания засыпает. «Рядом» будит. Сон обозначается Zzz, ранение — отдельным знаком.

При поражении лежит до ближайшего рассвета. Одна подходящая еда поднимает с 35% HP (не менее 10). Если не поднять — на рассвете возвращается к отмеченному дому с 50% HP (не менее 15), затем догоняет. Без дома ждёт живого хозяина на суше: не появляется на корабле или в подземелье. Вызов и тройной свист не заменяют поднятие.

Карман и путешествия

Карман — 15 ячеек, 150 веса. Подходящие предметы можно добавлять в неполные стопки даже при занятых ячейках. Сбор конкретного предмета зависит от оставшегося веса и совместимости стопки. Перегрузка не удаляет предметы; старое сохранение кармана сохраняется.

Забирай вещи через E. «Отнести добычу» выгружает на землю у отмеченного места, иначе дома; сундуки не используются. Автоматическая выгрузка полного кармана работает при следовании у отмеченной базы, не перебивает «Место», «Домой» и «Отойди». Явную выгрузку можно попросить отдельно; после неё сохраняется исходная команда. Собственную выгрузку обратно не подбирает.

Седло: на верстаке 10 оленьих шкур + 20 обрывков кожи + одна полная стопка обломков костей. Ходьба, бег и плавание — ×2 соответствующей скорости хозяина; прыжок учитывает силу прыжка хозяина. Верхом есть запас сил; в воде он не расходуется.

Плывёт за хозяином или кораблём, без посадки и любого ТП на палубу. После портала/возрождения хозяина и при большом отставании догоняет на суше вне кадра; обычный порог расстояния — 100 м, застревание отслеживается отдельно. В подземелье Хати следует размером с обычного волка и участвует в бою. Верхом нельзя; здоровье, характеристики, карман и надетое седло сохраняются. Снаружи возвращается большой размер и езда без повторного седла. F6 → настройки → Подземелья: «Со мной» (по умолчанию) или «Ждать снаружи» (скрыт и защищён). Если переключить на ожидание уже внутри, выйдите вместе — ожидание действует со следующего входа. «Место» удерживает на точке и при выходе; дай «Рядом». В коридорах следует в 2 м; после 8 секунд без продвижения вне боя пробует безопасный перенос рядом. Если нет свободной точки, ждёт, пока ты пройдёшь дальше. Переход не поднимает раненого. Дом, сбор и рыбалка доступны снаружи. Обход и автопрыжок помогают на рельефе, но стены, низкий потолок, крутые склоны и закрытые проходы могут блокировать путь. Под воздушной угрозой пробует уклоняться рядом, не становится неуязвимым.

Консоль, обновление и удаление

Консоль необязательна. Если нужна: аргумент запуска -console, открыть F5; devcommands не требуется.

Перед обновлением закрой игру/сервер и замени одну DLL у всех участников; не оставляй дубликаты. Перед удалением мода забери вещи и удали Хати через панель с подтверждением или команду. Перед откатом на старую вместимость освободи дополнительные ячейки и снизь вес.

Границы готовности

Бета 0.7.37: 1723 локальных проверок прошли. Физика, анимации, FPS, реальная доставка сетевых команд/лечения и совместимость с другими модами требуют игры на тестовом мире и выделенном сервере. Призыв стаи отсутствует. Проект Бьёрна с Ollama отложен; Хати использует оригинальные ситуативные реплики без языковой модели.

Наведение на Хати

Вблизи наводись на видимое тело волка: не нужно искать маленькую физическую капсулу. E открывает карман, Shift+E — посадка; подходящий предмет с панели кормит Хати. Дальность взаимодействия обычная игровая, кормление максимум с 4 м. Сундук или дверь под прицелом сохраняют приоритет; через стены взаимодействовать нельзя. Расширена только область наведения, проходимость и получение урона не менялись.

Аура рассеивания тумана

Хати автоматически рассеивает туман вокруг себя: радиус в покое в 1,5 раза больше штатного светлячка. На ходу аура смещается вперёд и расширяется до удвоенного базового радиуса, чтобы раньше рассеивать туман. Работает во всех режимах и верхом, пока Хати жив и активен; сохраняется при тяжёлом ранении и ожидании рассвета. При ожидании снаружи подземелья скрывается вместе с Хати. Светлячок или топливо хозяину не нужны. Обычный светлячок не изменён.

Рыбалка и заполнение кармана — 0.7.37

«Ловить рыбу» ищет ближайшую подходящую настоящую рыбу в 30 м от хозяина, на глубине до 4 м. Хати идёт к видимой воде, плывёт и ныряет за рыбой; улов кладёт в карман. Не создаёт рыбу из воздуха и не трогает рыбу на крючке. Со скалы напрямую в воду не бросается; стены и глубокая рыба могут мешать.

Если рыбы нет, сообщает об этом; если рыба не помещается, просит забрать вещи. При заполнении различает предел 150 веса и занятые 15 ячеек. Фильтра предметов нет.

«Место» сохраняет указанную точку: Хати не переносится за хозяином после портала. Для следования дай «Рядом». При «Место» Хати удерживает точку: для выхода из подземелья вместе дай «Рядом».

Каждый укус имеет случайный разброс ±10% от расчёта с навыком хозяина. Пределы 200 днём / 300 ночью сохраняются; по боссам — 100 / 150. Защита цели может дополнительно снизить урон. Случайный бросок не повышает постоянный рекорд атаки.

Статус и свободный проход

Над именем Хати показано текущее занятие. Если идти прямо на него, в безопасной обстановке он ненадолго отойдёт в сторону, затем продолжит приказ; отмеченное место не меняется. При кормлении стоя он не отходит. Если проход закрыт с обеих сторон, Хати не телепортируется сквозь стены. Сбор сообщает, когда рядом нет доступных ягод и грибов.