قراءة الملفات وتعديلها
يفتح الوكيل ملف serverconfig.json ويحرره، مع عرض التغييرات التي يمكنك قبولها أو رفضها.
تعامل Cascadia Merge مع ملف إعدادات خادم Vintage Story كما تتعامل مع أي ملف مشروع: تقرأ ملف serverconfig.json، تعرض التغييرات قبل كل تعديل وتشغل نصوصك الخاصة مع رمز الخروج الفعلي. وهي مخصصة للخوادم والإضافات التي تملكها أو تديرها، وتبدأ من المجلد الذي تختاره لكل دردشة.
يفتح الوكيل ملف serverconfig.json ويحرره، مع عرض التغييرات التي يمكنك قبولها أو رفضها.
يشغل Shell نصوص بدء التشغيل والنسخ الاحتياطي الخاصة بك ويظهر رمز الخروج الفعلي في بطاقة.
يجد grep السطر الذي فشل فيه تحميل إضافة أو انقطع اتصال لاعب.
يعمل الوكيل في المجلد الذي تختاره للدردشة ويشغل الأوامر في البيئة التي تختارها: Windows المحلي، أو WSL، أو SSH إلى خادم تملكه. تبقى أدوات الملفات في مجلد العمل.
serverconfig.jsonreadserverconfig.jsoncopiedserverconfig.json+2 -2MaxClients serverconfig.json1 matchstart-server.cmdexit 0failed Logs/0 matchesتريد مجلداً لعالم سينضم إليه أصدقاؤك. تقوم بتنزيل حزمة الخادم وفك ضغطها بنفسك، ثم تختار مجلد البيانات كمجلد عمل للدردشة. يستخدم الوكيل web_search و http_get لقراءة توثيق الخادم الرسمي، و write_file لحفظ خيارات البدء في نص بدء التشغيل، و read_file للتحقق من ملف serverconfig.json. يشغل Shell النص وتظهر البطاقة رمز الخروج الفعلي. راقب كل بطاقة. في وضع Ask first، ترى أيضاً التغييرات قبل كتابة أي ملف، وتقبلها أو ترفضها، لذا لا يتغير شيء على الجهاز خلف ظهرك. عندما ينتهي النص، تفتح اللعبة، تختار وضع متعدد اللاعبين وتختبر الاتصال بنفسك.
تريد إعادة تسمية الخادم، وتحديد MaxClients على 10 ووضع كلمة مرور عليه. يفتح الوكيل ملف serverconfig.json باستخدام read_file، ويخزن copy_file نسخة بجانبه قبل أي تغيير. ثم يغير edit_file ServerName و MaxClients و Password، وتظهر البطاقة التغييرات سطراً بسطر. أوقف الخادم قبل قبول التغييرات، لأن الملف لا يجب أن يتغير أثناء تشغيل الخادم. بعد ذلك، يتحقق grep من أن المفاتيح الثلاثة تحتوي على القيم الجديدة ويشغل Shell الخادم بنصك. ثم اطلب من صديق الانضمام وانظر إلى السجل معاً. يبقى المنفذ 42420 (TCP) كما هو ما لم تقم بتغيير Port بنفسك، وإذا كان اللاعبون يأتون من الإنترنت، فقم بتوجيه المنفذ الذي تستخدمه فقط على جهاز التوجيه الخاص بك.
تريد إضافة محتوى إضافي، وهو مجموعة من ملفات الأصول JSON، وبعد ذلك إضافة مكتوبة بلغة C#. تذهب الإضافات إلى مجلد Mods في مجلد البيانات كملفات .zip أو مجلدات، ويصف كل منها نفسه في ملف modinfo.json. يستخدم الوكيل list_dir لإظهار ما هو مثبت، و read_file لقراءة كل ملف modinfo.json و write_file لحفظ قائمة الإضافات التي يمكنك إرسالها إلى لاعبيك، لأن الخادم واللاعبين يحتاجون إلى نفس الإضافات والإصدارات. يمكنك إنشاء ترجمة كإضافة، لأن الترجمات هي ملفات أصول JSON. قبل إضافة إضافات توليد العالم، اسأل عما إذا كانت ستؤثر على الحفظات السابقة، واختبر الإجابة على نسخة من مجلد Saves. يظهر Plan only الخطوات أولاً.
يبلغ لاعب عن خطأ أثناء الانضمام. عندما لا يتمكن صديق من الدخول إلى خادمك، فإن المشتبه بهم الأوائل هم المنفذ وكلمة المرور وعدم تطابق الإضافات. يستخدم الوكيل grep للبحث في سجل الخادم عن السطر الذي انقطع فيه اتصال اللاعب أو فشلت إضافة في التحميل، و read_file يفتح ملف serverconfig.json بحيث يمكنك مقارنة Port و Password مع ما كتبه اللاعب. يعدد glob ملفات السجل ويظهر list_dir مجلد Mods. غيّر شيئاً واحداً. يوقف Ask first قبل أي تعديل، وتقرأ كل تطابق، وتختبر مرة أخرى بعد كل تغيير. إذا كانت الإضافة هي السبب، فقم بإزالة هذا الملف الوحيد من مجلد Mods بنفسك، وأعد تشغيل الخادم واقرأ السجل مرة أخرى، بحيث تعرف أي تغيير أصلح المشكلة.
Cascadia Merge ليس مكوناً إضافياً لمحرر اللعبة. وهو مخصص فقط لإضافاتك وملفاتك وخوادمك الخاصة، لذا أبقيه بعيداً عن عميل اللعبة للآخرين، والخوادم المباشرة التي لا تملكها، واللاعبين والحسابات الأخرى. لا يفرض الوكيل هذا الحد. لا شيء يضمن أن الكود أو الإعداد صحيح، ولهذا السبب يأتي كل تغيير كتغييرات (diff) لتقرأها، وكل نتيجة هي شيء تختبره بنفسك على نسخة من حفظاتك قبل انضمام لاعبيك. لا يلمس الوكيل أيضاً عميل اللعبة، وتشارك فقط الإضافات التي لديك الحق في مشاركتها.