Seidr Enchanting — Сейд: рунная ковка

🤖 Мод сгенерирован ИИ / AI-generated mod

Весь код, тексты, локализация, иконки, документация и балансные значения созданы искусственным интеллектом (LLM) под руководством автора. Мод проверялся запуском в Valheim, но в нём возможны ошибки, странные решения и несбалансированные значения. Перед установкой сделайте резервную копию сохранений.

English: This mod is AI-generated. All code, text, localization, icons, documentation and balance values were produced by an AI (LLM) under human direction. It was tested by running the game, but bugs, odd design choices and unbalanced values are possible. Back up your saves.

Мод для Valheim: зачарование снаряжения, аффиксы, руны и уровни локаций. Вдохновлён Valheim Enchantment System и Chaos VES, но написан с нуля: свой код, своя механика и своя панель «Кузня».

Установка

Через мод-менеджер (рекомендуется)

1. Установите Thunderstore Mod Manager или r2modman.
2. Выберите Valheim и профиль.
3. Найдите Seidr Enchanting и нажмите «Установить».
4. Запустите игру через менеджер.

Вручную

1. Установите BepInExPack for Valheim.
2. Распакуйте архив мода в папку Valheim так, чтобы появился путь BepInEx/plugins/SeidrEnchanting/SeidrEnchanting.dll.
3. Запустите игру.

Мод не требует Jotunn и других библиотек, кроме BepInEx.

Что делает мод

• Свитки по тирам биомов: E (Луга/Чёрный лес) → D (Болото/Океан) → C (Горы) → B (Равнины) → A (Туманные земли) → S (Пепельные земли) → S+ (Глубокий Север). Один набор свитков для оружия и брони, без деления на обычные и благословлённые.
• Уровни зачарования +1…+20 с шансами, safety level, понижением или уничтожением при провале, pity-системой и «перегрузкой» (+2 уровня).
• Аффиксы: до 6 слотов, открываются с уровнем, тиры I–V, реролл и замки. 80 аффиксов: 39 для оружия и 41 для брони/щитов, с отдельными пулами и активными эффектами (стихии, вампиризм, отражение, ауры, невидимость).
• Визуал оружия: эффект копируется с оружия-донора Valheim и облегает клинок, следуя за ним в руке и за спиной. Немагические аффиксы получают спокойные парящие руны, а не случайную стихийную сферу.
• Руны и рунные слова: 3 сокета, 8 рун, бонусы за слова.
• Локации: тир биома определяет дроп свитков; нативный мировой уровень игры влияет на качество и силу зачарования; элитные враги (опционально).
• QoL: авто-зачарование до цели, разбор в рунную пыль, обмен 3→1, импорт предметов из VES.
• Поддержка модов: Therzie Armory, Therzie Warfare, SouthsilArmor и CAH уже размечены по тирам; предметы из других модов добавляются в AdditionalItems.txt.
• Интерфейс: тёмное стекло, золото, руны, анимация, RU/EN.

Управление

• Y — открыть/закрыть панель «Кузня» (клавишу можно изменить в конфиге).
• Наведите предмет на панель, чтобы увидеть аффиксы, шансы и кулдауны.
• Свитки, руны и пыль лежат в инвентаре; рецепты свитков — на верстаке.

Совместимость

• Valheim (Steam, актуальная версия) + BepInEx 5.4.23xx.
• Мод заменяет VES. Перед установкой уберите sighsorry-Valheim_Enchantment_System из BepInEx/plugins, иначе оба мода будут менять одни и те же статы. Импорт уже зачарованных вещей встроен.
• Для мультиплеера установите одинаковую версию мода на сервер и на клиенты: мод добавляет новые предметы и аффиксы.

Поддержка модов

Встроены тиры и пулы аффиксов для Therzie Armory, Therzie Warfare, SouthsilArmor и CAH — их предметы не нужно настраивать вручную.

Предметы из любых других модов добавляются в BepInEx/config/SeidrEnchanting/AdditionalItems.txt (файл создаётся при первом запуске):

SwordMyMod = B
ArmorMyMod = A, armor
ShieldMyMod = S, shield
QuestItemMyMod = skip

• <PrefabName> = <тир>[, <категория>]; тиры: E, D, C, B, A, S, S+.
• Категории: weapon, armor, shield, auto, skip (можно по-русски).
• Если тир не указан, сработает эвристика по имени предмета.
• Записи из файла важнее встроенных списков.
• seidr mods в консоли покажет, какие предметы модов найдены и покрыты.

Настройки

Файл: BepInEx/config/narukami.seidr.enchanting.cfg.

Точные значения аффиксов, формулы и таблицы описаны в исходниках (docs/AFFIXES.md в репозитории).

Об использовании ИИ

Этот мод — эксперимент по созданию полноценного мода для Valheim с помощью ИИ. Модель сгенерировала:

• код плагина, Harmony-патчи, UI и процедурную графику;
• 80 аффиксов, их описания, шансы и кулдауны;
• свитки, руны, рецепты, локализацию RU/EN;
• эту страницу и сопроводительную документацию.

