godot · engine · tutorial

كيفية ترجمة ألعاب Godot إلى العربية

يترجم RuneTranslate ألعاب Godot 3.x / 4.x — بفتح ملف .pck (حتى عندما يكون مضمّناً داخل ملف .exe)، وفكّ تصريف GDScript والمشاهد باستخدام GDRE Tools، وسرد نصوص الواجهة والحوار. يعيد التصدير التحزيم داخل ملف .exe أو ملف .pck المستقل. تحقّق من تشغيل النسخة.

6 دقيقة قراءة

يترجم RuneTranslate الألعاب المبنية على Godot — المحرك المجاني مفتوح المصدر الذي صار بهدوء أحد أكثر الطرق شيوعاً لشحن لعبة مستقلة. كان Godot تاريخياً أحد أصعب المحركات للترجمة من الخارج، لأن لعبة Godot المُصدَّرة صندوق محكم: كل شيء يعيش في أرشيف .pck واحد (ملصق كثيراً بنهاية .exe نفسه)، والسكربتات مُصرَّفة إلى بايتكود GDScript، والمشاهد محفوظة كثنائي. يفتح RuneTranslate ذلك الصندوق، ويقرأ النص، ويحزّم ترجمتك عائدةً فيه.

يمتد Godot عبر إصدارات محرك وأنماط تحزيم كثيرة، فقبل أي شيء آخر: إن وجّهت RuneTranslate إلى لعبة Godot ولم يكتشفها، أو لم يفتحها، أو لم تعمل النسخة المصدَّرة، فأخبرنا رجاءً. المزيد عن ذلك في النهاية.

ما هو Godot فعلاً

Godot محرك ألعاب مجاني مرخّص بـ MIT مفتوح المصدر صار خياراً سائداً لألعاب 2D و3D المستقلة، وتُشحن عليه شريحة متنامية من العناوين اليابانية المستقلة. تُكتب الألعاب عادةً بـ GDScript، لغة Godot الشبيهة بـ Python، وتُخطَّط كـ مشاهد — أشجار عقد محفوظة كموارد. حين تُصدَّر لعبة، يُحزَّم كل ذلك — السكربتات والمشاهد والصور والصوت — في ملف حزمة .pck واحد، يقع بجانب الملف التنفيذي أو، شائعاً جداً، ملصقاً بنهاية .exe نفسه. ذلك التحزيم هو بالضبط ما يجعل ألعاب Godot تبدو منيعة.

لماذا كانت ألعاب Godot صعبة الترجمة

خلافاً لمحرك مدفوع بالسكربت مثل Ren’Py، لا تعرض لعبة Godot المُصدَّرة شيئاً تقريباً كنص عادي:

  • كل شيء داخل `.pck`. لا توجد ملفات سكربت أو نص حرة لتحريرها — وحين تكون الحزمة مضمّنة في .exe لا يوجد حتى .pck مرئي لتوجيه أداة إليه.
  • السكربتات مُصرَّفة. يُشحن GDScript كبايتكود مُصرَّف (.gdc) — وفي Godot 4 الحديث يُضغط ذلك البايتكود إضافةً — فالحوار المخبوز في الشيفرة ليس شيئاً تستطيع البحث عنه بـ grep أو فتحه في محرّر نصوص.
  • المشاهد ثنائية. تعيش ملصقات الواجهة ونص القوائم في ملفات مشاهد محفوظة بصيغة مورد Godot الثنائية (.scn)، لا .tscn المقروءة التي تراها في المحرّر.
  • ليست كل لعبة تستخدم ملف ترجمة. لدى Godot نظام توطين من الطراز الأول (CSV / .po → .translation)، لكن كثيراً من الألعاب، خصوصاً العناوين المستقلة الأصغر، لا تستخدمه أبداً وتخبز نصها ببساطة في السكربتات والمشاهد. يقرأ RuneTranslate الاثنين: النصوص المضمّنة (في .gd و.tscn و.tres و.cfg وproject.godot) وجداول ترجمة CSV المُصرَّفة، ويرقّعها في مكانها عند التصدير. أما كتالوجات .po داخل الحزمة فلا تُقرأ بعد.

