عرض مصدر Godot/migrating/upgrading to godot 4

<noinclude>{{DISPLAYTITLE: الترقية من جودو 3 إلى جودو 4}}</noinclude>
تتبع جودو نظام الإصدار الدلالي بشكل فضفاض، إذ تُعد التوافقية موجودة بين الإصدارات البسيطة والترقيعية، بينما يمكن للإصدارات الكبيرة أن تتسبب ببعض المشكلات، وبناءً على ذلك، لا يُنصح بنقل المشروع من إصدار كبير إلى آخر خلال عملية تطويره وخصوصًا إن كنت تعمل على المشروع لوقت طويل.

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

== هل يجب علي الترقية إلى جودو 4؟ ==
قبل البدء بعملية التحديث يجب الأخذ بعين الاعتبار المحاسن والمساوئ التي يمكن أن تحصل للمشروع الخاص بك.

=== محاسن التحديث ===
مع [https://github.com/godotengine/godot/blob/master/CHANGELOG.md الخاصيات الموجودة في 4.0] يعطيك التحديث المحاسن التالية.

* حل العديد من المشكلات في 4.0 التي لا يمكن حلها في ‎3‎.×‎ لعدد من الأسباب (مثل الفروقات في الرسومات في واجهة برمجة التطبيقات أو التوافق العكسي).
* سيحصل الإصدار 4‎.×‎ على [https://docs.godotengine.org/en/stable/about/release_policy.html#doc-release-policy فترة دعم أكبر]، إذ سيستمر الدعم لجودو 3‎.×‎ لبعض الوقت بعد إصدار 4.0 ولكنه سيتوقف عن الحصول على دعم بنهاية المطاف.

أنظر [https://docs.godotengine.org/en/stable/about/docs_changelog.html#doc-docs-changelog توثيق سجل التعديلات] للحصول على لائحة من الصفحات التي توثق المزايا الجديدة في جودو 4.0.

==== مساوئ التحديث ====
ستُفضل البقاء على 3‎.×‎ إذا لم ترد أي مزايا موجودة في جودو 4.0 للأسباب التالية:

* [https://godotengine.org/article/release-management-4-0-and-beyond أن جودو 3‎.‎‎×‎ مجرب وفعال ولكن لا يزال جودو 4 في المراحل الأولى]
** متوقع أن يكون لجودو 4.0 بعض المشاكل في الأداء ومسار العمل ليست موجودة في جودو ‎3‎.×‎، ولكن سيتم حل هذه المشاكل في المستقبل مع إصدارات جودو 4‎.×‎ 
* لا يوجد دلائل من طرف ثالث لجودو 4 منها لجودو مقارنة بجودو 3‎‎.×‎ ، إذا كُنت جديدًا في العمل على محركات الألعاب ستجد تجربة أفضل باستخدام جودو 3‎‎.×‎
* متطلبات عتاد الحاسوب لجودو 4 (مثل استخدام الذاكرة) هي أعلى قليلًا من أجل المحرر والمشاريع المُصدرة. كان هذا ضروريًا لتنفيذ بعض التحسينات
* بما أن جودو 4 يحتوي على ميزات أكثر من جودو 3 ، يُصبح حجم الملف الثنائي لجودو 4 للمشاريع المُصدرة أكبر، يمكننا تفادي ذلك [https://godotengine.org/article/release-management-4-0-and-beyond بتحسين الإنشاء ليخفف الحجم]. سيبقى البناء باستخدام 4.0 مع نفس الوحدات المفعلة أكبر من البناء باستخدام 3‎‎.×‎ مع نفس الوحدات. هذا سيسبب مشكلة عند [[Godot/export/exporting for web|التصدير إلى الويب]] لأن حجم الثنائي يؤثر بشكل مباشر على سرعة تهيئة المحرك (بغض النظر عن سرعة التنزيل).
* لم ولن يدعم جودو 4 لتصيير GLES2 (لا يزال هناك دعم لتصيير GLES3 باستخدام واجهة خلفية OpenGL جديدة، هذا يعني أن الأجهزة بدون دعم Vulkan يمكنها تشغيل جودو 4).
** يمنع التحديث المشاريع من العمل على عتاد قديم ،إذا كنت تستهدف عتاد قديم جدًا مثل كروت الشاشة المدمجة من انتل (الجيل الثاني) Sandy Bridge. يمكن تفادي ذلك باستخدام تنفيذات [https://github.com/pal1000/mesa-dist-win برمجيات OpenGL] ولكنها بطيئة وقت اللعب.

=== تحفظات التحديث ===
بما أن جودو 4 هو إعادة كتابة للغة في العديد من النواحي، حدث فقدان بعض الميزات أثناء التعديل. وسيتم إعادة بعض هذه الميزات في إصدارات جودو القادمة.

* فيزياء الطلقة تم إزالتها على حساب GodotPhysics. إن هذا يؤثر على المشاريع ثلاثية الأبعاد التي تستخدم المحرك الفيزيائي الافتراضي (الذي كان Bullet) ولم تُغير يدويًا إلى GodotPhysics. لا يوجد نية لإعادة إضافة فيزياء Bullet في الأساس، ولكن يمكن إنشاء إضافة من طرف ثالث بالاعتماد على GDExtention
* لم يعد يُستخدم HDR في التصيير الثنائي الأبعاد، أي أنه لا يوجد تأثير لقيم الوحدات "الأكثر إضاءة"، ويتم العمل على إعادتها في المستقبل
* لن تعيد الإطارات المعروضة أي بيانات HDR حتى لو كان التصيير ثلاثي الأبعاد يستخدم HDR باستخدام Forward Plus أو Forward Mobile، ويتم العمل على إعادتها في المستقبل.
* تم استبدال Mono بـ .NET 6 أي أن تصدير مشاريع C#‎ إلى أندرويد و iOS وHTML5 لم يعد مدعومًا الآن. ولكن تصدير مشاريع C#‎ إلى الحاسب المكتبي لا يزال مدعومًا، يتم العمل على دعم تصدير مشاريع C#‎ إلى منصات أخرى في إصدارات 4‎.×‎ عندما يتحسن الدعم الأولي.

يمكن الحصول على لائحة كاملة من التراجعات عن طريق البحث عن [https://github.com/godotengine/godot/issues?q=is%3Aissue+is%3Aopen+label%3Aregression+-label%3Abug المشاكل المسماة تراجعات regression وليس مشاكل bug على GitHub].

== تحضيرات ما قبل التحديث (اختياري) ==
إذا أردت ان تكون مستعدًا للتحديث إلى جودو 4 في المستقبل تذكر استخدام المتفرّدتين [https://docs.godotengine.org/en/stable/classes/class_tweener.html#class-tweener Tweener] و[https://docs.godotengine.org/en/stable/classes/class_time.html#class-time Time] في المشروع الخاص بك. تتوافر هذه الأصناف في جودو 3.5 وما بعد.

بهذه الطريقة، لن تعتمد على عقدة Tween ودوال OS time المهملتين واللتين تم إزالتهما من جودو 4.0

من الأفضل إعادة تسمية التظليلات الخارجية ليكون امتدادها ‎<code>.‎gdshader</code> بدلًا من <code>‎.shader</code>، إن جودو ‎3.×‎ تدعم كلًا من الامتدادين ولكن جودو 4.0 تدعم فقط <code>gdshade‎r‎‎.</code>

== تشغيل أداة تحديث المشروع ==
<blockquote>تنبيه: أنشئ نسخة احتياطية كاملة للمشروع قبل التحديث! لن تنسخ الأداة مشروعك نسخًا احتياطيًا خلال عملية التحديث

يمكنك إجراء بالنسخ الاحتياطي باستخدام التحكم بالإصدار، أو نسخ مجلد المشروع إلى مكان أخر.</blockquote>

=== استخدام مدير المشروع ===
لاستخدام أداة تحديث المشروع:

# افتح مدير المشروع الخاص بجودو 4
# استورد مشروع جودو 3‎.×‎ باستخدام زر '''استيراد Import''' أو استخدم زر '''مسح Scan''' لإيجاد المشروع داخل المجلد
# انقر نقرة مزدوجة على المشروع المستورد (أو اختر المشروع واختر '''تعديل Edit''')
# سترى مربع حوار بخيارين: '''تحويل project.godot فقط Convert project.godot Only''' أو '''تحويل كامل المشروع Convert Full Project'''. بعد التأكد من أن المشروع لديه نسخة احتياطية (راجع التنبيه السابق)، اختر '''تحويل كامل المشروع Convert Full Project'''. إن خيار '''تحويل project.godot فقط Convert project.godot Only''' هو للاستعمالات المتقدمة فقط إذا فشلت أداة التحويل.
# انتظر لينتهي تحويل المشروع. قد يستغرق عدة دقائق للمشاريع الكبيرة ذات المَشاهد المتعددة
# عندما تصبح واجهة مدير المشروع متاحة مجددًا انقر نقرة مزدوجة على المشروع (أو اختر المشروع واختر '''تعديل Edit''') لفتح المحرر

إذا واجهت مشكلة تحويل كون ملفات المشروع كبيرة أو طويلة يمكن استخدام سطر الأوامر لتحديث المشروع (راجع ما يلي) هذا سيسمح لك لتجاوز حدود المحول.

=== استخدام سطر الأوامر ===
يُفضل التأكد من صحة تحويل المشروع لاستخدام أداة التحديث سطر الأوامر عن طريق تنفيذ هذه الوسطاء باستخدام ملف جودو الثنائي.<syntaxhighlight lang="bash">
# [<max_file_kb>] [<max_line_size>] الوسطاء التالية هي وسطاء اختيارية
# يمكنك التخلي عنهما إذا لم ترد تغيير قيمهما
path/to/godot.binary --path /path/to/project/folder --validate-conversion-3to4 [<max_file_kb>] [<max_line_size>]
</syntaxhighlight>تفذ الأمر التالي في ثنائي محرر جودو إذا كانت لائحة التحديثات جيدة لتحديث ملفات المشروع<syntaxhighlight lang="bash">
# [<max_file_kb>] [<max_line_size>] الوسطاء التالية هي وسطاء اختيارية
# يمكنك التخلي عنهما إذا لم ترد تغيير قيمهما
path/to/godot.binary --path /path/to/project/folder --convert-3to4 [<max_file_kb>] [<max_line_size>]
</syntaxhighlight>إن الوسيطين <code>[<max_file_kb>]</code> و<code>[<max_line_size>]</code> هما اختياريان لتحديد الحد الأقصى لحجم ملفات للتحويل (باستخدام كيلوبايت وسطر). الحد الافتراضي هو 4 ميغابايت و 100000 سطر على الترتيب. إذا تم الوصول لأحد هذين الحدين لن يتم تحديثه من محّول المشروع. هذا يفيد في الحد من إبطاء التحديث للموارد الكبيرة.

زد حدود الحجم عند تشغيل أداة تحديث المشروع إذا أردت تحويل الملفات الكبيرة باستخدام أداة تحديث المشروع، مثلًا تشغيل محرر جودو الثنائي مع هذه الوسطاء يزيد الحدين عشرة أضعاف.<syntaxhighlight lang="bash">
path/to/godot.binary --path /path/to/project/folder --convert-3to4 40000 1000000
</syntaxhighlight><blockquote>ملاحظة: فقط مشاريع جودو 3.0 وما بعد يمكن تحديثها باستخدام أدارة تحويل المشروع الموجود في محرر جودو 4

يُفضل التأكد من أن المشروع محدث بأخر إصدار مستقر من 3‎.×‎ قبل تشغيل أداة تحديث المشروع</blockquote>

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

=== إعادة تسمية العقد والموارد ===
تشير اللائحة التالية إلى العقد التي تم إعادة تسميتها لتكون أوضح في جودو 4.0، تقوم أداة تحديث المشروع بإعادة تسميتهم بشكل تلقائي في السكربتات الخاصة بك

واحد من أهم المجموعات المعاد تسميتها هي العقد ثلاثية الأبعاد حيث تم إضافة اللاحقة <code>3D</code> للحفاظ على التناسق مع مشابهاتهم ثنائية البعد. مثلا أصبحت <code>Area</code> الآن <code>Area3D</code>

لسهولة البحث، في الجدول الآتي يوجد أسماء كل العقد والموارد التي أُعيد تسميتها تلقائيًا، ماعدا التي أُضيف <code>3D</code> لاسمها القديم
{| class="wikitable"
|الاسم القديم (جودو 3‎.×‎)
|الاسم الجديد (جودو 4)
|-
|AnimatedSprite
|AnimatedSprite2D
|-
|ARVRCamera
|XRCamera3D
|-
|ARVRController
|XRController3D
|-
|ARVRAnchor
|XRAnchor3D
|-
|ARVRInterface
|XRInterface
|-
|ARVROrigin
|XROrigin3D
|-
|ARVRPositionalTracker
|XRPositionalTracker
|-
|ARVRServer
|XRServer
|-
|CubeMesh
|BoxMesh
|-
|EditorSpatialGizmo
|EditorNode3DGizmo
|-
|EditorSpatialGizmoPlugin
|EditorNode3DGizmoPlugin
|-
|GIProbe
|VoxelGI
|-
|GIProbeData
|VoxelGIData
|-
|GradientTexture
|GradientTexture1D
|-
|KinematicBody
|CharacterBody3D
|-
|KinematicBody2D
|CharacterBody2D
|-
|Light2D
|PointLight2D
|-
|LineShape2D
|WorldBoundaryShape2D
|-
|Listener
|AudioListener3D
|-
|NavigationMeshInstance
|NavigationRegion3D
|-
|NavigationPolygonInstance
|NavigationRegion2D
|-
|Navigation2DServer
|NavigationServer2D
|-
|PanoramaSky
|Sky
|-
|Particles
|GPUParticles3D
|-
|Particles2D
|GPUParticles2D
|-
|ParticlesMaterial
|ParticleProcessMaterial
|-
|Physics2DDirectBodyState
|PhysicsDirectBodyState2D
|-
|Physics2DDirectSpaceState
|PhysicsDirectSpaceState2D
|-
|Physics2DServer
|PhysicsServer2D
|-
|Physics2DShapeQueryParameters
|PhysicsShapeQueryParameters2D
|-
|Physics2DTestMotionResult
|PhysicsTestMotionResult2D
|-
|PlaneShape
|WorldBoundaryShape3D
|-
|Position2D
|Marker2D
|-
|Position3D
|Marker3D
|-
|ProceduralSky
|Sky
|-
|RayShape
|SeparationRayShape3D
|-
|RayShape2D
|SeparationRayShape2D
|-
|ShortCut
|Shortcut
|-
|Spatial
|Node3D
|-
|SpatialGizmo
|Node3DGizmo
|-
|SpatialMaterial
|StandardMaterial3D
|-
|Sprite
|Sprite2D
|-
|StreamTexture
|CompressedTexture2D
|-
|TextureProgress
|TextureProgressBar
|-
|VideoPlayer
|VideoStreamPlayer
|-
|ViewportContainer
|SubViewportContainer
|-
|Viewport
|SubViewport
|-
|VisibilityEnabler
|VisibleOnScreenEnabler3D
|-
|VisibilityNotifier
|VisibleOnScreenNotifier3D
|-
|VisibilityNotifier2D
|VisibleOnScreenNotifier2D
|-
|VisibilityNotifier3D
|VisibleOnScreenNotifier3D
|-
|VisualServer
|RenderingServer
|-
|VisualShaderNodeScalarConstant
|VisualShaderNodeFloatConstant
|-
|VisualShaderNodeScalarFunc
|VisualShaderNodeFloatFunc
|-
|VisualShaderNodeScalarOp
|VisualShaderNodeFloatOp
|-
|VisualShaderNodeScalarClamp
|VisualShaderNodeClamp
|-
|VisualShaderNodeVectorClamp
|VisualShaderNodeClamp
|-
|VisualShaderNodeScalarInterp
|VisualShaderNodeMix
|-
|VisualShaderNodeVectorInterp
|VisualShaderNodeMix
|-
|VisualShaderNodeVectorScalarMix
|VisualShaderNodeMix
|-
|VisualShaderNodeScalarSmoothStep
|VisualShaderNodeSmoothStep
|-
|VisualShaderNodeVectorSmoothStep
|VisualShaderNodeSmoothStep
|-
|VisualShaderNodeVectorScalarSmoothStep
|VisualShaderNodeSmoothStep
|-
|VisualShaderNodeVectorScalarStep
|VisualShaderNodeStep
|-
|VisualShaderNodeScalarSwitch
|VisualShaderNodeSwitch
|-
|VisualShaderNodeScalarTransformMult
|VisualShaderNodeTransformOp
|-
|VisualShaderNodeScalarDerivativeFunc
|VisualShaderNodeDerivativeFunc
|-
|VisualShaderNodeVectorDerivativeFunc
|VisualShaderNodeDerivativeFunc
|-
|VisualShaderNodeBooleanUniform
|VisualShaderNodeBooleanParameter
|-
|VisualShaderNodeColorUniform
|VisualShaderNodeColorParameter
|-
|VisualShaderNodeScalarUniform
|VisualShaderNodeFloatParameter
|-
|VisualShaderNodeCubeMapUniform
|VisualShaderNodeCubeMapParameter
|-
|VisualShaderNodeTextureUniform
|VisualShaderNodeTexture2DParameter
|-
|VisualShaderNodeTextureUniformTriplanar
|VisualShaderNodeTextureParameterTriplanar
|-
|VisualShaderNodeTransformUniform
|VisualShaderNodeTransformParameter
|-
|VisualShaderNodeVec3Uniform
|VisualShaderNodeVec3Parameter
|-
|VisualShaderNodeUniform
|VisualShaderNodeParameter
|-
|VisualShaderNodeUniformRef
|VisualShaderNodeParameterRef
|}

=== إعادة تسمية التوابع والخاصيات والإشارات والثوابت ===
نظرًا لكيفية عمل أداة تحديث المشروع، لا يمكن إعادة تسمية كل واجهة برمجة التطبيقات بشكل تلقائي. تحتوي اللائحة التالية كل عمليات إعادة التسمية التي يجب القيام بها يدويًا باستخدام محرر السكربت.

راجع الجدول السابق إذا لم تجد أي عقدة أو مورد في اللائحة التالية لإيجاد الاسم الجديد

ملاحظة: يمكن استخدام نافذة حوار '''الاستبدال في الملفات Replace in Files''' لتسريع الاستبدال عن طريق ضغط <code>Ctrl+Shift+R</code> عندما يكون محرر السكربت مفتوحًا ولكن انتبه لأن نافذة حوار لا تقدم أي طريقة للرجوع عن أي تبديل. استخدم التحكم في الإصدار للالتزام بعمل التحديث بشكل منتظم. يمكن استخدام أدوات سطر الأوامر مثل [https://github.com/chmln/sd sd] إذا احتجت القيام بشيء أكثر مرونة من نافذة حوار '''الاستبدال في الملفات Replace in Files''' الخاصة بالمحرر.

تذكر بالبحث عن استخدامات واجهات برمجة التطبيقات القديمة بمحارف من نمط باسكال إذا كنت تستخدم C#‎ في المشروع (واستبدلها بمحارف من نمط باسكال) 

=== التوابع ===

* تم استبدال مسارات الأصناف والملف بـ [https://docs.godotengine.org/en/stable/classes/class_fileaccess.html#class-fileaccess FileAccess] و[https://docs.godotengine.org/en/stable/classes/class_diraccess.html#class-diraccess DirAccess] التي لديها واجهة برمجة تطبيقات مختلفة. العديد من العقد أصبحت ساكنة أي يمكن استدعائها بشكل مباشر في FileAccess وDirAccess بدون الحاجة لإنشاء نسخة عن ذلك الصنف.
* تم نقل التوابع الخاصة بالشاشة والنافذة (مثل <code>OS.get_screen_size()‎</code>) من متفرّدة [https://docs.godotengine.org/en/stable/classes/class_os.html#class-os OS] إلى متفرّدة [https://docs.godotengine.org/en/stable/classes/class_displayserver.html#class-displayserver DisplayServer]. وتغيرت تسمية التوابع لاستخدام <code>DisplayServer.<object>_<get/set>_property()‎. مثلًا OS.get_screen_size()‎</code> تصبح <code>DisplayServer.screen_get_size()‎</code>
* تم نقل توابع الوقت والتاريخ من المتفرّدة [https://docs.godotengine.org/en/stable/classes/class_os.html#class-os OS] إلى المتفردّة [https://docs.godotengine.org/en/stable/classes/class_time.html#class-time Time]. (متفرّدة Time موجودة أيضًا في جودو 3.5 وما بعد)
* ستحتاج لتبديل بعض استدعاءات <code>instance()</code>‎ باستدعاءات <code>instantiate()</code>‎ ، ويجب على المحول أن يقوم بذلك تلقائيًا ولكن هذا يعتمد على شيفرة مخصصة قد لا تعمل في كل الحالات
* أصبح <code>()set_autowarp</code> الخاص بـ AcceptDialog الآن هو <code>set_autowarp_mode()</code>‎
* أصبح <code>process()</code> ‎ الآن ‎<code>_proccess()‎</code> (لاحظ الشرطة السفلية البادئة التي تدل على تابع افتراضي).
* أصبح <code>get_points()</code> ‎ الخاص بـ AStar2D و Astar3D الآن <code>get_points_id()</code>‎
* أصبح <code>set_event()</code>‎ الخاص بـ BaseButton الآن <code>set_shortcut()‎</code>
* أصبح <code>get_v_offset()</code>‎ الخاص بـ Camera2D الآن <code>get_drag_vertical_offset()</code> ‎
* أصبح <code>set_v_offset()‎</code> الخاص بـ Camera2D الآن <code>set_drag_vertical_offset()</code> ‎
* أصبح <code>set_tooltip()</code>‎ الخاص بـ control الآن <code>set_tooltip_text()</code>‎
* أصبح <code>create_gizmo()</code>‎ الخاص بـ EditorNode3DGizomoPlugin الآن ‎ <code>_create_gizmo()</code>‎(لاحظ الشرطة السفلية البادئة التي تدل على تابع افتراضي)
* أصبح <code>get_peer_port()</code>‎ الخاص بـ EnetMultiplayerPeer الآن <code>get_peer()‎</code>
* أصبح <code>get_mode()</code>‎ الخاص بـ FileDialog الآن <code>get_file_mode()</code>‎
* أصبح <code>set_mode()</code>‎ الخاص بـ FileDialog الآن <code>set_file_mode()‎</code>
* أصبح <code>get_offset()</code>‎ الخاص بـ GraphNode الآن <code>get_position_offset()</code>‎
* أصبح <code>world_to_map()</code>‎ الخاص بـ GridMap الآن <code>local_to_map()</code>‎
* أصبح <code>map_to_world()‎</code> الخاص بـ GridMap الآن <code>map_to_local()</code>‎
* أصبح <code>get_rect()</code>‎ الخاص بـ Image الآن <code>get_region()‎</code>
* أصبح <code>get_v_scroll()</code>‎ الخاص بـ ItemList الآن <code>get_v_scroll_bar()‎</code>
* أصبح <code>get_network_connected_peers(‎)</code> الخاص بـ MultiplayerAPI الآن <code>get_peers()</code>‎
* أصبح <code>get_network_peer()</code>‎ الخاص بـ MultiplayerAPI الآن <code>get_peer()‎</code>
* أصبح <code>get_network_unique_id()</code>‎ الخاص بـ MultiplayerAPI الآن <code>get_unique_id()‎</code>
* أصبح <code>has_network_peer()</code>‎ الخاص بـ MultiplayerAPI الآن <code>has_multiplayer_peer()‎</code>
* أصبح <code>is_listening()</code>‎ الخاص بـ PacketPeerUDP الآن <code>is_bound()‎</code>
* أصبح <code>listen()</code>‎ الخاص بـ PacketPeerUDP الآن <code>bound()</code>‎
* أصبح <code>set_flag()‎</code> الخاص بـ ParticleProcessMaterials الآن <code>set_particle_flag()‎</code>
* أصبح <code>get_dependancies()‎</code> الخاص بـ ResourceFormatLoader الآن <code>‎_get_dependancies()</code>‎ (لاحظ الشرطة السفلية البادئة التي تدل على تابع افتراضي)
* أصبح <code>is_valid()‎</code> الخاص بـ Shortcut الآن <code>has_valid_event()</code>‎
* أصبح <code>world_to_map()‎</code> الخاص بـ TileMap الآن <code>local_to_map()</code>‎
* أصبح <code>map_to_world()</code>‎ الخاص بـ TileMap الآن <code>map_to_local()‎</code>

=== الخاصيات ===
<blockquote>ملاحظة: يجب إعادة تسمية توابع الضبط والجلب الخاصة بهذا التابع يدويًا في حال كانت موجودة في هذه القائمة ومستخدمة في المشروع. مثلًا، التوابع <code>set_offset()</code>‎ و<code>get_offset()‎</code> الخاصة بـ PathFollow2D وPathFollow3D. يجب إعادة تسميتها <code>set_progress()</code>‎ و<code>get_progress()‎</code> على الترتيب</blockquote>

* أصبحت <code>margin</code> الخاصة بـ Control الآن <code>offset</code>
* أصبحت <code>percent_visible</code> الخاصة بـ Label الآن <code>visible_ratio</code>
* أصبحت <code>refuse_new_network_connections</code> الخاصة بـ MultiPlayerAPI الآن <code>refuse_new_connections</code>
* أصبحت <code>offset</code> الخاصة بـ PathFollow2D وPathFollow3D الآن <code>progress</code>
* أصبحت <code>percent_visible</code> الخاصة بـ TextureProgressBar الآن <code>show_percentage</code>
* يجب تغيير خاصية <code>extents</code> في عقد CSG و VoxelIGI بـ <code>size</code>، مع تنصيف القيمة المضبوطة (لم يبقوا الآن نصف امتداد). يؤثر هذا أيضًا على التوابع الجالبة/الضابطة <code>set_extents()</code>‎ و<code>get_extents()</code>‎

=== المعدّدات ===

* أصبحت <code>FLAG_MAX</code> الخاصة بـ CPUParticles2D الآن <code>PARTICLE_FLAG_MAX</code>

=== الإشارات ===

* أصبحت <code>instantiate</code> الخاصة بـ FileSystemDock الآن <code>instance</code>
* أصبحت <code>hide</code> الخاصة بـ CanvasItem الآن <code>hidden</code>. لا تطبق إعادة التسمية على التابع <code>hide()‎</code> فقط الإشارة
* أصبحت <code>tween_all_completed</code> الخاص بـ Tween الآن <code>loop_finished</code>
* أصبحت <code>change</code> الخاص بـ EditorSettings الآن <code>settings_changed</code>

=== الثوابت ===

* أصبحت أسماء الألوان بالحروف الكبيرة ومع شرطة سفلية بين الكلمات. مثلًا، أصبح <code>Color.palegreen</code> الآن <code>Color.PLAE_GREEN</code>
* تم نسخ ثوابت <code>NOTIFICATION_‎</code> الخاصة بـ MainLoop إلى <code>Node</code> ما يعني أنه يمكن إزالة بادئة <code>MainLoop.‎</code> عند الرجوع إليهم.
* أصبحت <code>NOTIFICATION_MW_QUIT_REQUEST</code> الخاصة بـ MainLoop الآن <code>NOTIFICATION_CLOSE_REQUEST</code>

== التحقق من إعدادات المشروع ==
تم إعادة تسمية العديد من إعدادات المشروع وبعضهم تم تغيير المعدّدات الخاصة بهم بطرق غير متوافقة (مثل نوعية تصفية الظلال). هذا يعني أنك تحتاج إلى ضبط بعض قيم إعدادات المشروع مجددًا. تأكد من تفعيل '''متقدم Advanced''' في إعدادات المشروع لرؤية كل إعدادات المشروع

== التحقق من إعدادات البيئة ==
تم نقل إعدادات الرسوميات من إعدادات البيئة إلى إعدادات المشروع. تم القيام بذلك لجعل التعديلات وقت التنفيذ أسهل بدون الحاجة للوصول إلى مورد البيئة الفعال ومن ثم تعديل خصائصه.

نتيجة لذلك يجب تعديل إعدادات نوعية البيئة في إعدادات المشروع لأن إعدادات نوعية البيئة لم تحوّل تلقائيًا إلى إعدادات المشروع. 

يجب تغيير شيفرة قائمة إعدادات الرسوميات في جودو ‎3.×‎ التي تغير خصائص البيئة لاستدعاء توابع RenderingServer التي تؤثر على نوعية البيئة إذا كانت هذه القائمة موجودة. يبقى فقط الزر "الأساسي" لكل تأثير في البيئة موجودًا داخل مورد البيئة مع كل التأثيرات المتعلقة به.

== تحديث التظليل ==
يوجد بعض التغييرات التي لم تُغطى من أداة التحسين.

لم يعد مدعومًا امتداد الملف <code>shader.</code> وبالتلي جيب إعادة تسمية ملفات <code>shader.</code> إلى <code>gdshader.</code> وتحديث المراجع كما يجب في ملفات مشهد/مورد باستخدام محرر نصوص خارجي

بعض أهم التعديلات التي ستحتاج للقيام بها في التظليل هي:

* أصبحت فلترة الملمس وحالات الإعادة مضبوطة بشكل موحد، بدلًا من ملفات الملمس لوحدها.
* أصبحت <code>hint_albedo</code> الآن <code>source_color</code>
* تم إعادة تسمية متغيرات المصفوفة المضمنة
* لم تعد تستخدم مظللات الجزيئات دالة المعالجة <code>vertex‎‎‎()‎</code>‏‎‎‎ بل أصبحت تستخدم <code>start()</code>‎ و<code>process()‎</code>

راجع [[Godot/shaders/shader reference/shading language|لغة التظليل]] لمزيد من المعلومات.

== تحديث السكربتات لأخذ التعديلات غير المتوافقة رجوعيًا بعين الاعتبار   ==
بعض التغيرات الحاصلة بين جودو 3‎.×‎ و 4.0 ليست فقط إعادة تسمية ولكنها تعطل التوافقية الرجوعية بسبب سلوك افتراضي مختلف

من أشهر الأمثلة على ذلك

* أصبح كل من [https://docs.godotengine.org/en/stable/classes/class_string.html#class-string String]  و[https://docs.godotengine.org/en/stable/classes/class_stringname.html#class-stringname StringName] معرضين لـ GDScript. هذا يسمح لتحسينات أكثر حيث أن StringName مصمم بشكل خاص للاستخدام مع السلاسل النصية "الثابتة" المُنشأة مرة واحدة ويعاد استخدامها العديد من المرات. هذه الأنواع ليست بالضرورة متساوية لبعضها، أي أن <code>is_same("example", &"example")‎</code> تعيد <code>false</code>. على الرغم من كونها متبادلة في العديد من الحالات <code>("example" ==&"example" تعيد true)</code> ستحتاج في بعض الأحيان تبديل <code>"example"</code> بـ <code>‎&"example"‎</code>.
* تم تغيير [[Godot/scripting/gdscript/gdscript basics|صياغة الجالب والضابط]] الخاص بـ GDScript ولكن قامت أداة التحويل بتحويله جزئيًا، وتحتاج لتعديل يدوي في معظم الحالات لجعل التوابع الجالبة والضابطة تعمل مجددًا
* تم تغيير [[Godot/scripting/gdscript/gdscript basics|صياغة اتصال الإشارة]] الخاص بـ GDScript. تستخدم أداة التحويل الصياغة المبينة على السلاسل النصية التي لا تزال موجودة في جودو 4 ولكن يفضل التبديل إلى الصياغة المبنية على الإشارة المشروحة في صفحة الرابط. بهذه الطريقة لا تتدخل السلاسل النصية وبالتالي يمكن أن تواجهنا أخطاء باسم الإشارة وقت التنفيذ فقط.
* لا تحصل السكربتات المضمنة التي هي [[Godot/plugins/running code in the editor|سكربتات أداة]] على الكلمة المفتاحية <code>tool</code> على التوصيف <code>‎@tool‎</code> 
* تم إزالة عقدة Tween واستبدالها بـ Tweeners المتوافرة أساسًا في جودو 3.5 وما بعد . راجع [https://github.com/godotengine/godot/pull/41794 طلب السحب الأساسي] لتفاصيل أكثر
* يتم استدعاء <code>randomize()‎</code> تلقائيًا عند تحميل المشروع لذا العشوائية المحددة باستخدام النسخة العامة RandomNumberGenerate تحتاج ضبط الأصل يدويًأ في دالة <code>‎_‎ready()</code>‎ الخاصة بالسكربت 
* أصبحت <code>call_group()‎</code> و <code>set_group()‎</code> و <code>notify_group()‎</code> أصبحت فورية افتراضيًا. هذا يقود إلى تباطؤ عندا يتم استدعاء تابع كبير على مجموعة تحتوي على عدد كبير من العقد. لاستخدام الاستدعاءات المؤجلة كما قبل استبدل <code>call_group(…)‎</code> بـ <code>call_group_flags(SceneTree.GROUP_CALL_DEFERRED,..)</code> (وافعل الشيء ذاته مع <code>set_group()‎</code> و<code>notify_group()</code>‎ على الترتيب)
* أصبحت خاصية <code>rotation</code> معرضة للمحرر بدلًا من <code>rotation_degrees</code> الذي يظهر تلقائيًا كدرجات في نافذة المفتش. هذا يمكنه أن يسبب مشاكل في التحريك لأن التحويل لم يتم التعامل مه بشكل تلقائي من أداة التحويل.
* تم عكس وإعادة تسمية <code>has_no_surface()‎</code> الخاص بـ AABB إلى <code>has_surface()‎</code>
* تم عكس وإعادة تسمية <code>has_no_area()</code>‎ الخاص بـ AABB وRect2 إلى <code>has_area()‎</code>
* تم استبدال خاصية <code>fps</code> الخاص بـ [https://docs.godotengine.org/en/stable/classes/class_animatedtexture.html#class-animatedtexture AnimatedTexture] إلى <code>speed_scale</code> التي تعمل بنفس طريقة خاصية <code>playback_speed</code> الخاصة بـ AnimationPlayer
* تسمح الآن <code>speed_scale</code> الخاصة بالصنفين [https://docs.godotengine.org/en/stable/classes/class_animatedsprite2d.html#class-animatedsprite2d AnimatedSprite2D] و[https://docs.godotengine.org/en/stable/classes/class_animatedsprite3d.html#class-animatedsprite3d AnimatedSprite3D]  بقيم سلبية. هذا سيسبب مشاكل في التحريك إذا اعتمدت أن يكون <code>speed_scale</code> داخليًا ثابتًا على القيمة 0.0
* تم إزالة خاصية <code>playing</code> الخاصة بـ [https://docs.godotengine.org/en/stable/classes/class_animatedsprite2d.html#class-animatedsprite2d AnimatedSprite2D] و[https://docs.godotengine.org/en/stable/classes/class_animatedsprite3d.html#class-animatedsprite3d AnimatedSprite3D]، استخدم التوابع <code>play()</code>/<code>stop()</code>‎ بدلًا عنه أو اضبط حركة <code>autoplay</code> عن طريق اللائحة السفلية الخاصة بـ SpriteFrames (ولكن ليس الاثنين نفس الوقت)
* أصبحت إشارات [https://docs.godotengine.org/en/stable/classes/class_basebutton.html#class-basebutton BaseButton] الآن <code>button_up</code> و<code>button_down</code>. وأصبحت خاصية <code>pressed</code> الآن <code>button_pressed</code>
* تم استبدال خاصية <code>rotating</code> الخاصة بـ [https://docs.godotengine.org/en/stable/classes/class_camera2d.html#class-camera2d Camera2D] إلى <code>ignore_rotation</code> التي لديها سلوك عكسي
* تم عكس خاصية <code>zoom</code> الخاصة بـ Camera2D: القيم الأكبر تعني تكبير أكثر بدلًا من أقل
* تم إزالة تابع <code>remove_and_skip</code> الخاص بـ Node. إذا اردت إعادة تنفيذه في سكربت يمكن استخدام تنفيذ C++‎ القديم كمرجع
* يجب تحويل <code>OS.get_system_time_secs()</code>‎ إلى <code>Time.get_time_dict_from_system()["second"]</code>‎
* تم تبديل وسائط التابع <code>save()</code>‎ الخاص بـ [https://docs.godotengine.org/en/stable/classes/class_resourcesaver.html#class-resourcesaver ResourceSaver] (<code>resource: Resource, path: String</code>). هذا يطبق أيضًا على تابع <code>‎_save()‎‎</code> الخاص بـ [https://docs.godotengine.org/en/stable/classes/class_resourceformatsaver.html#class-resourceformatsaver ResorceFormatSaver]
* يجب استدعاء <code>poll()</code>‎ على [https://docs.godotengine.org/en/stable/classes/class_streampeertcp.html#class-streampeertcp StraemPeerTCP] لتحديث حالته بدلًا من الاعتماد على أن تقوم <code>get_status()</code>‎ بالاقتراع تلقائيًا: [https://github.com/godotengine/godot/pull/59582 GH-59582]
* تم [https://github.com/godotengine/godot/pull/36180 تغيير سلوك التابع] <code>right()</code>‎ الخاص بـالسلاسل النصية: الآن يعيد عدد من المحارف من يمين السلسلة النصية بدلًا من الطرف الطرف الأيمن من السلسلة النصية بدأ من موقع معين، استخدم <code>substr()‎</code> إذا أردت السلوك القديم.
* تم إزالة <code>is_connected_to_host()</code>‎ من StreamPeerTCP وPacketPeerUDP كما في [https://github.com/godotengine/godot/pull/59582 GH-59582]. يمكن استخدام <code>get_status()</code>‎ بدلًا عنها في StreamPeerTCP و استخدام <code>is_socket_connected()</code>‎ في [https://docs.godotengine.org/en/stable/classes/class_packetpeerudp.html#class-packetpeerudp PacketPeerUDP]
* أصبح تلميح السلسلة النصية <code>or_lesser</code> الآن هو <code>or_less</code> في ‎<code>_get_property_list()</code>‎
* أصبح تلميح السلسلة النصية <code>noslider</code> الآن هو <code>no_slider</code> في <code>‎_get_property_list()</code>‎
* أصبح VisualShaderNodeVec4Parameter يأخذ [https://docs.godotengine.org/en/stable/classes/class_vector4.html#class-vector4 Vector4] كمعامل بدلًا من [https://docs.godotengine.org/en/stable/classes/class_quaternion.html#class-quaternion Quanternion]

==== العقد/الموارد المُزال أو المستبدلة ====
هذه لائحة بكل العقد المستبدلة بعقد أخرى التي تحتاج إلى تنظيم مختلف. يجب القيام بهذا الضبط من الأول مجددًا لأن محول المشروع لا يدعم تحديث الضبط الحالي
{| class="wikitable"
|العقدة المُزالة
|التقريب
|ملاحظات
|-
|AnimationTreePlayer
|AnimationTree
|تم إهمال AnimationTreePlayer منذ جودو 3.1
|-
|BakedLightmap
|LightmapGI
| rowspan="2" |راجع [[Godot/3d/global illumination/using lightmap gi|استخدام الإنارة العامة Lightmap]]
|-
|BakedLightmapData
|LightmapGIData
|-
|BitmapFont
|FontFile
| rowspan="3" |راجع [[Godot/ui/gui using fonts|استخدام الخطوط]] 
|-
|DynamicFont
|FontFile
|-
|DynamicFontData
|FontFile
|-
|Navigation2D
|Node2D
|تم استبداله [[Godot/navigation/navigation introduction 2d|بعقد تحرك ثنائية الأبعاد أخرى]]
|-
|Navigation3D
|Node3D
|تم استبداله [[Godot/navigation/navigation introduction 3d|بعقد تحرك ثلاثية الأبعاد أخرى]]
|-
|OpenSimplexNoise
|FastNoiseLite
|لديه معاملات خاصة والمزيد من أنواع الضجيج مثل الخلوي. لا يوجد دعم للضجيج رباعي الأبعاد لأنه غير موجود من مكتبة FastNoiseLite
|-
|ToolButton
|Button
|كان ToolButton هو Button مع خاصية '''Flat''' مفعلة افتراضيًا
|-
|YSort
|Node2D or Control
|أصبح لدى CanvasItem خاصية '''Y Sort Enabled''' في 4.0
|-
|ProximityGroup
|Node3D
|يمكن استخدام [https://docs.godotengine.org/en/stable/classes/class_visibleonscreennotifier3d.html#class-visibleonscreennotifier3d VisibleOnScreenNotifier3D] كبديل
|-
|Portal
|Node3D
| rowspan="4" |تم استبدال [[Godot/3d/occlusion culling|إعدام الانسداد]] في الفتحات والغرف بإعدام الانسداد النقطي ( عقدة OccluderIntance3D) التي تتطلب طريقة ضبط مختلفة
|-
|Room
|Node3D
|-
|RoomManager
|Node3D
|-
|RoomGroup
|Node3D
|-
|Occluder
|Node3D
| rowspan="2" |تم استبدال [[Godot/3d/occlusion culling|إعدام الانسداد]] في الأبعاد الهندسية بإعدام الانسداد النقطي ( عقدة OccluderIntance3D) التي تتطلب طريقة ضبط مختلفة
|-
|OccluderShapeSphere
|Resource
|}
تُبدل العقد تلقائيًأ مع عمود "التقريب" إذا تم تحميل مشروع قديم (حتى لو لم يتم استخدام أداة تحسين المشروع).

==== تغيرات الخيوط ====
تم تغيير واجهات برمجة ا<nowiki/>[[Godot/performance/using multiple threads|لخيوط]] في 4.0 مثلًا يجب تعديل هذا الجزء من الشيفرة في 3‎.x للعمل على 4.0<syntaxhighlight lang="py">
# 3.x
var start_success = new_thread.start(self, "__threaded_background_loader",
    [resource_path, thread_num]
)

# 4.0
var start_success = new_thread.start(__threaded_background_loader.bind(resource_path, thread_num))
</syntaxhighlight>لم تعد <code>Thread.is_active()‎</code> مستخدمة ويجب تحويلها إلى <code>Thread.is_alive()</code>‎<blockquote>انظر إلى: راجع [https://github.com/godotengine/godot/blob/master/CHANGELOG.md سجل التغييرات] للحصول على لائحة كاملة للتغيرات بين جودو 3‎.×‎ و جودو 4</blockquote>

=== تحطم توافقية موارد ArrayMesh ===
التنسيق للملفات المحفوظة في <code>‎.res</code> و<code>‎.tres</code> لموارد ArrayaMesh المستخدم في 4.0 لا يتوافق مع المستخدم في 3‎.×‎ . ستحتاج إلى استيراد ملف شبكة الموارد وحفظه كمورد ArrayMesh مجددًا.

== لائحة التوابع والخاصيات والإشارات والثوابت المُعاد تسميتها تلقائيًا ==
يوجد في الملف المصدري [https://github.com/godotengine/godot/blob/master/editor/renames_map_3_to_4.cpp editor/renames_map_3_to_4.ccp] لائحة لكل عمليات إعادة التسمية عن طريق أداة تحسين المشروع. الأسطر التي فيها تعليق تشير الى إعادة تسمية من واجهة برمجة التطبيقات التي لا يمكن القيام بها تلقائيًا.

== إعدادات محرر النقل ==
تستخدم كلًّا من جودو 4.0 و 3‎.×‎ إعدادات محرر مختلفة أي أن الإعدادات يمكن تغييرها بمعزل عن بعض

افتح [[Godot/io/data paths|مجلد إعدادات المحرر]] إذا اردت نقل إعدادات جودو 3‎.×‎ إلى جودو 4.0 وانسخ <code>editor_settings-3.tres</code> إلى <code>editor_settings-4.tres</code> عندما يكون محرر جودو 4 مغلقًا.<blockquote>ملاحظة: العديد من أسماء الإعدادات والفئات تم تغييرها منذ جودو 3‎.×‎. لا تنتقل إعدادات المحرر التي أسمائها أو فئاتها قد تغيرت إلى جودو4.0 يجب ضبط هذه القيم مجددًا</blockquote>
== مصادر ==
* [https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.html صفحة Upgrading from Godot 3 to Godot 4 في توثيق جودو الرسمي.]
[[تصنيف:Godot|{{SUBPAGENAME}}]]
[[تصنيف:Godot Migrating|{{SUBPAGENAME}}]]
{{DEFAULTSORT:Godot/migrating/upgrading to godot 4}}