هذا هو برنامج التثبيت قيد التقدم لتعديلات Fields of Mistria. نظرًا لأن تطويره لا يزال مبكرًا جدًا، يرجى الأخذ في الاعتبار أنه قد يحتوي على العديد من الأخطاء وقد لا يعمل على جميع الأنظمة. وبالمثل، فهو لن يدعم جميع التعديلات التي تم إصدارها حتى الآن، وسيحتاج كل تعديل إلى التحديث للعمل مع هذا المثبت، وهو ما يفعله العديد من المعدِّلين بالفعل.
data.win
.mistria-mods
في دليلك الرئيسي.data.win
. لقد قمت بتثبيت عنصر تجميلي جديد، ولكنه لا يظهر في الألعاب الحالية حاول أولاً تنزيل أحدث إصدار من MOMI ثم أعد تثبيته. ستضيف العديد من تعديلات مستحضرات التجميل أن مستحضرات التجميل ستضيف أيضًا مستحضرات التجميل التي سيتم بيعها في متجر، ولكن المثبتات الأقدم من 0.1.3
غير قادرة على إضافة عناصر إلى المتجر. إذا لم ينجح تحديث مثبت MOMI، فتحقق من وصف التعديل لمعرفة ما إذا كان يتحدث عن كيفية الحصول على مستحضرات التجميل. على سبيل المثال، قد تختار بعض التعديلات إضافة العنصر إلى أسواق السبت فقط. إذا كنت لا تزال تواجه مشكلات، فلا تتردد في الذهاب إلى Discord Server لطلب المساعدة.
يقول المثبت أنه لا يمكنه العثور على موقع Fields of Mistria حاول وضع المثبت في مجلد Fields of Mistria الخاص بك، بجوار data.win
، وهذا من شأنه أن يسمح للمثبت بالعثور على اللعبة.
يقول المثبت أنه لا يمكنه العثور على مجلد التعديل. تأكد من أنك قمت بإنشاء مجلد يسمى "mods" في مجلد Fields of Mistria الخاص بك، بجوار data.win
، أو مجلد يسمى mistria-mods
في الدليل الرئيسي الخاص بك إذا كنت على سطح السفينة / لينكس.
يقول المثبت أنه لم يعثر على أي تعديلات لتثبيتها. تأكد من وجود تعديلات في مجلد التعديلات لديك وأن التعديلات متوافقة مع المثبت. إذا لم تكن متأكدًا، فتحقق من مجلد التعديل، حيث يجب أن يكون هناك ملف manifest.json
بداخله. إذا لم يكن الأمر كذلك، فإن التعديل غير متوافق وسيتعين تحديثه بواسطة مؤلف التعديل.
لا يمكن لبرنامج التثبيت تثبيت التعديلات التي تكون عبارة عن ملفات .zip
، لذا تأكد من استخراج التعديلات. عند الاستخراج تأكد من أن مجلد التعديل موجود مباشرة داخل مجلد التعديل وليس داخل مجلد آخر. على سبيل المثال، إذا كنت تقوم بتثبيت "Effe's Decor - Fridge"، فتأكد من أن بنية المجلد هي mods -> Effe's Decor - Fridge -> manifest.json
وليس mods -> Effe's Decor - Fridge -> Effe's Decor - Fridge -> manifest.json
.
لدي مشكلة مختلفة إذا لم تكن مشكلتك مذكورة أعلاه، فيرجى الحضور والاستفسار في مجالات Mistria Discord. هناك قناة #modding
ستراها بعد قبول القواعد وهذا هو أفضل مكان للحصول على المساعدة. لتوفير مزيد من المعلومات، حاول تنزيل إصدار -cli
من برنامج التثبيت، وتشغيله ثم التقاط لقطة شاشة للنافذة التي ظهرت. لا يبدو إصدار -cli
جميلًا، ولكن يجب أن يوفر المزيد من المعلومات حول الأخطاء التي تحدث.
إذا كنت من مستخدمي التعديل وترغب في جعل تعديلك متوافقًا مع برنامج التثبيت هذا، فلا تتردد في الرجوع إلى مجلد mods
على سبيل المثال التعديلات. فيما يلي معلومات عما ستحتاج إليه. هذه ليست قائمة شاملة وسيتم إضافة المزيد من الوثائق في المستقبل.
manifest.json
{
"author" : " Mod Author Name " ,
"name" : " Mod Name " ,
"version" : " 1.0.0 " ,
"minInstallerVersion" : " 0.1.3 " ,
"manifestVersion" : 1
}
سيتم منح التعديل الخاص بك معرفًا يعتمد على حقلي المؤلف والاسم، لذا تأكد من أن هذين الاثنين معًا فريدان. بدءًا من الإصدار 0.1.3 وما بعده، سيتحقق المثبت من حقل minInstallerVersion
للتأكد من أن المثبت جديد بما يكفي لتثبيت التعديل وإخبار المستخدم إذا لم يتمكن من تثبيت التعديل دون تحديث المثبت. لم يتم استخدام حقل manifestVersion
بعد، ولكنه سيسمح بالتوافق مع الإصدارات السابقة في الإصدارات المستقبلية من برنامج التثبيت إذا تم إجراء تغييرات كبيرة على كيفية تنظيم التعديلات.
fiddle/
سيتم دمج ملفات JSON الموجودة في مجلد fiddle/
في ملف __fiddle__.json
الخاص باللعبة. يمكنك تسمية الملفات بالطريقة التي تريدها والحصول على قيم JSON متعددة في ملف واحد أو تقسيمها إلى ملفات متعددة كما تراه مناسبًا.
localisation/
سيتم دمج ملفات JSON الموجودة في مجلد localisation/
في ملف __localisation__.json
الخاص باللعبة. يمكنك تسميتها كيفما تشاء، ولكن يجب أن تنتهي بـ .eng.json
أو .jpn.json
(أو باستخدام رمز لغة مشابه) لتحديد اللغة المخصصة لها. في الوقت الحالي، يدعم Mistria اللغة الإنجليزية فقط، ولكن قد يتم دعم المزيد من اللغات في المستقبل. إليك ملف مثال:
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/
إذا كنت ترغب في إضافة أزياء جديدة إلى اللعبة، يمكنك القيام بذلك عن طريق وضع تعريف JSON للزي في مجلد outfits/
ويجب أن تكون الكائنات في مجلد images/
. يجب أن تكون الملفات التي تكون عبارة عن إطارات متعددة لنفس الرسوم المتحركة في مجلد خاص بها، منفصلة عن الكائنات الأخرى. إليك ملف مثال:
{
"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 "
}
}
}
للحصول على مثال كامل، راجع مثال dolphin_tail
.
stores/
إذا كنت تريد إضافة فئات إلى متجر، أو عناصر جديدة إلى فئة في متجر، فيمكنك القيام بذلك عن طريق وضع JSON في stores/
المجلد الخاص بتعديلك. في JSON الخاص بك، يمكنك إما تحديد قائمة بالفئات الجديدة لإضافتها إلى المتجر، أو قائمة بالعناصر الجديدة لإضافتها إلى الفئات أو كليهما. فيما يلي مثال على الخيارات التي يمكنك تعيينها:
{
"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
}
]
}
إذا أضافت عدة تعديلات فئة تحمل نفس icon_name
إلى نفس المتجر، فستتم إضافة فئة واحدة فقط بهذا الاسم. يجب أن يتطابق مفتاح category
الخاص بعنصر ما دائمًا مع icon_name
للفئة التي تريد إضافتها إليها، سواء كانت فئة تم تعديلها أو فئة فانيليا. إذا قمت بتعيين مفتاح season
لعنصر ما، فستتم إضافته إلى المخزون الموسمي لهذه الفئة، وإلا فستتم إضافته إلى المخزون على مدار العام.
sprites/
إذا كنت تريد إضافة نقوش متحركة جديدة إلى اللعبة، فيمكنك القيام بذلك عن طريق وضع النقوش المتحركة في مجلد images/
ثم إنشاء ملف تعريف JSON في مجلد sprites/
. إليك ملف مثال:
{
"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
}
}
للحصول على مثال كامل، قم بإلقاء نظرة على مثال Effe's Decor - Fridge
. يجب أن تكون الملفات التي تكون عبارة عن إطارات متعددة لنفس الرسوم المتحركة في مجلد خاص بها، منفصلة عن الكائنات الأخرى. كمرجع، القائمة الكاملة لخصائص الكائنات التي يمكنك التحكم فيها هي:
{
"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/
إذا كنت تريد إضافة كائنات الظل إلى اللعبة، فقم بإنشاء ملف JSON في مجلد shadows/
بالشكل التالي:
{
"shadow_sprite_name" : {
"regular_sprite_name" : " spr_regular_sprite_name " ,
"sprite" : " images/sprite.png " ,
"is_animated" : false
}
}
سيؤدي هذا إلى إنشاء كائنات جديدة في مجلد data.win
باسم shadow_sprite_name
بالإضافة إلى إدخال في animation/generated/shadow_manifest.json
والذي سيبدو كما يلي:
{
"spr_regular_sprite_name" : " shadow_sprite_name "
}
إذا كنت تستخدم هذا، فيرجى تعيين minInstallerVersion
في manifest.json
الخاص بك على ما لا يقل عن 0.1.4
aurie/
ملحوظة: في الوقت الحالي، لن يتم تثبيت تعديلات Aurie على Steam Deck/Linux
إذا كان لديك ملفات Aurie DLLs كجزء من تعديلك، فضعها في مجلد aurie/
الخاص بتعديلك. ستقوم MOMI بعد ذلك بتثبيت Aurie تلقائيًا على إعداد المشغلات، وتسجيل المفاتيح الضرورية ونسخ ملف DLL الخاص بك إلى مجلد Aurie الصحيح. إذا قمت بذلك، يرجى تعيين minInstallerVersion
في manifest.json
الخاص بك على ما لا يقل عن 0.2.0
.