ما يفعله RuneTranslate الآن

يعامل RuneTranslate محرك Godot كمحرك من الطراز الأول ويعيد بناء المشروع المقروء نيابةً عنك. تحت الغطاء، يضمّن نسخةً من GDRE Tools (طقم الهندسة العكسية مفتوح المصدر لـ Godot) ويستخدمها لـ:

  • فك حزمة `.pck` — المستقلة، أو data.pck، أو الحزمة المضمّنة في نهاية .exe (يكتشف RuneTranslate توقيع الحزمة المضمّنة تلقائياً).
  • فك تصريف GDScript المُصرَّف (.gdc → .gd) بحيث يصير الحوار والسرد في الشيفرة مقروءاً مجدداً.
  • تحويل المشاهد الثنائية (.scn → .tscn) بحيث يمكن استخراج الملصقات ونص الواجهة عليها.

ثم يفحص المشروع المُستعاد ويسرد كل نص قابل للترجمة (حوار السكربتات، ونص المشاهد/الواجهة، وجداول الترجمة، ومحادثات Dialogic وDialogue Manager، وملفات بيانات JSON) مصنّفاً حسب الملف في المحرّر، مع إخفاء علامات المحرك خلف عناصر نائبة بحيث لا يفسدها المزوّد أبداً. وعند التصدير يدمج ترجماتك عائدةً في المصدر المُستعاد ويعيد تحزيم نسخة قابلة للتشغيل من اللعبة (المزيد عن الكيفية بالضبط أدناه).

ما تحتاجه

  • RuneTranslate لنظامي Windows وLinux — مجاني، كل محرك وكل مزوّد عدا RuneLingua مفتوح.
  • مجلد لعبة Godot — عادةً مجرد .exe الخاص باللعبة (مع الحزمة مضمّنة)، أو .exe إضافةً إلى .pck / data.pck بجانبه. Godot 3.x و4.x مدعومان معاً.
  • لغة هدف — الإنجليزية، الإسبانية، الفرنسية، الألمانية، البرتغالية، الروسية، الصينية، الإيطالية، التركية، الفيتنامية، وأكثر من 20 أخرى.
  • مزوّد ترجمة واحد. تعمل Google Translate المجانية مباشرةً؛ ولدى DeepL فئة مجانية؛ وأما OpenAI وAnthropic ونموذج محلي (Ollama / LM Studio) وأي واجهة متوافقة مع OpenAI فبمفتاحك الخاص. ألعاب Godot غنية بالحوار عادةً، فيقرأ نموذج لغوي (OpenAI / Anthropic) أو DeepL أفضل للنص القصصي.

الخطوة 1: افتح مجلد اللعبة

أطلق RuneTranslate، وانقر New project، ووجّهه إلى مجلد لعبة Godot — المجلد الذي يحتوي على .exe الخاص باللعبة (و.pck، إن شُحن منفصلاً). يعمل اكتشاف المحرك تلقائياً: يتعرّف على توقيع الحزمة المضمّنة في نهاية الملف التنفيذي، أو .pck حراً، أو مشروع Godot. لا تُعدَّل ملفاتك الأصلية أبداً.

الخطوة 2: افك الحزمة واستعِد المشروع

يشغّل RuneTranslate مكوّنه المرافق المضمّن GDRE Tools لفك الحزمة، وفك تصريف GDScript المُصرَّف، وتحويل المشاهد الثنائية إلى مصدر مقروء. ثم يفحص ذلك المشروع المُستعاد ويسرد كل سطر قابل للترجمة (الحوار والسرد من السكربتات، والملصقات ونص الواجهة من المشاهد، وجداول الترجمة في اللعبة، ومحادثات Dialogic وDialogue Manager، وملفات بيانات JSON)، مصنّفاً حسب الملف. تُصفّى مسارات الأصول وأسماء العقد ومعرّفات الشيفرة الأخرى بحيث تترجم فقط النصوص التي يراها اللاعب فعلاً.

الخطوة 3: الترجمة