Человек задавал направление, проверял сборку и запускал игру для проверки эффектов. Из-за этого в моде возможны нестандартные решения, опечатки и краевые случаи. Если вы нашли баг — опишите его в комментариях к моду.

English summary: AI-generated Valheim mod adding 80 affixes, seven scroll tiers (E–S+), +1…+20 enchanting, rune sockets, donor-based weapon VFX, and built-in support for Therzie Armory/Warfare, SouthsilArmor and CAH. Custom mod items can be added in AdditionalItems.txt. Requires BepInEx 5.4.23xx. Not compatible with VES. Back up your saves.

Сборка из исходников

.\build.ps1            # собрать DLL
.\build.ps1 -Install   # собрать и установить в BepInEx/plugins
.\tools\package.ps1    # собрать архив для Thunderstore в dist/

Требуется .NET SDK 8+ и установленный Valheim.

Changelog

0.5.6

Мод сгенерирован ИИ (AI-generated).

Небольшой фикс поверх 0.5.5.

• Проверка оглушения цели (Character.IsStaggering) теперь защищена от того же вылета, что и проверка приседа: обе идут через аниматор, которого может не быть у только что заспавненного или уже мёртвого персонажа.
• Добавлен автотест, который воспроизводит падавший стек: аниматор выключен, контроллер снят — вызова исключения нет.

English summary: Small fix on top of 0.5.5. The target stagger check is now guarded against the same animator crash as the crouch check, and an automated test reproduces the failing stack with the animator disabled and its controller removed.

0.5.5

Мод сгенерирован ИИ (AI-generated).

• Полностью проверены все 46 характеристик и все 44 активных эффекта аффиксов на живой игре: 47 замеров «до/после», ни одного провала.
• Исправлен вылет по стеку MonsterAI.UpdateTarget → патч невидимости → Player.IsCrouching → Character.GetCurrentAnimHash → Animator.GetCurrentAnimatorStateInfo. Проверка приседа больше не обращается к выключенному или отсутствующему аниматору, и весь вызов дополнительно обёрнут в перехват. Та же защита добавлена для проверки оглушения цели.
• Исправлено снижение урона, сопротивление падению и взрывам: они не действовали на урон от падения и удары окружения, потому что встроенный HitData.ApplyModifier не трогает поле, куда игра пишет такой урон.
• Исправлен «Дух» — бонус не попадал в урон оружия.
• Исправлен «Дробящий удар» — не работал ни на монстрах, ни на игроке.
• Исправлена скорость плавания — бонус применялся с задержкой в кадр.
• Исправлены бонусы HP, выносливости и эйтра — накапливались с каждым входом в мир и портили сохранение персонажа.
• Удалены характеристики, которые ни на что не влияли.

English summary: Every one of the 46 stats and all 44 active affix effects was verified against the running game (47 before/after measurements, no failures). Fixed the crash whose stack was MonsterAI.UpdateTarget → the invisibility affix → Player.IsCrouching → Character.GetCurrentAnimHash → Animator.GetCurrentAnimatorStateInfo: the crouch check no longer touches a disabled or missing animator and the whole call is guarded; the same guard now covers the target stagger check. Fixed damage reduction, fall and blast resistance not applying to fall damage and environmental hits, because the built-in HitData.ApplyModifier does not scale the field the game writes those damages into. Fixed Spirit damage missing from weapons, armor break doing nothing, swim speed lagging one frame, and flat HP/stamina/eitr bonuses stacking on every world load.

0.5.0

Мод сгенерирован ИИ (AI-generated). Сборка не публиковалась: все её правки вошли в 0.5.5.

• Обычный крафт свитка выдаёт 20 свитков своего биома, стак свитков — 100.
• Исправлены вылет невидимости, дроп на выделенном сервере и регистрация префабов в сети.

0.4.2

Мод сгенерирован ИИ (AI-generated).

• Промежуточная сборка: правки 0.5.0 (20 свитков за крафт, стак 100, исправление NRE и дропа на дедик-сервере) собирались под этим номером, но не публиковались. Используйте 0.5.5.

0.4.1

Мод сгенерирован ИИ (AI-generated).

• В начало README добавлена ссылка на Discord-сервер мода: https://discord.gg/4duXAv2Fra.
• Включает все изменения 0.4.0: благословлённые свитки, разбор трофеев и удаление рун.

0.4.0

Мод сгенерирован ИИ (AI-generated).

Крупное обновление по сравнению с 0.3.0: руны убраны, добавлены благословлённые свитки и разбор трофеев с индивидуальной ценой.

Добавлено

