رموز التوافق بين التعديلات (CMCT)

تضيف رموز التوافق بين التعديلات بعض رموز Content Patcher الخاصة والمخصصة، والتي تتيح لك (إذا كنتَ مُنشئ تعديل) الوصول إلى قيم التكوين والترجمات والرموز الديناميكية من تعديلات أخرى، بما في ذلك التعديلات غير المُصممة خصيصًا لـ Content Patcher. قد تكون هذه الرموز مفيدة إذا لم يكن لديك طريقة أخرى لضمان التوافق التام بين تعديلك وتعديلهم، إذا احتجتَ إلى تغيير أي شيء بناءً على أي من القيم المذكورة أعلاه.

تثبيت

• قم بتثبيت أحدث إصدار من SMAPI.
• قم باستخراج التعديل في Stardew Valley/Mods.
• قم بتشغيل اللعبة باستخدام SMAPI.
  

الاستخدام للاعبين
هذا التعديل لا يفعل شيئًا بمفرده. لا فائدة من تثبيته كمستخدم إذا كان تعديل آخر تستخدمه لا يتطلبه.

استخدام لمؤلفي تعديل Content Patcher
يضيف هذا التعديل أربعة رموز:

• Spiderbuttons.CMCT/Config
• Spiderbuttons.CMCT/الترجمة
• Spiderbuttons.CMCT/ديناميكي
• Spiderbuttons.CMCT/الأصول
  

كلٌّ من هذه الرموز سيسمح لك بالحصول على قيم التكوين، أو سلاسل الترجمة، أو قيم الرموز الديناميكية، أو مفاتيح الأصول الداخلية على التوالي. جميعها الأربعة يتطلب وسيطات الإدخال. ستكون وسيطة الإدخال الأولى دائمًا هي المُعرِّف الفريد للمُودِّل الذي تحاول الحصول على القيمة منه. تعتمد وسيطة الإدخال الثانية على الرمز المُراد:

• التكوين: اسم قيمة التكوين المطلوب البحث عنها. إذا كانت قيمة التكوين مُتداخلة، يجب تضمين مسار التكوين الكامل بناءً على بنية JSON.
• الترجمة: مفتاح i18n للترجمة التي تريدها. سيعرض دائمًا ترجمة اللغة المحددة حاليًا.
• ديناميكي: اسم الرمز الديناميكي.
• الأصل: مسار الأصل من الوضع الآخر بالنسبة إلى هُم ملف manifest.json.
  

إذا كنت تستخدم أيًا من هذه الرموز، فأنت يجب اضبط التعديل الآخر كاعتمادية. إذا لم تفعل، فسيؤدي ذلك إلى قد يعمل، ولكنه قد يُسبب لك بعض الأخطاء الغريبة. إليك أربعة أمثلة، مثال لكل رمز، باستخدام البحث عن أي شيء, قبعة الفأر لاسي، و كتب بوتون الإضافية للتوضيح:

• {{Spiderbuttons.CMCT/Config: Pathoschild.LookupAnything، Controls.ToggleSearch}}
• {{Spiderbuttons.CMCT/Translation: ichortower.HatMouseLacey, houseDisplayName}}
• {{أزرار العنكبوت.CMCT/ديناميكية: برج القبعة.لايسي، لايسي}}
• {{Spiderbuttons.CMCT/Asset: Spiderbuttons.ButtonsExtraBooks, assets/Books/sheet.png}}
  

القيود
حاليًا، هناك شيئان رئيسيان أعتبرهما حدودًا:

• لا تعمل الترجمات التي تأخذ الرموز كمدخلات (أي قيم i18n التي تحتوي على {{tokens}} خاصة بها داخل i18n نفسها) بشكل صحيح وستلتقط فقط السلسلة الحرفية مع وجود الرمز مع الأقواس.
• يتم تهيئة الرموز الديناميكية فقط عند تحميل ملف الحفظ، وليس عند تشغيل اللعبة. قد يهمك هذا الأمر أو لا يهمك.
  

ومن الجدير بالذكر أيضًا أنه يجب عليك استخدام الرمز الديناميكي بأقل قدر ممكندون الخوض في تفاصيل عمل Content Patcher، نظرًا لطريقة تطبيقي للرمز، سيُشير دائمًا إلى ضرورة نشر تغييراته حتى لو لم يتغير الرمز الديناميكي الذي يتحقق منه من تعديل آخر. هذا ليس سيئًا إذا كان رمزك يُحدّث فقط عند بدء التشغيل يوميًّا كما تفعل الرموز افتراضيًا، ولكنه قد يكون مكلفًا إذا كنت تُحدّثه عند تغيير الوقت أو عند تغيير الموقع!

الكود المصدر