اختر مزوّداً وشغّل. للعبة مدفوعة بالقصة، نموذج لغوي (OpenAI / Anthropic) هو الأفضل لصوت الشخصية، وDeepL سريع ونظيف للسرد، وGoogle Translate المجانية جيدة لنصوص الواجهة القصيرة. غالباً ما تُبقي ألعاب Godot حوارها كمصفوفات طويلة من الأسطر داخل سكربت واحد — "قاعدة بيانات قصة" — فيظهر اسم الشخصية أو المكان نفسه مئات المرات. أدرِج طاقمك ومصطلحاتك الرئيسية في المسرد مسبقاً بحيث تُعرض بشكل متطابق في كل مكان؛ انظر أساسيات المسرد. يشدّ مرور اختياري بـمُنقّح الذكاء الاصطناعي الصياغة الجامدة التي تميل الترجمة الآلية إلى تركها.

الخطوة 4: صدّر نسخة مترجمة

انقر Export. لأن السكربتات الأصلية بايتكود مُصرَّف، يستخدم RuneTranslate نهج تجاوز المصدر: يكتب ترجماتك في مصدر .gd / .tscn المُستعاد، ويُسقط .gdc المُصرَّف / .scn الثنائي بحيث يرجع المحرك إلى المصدر المترجم الحر، ويعيد تحزيم .pck جديد، ويعيده إلى المكان الذي تحتفظ به اللعبة فيه: مضمّناً من جديد في نسخة من .exe، أو مكتوباً كملف .pck بجانبه. تبقى لعبتك الأصلية دون مساس؛ وتحصل على نسخة منفصلة قابلة للتشغيل ومترجمة.

نطاق التصدير: يعمل التصدير لألعاب Godot 3 وGodot 4 على السواء، سواء كانت الحزمة مضمّنة في .exe أو تُشحن كملف .pck مستقل بجانبه. وفي الحالتين تحصل على نسخة منفصلة قابلة للعب ومترجمة.

الخطوة 5: تحقّق من تشغيل النسخة

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

قيود معروفة

  • تحقّق من إطلاق اللعبة المصدَّرة وقراءتها بشكل صحيح قبل إعادة التوزيع.
  • كتالوجات `.po`. يقرأ RuneTranslate النص بلغة المصدر في السكربتات والمشاهد وملفات بيانات JSON وملفات Dialogic وDialogue Manager وجداول ترجمة CSV المُصرَّفة، لكنه لا يقرأ كتالوجات .po داخل الحزمة.
  • ألعاب C# / .NET (Mono). يركّز RuneTranslate على GDScript؛ ولا يُبلَغ النص المُصرَّف في منطق لعبة Godot بـ C# إلا حين تحمّل اللعبة سلاسلها من ملف بديل خاص بها.
  • النص المرسوم في الصور. عنوان أو شعار مُرسَّم كعمل فني بكسلات، لا نصوص — تلك مهمة ترجمة نص الصور، لا استخراج السكربتات.
  • تعتمد اللغات الهدف غير اللاتينية على شحن اللعبة خطاً قادراً فعلاً على عرضها.

أخبرنا بما ينكسر

يمتد Godot عبر إصدارات محرك وأنماط تحزيم كثيرة، ولم نرها كلها. إن لم تُكتشف لعبة، أو لم تُفكّ حزمتها، أو صدّرت شيئاً لا يُطلَق، فأبلِغ عنه رجاءً — اسم اللعبة وإصدار Godot الخاص بها وكيفية تحزيمها (حزمة مضمّنة مقابل .pck حر) هو بالضبط ما يساعدنا على تحصينه أسرع.

نزّل RuneTranslate، ووجّهه إلى لعبة Godot تلك التي عزمت على قراءتها، وجرّبه. لمحرك حديث آخر، انظر شرح Unity تالياً.

مستعد لتجربة RuneTranslate؟

تفتح الباقة المجانية كل محرك + كل مزود ترجمة عدا RuneLingua. باقة Supporter ($3.99/mo) تفتح السرعة الكاملة.

التنزيل لأنظمة Windows وMac وLinux