استخدام GitHub Desktop لتبسيط تحديثات FiveM ورصد كل تغيير

مقدمة

كل صاحب خادم يعرف هذا الشعور. يصدر إصدار جديد من المورد، ويقول سجل التغييرات "استبدل مجلد /config/framework"، فتتوقف مكانك — لأنك قضيت ساعات في ضبط تلك الملفات وليس لديك أدنى فكرة عما لمسه التحديث فعلياً. هل تقوم بالاستبدال وتفقد عملك؟ هل تتخطى المجلد وتخاطر بتعطل السكريبت؟ هل تنسخ الأسطر ذهاباً وإياباً يدوياً وتأمل ألا تكون قد أغفلت أي شيء؟

هناك طريقة أفضل بكثير — ولا تحتاج إلى كتابة أمر واحد. باستخدام تطبيق مجاني يسمى GitHub Desktop، يمكنك رؤية ما تغير بالضبط في أي تحديث، والحفاظ على تخصيصاتك الخاصة آمنة، والتراجع في ثوانٍ، كل ذلك من خلال واجهة بسيطة تعتمد على النقر.

ما هو Git، وما هو GitHub Desktop؟

Git هو نظام للتحكم في الإصدارات — فكر فيه كأنه سجل تراجع غير محدود ومثالي لمجلد ما. في كل مرة تقوم فيها بحفظ لقطة (تسمى commit)، فإنه يسجل الحالة الدقيقة لكل ملف. لاحقاً يمكنك مقارنة أي لقطتين سطراً بسطر، أو استعادة حالة سابقة، أو دمج التغييرات معاً.

GitHub Desktop هو تطبيق مرئي ومجاني يضع Git خلف أزرار سهلة الاستخدام. لا توجد شاشة سوداء (terminal)، ولا أوامر تحتاج لحفظها — فقط نافذة واضحة تظهر لك ما الذي تغير وتسمح لك بعمل commit، وتراجع، ودمج بضغطة زر واحدة.

بالنسبة لخادم FiveM، المجلد الذي تتبعه هو دليل resources الخاص بك (أو سكربت واحد بداخله). يقوم Git بتحويل "أعتقد أنني غيرت شيئاً هنا قبل بضعة أسابيع" إلى "أرني بالضبط ما الذي تغير بين الشهر الماضي واليوم."

لماذا يعد هذا مثالياً لتحديثات الموارد (Resources)

تحديث سكربت بالطريقة التقليدية يعني العمل دون رؤية واضحة. يمنحك Git ثلاث قدرات خارقة:

1. كشف التغييرات — بعد وضع إصدار جديد، يقوم GitHub Desktop بتمييز كل ملف تم تغييره وكل سطر تم تعديله. يخبرك سجل التغييرات (changelog) بأي المجلدات يجب استبدالها؛ حيث يوضح لك Git ما الذي تغير فعلياً لتتمكن من الوثوق به.
2. تخصيص آمن — تعديلاتك محفوظة في الـ commits. عندما يمسس تحديث المورد (vendor update) نفس الملف، يمكن لـ Git دمج مجموعتي التغييرات، مع الحفاظ على تعديلاتك وتعديلاتهم.
3. تراجع فوري — إذا تسبب تحديث في تعطل خادمك، فأنت على بُعد نقرة واحدة من الحالة الدقيقة التي كان عليها الخادم قبل خمس دقائق. لا داعي للذعر من سؤال "أين وضعت ذلك النسخة الاحتياطية".

إعداد لمرة واحدة باستخدام GitHub Desktop

تقوم بهذا الأمر مرة واحدة فقط لكل خادم.

# Never track secrets
**/*.env
**/secrets.lua
server.cfg

# Caches, logs, build output
**/cache/
**/logs/
**/.DS_Store

سير عمل التحديث

هذا هو الروتين الذي تكرره مع كل تحديث. يستغرق الأمر حوالي دقيقة واحدة.

الاستعادة عند حدوث خلل ما

هل حدث خلل في التحديث؟ ابقَ هادئاً — يمنحك GitHub Desktop عدة خيارات، من الخيارات البسيطة إلى الخيارات الجذرية.

التراجع عن التغييرات غير الملتزم بها. في علامة التبويب Changes، حدد الملفات (أو جميعها)، وانقر بزر الماوس الأيمن، واختر Discard Changes / Discard All Changes. سيؤدي ذلك إلى استعادتها إلى آخر عملية التزام (commit) قمت بها.

