Harmoni

Catatan
Ini adalah distribusi tidak resmi dari Harmonipustaka yang dibuat untuk memberikan cara yang lebih mudah dalam mengelola dependensi pustaka eksternal.
Repositori mod - Bannerlord.Harmony.

Pengumuman Bannerlord.Lib.Harmony untuk Modder
Asli Harmoniperpustakaan sekarang sepenuhnya mendukung netstandard2.0, jadi kami kembali ke sana. garpu perpustakaan sekarang sudah tidak digunakan lagi.

Instalasi
Modul ini harus berada di urutan paling atas dalam urutan pemuatan. Modul lain yang perlu ditempatkan di urutan paling atas (Better Exception Window, ButterLib, MCM, dll.) harus dimuat setelah mod ini.

Untuk Pemain
Mod ini dimaksudkan untuk memastikan bahwa semua mod dalam daftar mod pemain menggunakan versi Harmony terbaru untuk meminimalkan konflik.

Untuk Modder
Kami menambahkan UI Debug! Tersedia melalui CTRL+ALT+H.

Anda masih perlu merujuk Harmony sebagai paket NuGet, tidak diharuskan menyertakan 0Harmony.dll dalam keluaran /bin akhir modul Anda.
Anda perlu menambahkan ini ke SubModul.xml
<DependedModules>
<DependedModule Id="Bannerlord.Harmony" />
</DependedModules>
Dengan cara ini permainan akan memastikan bahwa pustaka Harmony dimuat sebelum mod Anda.

Versi
Modul ini menggabungkan versi Harmony yang digunakan dan ID Build yang menerbitkan Modul tersebut. ID Build cukup ditambahkan di bagian akhir.
2.0.2.22 menunjukkan bahwa Harmony 2.0.2.0 digunakan dan 22 adalah ID Build.
2.0.0.1025 menunjukkan bahwa Harmony 2.0.0.10 digunakan dan 25 adalah ID Build.

Kami mempertimbangkan untuk menggunakan pendekatan Rimworld dengan memperkenalkan sistem versi kami sendiri, tetapi pendekatan tersebut tidak memberikan cara yang jelas untuk mendeteksi versi Harmony yang terdapat dalam Modul. Lebih mudah bagi pengguna untuk melaporkan versi Modul yang digunakan daripada memeriksa versi assembly/mengirimkannya.

Pemecahan Masalah
* Kesulitan mengekstrak arsip? Instal melalui Vortex, atau unduh 7-zip. JANGAN GUNAKAN APAPUN DARI WINDOWS APP STORE.
   Kami juga menambahkan artikel tentang cara menginstal dan menggunakan 7-zip!
* Jika game mogok saat dijalankan, kemungkinan besar Anda menggunakan atau pernah menggunakan Peluncur Tetap. Saat diinstal, peluncur tersebut menyalin 0Harmony.dll yang mencegah Bannerlord.Harmony berfungsi.
* Jika Peluncur Tetap dihapus instalasinya atau tidak pernah diinstal, periksa apakah file-file berikut tidak ada di folder utama /bin game (Mount & Blade II
Bannerlord\bin\Win64_Shipping_Client)
- TaleWorlds.MountAndBlade.Launcher.exe.config
- 0Harmony.dll
- LauncherPatcher.dll
- LauncherPatcher.pdb

Tentang
Harmony memberi Anda cara yang elegan dan canggih untuk mengubah fungsionalitas dalam aplikasi yang ditulis dalam C#. Harmony berfungsi dengan baik dalam game dan sudah mapan dalam judul-judul seperti 7 Days To Die, BattleTech, Besiege, Cities:Skylines, Kerbal Space Program, Oksigen Tidak Termasuk, Ravenfield, Rimworld, Sheltered, Stardew Valley, Staxel, Subnautica, Game Nerd Terbaik, Total Miner, Unturned dan masih banyak lagi.

Ini juga digunakan dalam pengujian unit kontrol WFP dan di banyak area lainnya.

Cara kerjanya
Jika Anda mengembangkan dalam C# dan kode Anda dimuat sebagai modul/plugin ke dalam aplikasi host, Anda dapat menggunakan Harmony untuk mengubah fungsionalitas semua assembly yang tersedia di aplikasi tersebut. Sementara pustaka patch lain hanya memungkinkan Anda mengganti metode aslinya, Harmony selangkah lebih maju dan memberikan Anda:

• Cara untuk menjaga metode asli tetap utuh
• Jalankan kode Anda sebelum dan/atau setelah metode asli
• Ubah dokumen asli dengan prosesor kode IL
• Beberapa patch Harmony hidup berdampingan dan tidak saling bertentangan
• Bekerja saat runtime dan tidak menyentuh file apa pun

Dokumentasi
Silakan periksa dokumentasi.

Menyumbang
pardeike Luangkan ribuan jam untuk proyek ini dan dukungannya. Jadi, setiap tindakan kecil sangat membantu:
• Upvote ini jawaban stackoverflow
• Sebarkan informasi ini di komunitas pengembang Anda
• Menjadi Sponsor GitHub atau sebuah Patreon

Proyek ini menggunakan yang hebat MonoMod.Umum perpustakaan oleh 0x0ade.