• Благословлённые свитки — отдельный предмет для каждого тира (SeidrBlessedScroll_E … SeidrBlessedScroll_SP). Гарантируют успех одной попытки зачарования и расходуются. Иконки с золотым отблеском.
• Крафт благословлённых свитков — 7 новых рецептов на верстаке: материалы тира + рунная пыль + редкий материал + трофей. Уровень станции на 1 выше, чем у обычного свитка того же тира. Всего рецептов свитков теперь 14 (7 обычных + 7 благословлённых).
• Обмен благословлённых свитков — 3 благословлённых свитка одного тира объединяются в благословлённый свиток следующего тира. Обычные и благословлённые свитки не смешиваются при обмене.
• Разбор трофеев — новое окно в «Кузне» (кнопка «Разобрать трофеи в пыль»). Показывает каждый трофей, его количество и цену в рунной пыли. Один клик разбирает ровно один трофей, пыль сразу попадает в сумку. Список разбит на страницы по 8 трофеев.
• Индивидуальные цены трофеев — у каждого ванильного трофея своя цена: от 4 пыли за шею до 160 за Фадера. Боссы и поздние биомы дают заметно больше. Модовые трофеи без явной цены считаются по тиру биома и стоимости предмета.
• Переключатель «Благословение» в панели «Кузня»: выбирает обычный или благословлённый свиток, показывает гарантированный успех и остаток в сумке.
• Дроп благословлённых свитков — боссы с шансом 75%, редкие (звёздные) враги с небольшим шансом, зависящим от тира биома.
• Тултипы: у свитков показан вариант (обычный/благословлённый), у трофеев — сколько пыли даст разбор.
• Команды: seidr blessed <тир|all> [кол-во], seidr trophies, seidr drop <тир> [кол-во] blessed.

Изменено

• Свитки теперь двух вариантов: обычный (шанс) и благословлённый (100% успех). Формат хранения: E и E:blessed; старые поля category:tier:blessed читаются и мигрируют автоматически.
• Обычные и благословлённые свитки имеют раздельные префабы, рецепты и иконки; благословлённые дороже и требуют более высокий верстак.
• Тултип рунной пыли теперь упоминает и перековку аффиксов, и крафт благословлённых свитков.
• Рецепт свитка A: RefinedEitr заменён на Softtissue (префаба RefinedEitr в игре нет).
• Проверка звёздных врагов для дропа теперь через Character.GetLevel().

Удалено

• Руны: предметы рун, сокеты, рунные слова и бонусы полностью убраны. В «Кузне» больше нет блока рун и кнопки извлечения руны.
• Руны больше не выпадают из монстров и не показываются в тултипах.
• Команда seidr rune удалена (заменена на seidr blessed).
• Звук установки руны заменён звуком разбора.

Обновление с 0.3.0

• Сохранения совместимы. Старые префабы SeidrRune_* и маркер seidr.rune перенаправлены на рунную пыль — предметы из инвентаря и мира не исчезают, а превращаются в пыль.
• Старые SeidrScroll_*_Blessed указывают на обычные свитки соответствующего тира: новый благословлённый свиток — это отдельный предмет.
• Старые сокеты и рунные слова удаляются из данных предмета при загрузке; их бонусы больше не применяются.
• Конфиг, AdditionalItems.txt и остальные настройки не менялись.

English summary: Removed runes (items, sockets, rune words). Added blessed scrolls (SeidrBlessedScroll_*) with guaranteed success, 7 new recipes, and blessed-to-blessed transmutation. Added trophy salvage with per-trophy dust values and a dedicated salvage window. Bosses drop blessed scrolls (75%). Old rune items convert to runic dust; old blessed scrolls convert to normal scrolls. 14 scroll recipes total.

0.3.0

Мод сгенерирован ИИ (AI-generated).

• Поддержка Therzie Armory, Therzie Warfare, SouthsilArmor и CAH: тиры и пулы аффиксов заданы для 539 предметов этих модов.
• BepInEx/config/SeidrEnchanting/AdditionalItems.txt — список предметов из любых других модов. Формат: PrefabName = B, PrefabName = A, armor, PrefabName = skip. Записи пользователя важнее встроенных.
• Новая команда seidr mods: показывает, сколько снаряжения модов найдено и покрыто, какие префабы остались без тира.
• Бомба BombSpirit_TW исключена из зачарования, хотя у неё оружейный ItemType.
• Свитки и аффиксы для модовых предметов работают по тем же правилам, что и для ванильных: тир определяет дроп и силу, категория — пул аффиксов.

0.2.0

Первый публичный релиз. Мод сгенерирован ИИ (AI-generated).

• 80 аффиксов: 39 для оружия и 41 для брони/щитов, с отдельными пулами, тирами I–V и активными эффектами.
• Семь тиров свитков: E, D, C, B, A, S, S+ — единый набор для оружия и брони, без деления на обычные и благословлённые.
• Заточка +1…+20: шансы, safety level, понижение/уничтожение при провале, pity-система и перегрузка (+2 уровня).
• Руны: 3 сокета, 8 рун, рунные слова и бонусы.
• Донорские VFX оружия: эффект копируется с реального оружия Valheim и следует за клинком в руке и за спиной. Немагические аффиксы получают процедурные парящие руны.
• Панель «Кузня» (Y), тултипы с шансами и кулдаунами, RU/EN.
• QoL: авто-зачарование, разбор в рунную пыль, обмен 3→1, импорт из VES.
• Дроп свитков по биомам, нативный мировой уровень, элитные враги.
• Миграция старых данных: старые тиры свитков приводятся к новой сетке, blessed-поля игнорируются.