Mods du programme d'installation de Mistria
ersion
Il s'agit du programme d'installation en cours pour les mods Fields of Mistria. Comme il en est actuellement à ses débuts en développement, gardez à l'esprit qu'il peut contenir de nombreux bugs et qu'il peut ne pas fonctionner sur tous les systèmes. De même, il ne prendra pas en charge tous les mods publiés jusqu'à présent, chaque mod devra être mis à jour pour fonctionner avec cet installateur, ce que de nombreux moddeurs font déjà.
data.winmistria-mods dans votre répertoire personnel.data.win . J'ai installé un nouveau produit cosmétique, mais il n'apparaît pas dans les jeux existants. Essayez d'abord de télécharger la dernière version de MOMI et de la réinstaller. De nombreux mods cosmétiques ajouteront ce cosmétique qui sera également vendu dans une boutique, mais les installateurs antérieurs à 0.1.3 ne peuvent pas ajouter d'articles à la boutique. Si la mise à jour du programme d'installation de MOMI ne fonctionne pas, vérifiez la description du mod pour voir s'il explique comment acquérir le cosmétique. Par exemple, certains mods peuvent choisir d'ajouter l'objet uniquement aux marchés du samedi. Si vous rencontrez toujours des problèmes, n'hésitez pas à venir sur le serveur Discord pour demander de l'aide.
Le programme d'installation indique qu'il ne peut pas trouver l'emplacement de Fields of Mistria. Essayez de placer le programme d'installation dans votre dossier Fields of Mistria, à côté de data.win , cela devrait permettre au programme d'installation de trouver le jeu.
Le programme d'installation indique qu'il ne trouve pas le dossier mods. Assurez-vous d'avoir créé un dossier appelé "mods" dans votre dossier Fields of Mistria, à côté de data.win , ou un dossier appelé mistria-mods dans votre répertoire personnel si vous êtes sur le Steam Deck/Linux.
Le programme d'installation indique qu'il n'a trouvé aucun mod à installer. Assurez-vous que vous avez des mods dans votre dossier mods et que les mods sont compatibles avec le programme d'installation. Si vous n'êtes pas sûr, vérifiez le dossier mod, il devrait contenir un fichier manifest.json . Si ce n'est pas le cas, le mod n'est pas compatible et devra être mis à jour par l'auteur du mod.
Le programme d'installation ne peut pas installer de mods qui sont des fichiers .zip , alors assurez-vous que les mods sont extraits. Lors de l'extraction, assurez-vous que le dossier mod se trouve directement dans le dossier mods, et non dans un autre dossier. Par exemple, si vous installez "Effe's Decor - Fridge", assurez-vous que la structure des dossiers est mods -> Effe's Decor - Fridge -> manifest.json et non mods -> Effe's Decor - Fridge -> Effe's Decor - Fridge -> manifest.json .
J'ai un problème différent. Si votre problème n'est pas répertorié ci-dessus, veuillez venir le demander sur le Discord des Champs de Mistria. Il existe une chaîne #modding que vous verrez après avoir accepté les règles et c'est le meilleur endroit pour obtenir de l'aide. Pour fournir plus d'informations, essayez de télécharger la version -cli du programme d'installation, de l'exécuter, puis de capturer la fenêtre qui est apparue. La version -cli n'a pas l'air aussi jolie, mais devrait fournir plus d'informations sur ce qui ne va pas.
Si vous êtes moddeur et souhaitez rendre votre mod compatible avec cet installateur, n'hésitez pas à vous référer au dossier mods par exemple mods. Vous trouverez ci-dessous des informations sur ce dont vous aurez besoin. Il ne s'agit pas d'une liste exhaustive et davantage de documentation sera ajoutée à l'avenir.
manifest.json{
"author" : " Mod Author Name " ,
"name" : " Mod Name " ,
"version" : " 1.0.0 " ,
"minInstallerVersion" : " 0.1.3 " ,
"manifestVersion" : 1
} Votre mod recevra un identifiant basé sur les champs auteur et nom, alors assurez-vous que ces deux combinés sont uniques. À partir de la version 0.1.3, le programme d'installation vérifiera le champ minInstallerVersion pour s'assurer que le programme d'installation est suffisamment récent pour installer le mod et indiquera à l'utilisateur s'il ne peut pas installer le mod sans mettre à jour le programme d'installation. Le champ manifestVersion n'est pas encore utilisé, mais permettra une compatibilité ascendante dans les futures versions du programme d'installation si des modifications importantes sont apportées à la structure des mods.
fiddle/ Les fichiers JSON du dossier fiddle/ seront fusionnés dans le fichier __fiddle__.json du jeu. Vous pouvez nommer les fichiers comme vous le souhaitez et avoir plusieurs valeurs JSON dans un seul fichier ou les diviser en plusieurs fichiers comme bon vous semble.
localisation/ Les fichiers JSON du dossier localisation/ seront fusionnés dans le fichier __localisation__.json du jeu. Vous pouvez les nommer comme vous le souhaitez, mais ils doivent se terminer par .eng.json ou .jpn.json (ou en utilisant un code de langue similaire) pour spécifier la langue à laquelle ils sont destinés. Pour l'instant, Mistria ne prend en charge que l'anglais, mais d'autres langues pourraient être prises en charge à l'avenir. Voici un exemple de fichier :
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/ Si vous souhaitez ajouter de nouvelles tenues au jeu, vous pouvez le faire en plaçant une définition JSON pour la tenue dans le dossier outfits/ et les sprites doivent être dans un dossier images/ . Les fichiers constitués de plusieurs images de la même animation doivent se trouver dans leur propre dossier, distinct des autres sprites. Voici un exemple de fichier :
{
"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 "
}
}
} Pour un exemple complet, consultez l'exemple dolphin_tail .
stores/ Si vous souhaitez ajouter des catégories à une boutique, ou de nouveaux articles à une catégorie dans une boutique, vous pouvez le faire en plaçant un JSON dans le dossier stores/ de votre mod. Dans votre JSON, vous pouvez soit définir une liste de nouvelles catégories à ajouter à un magasin, une liste de nouveaux articles à ajouter aux catégories, ou les deux. Vous trouverez ci-dessous un exemple des options que vous pouvez définir :
{
"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
}
]
} Si plusieurs mods ajoutent une catégorie avec le même icon_name au même magasin, une seule catégorie de ce nom sera ajoutée. La clé category d'un élément doit toujours correspondre au icon_name de la catégorie à laquelle vous souhaitez l'ajouter, qu'il s'agisse d'une catégorie qui a été modifiée ou d'une catégorie vanille. Si vous définissez la clé season pour un article, il sera ajouté au stock saisonnier de cette catégorie, sinon il sera ajouté au stock toute l'année.
sprites/ Si vous souhaitez ajouter de nouveaux sprites au jeu, vous pouvez le faire en plaçant les sprites dans le dossier images/ , puis en créant un fichier JSON de définition dans le dossier sprites/ . Voici un exemple de fichier :
{
"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
}
} Pour un exemple complet, jetez un œil à l'exemple Effe's Decor - Fridge . Les fichiers constitués de plusieurs images de la même animation doivent se trouver dans leur propre dossier, distinct des autres sprites. Pour référence, la liste complète des propriétés des sprites que vous pouvez contrôler sont :
{
"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/ Si vous souhaitez ajouter des sprites d'ombre au jeu, créez un fichier JSON dans le dossier shadows/ avec la forme suivante :
{
"shadow_sprite_name" : {
"regular_sprite_name" : " spr_regular_sprite_name " ,
"sprite" : " images/sprite.png " ,
"is_animated" : false
}
} Cela créera de nouveaux sprites dans le dossier data.win avec le nom shadow_sprite_name ainsi qu'une entrée dans animation/generated/shadow_manifest.json qui ressemblera à :
{
"spr_regular_sprite_name" : " shadow_sprite_name "
} Si vous l'utilisez, veuillez définir minInstallerVersion dans votre manifest.json sur une valeur non inférieure à 0.1.4
aurie/Remarque : Pour le moment, les mods Aurie ne seront pas installés sur Steam Deck/Linux.
Si vous avez des DLL Aurie dans votre mod, placez-les dans le dossier aurie/ de votre mod. MOMI installera alors automatiquement Aurie sur la configuration du lecteur, enregistrera les clés nécessaires et copiera votre DLL dans le bon dossier Aurie. Si vous faites cela, veuillez définir minInstallerVersion dans votre manifest.json sur une valeur non inférieure à 0.2.0 .
