Mod Penginstal Mistria

Mod Penginstal Mistria

Ini adalah penginstal yang sedang dalam proses untuk mod Fields of Mistria. Karena saat ini pengembangannya masih sangat awal, harap diingat bahwa mungkin ada banyak bug dan mungkin tidak berfungsi pada semua sistem. Demikian pula, ia tidak akan mendukung semua mod yang telah dirilis hingga saat ini, setiap mod perlu diperbarui agar dapat berfungsi dengan penginstal ini, yang sudah dilakukan oleh banyak modder.

Instalasi

1. Buat folder mods untuk meletakkan mod Anda
   • Di Windows, Anda ingin membuat folder "mods" di dalam folder Fields of Mistria, di sebelah file data.win
   • Di Steam Deck (atau distro Linux lainnya) Anda juga dapat membuat folder mods di dalam folder Fields of Mistria, atau Anda dapat membuat folder mistria-mods di direktori home Anda.
2. Unduh penginstal dari halaman rilis.
3. Klik dua kali penginstal untuk menjalankannya. Jika tidak dapat mendeteksi lokasi Fields of Mistria, coba letakkan penginstal di folder Fields of Mistria Anda, di sebelah data.win .
4. Klik tombol "Instal" untuk menginstal mod. Jika Anda memiliki mod di folder mods, mod tersebut akan muncul dalam daftar.
5. Saat game diperbarui lagi, jalankan kembali penginstal untuk menginstal ulang mod Anda

Pemecahan masalah

Saya menginstal kosmetik baru, tetapi tidak muncul di game yang sudah ada. Pertama coba unduh MOMI versi terbaru dan instal ulang. Banyak mod kosmetik yang menambahkan kosmetik tersebut juga akan menambahkan kosmetik tersebut untuk dijual di toko, namun pemasang yang lebih lama dari 0.1.3 tidak dapat menambahkan item ke toko. Jika memperbarui penginstal MOMI tidak berhasil, periksa deskripsi mod untuk melihat apakah mod tersebut menjelaskan tentang cara memperoleh kosmetik. Misalnya, beberapa mod mungkin memilih untuk hanya menambahkan item ke Pasar Sabtu. Jika Anda masih mengalami masalah, silakan datang ke Server Discord untuk meminta bantuan.

Penginstal mengatakan tidak dapat menemukan Lokasi Fields of Mistria. Coba tempatkan penginstal di folder Fields of Mistria Anda, di sebelah data.win , ini akan memungkinkan penginstal menemukan permainan.

Penginstal mengatakan tidak dapat menemukan folder mods. Pastikan Anda telah membuat folder bernama "mods" di folder Fields of Mistria Anda, di samping data.win , atau folder bernama mistria-mods di direktori home Anda jika Anda berada di folder tersebut. Dek Uap/Linux.

Penginstal mengatakan tidak menemukan mod apa pun untuk dipasang. Pastikan Anda memiliki mod di folder mod Anda dan mod tersebut kompatibel dengan penginstal. Kalau kurang yakin, cek folder mod, di dalamnya pasti ada file manifest.json . Jika tidak ada, mod tersebut tidak kompatibel dan harus diperbarui oleh pembuat mod.

Penginstal tidak dapat menginstal mod yang berupa file .zip , jadi pastikan mod tersebut diekstraksi. Saat mengekstrak, pastikan folder mod langsung berada di dalam folder mods, bukan di dalam folder lain. Misalnya, jika Anda menginstal "Effe's Decor - Fridge", pastikan struktur foldernya adalah mods -> Effe's Decor - Fridge -> manifest.json dan bukan mods -> Effe's Decor - Fridge -> Effe's Decor - Fridge -> manifest.json .

Saya punya masalah lain. Jika masalah Anda tidak tercantum di atas, silakan datang dan bertanya di Fields of Mistria Discord. Ada saluran #modding yang akan Anda lihat setelah Anda menerima peraturan dan itulah tempat terbaik untuk mendapatkan bantuan. Untuk memberikan informasi lebih lanjut, coba unduh penginstal versi -cli , jalankan penginstal tersebut, lalu ambil tangkapan layar jendela yang muncul. Versi -cli tidak terlihat bagus, tetapi seharusnya memberikan lebih banyak informasi tentang apa yang salah.