العودة إلى لقطة سابقة. افتح علامة التبويب History (السجل) في الشريط الجانبي الأيسر لرؤية كل لقطة قمت بإنشائها:

• لـ التراجع بأمان عن تحديث مع الحفاظ على سجل نظيف، انقر بزر الماوس الأيمن على الـ commit الخاطئ واختر Revert Changes in Commit (التراجع عن التغييرات في الـ commit). سيؤدي هذا إلى إنشاء commit جديد للتراجع عن التغييرات — دون فقدان أي شيء.
• للرجوع بالكامل إلى حالة سابقة، انقر بزر الماوس الأيمن على اللقطة التي تريدها واختر إعادة الضبط إلى الالتزام (Reset to commit).

قم بوضع تغييراتك في الرف مؤقتًا — مفيد لاختبار تحديث ببيئة نظيفة، ثم استعادة عملك. انقر بزر الماوس الأيمن على رأس الملفات المتغيرة (Changed files) واختر تخزين جميع التغييرات (Stash All Changes). لاستعادتها، اختر التغييرات المخزنة (Stashed Changes) في الشريط الجانبي وانقر على استعادة (Restore).

نصيحة احترافية: الدمج التلقائي لتحديثات الموردين

هل سئمت من إعادة تطبيق تعديلات الإعدادات يدويًا بعد كل تحديث؟ يمكن لـ GitHub Desktop القيام بذلك نيابة عنك باستخدام دمج ثلاثي (three-way merge).

الفكرة: الاحتفاظ بفرع واحد يحتوي على إصدارات الموردين الأصلية وفرع آخر يحتوي على تعديلاتك فوقها.

هذه هي نفس التقنية التي تستخدمها الفرق الاحترافية لتتبع المكتبات الأصلية دون فقدان التغييرات المحلية — وهي تعمل بنفس الكفاءة لخادمك.

هل تفضل استخدام سطر الأوامر؟

إذا كنت مرتاحًا في استخدام الطرفية (terminal)، فإن سير العمل المذكور أعلاه يترجم إلى مجموعة من الأوامر:

# One-time setup (run inside your resources folder)
git init
git add .
git commit -m "Baseline: working server before updates"

# Each update
git add . && git commit -m "Pre-update snapshot"   # snapshot first
# ...drop in the new release, overwriting files...
git status            # which files changed
git diff --stat       # a compact per-file summary
git diff              # full line-by-line changes
git add . && git commit -m "Update sky_base to 1.21.0"

# Rolling back
git restore <file>    # undo changes to one file
git restore .         # undo all uncommitted changes
git log --oneline     # find a snapshot
git reset --hard <id> # rewind to it (destructive)
git stash / git stash pop   # shelve and restore temporarily

أفضل الممارسات

• قم بعمل commit قبل كل تحديث. أخذ لقطة (snapshot) يستغرق ثانيتين ويوفر ساعات.
• اكتب ملخصات واضحة. Update sky_base to 1.21.0 تتفوق على stuff عند مراجعة السجل بعد ستة أشهر.
• حافظ على تجاهل الملفات السرية. لا يجب أبدًا تضمين بيانات الاعتماد في سجل الإصدارات.
• قم بعمل commit بعد عملية تشغيل نظيفة، وليس قبلها. لا تضع علامة "جيد" على اللقطة إلا بعد تشغيل الخادم فعليًا.
• تتبع مجلد resources الكامل في مستودع واحد. بهذه الطريقة، يمكن لعملية تراجع (rollback) واحدة استعادة أي سكربت من تحديث سيء.
• احتفظ به محليًا. لا تنشر أبدًا الموارد المرخصة أو المحمية بنظام Escrow في مستودع عام.

الخلاصة

لم يعد تحديث خادم FiveM يعني التخمين، أو فقدان التخصيصات، أو البحث المحموم عن النسخ الاحتياطية. فمن خلال إعداد GitHub Desktop لمرة واحدة وروتين يستغرق دقيقة واحدة، يمكنك رؤية كل تغيير يجريه التحديث، والحفاظ على تعديلاتك الخاصة كما هي، والتراجع عن أي خطأ فوراً — كل ذلك دون كتابة أمر واحد.

في المرة القادمة التي يخبرك فيها سجل التغييرات باستبدال مجلد ما، ستفعل ذلك بكل ثقة — لأن GitHub Desktop سيوضح لك بالضبط ما الذي تغير، في كل مرة.