Harmony

Для ранней версии, пожалуйста, посетите это! Для версии v1.0.0-v1.2.12, пожалуйста, посетите эту страницу! (this!, this!)

Если вы испытываете вражду с игровыми очками v1.0.0-v1.2.12

Этот мод Harmony совместим с v1.3.4 и выше. Вместо этого используйте Harmony v1.0.0-v1.2.12! (Harmony v1.0.0-v1.2.12)

Для владельцев коллекций

Прочитайте сообщение выше и переключитесь на версию Гармонии v1.0.0-v1.2.12!

Библиотека для исправления, замены и украшения методов .NET и Mono во время выполнения. Предназначен для обеспечения того, чтобы все моды в модлисте игрока использовали последнюю версию Harmony для минимизации конфликтов. Мы также добавили интерфейс Debug! Доступно через CTRL+ALT+H.

Заметки

Это неофициальное распространение библиотеки Гармонии, поддерживаемой сообществом, чтобы иметь более простой способ управления внешними библиотечными зависимостями. Репозиторий мода — Bannerlord. Гармония. (Harmony, Bannerlord.Harmony)

Установка

Этот модуль должен быть самым высоким по порядку загрузки. Любой другой модуль, который должен быть установлен сверху (Better Exception Window, ButterLib, MCM и т. д.), должен быть загружен после этого мода.

Для игроков

Этот мод предназначен для обеспечения того, чтобы все моды в модлисте игрока использовали последнюю версию Harmony для минимизации конфликтов.

Для моддеров

Мы добавили интерфейс Debug! Доступно через CTRL+ALT+H.

Вы все равно должны ссылаться на Harmony как на пакет NuGet, он не должен включать 0Harmony. dll в окончательном выводе /bin вашего модуля. Вы должны добавить это в свой SubModule.xml

Таким образом, игра обеспечит загрузку библиотеки Harmony перед модом.

Версия

Модуль сочетает в себе версию Harmony и Build Id, который опубликовал модуль. Строительный код просто добавляется к концу. 2.0.2.22 указывает, что используется Гармония 2.0.2.0, а 22 - Ид Строительства 2.0.0.1025 указывает, что используется Гармония 2.0.0.10 и 25 - Ид Строительства.

Мы рассматривали возможность использования подхода Rimworld с введением нашей собственной системы версий, но это не даст четкого способа определить, какую версию Harmony содержит Модуль. Пользователю проще сообщить об используемой версии Модуля, чем проверить версию сборки/отправить ее.

Устранение неполадок

• Steam не всегда обновляет все моды. Мы рекомендуем вручную повторно подписаться на Harmony, если вы столкнулись с авариями!

• Убедитесь, что папка модулей (C:\Program Files (x86)\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules) не содержит Bannerlord. Папка Гармонии!

• Если игра падает на старте, возможно, использовался Fixed Launcher. При установке он копирует 0Harmony. Дл, который мешает Баннерлорду. Гармония от работы.

• Если Fixed Launcher был удален или никогда не установлен, проверьте, что следующие файлы не находятся в основной папке /bin игры (Mount & Blade II Bannerlord\bin\Win64 Shipping Client)

• TaleWorlds.MountAndBlade.Launcher.exe.config (если установлен BUTRLoader, переустановите его после)

• 0Harmony.dll

• Разработчик: LauncherPatcher.dll

• Разработчик: LauncherPatcher.pdb

О нас

Harmony дает вам элегантный и высокоуровневый способ изменения функциональности в приложениях, написанных на C#. Он отлично работает в играх и хорошо зарекомендовал себя в таких играх, как 7 Days To Die, BattleTech, Besiege, Cities:Skylines, Kerbal Space Program, Oxygen Not Included, Ravenfield, Rimworld, Sheltered, Stardew Valley, Staxel, Subnautica, The Ultimate Nerd Game, Total Miner, Unturned и многих других.

Он также используется в единичном тестировании элементов управления ВПП и во многих других областях.

Как это работает

Если вы разрабатываете на C# и ваш код загружается в качестве модуля/плагина в хост-приложение, вы можете использовать Harmony для изменения функциональности всех доступных сборок этого приложения. Там, где другие библиотеки патчей просто позволяют вам заменить оригинальный метод, Harmony идет на один шаг дальше и дает вам:

• Способ сохранить оригинальный метод нетронутым

• Выполните код до и/или после оригинального метода

• Измените оригинал с помощью процессоров кода IL

• Несколько патчей гармонии сосуществуют и не конфликтуют друг с другом

• Работает во время выполнения и не касается файлов

Документация

Пожалуйста, проверьте документацию. (documentation)

Содействовать

пардейк вложил тысячи часов в этот проект и его поддержку. Каждое небольшое действие помогает:

• Выберите этот ответ Stackoverflow (stackoverflow answer)
• Распространяйте информацию в сообществах разработчиков
• Станьте спонсором GitHub или Patreon (GitHub sponsor, Patreon)

Этот проект использует большой MonoMod. Общая библиотека 0x0ade. (MonoMod.Common, 0x0ade)