Format Mod

Jika Anda seorang modder dan ingin membuat mod Anda kompatibel dengan penginstal ini, silakan lihat folder mods untuk contoh mods. Di bawah ini adalah informasi tentang apa yang Anda perlukan. Ini bukanlah daftar yang lengkap dan dokumentasi lainnya akan ditambahkan di masa mendatang.

manifest.json

{
  "author" : " Mod Author Name " ,
  "name" : " Mod Name " ,
  "version" : " 1.0.0 " ,
  "minInstallerVersion" : " 0.1.3 " ,
  "manifestVersion" : 1
}

Mod Anda akan diberi ID berdasarkan kolom penulis dan nama, jadi pastikan gabungan keduanya unik. Mulai versi 0.1.3 dan seterusnya, penginstal akan memeriksa kolom minInstallerVersion untuk memastikan bahwa penginstal tersebut cukup baru untuk menginstal mod dan memberi tahu pengguna jika mereka tidak dapat menginstal mod tanpa memperbarui penginstal. Bidang manifestVersion belum digunakan, namun akan memungkinkan kompatibilitas mundur di versi penginstal mendatang jika ada perubahan besar pada struktur mod.

fiddle/

File JSON di folder fiddle/ akan digabungkan ke dalam file __fiddle__.json game. Anda dapat memberi nama file sesuai keinginan dan memiliki beberapa nilai JSON dalam satu file atau membaginya menjadi beberapa file sesuai keinginan Anda.

localisation/

File JSON di folder localisation/ akan digabungkan ke dalam file __localisation__.json game. Anda dapat menamainya sesuka Anda, namun harus diakhiri dengan .eng.json atau .jpn.json (atau menggunakan kode bahasa serupa) untuk menentukan bahasa yang digunakan. Untuk saat ini Mistria hanya mendukung bahasa Inggris, tetapi mungkin akan lebih banyak bahasa yang didukung di masa mendatang. Berikut contoh filenya:

localisation/first_mod.eng.json

{
  "letters/first_mod/subject_line" : " Olrics Favour " ,
  "letters/first_mod/local" : " I found something when rummaging through my items the other day and I want you to have it. nn Come see me at the Blacksmith shop when you have a moment. "
}

outfits/

Jika Anda ingin menambahkan pakaian baru ke dalam game, Anda dapat melakukannya dengan menempatkan definisi JSON untuk pakaian tersebut di folder outfits/ dan sprite harus berada di folder images/ . File yang merupakan beberapa frame dari animasi yang sama harus berada di foldernya sendiri, terpisah dari sprite lainnya. Berikut contoh filenya:

{
  "dolphin_tail" : {
    "name" : " Dolphin Tail " ,
    "description" : " A dolphins tale. " ,
    "ui_slot" : " back " ,
    "default_unlocked" : true ,
    "ui_sub_category" : " back " ,
    "lutFile" : " images/lut.png " ,
    "uiItem" : " images/ui.png " ,
    "outlineFile" : " images/outline.png " ,
    "animationFiles" : {
      "back_gear" : " images/tail_animation "
    }
  }
}

Untuk contoh selengkapnya, lihat contoh dolphin_tail .

stores/

Jika Anda ingin menambahkan kategori ke toko, atau item baru ke kategori di toko, Anda dapat melakukannya dengan menempatkan JSON di folder stores/ mod Anda. Di JSON Anda, Anda bisa menentukan daftar kategori baru untuk ditambahkan ke toko, daftar item baru untuk ditambahkan ke kategori atau keduanya. Di bawah ini adalah contoh opsi yang dapat Anda atur:

