أصدرت تحديثًا للعبة، وأنت تريد تحديث الإضافات وعالمك دون فقدان التقدم. تغيير إعدادات سيرفر Vintage Story وإضافة الإضافات هما التغيران اللذان قد يمنعان تحميل العالم، لذا يعمل هذا المسار على تنفيذها بترتيب ثابت: نسخ الحفظ، تغيير شيء واحد، بدء السيرفر وقراءة السجل، ثم تغيير الشيء التالي. يقوم Cascadia Merge بأعمال الملفات ويعرض لك كل نتيجة كبطاقة. أنت تتخذ كل قرار، وتبقي السيرفر متوقفًا أثناء تغيير الملفات. خطط لقضاء وقتك في قراءة الاختلافات والسجل، وليس في كتابة المسارات، وادون إصدار كل إضافة قبل تغييرها، بحيث تكون القائمة بمثابة سجل ليوم التحديث.
اختر مجلد بيانات السيرفر كمجلد العمل لمحادثة جديدة. يدرج الوكيل المجلد باستخدام list_dir، بحيث يمكنك رؤية المجلدات Saves وBackups وMods قبل أن يلمس أي شيء. على جهاز Windows، يكون الموقع الافتراضي هو مجلد VintagestoryData ضمن مجلد AppData\Roaming الخاص بمستخدمك، ما لم تبدأ السيرفر بمسار بيانات آخر.
بإيقاف السيرفر، ينسخ الوكيل مجلد Saves إلى Backups باستخدام سكريبت النسخ الاحتياطي الخاص بك. تقرأ رمز الخروج في البطاقة، تطلب قائمة ثانية لمجلد Backups باستخدام list_dir، وتؤكد أن النسخة الجديدة موجودة حقًا قبل المتابعة.
عدّل serverconfig.json أو استبدل إضافة واحدة، ولا تفعل الاثنين معًا. يظهر الوكيل الاختلاف لتغيير الإعداد، وأنت تقبله أو ترفضه في وضع Ask first. إضافة تستبدلها يدويًا توضع في مجلد Mods كملف .zip، ويتغير ملف واحد فقط من هذا النوع في كل جولة.
ابدأ السيرفر باستخدام سكريبتك الخاص، اطلب من الوكيل البحث في السجل عن الإضافات الفاشلة، وانضم من اللعبة. إذا تعطل شيء، تعرف أي تغيير هو السبب، ويمكنك نقل هذا الملف أو استعادة هذا السطر من النسخة التي أنشأتها في البداية.
Mods/foundMods/examplemod/modinfo.jsonreadversion Mods/3 matchesmod-list.txtsaved{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}هذا مقتطف من ملف serverconfig.json، وليس ملفًا كاملاً، ويحتوي فقط على قيم افتراضية. منفذ اللعبة هو 42420 (TCP)، وكلمة المرور الفارغة تعني عدم تعيين كلمة مرور، لذا أضف واحدة قبل فتح العالم للإنترنت. عدّل الملف الحقيقي فقط عندما يكون السيرفر متوقفًا، واحتفظ بنسخة منه بجانب مجلد Saves.
ابدأ بالنظر قبل أن تغير أي شيء. يستخدم الوكيل list_dir وglob للعثور على مجلد Mods داخل مجلد البيانات، وread_file لفتح ملف modinfo.json لكل إضافة موجودة في مجلد، وwrite_file لحفظ قائمة نصية بسيطة بالأسماء والإصدارات في مجلد العمل. إذا كنت بحاجة إلى مساعدة مع الإضافات على سيرفر مستضاف، تحقق أولاً من إمكانية الوصول إلى مجلد البيانات الخاص به، لأن الوكيل يمكنه العمل فقط على الملفات التي يمكنك فتحها. اطبع القائمة. قارنها مع الإضافات التي يمتلكها لاعبوك، لأن السيرفر واللعبين يحتاجان إلى نفس الإضافات والإصدارات، وقرر ما تريد تحديثه. لم يتغير شيء بعد، ولديك سجل لما كان مثبتًا قبل التحديث، مما يساعد إذا اضطررت إلى التراجع عن خطوة لاحقًا.
عالمك هو ملف واحد بصيغة .vcdbs في مجلد Saves، لذا انسخ هذا المجلد قبل كل تحديث للعبة، وتغيير إضافة، وتغيير إعدادات. أوقف السيرفر أولاً. يستخدم الوكيل copy_file لوضع ملف العالم في مجلد Backups، ويشغل Shell سكريبت النسخ الاحتياطي الخاص بك ويبلغ رمز الخروج الحقيقي في البطاقة. نسخة لم يتم استعادتها مرة واحدة هي مجرد تخمين، لذا استعد مرة واحدة في مجلد احتياطي، افتحه وتحقق من وجود العالم. فقط بعد ذلك تنتقل إلى جزء العمل الذي يغير الملفات، مع طريقة آمنة للعودة إذا ساء التغيير. لا تحذف شيئًا، ولا تُزال نسخة احتياطية دون نسخة. إذا كان المجلد يحتوي على عدة عوالم، انسخ مجلد Saves بالكامل لضمان عدم تفويت أي منها.
الآن غيّر شيئًا واحدًا. لضبط إعدادات سيرفر Vintage Story، يستخدم الوكيل edit_file على serverconfig.json ويعرض الاختلاف في وضع Ask first؛ لتحديث إضافة، تضع ملف .zip الجديد في مجلد Mods بنفسك، من قاعدة بيانات الإضافات الرسمية فقط. إذا لم يتم تحميل العالم بعد تثبيت إضافة، فإن التغيير الأخير هو المشتبه به، ويمكنك التراجع عنه بنقل هذا الملف خارجًا. توقف هنا. لا تضيف إضافة ثانية قبل اختبار الأولى، لأن التغييرين معًا يخفيان السبب. يمكن لوضع Plan only كتابة الخطوات أولاً دون تشغيلها، وهو مفيد عندما تريد قائمة مراجعة ليوم التحديث يمكن لقارئ إداري ثانٍ قراءتها أيضًا.
ابدأ السيرفر باستخدام سكريبت البدء الخاص بك. يشغل Shell السكريبت ويعرض رمز الخروج الحقيقي، ثم يبحث grep في سجل السيرفر عن الكلمات failed وerror. استكشاف أخطاء السيرفر المخصص يبدأ بذلك السجل، وتدرج البطاقة كل سطر مطابق لقراءته بالترتيب. يجد glob ملفات السجل إذا لم تكن متأكدًا من أيها الأحدث. بعد ذلك تنضم من اللعبة وتتمشى في العالم. تقبل التغيير كمنتهي فقط بعد أن يكون السجل نظيفًا وانضم لاعب ثانٍ. إذا لم يكن نظيفًا، تعود خطوة إلى الوراء، تقرأ الخطأ الأول بدلاً من الأخير، وتستعيد نسخة الحفظ إذا كان العالم نفسه قد تضرر.