{
  "items" : [
    {
      "item" : " seed_turnip " ,
      "store" : " general " ,
      "category" : " modded_icon " ,
      "season" : " spring "
    },
    {
      "item" : { "cosmetic" :  " froggy_hat " },
      "store" : " general " ,
      "category" : " modded_icon "
    },
    {
      "item" : { "cosmetic" :  " froggy_hat " },
      "store" : " louis " ,
      "category" : " modded_icon " ,
      "random_stock" : true
    }
  ],
  "categories" : [
    {
      "store" : " general " ,
      "icon_name" : " modded_icon " ,
      "sprite" : " images/icon_modded.png "
    },
    {
      "store" : " louis " ,
      "icon_name" : " modded_icon " ,
      "sprite" : " images/icon_modded.png " ,
      "random_selections" : 5
    }
  ]
}

Jika beberapa mod menambahkan kategori dengan icon_name yang sama ke toko yang sama, hanya satu kategori dengan nama tersebut yang akan ditambahkan. Kunci category untuk suatu item harus selalu cocok dengan icon_name dari kategori yang ingin Anda tambahkan, apakah itu kategori yang telah dimodifikasi atau kategori vanilla. Jika Anda menyetel kunci season untuk suatu item, maka item tersebut akan ditambahkan ke stok musiman untuk kategori tersebut, jika tidak maka akan ditambahkan ke stok sepanjang tahun.

sprites/

Jika Anda ingin menambahkan sprite baru ke dalam game, Anda dapat melakukannya dengan menempatkan sprite di folder images/ dan kemudian membuat file JSON definisi di folder sprites/ . Berikut contoh filenya:

{
  "spr_furniture_stone_storage_chest_spring_v1_bounce" : {
    "IsAnimated" : true ,
    "Location" : " images/v1/bounce " ,
    "OriginX" : 16 ,
    "OriginY" : 56 ,
    "MarginLeft" : 3 ,
    "MarginRight" : 29 ,
    "MarginBottom" : 39 ,
    "MarginTop" : 15
  }
}

Untuk contoh selengkapnya, lihat contoh Effe's Decor - Fridge . File yang merupakan beberapa frame dari animasi yang sama harus berada di foldernya sendiri, terpisah dari sprite lainnya. Sebagai referensi, daftar lengkap properti sprite yang dapat Anda kontrol adalah:

{
  "sprite_name" : {
    "Location" : " imageLocation.png " ,
    "IsAnimated" : true ,
    "BoundingBoxMode" : 2 ,
    "OriginX" : 0 ,
    "OriginY" : 0 ,
    "MarginRight" : 0 ,
    "MarginLeft" : 0 ,
    "MarginTop" : 0 ,
    "MarginBottom" : 0 ,
    "IsPlayerSprite" : true ,
    "IsUiSprite" : true
  }
}

shadows/

Jika Anda ingin menambahkan sprite bayangan ke dalam game, buat file JSON di folder shadows/ dengan bentuk berikut:

{
  "shadow_sprite_name" : {
    "regular_sprite_name" : " spr_regular_sprite_name " ,
    "sprite" : " images/sprite.png " ,
    "is_animated" : false
  }
}

Ini akan membuat sprite baru di folder data.win dengan nama shadow_sprite_name serta entri di animation/generated/shadow_manifest.json yang akan terlihat seperti:

{
  "spr_regular_sprite_name" : " shadow_sprite_name "
}

Jika Anda menggunakan ini, setel minInstallerVersion di manifest.json Anda ke tidak lebih rendah dari 0.1.4

aurie/

Catatan: Saat ini, mod Aurie tidak akan diinstal di Steam Deck/Linux

Jika Anda memiliki Aurie DLL sebagai bagian dari mod Anda, letakkan di folder aurie/ mod Anda. MOMI kemudian akan secara otomatis menginstal Aurie ke pengaturan pemain, mendaftarkan kunci yang diperlukan dan menyalin DLL Anda ke folder Aurie yang benar. Jika Anda melakukan ini, setel minInstallerVersion di manifest.json Anda ke tidak lebih rendah dari 0.2.0 .