> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# أساسيات 3D في الألعاب: المجسمات Meshes والخامات والإضاءة
- URL: https://arabroot.io/articles/اساسيات-3d-في-الالعاب-المجسمات-meshes-والخامات-والاضاءة/
- Published: 2026-11-18T11:56:34.000Z
- Updated: 2026-11-18T12:56:42.000Z
- Description: نبني فناءً صغيراً ثلاثي الأبعاد بالكود في Godot 4 ونرسمه إطاراً حقيقياً، ثم نقرأ من المحرك نفسه ما يكلفه كل مجسم وخامة وضوء وظل، ونصنع أخطاء العموديات وUV والعمق التي يقع فيها كل مبتدئ.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, تطوير الألعاب

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

وفي المرحلة السابقة بنينا لعبة «جني التمر» ثنائية الأبعاد، وكان كل شيء فيها صورة مسطحة Sprite لها موضع على الشاشة. وفي هذه المرحلة ننتقل إلى العالم ثلاثي الأبعاد، وأول ما نحتاجه أن نفهم مكوناته الخمسة: المجسم Mesh الذي يحدد الشكل، والخامة Material التي تحدد كيف يرد السطح الضوء، والأضواء Lights والظلال Shadows، والكاميرا Camera التي تحول العالم إلى صورة، والبيئة Environment التي تعطي السماء والضوء العام. وسوف نبني فناءً صغيراً بالكود فقط، دون أي ملف من خارج المشروع، ونرسمه في Godot 4.7.2 إطاراً حقيقياً، ونقرأ من المحرك نفسه كم جسماً رسم، وكم مثلثاً، وكم أمر رسم Draw Call أرسل، ثم نصنع الأخطاء التي يقع فيها كل مبتدئ تقريباً، ونرى شكلها في الصورة وسببها في الأرقام.

وسوف نتناول في هذا المقال ما يلي:

- كيف تتحول قائمة أرقام إلى صورة: مسار الرسم Rendering Pipeline، والإحداثيات في Godot.
- المجسم Mesh من الداخل: الرؤوس Vertices والمثلثات والعمودي Normal وإحداثيات الخامة UV، وبناء مجسم بيدك بالأداة SurfaceTool.
- أخطاء العمودي واتجاه الوجه، وأخطاء UV، مصنوعة عن قصد ومرسومة في إطار حقيقي.
- الخامة StandardMaterial3D وطريقة PBR: المعدنية Metallic والخشونة Roughness.
- الأضواء الثلاثة في Godot، وماذا تكلف الظلال من أوامر الرسم.
- الكاميرا Camera3D: زاوية الرؤية والإسقاط المتعامد، والسطحان المتداخلان Z-fighting.
- البيئة WorldEnvironment: السماء والضوء المحيط وتحويل الألوان Tonemapping والضباب.
- العارضات الثلاث ⁦Forward+⁩ وMobile وCompatibility، وكيف تقرأ عدادات المحرك.

## كيف تتحول الأرقام إلى صورة؟ مسار الرسم Rendering Pipeline

كل ما في المشهد ثلاثي الأبعاد قائمة من النقاط في الفضاء، وكل ثلاث نقاط منها تكون مثلثاً، والمثلث هو الوحدة الوحيدة التي يرسمها كرت الشاشة GPU. فالمكعب اثنا عشر مثلثاً، والكرة آلاف المثلثات الصغيرة، وشخصية اللعبة عشرات الآلاف. وفي كل إطار يمر كل مثلث بالمراحل نفسها تقريباً، والشكل التالي يبينها كما تحدث في الفناء الذي سنبنيه:

![مخطط من خمس مراحل من اليمين إلى اليسار. الأولى المجسم Mesh: نقاط ومثلثات للخيمة مع أرقام الرؤوس. الثانية معالج الرؤوس Vertex Shader: يضرب كل نقطة في موضع الجسم ثم في موضع الكاميرا ثم في الإسقاط فتنتقل من إحداثيات الجسم إلى الشاشة. الثالثة تحويل المثلث إلى بكسلات Rasterization مع حذف الوجوه الخلفية. الرابعة معالج البكسل Fragment Shader: يحسب اللون من الخامة والعمودي والضوء والبيئة. الخامسة اختبار العمق Depth Test: البكسل الأقرب إلى الكاميرا يبقى، ثم الصورة النهائية](https://arabroot.io/content/images/2026/11/game-3d-basics-01-pipeline.webp)

كل مثلث يمر بالمراحل نفسها في كل إطار: من نقاط المجسم إلى بكسل على الشاشة

والمراحل بالترتيب كما يلي:

1. **المجسم Mesh:** قوائم أرقام، أهمها مواضع الرؤوس، وبجانب كل رأس عموديه واتجاهه، وإحداثياته على الخامة UV، وقد تكون معها قائمة فهارس Indices تقول أي ثلاثة رؤوس تكون كل مثلث.
2. **معالج الرؤوس Vertex Shader:** برنامج صغير يعمل على كل رأس، فينقله من إحداثيات الجسم إلى إحداثيات العالم بحسب موضع العقدة ودورانها وحجمها، ثم إلى إحداثيات الكاميرا، ثم يسقطه على مستوى الشاشة. وهذه التحويلات هي ضرب مصفوفات Matrices، وهي امتداد لما شرحناه عن المتجهات في [رياضيات الألعاب](https://arabroot.io/articles/%D8%B1%D9%8A%D8%A7%D8%B6%D9%8A%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D9%84%D8%B9%D8%A7%D8%A8-%D8%A7%D9%84%D9%85%D8%AA%D8%AC%D9%87%D8%A7%D8%AA-vectors-%D9%88%D8%A7%D9%84%D8%AD%D8%B1%D9%83%D8%A9-%D9%88%D8%A7%D9%84%D8%AA%D8%B5%D8%A7%D8%AF%D9%85/).
3. **التحويل إلى بكسلات Rasterization:** يحدد كرت الشاشة البكسلات التي يغطيها كل مثلث على الشاشة، ويهمل المثلثات التي يرى ظهرها، وهذا ما يسمى حذف الوجوه الخلفية Backface Culling، وسوف نرى أثره بعد قليل.
4. **معالج البكسل Fragment Shader:** برنامج آخر يعمل على كل بكسل، فيحسب لونه من الخامة، ومن العمودي في تلك النقطة، ومن كل ضوء يصلها، ومن البيئة حولها.
5. **اختبار العمق Depth Test:** إذا وقع مثلثان على البكسل نفسه، يبقى الأقرب إلى الكاميرا بحسب ذاكرة العمق Depth Buffer، وهذه الذاكرة دقتها محدودة كما سنرى في قسم الكاميرا.

ولا تكتب أنت هذه البرامج في الغالب، لأن الخامة StandardMaterial3D تولد معالج الرؤوس ومعالج البكسل نيابة عنك من الإعدادات التي تختارها. ولكن فهم المراحل هو ما يجعلك تعرف أين تبحث عندما تخرج الصورة خاطئة: شكل خاطئ يعني مشكلة في المجسم أو في التحويل، ولون خاطئ يعني مشكلة في الخامة أو الضوء أو البيئة، ووميض بين سطحين يعني مشكلة في العمق.

وأما الإحداثيات فيذكر [توثيق مقدمة 3D في Godot](https://docs.godotengine.org/en/stable/tutorials/3d/introduction%5Fto%5F3d.html?ref=arabroot.io) أن المحرك يستخدم المتر وحدةً لكل شيء، فالوحدة الواحدة متر، وأن الفيزياء وغيرها مضبوطة على هذا المقياس، ولذلك ينصح أن يعمل الفنانون بالمقياس الصحيح من البداية. والمحور Y هو الأعلى، والمحوران X وZ أفقيان في نظام يميني Right-handed، أي أن X يمين ويسار، وY أعلى وأسفل، وZ أمام وخلف، والكاميرا تنظر في اتجاه ⁦-Z⁩. وهذه التفاصيل تبدو مملة الآن، ولكنها سبب أغلب مشاكل استيراد النماذج من Blender، وهو موضوع المقال التالي في هذه المرحلة.

## المختبر: فناء صغير مبني بالكود

المشهد الذي سنعمل عليه فناء مساحته 12 في 12 متراً: أرضية من بلاط رملي، وجداران من الجص، وصندوق خشبي، وعمود، وكرة نحاسية، وخيمة حمراء على شكل هرم بنيناها رأساً رأساً، وفانوس صغير مضيء معلق على الجدار. ولا يوجد في المشروع أي ملف صورة أو نموذج، فكل شيء ينشئه السكربت `lab.gd` عند التشغيل، حتى خامة البلاط يرسمها بكسلاً بكسلاً. والسبب أن تقرأ المشهد كله في ملف واحد، وأن تغير أي سطر فيه وترى أثره. وهذا جزء من الدالة التي تبني الفناء:

```gdscript
func courtyard() -> void:
	var floor_mat := mat(Color.WHITE, 0.0, 0.9)
	floor_mat.albedo_texture = tiles
	floor_mat.uv1_scale = Vector3(6, 6, 1)                              # 12 m floor, one texture every 2 m
	var floor_mesh := PlaneMesh.new()
	floor_mesh.size = Vector2(12, 12)
	add_mesh(floor_mesh, floor_mat, Vector3.ZERO).name = "Floor"
	var plaster := mat(Color(0.93, 0.89, 0.82), 0.0, 0.95)
	var wall := BoxMesh.new()
	wall.size = Vector3(12, 3, 0.4)
	add_mesh(wall, plaster, Vector3(0, 1.5, -6)).name = "BackWall"
	add_mesh(wall, plaster, Vector3(-6, 1.5, 0)).rotation_degrees.y = 90
	var crate := BoxMesh.new()
	add_mesh(crate, mat(Color(0.55, 0.36, 0.2), 0.0, 0.85), Vector3(2.2, 0.5, 1.2)).name = "Crate"
	var column := CylinderMesh.new()
	column.top_radius = 0.3
	column.bottom_radius = 0.3
	column.height = 3.0
	add_mesh(column, plaster, Vector3(-3.5, 1.5, -3.5)).name = "Column"
	var ball := SphereMesh.new()
	add_mesh(ball, mat(Color(0.95, 0.7, 0.3), 1.0, 0.25), Vector3(0.8, 0.5, 2.6)).name = "BrassBall"
	add_mesh(pyramid(), mat(Color(0.75, 0.2, 0.15), 0.0, 0.7), Vector3(-1.5, 0, 0.5)).name = "Tent"
```

في الكود أعلاه لاحظ التالي:

- **كل شيء في المشهد ثلاثة أجزاء:** مجسم مثل `BoxMesh` أو `SphereMesh`، وخامة تصنعها الدالة `mat` من لون ومعدنية وخشونة، وعقدة MeshInstance3D تجمعهما وتضعهما في مكان من العالم بالدالة `add_mesh`. والمجسم نفسه لا موضع له، ولذلك استخدمنا مجسم الجدار مرتين، مرة في الخلف ومرة على اليسار بعد تدويره 90 درجة.
- **المقاسات بالمتر:** الجدار 12 متراً طولاً و3 أمتار ارتفاعاً، والصندوق متر في متر، ومركزه على ارتفاع نصف متر حتى يقف على الأرض لا أن يغوص فيها، لأن نقطة الأصل في المجسمات الجاهزة في مركزها.
- **البلاط:** الخامة تكرر صورة البلاط ست مرات في كل اتجاه بالخاصية `uv1_scale`، فتغطي الصورة الواحدة مترين من الأرضية، وسوف نعود إلى ذلك في قسم UV.

والمختبر يعمل في Docker على صورة Godot 4.7.2 الرسمية نفسها التي استخدمناها في المرحلة السابقة، وأضفنا إليها حزمة `mesa-vulkan-drivers`. والسبب أن العارض الافتراضي للمشاريع ثلاثية الأبعاد ⁦Forward+⁩ يحتاج Vulkan، والـ Container لا يوجد فيه كرت شاشة، فترسم مكتبة Mesa بالمعالج نفسه: الجزء المسمى lavapipe ينفذ Vulkan، والجزء المسمى llvmpipe ينفذ OpenGL للعارض Compatibility. وهذا أول سطر يطبعه المختبر:

```text
Vulkan 1.3.230 - Forward+ - Using Device #0: Unknown - llvmpipe (LLVM 15.0.6, 256 bits)
Godot 4.7.2-stable (official) | renderer: forward_plus | llvmpipe (LLVM 15.0.6, 256 bits) 1.3.230 | display: X11
```

والصور في هذا المقال إطارات رسمها المحرك فعلاً بهذه الطريقة، ثم حفظها السكربت بالدالة `get_viewport().get_texture().get_image()`، فهي ما يراه اللاعب بالضبط، لا لقطة من المحرر. ولأن الرسم يحدث على المعالج، فإن رسم الإطار الأول يأخذ ثواني بدل أجزاء من الثانية، وأغلبها في ترجمة برامج الرسم Shaders لأول مرة، ولكن هذا لا يغير ما يرسم ولا العدادات التي سنقرؤها، فعدد المثلثات وأوامر الرسم هو نفسه على أي كرت شاشة. وهذا هو الفناء كاملاً بالشمس وظلها والفانوس:

![إطار حقيقي من Godot: فناء بأرضية بلاط رملي فيه مربعات حمراء صغيرة متكررة، وجدار خلفي وجدار أيسر بلون الجص، وخيمة حمراء على شكل هرم، وكرة نحاسية لامعة، وصندوق خشبي بني، وعمود أبيض، وفانوس مضيء على الجدار، وظلال الأجسام على الأرض، وسماء رمادية زرقاء](https://arabroot.io/content/images/2026/11/game-3d-basics-02-courtyard.webp)

الفناء كما رسمه Godot 4.7.2 بالعارض ⁦Forward+⁩: كل ما فيه مبني بالكود

## المجسم Mesh من الداخل: رؤوس ومثلثات

المجسم في Godot مورد Resource يحتوي سطحاً Surface واحداً أو أكثر، وكل سطح مجموعة مصفوفات Arrays بالطول نفسه، والعنصر رقم 5 في كل مصفوفة يخص الرأس رقم 5\. والمصفوفات التي ستقابلها دائماً أربع:

- **المواضع ARRAY\_VERTEX:** نقطة لكل رأس، بالمتر، في إحداثيات الجسم نفسه.
- **العموديات ARRAY\_NORMAL:** متجه طوله واحد لكل رأس، يقول في أي اتجاه ينظر السطح عند هذا الرأس، والضوء يحسب منه، فالسطح الذي ينظر نحو الشمس مضيء والذي يعطيها ظهره مظلم.
- **إحداثيات الخامة ARRAY\_TEX\_UV:** نقطة ثنائية الأبعاد لكل رأس بين 0 و1 غالباً، تقول أي نقطة من الصورة تلصق على هذا الرأس.
- **الفهارس ARRAY\_INDEX:** اختيارية، وهي أرقام الرؤوس ثلاثة ثلاثة، وكل ثلاثة منها مثلث. ودونها يكون كل ثلاثة رؤوس متتالية مثلثاً.

والتجربة `mesh` تطبع هذه المصفوفات لأول وجه من الخيمة، ثم تعد الرؤوس والمثلثات في الخيمة وفي المجسمات الجاهزة في Godot بإعداداتها الافتراضية، والمخرج كان كما يلي:

```text
the tent, face 1 (three vertices: position | normal | uv):
  v0  (-1.0, 0.0, 1.0) | (0.0, 0.555, 0.832) | (0.0, 1.0)
  v1  (0.0, 1.5, 0.0) | (0.0, 0.555, 0.832) | (0.5, 0.0)
  v2  (1.0, 0.0, 1.0) | (0.0, 0.555, 0.832) | (1.0, 1.0)
tent (SurfaceTool, 6 faces)        vertices    18  indices     0  triangles     6  normals yes  uv yes
tent with index()                  vertices    18  indices    18  triangles     6  normals yes  uv yes
the same face with generate_normals() default smoothing:
  v0  normal (-0.704, 0.093, 0.704)
  v1  normal (0.0, 1.0, 0.0)
  v2  normal (0.564, -0.604, 0.564)
BoxMesh (default)                  vertices    24  indices    36  triangles    12  normals yes  uv yes
PlaneMesh (default)                vertices     4  indices     6  triangles     2  normals yes  uv yes
CylinderMesh (default)             vertices   522  indices  2304  triangles   768  normals yes  uv yes
SphereMesh (default 64x32)         vertices  2210  indices 12672  triangles  4224  normals yes  uv yes
SphereMesh (16x8)                  vertices   170  indices   864  triangles   288  normals yes  uv yes
AABB of the tent: [P: (-1.0, 0.0, -1.0), S: (2.0, 1.5, 2.0)]
```

والقراءة كما يلي:

- **الوجه الأول من الخيمة:** ثلاثة رؤوس، اثنان على الأرض عند z=1 والثالث في القمة على ارتفاع 1.5 متر، والثلاثة لها العمودي نفسه (0, 0.555, 0.832)، أي أن هذا الوجه ينظر إلى الأمام (⁦+Z⁩) ويميل إلى الأعلى. وإحداثيات UV تأخذ مثلثاً من الصورة: الزاويتان السفليتان والمنتصف الأعلى.
- **18 رأساً لستة مثلثات:** للخيمة خمس نقاط فقط، أربع زوايا وقمة، فلماذا 18؟ لأن الرأس في المجسم ليس نقطة في الفضاء فقط، وإنما نقطة مع عمودي ومع UV، والقمة تشترك فيها أربعة وجوه لكل منها عمودي مختلف، فهي أربعة رؤوس لا رأس واحد. ولذلك لم يوفر الأمر `index()` أي رأس هنا، فكل الرؤوس مختلفة بعموديها، وإنما أضاف قائمة فهارس فقط.
- **المكعب 24 رأساً لا 8:** للسبب نفسه، فكل زاوية تشترك فيها ثلاثة أوجه بثلاثة عموديات، و8 في 3 تساوي 24\. والحواف الحادة في أي نموذج تكلف رؤوساً إضافية، وهذا مهم عندما تقرأ عدد الرؤوس في نموذج من Blender فتجده في Godot أكبر مما توقعت.
- **الكرة الافتراضية 4,224 مثلثاً:** وهي 64 قطعة حول المحور و32 حلقة، وتكفي لكرة تملأ الشاشة. أما كرة صغيرة بعيدة فتكفيها 16 في 8، أي 288 مثلثاً، وهو أقل بخمس عشرة مرة. والعمود الافتراضي 768 مثلثاً لأسطوانة لا يرى أحد تفاصيلها. ولذلك لا تترك الإعدادات الافتراضية للمجسمات الجاهزة عندما تكررها مئات المرات، وهو ما سنقيسه في مقال الأداء.
- **الصندوق المحيط AABB:** أصغر صندوق يحيط بالمجسم، يبدأ عند (-1, 0, -1) وحجمه 2 في 1.5 في 2\. والمحرك يستخدمه ليعرف بسرعة هل الجسم داخل نظر الكاميرا أم لا، قبل أن ينظر إلى أي مثلث فيه.

### بناء مجسم بيدك: SurfaceTool

الخيمة ليست مجسماً جاهزاً، وإنما بنيناها بالأداة SurfaceTool، وهي بحسب [توثيق SurfaceTool](https://docs.godotengine.org/en/stable/classes/class%5Fsurfacetool.html?ref=arabroot.io) مساعد لبناء المجسمات رأساً رأساً، تحدد فيه خصائص الرأس التالي ثم تضيف موضعه، ومعه دوال لتوليد العموديات والفهارس. والتوثيق ينبه إلى نقطة مهمة: Godot يعتبر الوجه أمامياً إذا كانت رؤوسه بترتيب عقارب الساعة Clockwise كما تراها من الأمام. وهذه الدالة كما هي في المختبر:

```gdscript
func pyramid(mode := "ok") -> ArrayMesh:
	var a := Vector3(-1, 0, -1)
	var b := Vector3(1, 0, -1)
	var c := Vector3(1, 0, 1)
	var d := Vector3(-1, 0, 1)
	var top := Vector3(0, 1.5, 0)
	var faces := [[d, top, c], [c, top, b], [b, top, a], [a, top, d], [a, d, c], [a, c, b]]   # clockwise seen from outside
	var st := SurfaceTool.new()
	st.begin(Mesh.PRIMITIVE_TRIANGLES)
	if mode != "smooth":
		st.set_smooth_group(-1)   # -1 = flat: every face keeps its own normal. Without this line generate_normals() averages them.
	for f in faces:
		var tri: Array = f.duplicate()
		if mode == "reversed":
			tri.reverse()
		var uvs := [Vector2(0, 1), Vector2(0.5, 0), Vector2(1, 1)]
		for i in 3:
			if mode != "no-uv":
				st.set_uv(uvs[i])
			st.add_vertex(tri[i])
	if mode == "indexed":
		st.index()                 # merge identical vertices (same position, normal and uv), so faces share them
	if mode != "no-normals":
		st.generate_normals()      # one normal per vertex, from the faces that use it
	return st.commit()
```

في الكود أعلاه لاحظ التالي:

- **ستة وجوه:** أربعة جوانب مثلثة، والقاعدة المربعة مثلثان. وكل وجه مكتوب بترتيب عقارب الساعة كما تراه من خارج الخيمة.
- **الدالة `set_uv` قبل `add_vertex`:** الخصائص تحدد أولاً، ثم يضاف الموضع فيأخذ آخر خصائص حددتها، وهذا ترتيب SurfaceTool في كل شيء.
- **المعامل `mode`:** نفس الدالة تصنع الخيمة الصحيحة، أو خيمة بلا عموديات، أو بوجوه معكوسة، أو بعموديات منعمة، أو بلا UV، وهذا ما نحتاجه للتجارب التالية.
- **السطر `set_smooth_group(-1)`:** لم يكن في النسخة الأولى من الدالة، وسوف ترى في القسم التالي ماذا حدث دونه.

والتوثيق ينبه أيضاً إلى أن بناء المجسمات بالكود مناسب للأشكال الثابتة التي لا تتغير كثيراً، لأن إنشاء مصفوفات الرؤوس وإرسالها إلى كرت الشاشة له تكلفة كبيرة، فلا تبني مجسماً من جديد في كل إطار. وفي الألعاب الحقيقية تأتي أغلب المجسمات من برنامج نمذجة مثل Blender، وأما SurfaceTool فلشيء تولده اللعبة نفسها: أرض من خريطة ارتفاعات، أو طريق يتبع منحنى، أو مثل هنا، شكل بسيط تريد أن تفهم مكوناته.

## العمودي Normal واتجاه الوجه: أربع خيام

في أول تشغيل للدالة لم يكن فيها السطر `set_smooth_group(-1)`، وكانت الخيمة «الصحيحة» تبدو كأنها مصنوعة من القماش المنفوخ، بحواف ناعمة لا تشبه الهرم. وعندما طبعنا العموديات وجدنا أن رأس القاعدة الأيمن في الوجه الأمامي عموديه (0.564, -0.604, 0.564)، أي أنه ينظر إلى الأسفل، وهذا مستحيل لوجه يميل إلى الأعلى. والسبب كما يشرح التوثيق أن `generate_normals()` تأخذ مجموعات التنعيم Smooth Groups في حسابها، وكل رأس يأخذ افتراضياً المجموعة 0، فتتجمع الرؤوس التي في الموضع نفسه ويأخذ كل منها متوسط عموديات الوجوه التي تلتقي عنده، ومنها القاعدة التي تنظر إلى الأسفل. وهذا مناسب للكرة، وخاطئ تماماً للهرم والصندوق، ولذلك تحتاج القيمة -1 قبل إضافة الرؤوس لتحصل على عموديات مسطحة Flat.

ثم جعلنا من هذا الخطأ تجربة: التجربة `normals` ترسم أربع خيام بالخامة الحمراء نفسها والضوء نفسه، والفرق بينها في المجسم فقط:

![إطار حقيقي من Godot فيه أربع خيام حمراء على شكل هرم، وتحت كل واحدة عنوان. الأولى من اليمين بلا عموديات: لون أحمر واحد مسطح بلا ظل ولا ضوء على أي وجه. الثانية بوجوه معكوسة: الوجه الأمامي مفقود فترى داخل الخيمة من خلاله والوجه الخلفي من الداخل داكناً. الثالثة بعموديات منعمة بالإعداد الافتراضي: الحواف ناعمة وعليها لمعة كأنها مخروط مستدير. الرابعة الصحيحة بعموديات مسطحة: كل وجه بلون واحد والحافة بين الوجهين حادة](https://arabroot.io/content/images/2026/11/game-3d-basics-03-normals.webp)

المجسم نفسه أربع مرات: بلا عموديات، ووجوه معكوسة، وتنعيم في غير مكانه، ثم الصحيح

والقراءة من اليمين كما يلي:

- **بلا عموديات:** الخيمة لون واحد مسطح، كأنها قص من ورق، لأن المحرك لا يعرف اتجاه أي وجه فيحسب الضوء كأن كل الوجوه تنظر في الاتجاه نفسه. وهذا ما تراه عندما يصدر نموذج من برنامج نمذجة دون عموديات، أو عندما تبني مجسماً بالكود وتنسى `generate_normals()`.
- **بوجوه معكوسة:** الوجه الأمامي اختفى، وترى من خلاله ظهر الوجه الخلفي من الداخل. والسبب أن ترتيب الرؤوس عكس عقارب الساعة، فأصبح كل وجه «ظهراً» في نظر المحرك، وحذفه كرت الشاشة في مرحلة حذف الوجوه الخلفية. ولاحظ أن العموديات نفسها انعكست، لأن `generate_normals()` تحسبها من ترتيب الرؤوس، فهي تنظر إلى داخل الخيمة. وهذا الخطأ يظهر في النماذج المستوردة عندما تعكس الحجم بقيمة سالبة، مثل -1 على محور واحد، ولا تطبقه.
- **بعموديات منعمة:** الشكل صحيح، ولكن الضوء ينزلق على الحواف كأنها منحنية، وعلى الخيمة لمعة في غير مكانها. وهي الخيمة التي ظهرت لنا في أول تشغيل.
- **الصحيحة:** كل وجه بلون واحد، والحافة بين وجهين حادة، لأن لكل وجه عموديه.

💡

إذا شككت في اتجاه الوجوه في نموذج ما، فضع في خامته الإعداد `cull_mode` على Disabled مؤقتاً: إذا ظهرت الأجزاء المفقودة فالمشكلة في ترتيب الرؤوس أو في حجم سالب، لا في المجسم نفسه. ثم أعده إلى Back بعد الإصلاح، لأن رسم الوجهين يضاعف عمل كرت الشاشة على كل مثلث.

## إحداثيات الخامة UV: الصورة على السطح

الصورة التي تلصقها على المجسم مستطيل ثنائي الأبعاد، والمجسم ثلاثي الأبعاد، والجسر بينهما هو UV: لكل رأس نقطة على الصورة، والمحرك يملأ المثلث بما بين النقاط الثلاث من الصورة. واسم UV جاء لأن X وY مستخدمان للموضع، فاختاروا حرفين آخرين. والتجربة `uv` تستخدم صورة البلاط نفسها على ثلاثة أشياء، وصورة البلاط فيها علامة حمراء في الزاوية العليا اليسرى من الصورة عن قصد، حتى ترى أين وقعت الزاوية وهل تمدد البلاط:

![إطار حقيقي من Godot فيه ثلاثة أشياء بخامة البلاط نفسها. على اليمين خيمة بلا UV: لون بيج واحد مسطح على كل الوجوه، بلا بلاط. في الوسط جدار طوله 4 أمتار بإحداثيات BoxMesh الافتراضية: بلاطتان كبيرتان ممدودتان وعلامة حمراء ضخمة ممطوطة أفقياً. على اليسار الجدار نفسه بإسقاط Triplanar على إحداثيات العالم: بلاط مربع صغير منتظم كل مترين صورة كاملة](https://arabroot.io/content/images/2026/11/game-3d-basics-04-uv.webp)

الصورة نفسها على ثلاثة أشياء: بلا UV، وبـ UV الافتراضي، وبإسقاط Triplanar على إحداثيات العالم

ومخرج التجربة كان كما يلي:

```text
tent without UV                    vertices    18  indices     0  triangles     6  normals yes  uv no
BoxMesh 4 x 1.2 x 0.4 m: UV range of the six faces together (0.0, 0.0) .. (1.0, 1.0)
3 objects              objects   3  primitives     30  draw calls   3 | shadow pass: objects   0  primitives      0  draw calls   0
```

والقراءة كما يلي:

- **الخيمة بلا UV:** لا توجد مصفوفة UV، فكل الرؤوس تقرأ النقطة (0, 0) من الصورة، أي بكسلاً واحداً، فيصبح المجسم كله بلونه. وهذا ما تراه عندما يصدر نموذج لم يفك له أحد إحداثياته في Blender، والعلاج هناك بفك الإحداثيات UV Unwrapping، لا في Godot.
- **الجدار بإحداثيات BoxMesh الافتراضية:** كل الأوجه الستة معاً تأخذ المدى من 0 إلى 1، والمجسم الجاهز يوزعها على الصورة في شبكة من ثلاثة في اثنين، فكل وجه يأخذ جزءاً من الصورة مهما كان طوله. وجدار طوله 4 أمتار وارتفاعه 1.2 متر يأخذ القطعة نفسها التي يأخذها مكعب صغير، فتتمدد البلاطات وتتضخم العلامة الحمراء.
- **الجدار بإسقاط Triplanar:** الخامة تتجاهل UV المجسم، وتسقط الصورة من المحاور الثلاثة على حسب اتجاه كل وجه، ومع الإعداد `uv1_world_triplanar` تحسب من إحداثيات العالم لا من إحداثيات الجسم، فتبقى البلاطة مترين مهما طال الجدار أو كبر حجمه. وهذا هو الحل المعتاد للجدران والأرضيات والصخور التي لا تريد أن تفك لها UV بيدك، وثمنه حساب أكثر في معالج البكسل، لأن كل بكسل يقرأ الصورة ثلاث مرات.

ولاحظ أن الأرضية في الفناء حلت مشكلتها بطريقة ثالثة، وهي `uv1_scale`: الأرضية مستوى واحد، فضربنا UV في 6 فتكررت الصورة ست مرات في كل اتجاه. وهذا يكفي للأسطح المسطحة، ولكنه لا يصلح للجدار المستطيل، لأن الضرب في رقم واحد لا يصلح الفرق بين طوله وارتفاعه. ولذلك القاعدة: إذا كان المجسم من Blender ففك UV هناك بالمقياس الذي تريده، وإذا كان مجسماً جاهزاً بسيطاً فاستخدم `uv1_scale` للمستوى، وTriplanar لما سواه.

## الخامة Material وطريقة PBR

الخامة تخبر معالج البكسل كيف يتعامل السطح مع الضوء. والخامة التي تستخدمها في أغلب الأحوال في Godot هي StandardMaterial3D، وهي تتبع طريقة الرسم المبني على الفيزياء Physically Based Rendering واختصاراً PBR، أي أنها تصف المادة بخصائص فيزيائية، وتترك للمحرك أن يحسب شكلها تحت أي ضوء. والفائدة العملية أن الخامة التي ضبطتها في النهار تبقى صحيحة في الليل وتحت الفانوس، دون أن تعدلها لكل مشهد. والخصائص الأساسية ثلاث:

- **اللون الأساسي Albedo:** لون السطح دون أي ضوء أو انعكاس، لوناً واحداً أو صورة.
- **المعدنية Metallic:** بحسب [توثيق StandardMaterial3D](https://docs.godotengine.org/en/stable/tutorials/3d/standard%5Fmaterial%5F3d.html?ref=arabroot.io) هي مقدار ما يعكسه السطح، وكلما زادت قل أثر الضوء المنتشر والضوء المحيط وزاد الانعكاس، والتوثيق يذكر أن أقل انعكاس داخلي 0.04، فلا توجد مادة لا تعكس شيئاً كما في الواقع. وفي العمل اليومي تكون القيمة إما 0 للخشب والجص والقماش والبلاستيك، أو 1 للمعادن، والقيم بينهما نادرة.
- **الخشونة Roughness:** القيمة 0 مرآة كاملة، و1 تنشر الانعكاس تماماً، وأغلب المواد بين 0.3 و0.9.

والتجربة `pbr` ترسم 25 كرة باللون البرتقالي نفسه، كل صف بمعدنية مختلفة من 0 في الأعلى إلى 1 في الأسفل، وكل عمود بخشونة مختلفة من 0 على اليسار إلى 1 على اليمين:

![إطار حقيقي من Godot: شبكة من خمسة في خمسة من الكرات البرتقالية تحت سماء. محور أفقي مكتوب عليه الخشونة Roughness من 0 إلى 1 من اليسار إلى اليمين، ومحور عمودي مكتوب عليه المعدنية Metallic من 0 في الأعلى إلى 1 في الأسفل. الكرات في الأعلى يسار لامعة بنقطة ضوء صغيرة حادة، والكرات في الأسفل يسار تعكس السماء والأرض كالمرآة بلون داكن، والكرات على اليمين مطفأة بلا لمعة. وتحت الشبكة سطران: 25 خامة تعني 25 أمر رسم، وخامة واحدة مشتركة تعني أمر رسم واحداً](https://arabroot.io/content/images/2026/11/game-3d-basics-05-pbr.webp)

اللون نفسه بخمس معدنيات وخمس خشونات: المعادن تأخذ لونها من البيئة التي تعكسها

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

وطبعت التجربة عدادات الرسم مرتين، مرة وكل كرة لها خامتها، ومرة بعد أن أعطينا الكرات الخمس والعشرين خامة واحدة مشتركة:

```text
25 spheres, 25 materials objects  25  primitives 105600  draw calls  25 | shadow pass: objects   0  primitives      0  draw calls   0
25 spheres, 1 material objects  25  primitives 105600  draw calls   1 | shadow pass: objects   0  primitives      0  draw calls   0
```

الأجسام 25 في الحالتين، والمثلثات 105,600، أي 25 في 4,224، ولكن أوامر الرسم Draw Calls نزلت من 25 إلى 1\. وأمر الرسم هو طلب يرسله المعالج إلى كرت الشاشة: ارسم هذا المجسم بهذه الخامة، ولكل أمر تكلفة على المعالج قبل أن يبدأ كرت الشاشة عمله. والسبب في النزول أن العارض ⁦Forward+⁩ يجمع تلقائياً العقد التي تستخدم المجسم نفسه والخامة نفسها في أمر رسم واحد، ويسمي [توثيق أداء 3D](https://docs.godotengine.org/en/stable/tutorials/performance/optimizing%5F3d%5Fperformance.html?ref=arabroot.io) ذلك التكرار التلقائي Automatic Instancing، ويذكر أنه في ⁦Forward+⁩ فقط، وأنه لا يعمل مع الخامات الشفافة بالمزج Alpha Blending. فإذا كان عندك مئة صندوق متشابه، فلا تنشئ لكل صندوق خامة جديدة بالكود كما فعلنا في الكرات، وإنما اجعل الخامة موردا واحداً تشترك فيه.

وفي StandardMaterial3D خصائص أخرى ستحتاجها قريباً: صورة العموديات Normal Map التي تضيف تفاصيل صغيرة دون مثلثات إضافية، والانبعاث Emission الذي جعل زجاج الفانوس يضيء في الفناء، والشفافية Transparency، والإعداد `cull_mode` الذي ذكرناه. وإذا احتجت شيئاً لا تقدمه، مثل أوراق نخل تتحرك مع الريح، فتكتب معالجاً خاصاً بك في ShaderMaterial، كما سنفعل في مقال الأداء.

## الأضواء Lights والظلال Shadows

في Godot ثلاثة أنواع من الأضواء، ويشرحها [توثيق الأضواء والظلال](https://docs.godotengine.org/en/stable/tutorials/3d/lights%5Fand%5Fshadows.html?ref=arabroot.io):

- **الضوء الاتجاهي DirectionalLight3D:** الشمس أو القمر: أشعة متوازية تصل إلى كل مكان في المشهد بالقوة نفسها، وموضع العقدة لا يهم، وإنما دورانها.
- **الضوء النقطي OmniLight3D:** مصباح أو فانوس: ينتشر في كل الاتجاهات من نقطة، ويضعف مع المسافة حتى المدى `omni_range`.
- **الضوء الموجه SpotLight3D:** كشاف أو ضوء سيارة: مخروط من نقطة في اتجاه واحد.

والتجربة `lights` ترسم الفناء أربع مرات: بلا أي ضوء ولا بيئة، ثم بشمس وسماء دون ظلال، ثم بالظلال، ثم في المغرب بشمس منخفضة برتقالية وسماء خافتة وضوء الفانوس بظلاله:

![أربعة إطارات حقيقية من Godot للفناء نفسه في شبكة اثنين في اثنين، وتحت كل إطار عنوان وأرقام. الأول بلا ضوء ولا بيئة: خلفية رمادية والأجسام باهتة داكنة والكرة النحاسية سوداء تماماً، 7 أوامر رسم ولا يوجد ظل. الثاني شمس وسماء دون ظلال: الألوان واضحة والكرة النحاسية تعكس السماء ولا توجد ظلال على الأرض، 7 أوامر رسم. الثالث شمس بظلالها: ظلال الخيمة والكرة والصندوق والعمود على الأرض، 7 أوامر رسم و18 أمراً في رسم الظلال. الرابع المغرب: نصف الفناء مظلم وضوء الفانوس البرتقالي على الجدار الأيمن والأرض، 7 أوامر رسم و11 أمراً في رسم الظلال](https://arabroot.io/content/images/2026/11/game-3d-basics-06-lights.webp)

الفناء نفسه بأربع إضاءات، وتحت كل إطار ما كلفه من أوامر الرسم

وهذه عدادات المحرك لكل حالة، وفيها قسمان: ما رسم للكاميرا، وما رسم لخرائط الظلال Shadow Maps:

```text
no-light               objects   8  primitives   9260  draw calls   7 | shadow pass: objects   0  primitives      0  draw calls   0
sun                    objects   8  primitives   9260  draw calls   7 | shadow pass: objects   0  primitives      0  draw calls   0
sun-shadow             objects   8  primitives   9260  draw calls   7 | shadow pass: objects  18  primitives  18534  draw calls  18
dusk                   objects   8  primitives   9260  draw calls   7 | shadow pass: objects  11  primitives   9280  draw calls  11
```

في المخرج أعلاه لاحظ التالي:

- **ثمانية أجسام وسبعة أوامر رسم:** الجداران يستخدمان المجسم نفسه والخامة نفسها، فجمعهما التكرار التلقائي في أمر واحد كما رأينا في الكرات.
- **بلا ضوء:** لم يتغير شيء في العدادات، ولكن الصورة باهتة والكرة النحاسية سوداء. والسبب أن المشهد ليس فيه WorldEnvironment ولا ضوء، ويوضح [توثيق البيئة](https://docs.godotengine.org/en/stable/tutorials/3d/environment%5Fand%5Fpost%5Fprocessing.html?ref=arabroot.io) أن المحرر في هذه الحالة يعرض سماء وشمساً للمعاينة فقط، وأنها لا تظهر في اللعبة عند تشغيلها. وهذا بالضبط سبب الكرة التي كانت ذهبية في المحرر وسوداء في اللعبة: المحرر كان يجمل لك المشهد بسماء غير موجودة فيه.
- **الظلال لها ثمن:** تفعيل ظل الشمس لم يغير ما يرسم للكاميرا، ولكنه أضاف 18 أمر رسم و18,534 مثلثاً في رسم الظلال، أي ضعف مثلثات المشهد كله. والسبب أن ظل الشمس افتراضياً مقسم إلى أربعة أجزاء بحسب البعد عن الكاميرا، ويسمى ذلك PSSM، والتوثيق يذكر أن الجسم الكبير الذي يقع في الأجزاء الأربعة يرسم خمس مرات: مرة لكل جزء ومرة للصورة النهائية. والأرضية والجداران تمتد في الأجزاء كلها، فرسمت في كل جزء.
- **المغرب:** رسم الظلال 11 أمراً، أقل من الشمس وحدها رغم أن في المشهد ضوءين بظلال. والعدد لا يتبع عدد الأضواء، وإنما عدد الأجسام التي تقع داخل كل خريطة ظل: الشمس هنا في زاوية أخرى فتقع الأجسام في أجزاء أقل، والفانوس مداه سبعة أمتار فقط، فلا يدخل في ظله إلا ما حوله. ولذلك لا تحكم على تكلفة الظل من الإعدادات، وإنما من العداد.

والدرس العملي من هذه الأرقام: كل ضوء بظل يرسم جزءاً من المشهد مرة أخرى على الأقل، ولذلك لا تفعل الظلال في كل ضوء. والقاعدة التي يتبعها أغلب المطورين: الشمس بظلها، والأضواء الصغيرة بلا ظلال إلا القريب منها والمهم للمشهد، ومدى الظل في الشمس بأقصر مسافة يقبلها المشهد من الخاصية `directional_shadow_max_distance`، فكلما قصرت كانت الظلال القريبة أوضح والأجسام الداخلة فيها أقل.

⚠️

إذا ظهرت على الأسطح خطوط متوازية من الظل تشبه حبات الرمل، وهي ما يسمى Shadow Acne، أو انفصل الظل عن الجسم كأنه يطفو، فلا تغير حجم خريطة الظلال أولاً، وإنما جرب الخاصيتين `shadow_bias` و`shadow_normal_bias` في الضوء نفسه بخطوات صغيرة، فالأولى تقلل الخطوط وكثيرها يفصل الظل، والثانية تعالج الأسطح المائلة.

## الكاميرا Camera3D: زاوية الرؤية والإسقاط

الكاميرا هي التي تحدد أي جزء من العالم يصبح صورة، ولها في [توثيق Camera3D](https://docs.godotengine.org/en/stable/classes/class%5Fcamera3d.html?ref=arabroot.io) خصائص كثيرة، وأهمها أربع:

- **زاوية الرؤية `fov`:** بالدرجات، وهي في Godot الزاوية العمودية افتراضياً، وقيمتها 75\. كلما كبرت رأيت أكثر من العالم، وصغرت الأجسام وتشوهت أطراف الصورة.
- **نوع الإسقاط `projection`:** منظوري Perspective، وفيه يصغر البعيد كما في العين، أو متعامد Orthogonal، وفيه يبقى الحجم واحداً مهما بعد الجسم، كما في ألعاب الإستراتيجية والمخططات الهندسية.
- **أقرب مسافة `near` وأبعد مسافة `far`:** ما هو أقرب من الأولى أو أبعد من الثانية لا يرسم، والقيمتان تحددان دقة ذاكرة العمق كما سنرى.

والتجربة `camera` ترسم الفناء من الموضع نفسه بثلاث زوايا رؤية، ثم بإسقاط متعامد:

![أربعة إطارات حقيقية من Godot للفناء من موضع الكاميرا نفسه. زاوية رؤية 35 درجة: الفناء قريب يملأ الإطار والخيمة والكرة والصندوق كبيرة. زاوية 75 درجة: الفناء كاملاً مع السماء. زاوية 110 درجات: الفناء صغير في وسط الإطار وأطرافه ممطوطة والأرضية تمتد كمثلث. والإسقاط المتعامد بحجم 10 أمتار: الجداران متوازيان بلا منظور، وعلى الأرضية قرب الجدار الأيسر خطوط ظل متكررة. وتحت كل إطار عدد أوامر الرسم في خرائط الظلال: 15 و18 و27 و7](https://arabroot.io/content/images/2026/11/game-3d-basics-07-camera.webp)

الفناء نفسه من النقطة نفسها: زاوية الرؤية تغير الصورة وتغير عمل الظلال أيضاً

وهذه العدادات لكل حالة:

```text
fov 35                 objects   8  primitives   9260  draw calls   7 | shadow pass: objects  15  primitives  14292  draw calls  15
fov 75                 objects   8  primitives   9260  draw calls   7 | shadow pass: objects  18  primitives  18534  draw calls  18
fov 110                objects   8  primitives   9260  draw calls   7 | shadow pass: objects  28  primitives  32030  draw calls  27
orthogonal size 10     objects   8  primitives   9260  draw calls   7 | shadow pass: objects   8  primitives   9260  draw calls   7
```

ما يرسم للكاميرا لم يتغير، فالفناء كله داخل الصورة في الحالات الأربع، ولكن رسم الظلال تغير من 15 أمراً إلى 27\. والسبب أن أجزاء ظل الشمس الأربعة تقسم المنطقة التي تراها الكاميرا، فكلما اتسعت الزاوية اتسعت المنطقة، ووقعت أجسام أكثر في أكثر من جزء. ولذلك لا تختر زاوية رؤية واسعة لأنها تبدو أجمل في المحرر، فهي تكلف في الظلال قبل أي شيء آخر. وفي الإسقاط المتعامد انخفض رسم الظلال إلى 7، ولكن ظهرت على الأرضية قرب الجدار خطوط ظل متكررة، وهي ظاهرة Shadow Acne التي ذكرناها، لأن إعدادات الظل الافتراضية مضبوطة للإسقاط المنظوري، فإذا اخترت المتعامد للعبتك فاضبط `shadow_bias` في الشمس معه.

### سطحان في المكان نفسه: Z-fighting

ذاكرة العمق Depth Buffer تحفظ لكل بكسل بعد أقرب سطح رسم فيه، ويذكر [توثيق حدود الرسم 3D](https://docs.godotengine.org/en/stable/tutorials/3d/3d%5Frendering%5Flimitations.html?ref=arabroot.io) أن دقتها محدودة، 32 بت على سطح المكتب و24 على الجوال، وأنه إذا وقع سطحان على القيمة نفسها حدث ما يسمى Z-fighting: يتناوب السطحان على البكسل، فترى خطوطاً وتمزقاً يرتجف كلما تحركت الكاميرا. والمثال الكلاسيكي سجادة على أرضية، أو ملصق على جدار، أو طريق على أرض. والتجربة `zfight` تضع سجادة حمراء طولها 18 متراً على أرضية كبيرة بأربع طرق: على الأرضية تماماً، ثم مرفوعة سنتيمتراً، ثم مرفوعة سنتيمتراً مع كاميرا `near` فيها جزء من الألف من المتر و`far` مئة كيلومتر، ثم مرفوعة مليمتراً واحداً. وشغلناها بالعارضين ⁦Forward+⁩ وCompatibility:

![ثمانية إطارات حقيقية في صفين. الصف الأعلى Forward+ والأسفل Compatibility، وفي كل صف أربع حالات. السجادة على الأرضية تماماً: في Forward+ تمزق قطري في السجادة يظهر منه لون الأرضية وخطوط أفقية متقطعة قرب حافتها، وفي Compatibility تبدو سليمة في هذا الإطار. مرفوعة سنتيمتراً: سليمة في العارضين. مرفوعة سنتيمتراً مع near تساوي 0.001 وfar تساوي 100000: لا ترسم الأرضية ولا السجادة في العارضين، وتظهر السماء ولون داكن تحت الأفق. مرفوعة مليمتراً: سليمة في العارضين](https://arabroot.io/content/images/2026/11/game-3d-basics-08-zfight.webp)

السجادة على الأرضية بأربع طرق وبعارضين: التداخل، والحل الصغير، والكاميرا التي لم ترسم شيئاً

والقراءة كما يلي:

- **على الأرضية تماماً:** في ⁦Forward+⁩ ظهر تمزق قطري في السجادة يظهر منه لون الأرضية، وخطوط متقطعة قرب حافتها. وفي Compatibility بدت السجادة سليمة في هذا الإطار بالذات، ولا تعتمد على ذلك، فالنتيجة تتغير مع زاوية الكاميرا وكرت الشاشة، والسطحان في المكان نفسه خطأ في المشهد لا في العارض.
- **مرفوعة سنتيمتراً أو حتى مليمتراً:** اختفى التداخل في العارضين، على مسافة تصل إلى أكثر من عشرين متراً من الكاميرا. وهذا هو الحل الذي يقترحه التوثيق: أبعد السطحين قليلاً بقدر لا يلاحظه اللاعب. وللملصقات على الجدران والأرضيات في Godot عقدة خاصة اسمها Decal ترسم الصورة على السطح الذي تحتها دون سطح ثان أصلاً.
- **مع `near` صغيرة جداً و`far` كبيرة جداً:** لم ترسم الأرضية ولا السجادة في العارضين، وطبع المحرك أربع مرات الخطأ `Condition "!res" is true` دون أي شرح. والنسبة بين المسافتين هنا مئة مليون، وهذا أبعد كثيراً مما تحتمله الحسابات. ويوضح التوثيق أن رفع `near` هو أهم ما يحسن دقة العمق، أكثر من خفض `far`، ولذلك القيمة الافتراضية 0.05 متر مناسبة لأغلب الألعاب، ولا تخفضها إلا إذا رأيت الكاميرا تقص جسماً قريباً منها.

## البيئة Environment: السماء والضوء المحيط وتحويل الألوان

العقدة WorldEnvironment تحمل مورداً من نوع Environment، وهو كل ما يحيط بالمشهد ولا يخص جسماً بعينه: الخلفية، والضوء المحيط Ambient Light الذي يصل إلى الظل فلا يصبح أسود، والانعكاسات التي تأخذها المعادن من السماء، وتحويل الألوان Tonemapping، والضباب Fog والتوهج Glow. ويشرحها [توثيق البيئة والمعالجة اللاحقة](https://docs.godotengine.org/en/stable/tutorials/3d/environment%5Fand%5Fpost%5Fprocessing.html?ref=arabroot.io). والسماء في المختبر من نوع ProceduralSkyMaterial، أي سماء يحسبها المحرك من ألوان وزوايا دون صورة، وهذه الدالة التي تضيفها:

```gdscript
func sky_env(tonemap := Environment.TONE_MAPPER_AGX, energy := 1.0) -> WorldEnvironment:
	var sky_mat := ProceduralSkyMaterial.new()
	var sky := Sky.new()
	sky.sky_material = sky_mat
	var env := Environment.new()
	env.background_mode = Environment.BG_SKY
	env.sky = sky
	env.ambient_light_source = Environment.AMBIENT_SOURCE_SKY
	env.reflected_light_source = Environment.REFLECTION_SOURCE_SKY
	env.tonemap_mode = tonemap
	env.background_energy_multiplier = energy
	var we := WorldEnvironment.new()
	we.environment = env
	world.add_child(we)
	return we
```

والتجربة `env` ترسم الفناء بالشمس وظلها أربع مرات: دون بيئة، ثم بسماء مع تحويل ألوان خطي Linear، ثم بسماء مع AgX، ثم مع الضباب والتوهج:

![أربعة إطارات حقيقية للفناء بالشمس وظلها. دون بيئة: خلفية رمادية مسطحة، والكرة النحاسية سوداء إلا نقطة لمعة، والظلال قاتمة. سماء مع Linear: سماء زرقاء رمادية، والألوان مشبعة، والجدار الأيمن ساطع. سماء مع AgX: الألوان نفسها أهدأ وأقل تشبعاً، والجدار الساطع لم يفقد تفاصيله. مع الضباب والتوهج: كل شيء يميل إلى لون الضباب البيج، والسماء اختفت خلفه](https://arabroot.io/content/images/2026/11/game-3d-basics-09-environment.webp)

الفناء نفسه بالشمس نفسها، والفرق في البيئة وحدها

والعدادات في الحالات الأربع واحدة: 7 أوامر رسم للكاميرا و18 للظلال، فالبيئة لا تضيف أجساماً، وإنما عملاً على كل بكسل. وفي الصور لاحظ التالي:

- **دون بيئة:** الكرة النحاسية سوداء مرة أخرى رغم وجود الشمس، لأن المعدن يأخذ لونه من الانعكاس، ولا توجد سماء يعكسها، والظلال قاتمة لأنه لا يوجد ضوء محيط يصلها. وهذا هو الإطار الذي يراه اللاعب إذا اعتمدت على سماء المعاينة في المحرر.
- **Linear مقابل AgX:** تحويل الألوان يقرر كيف تتحول القيم الكبيرة من الضوء إلى ألوان تستطيع الشاشة عرضها. والخطي لا يغير شيئاً، فتظهر الأجزاء الساطعة مشبعة أو بيضاء تماماً، ويصف التوثيق AgX بأنه منحنى يشبه الأفلام، يخفف تشبع الألوان الساطعة ويحافظ على درجتها أفضل من غيره، مع ملاحظة أنه أبطأ الخيارات. والفرق في الصورة واضح في الجدار الأيمن.
- **الضباب والتوهج:** كثافة الضباب 0.02 كافية لتخفي السماء خلف 50 متراً تقريباً، وهذا كثير لفناء صغير، ومفيد لعالم مفتوح تريد أن تخفي فيه حدود الرسم البعيدة.

## ثلاث طرق للرسم: ⁦Forward+⁩ وMobile وCompatibility

في Godot 4 ثلاث عارضات Renderers، ويشرحها [توثيق العارضات](https://docs.godotengine.org/en/stable/tutorials/rendering/renderers.html?ref=arabroot.io): ⁦Forward+⁩ الأكثر تقدماً، وهو لسطح المكتب فقط ويحتاج Vulkan أو Direct3D 12 أو Metal، وMobile بميزات أقل وأسرع في المشاهد البسيطة، وهو الافتراضي على الجوال، وCompatibility الأقل ميزات، ويعمل على OpenGL ويدعم أكبر عدد من الأجهزة، وهو الخيار الوحيد للويب، كما رأينا في [مقال التصدير إلى الويب والجوال وسطح المكتب](https://arabroot.io/articles/%D8%AA%D8%B5%D8%AF%D9%8A%D8%B1-%D8%A7%D9%84%D9%84%D8%B9%D8%A8%D8%A9-%D9%85%D9%86-godot-%D8%A7%D9%84%D9%89-%D8%A7%D9%84%D9%88%D9%8A%D8%A8-%D9%88%D8%A7%D9%84%D8%AC%D9%88%D8%A7%D9%84-%D9%88%D8%B3%D8%B7%D8%AD-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8/). والتوثيق يذكر أن الانتقال بين ⁦Forward+⁩ وMobile يحتاج تعديلات أقل من الانتقال بين أي منهما وCompatibility. ورسم المختبر الفناء نفسه بالعارضين ⁦Forward+⁩ وCompatibility، والعدادات كانت كما يلي:

```text
Godot 4.7.2-stable (official) | renderer: forward_plus | llvmpipe (LLVM 15.0.6, 256 bits) 1.3.230 | display: X11
courtyard              objects   8  primitives   9260  draw calls   7 | shadow pass: objects  18  primitives  18534  draw calls  18
mesh instances: 8, lights: sun + lantern (both with shadows)
video memory used: 132.6 MB
Godot 4.7.2-stable (official) | renderer: gl_compatibility | llvmpipe (LLVM 15.0.6, 256 bits) 4.5 (Core Profile) Mesa 22.3.6 | display: X11
courtyard              objects  26  primitives   9260  draw calls  32 | shadow pass: objects   0  primitives  18534  draw calls   0
mesh instances: 8, lights: sun + lantern (both with shadows)
video memory used: 11.4 MB
```

في المخرج أعلاه لاحظ التالي:

- **أوامر الرسم:** 7 في ⁦Forward+⁩ و32 في Compatibility للمشهد نفسه. والسبب أن Compatibility لا يجمع الأجسام المتشابهة تلقائياً، وأنه يرسم الجسم الذي يصله أكثر من ضوء مرة لكل ضوء إضافي، فالجسم الذي يضيئه الفانوس والشمس يرسم مرتين، ولذلك عد 26 جسماً بدل 8.
- **رسم الظلال:** عد Compatibility المثلثات نفسها، 18,534، ولكنه لا يملأ عدادات الأجسام والأوامر لهذا القسم، فلا تقارن العارضين بهذه الأرقام وحدها.
- **ذاكرة الرسم:** 132.6 ميجابايت في ⁦Forward+⁩ مقابل 11.4 في Compatibility، لأن الأول يحجز مخازن لمؤثراته المتقدمة حتى لو لم تستخدمها.

وفي الصورة فرق آخر أهم: ضوء الفانوس في Compatibility أقوى بكثير، يغمر الجدار الأيمن والأرضية بلون أصفر، بينما هو في ⁦Forward+⁩ هالة صغيرة. والإعدادات واحدة، ولكن العارضين لا يحسبان الضوء والألوان بالطريقة نفسها. ولذلك اختر العارض في أول يوم من مشروعك، واضبط الإضاءة عليه، لأن تغييره لاحقاً يعني أن تعيد ضبط كل مشهد.

![إطاران حقيقيان للفناء نفسه بالشمس والفانوس. على اليمين Forward+ على Vulkan: الفانوس هالة صغيرة على الجدار، و7 أوامر رسم و132.6 ميجابايت من ذاكرة الرسم. على اليسار Compatibility على OpenGL: ضوء الفانوس يغمر الجدار الأيمن والأرضية بلون أصفر ساطع، و32 أمر رسم و11.4 ميجابايت](https://arabroot.io/content/images/2026/11/game-3d-basics-10-renderers.webp)

المشهد نفسه بالإعدادات نفسها في عارضين: الأرقام مختلفة والضوء مختلف

## اقرأ ما يقوله المحرك: عدادات الرسم

كل الأرقام في هذا المقال جاءت من مكانين في المحرك، وتستطيع أن تقرأهما في لعبتك أنت. الأول الدالة `get_render_info` في كل Viewport، وهي بحسب [توثيق Viewport](https://docs.godotengine.org/en/stable/classes/class%5Fviewport.html?ref=arabroot.io) تعطي عدد الأجسام والمثلثات وأوامر الرسم في آخر إطار، لكل نوع من المرور: ما رسم للكاميرا، وما رسم للظلال، وما رسم للواجهة ثنائية الأبعاد. وهذه الدالة التي طبعت كل الأسطر التي رأيتها:

```gdscript
func info(tag: String) -> void:
	var vp := get_viewport()
	var v := func(t: int, w: int) -> int: return vp.get_render_info(t, w)
	print("%-22s objects %3d  primitives %6d  draw calls %3d | shadow pass: objects %3d  primitives %6d  draw calls %3d" % [tag,
		v.call(Viewport.RENDER_INFO_TYPE_VISIBLE, Viewport.RENDER_INFO_OBJECTS_IN_FRAME),
		v.call(Viewport.RENDER_INFO_TYPE_VISIBLE, Viewport.RENDER_INFO_PRIMITIVES_IN_FRAME),
		v.call(Viewport.RENDER_INFO_TYPE_VISIBLE, Viewport.RENDER_INFO_DRAW_CALLS_IN_FRAME),
		v.call(Viewport.RENDER_INFO_TYPE_SHADOW, Viewport.RENDER_INFO_OBJECTS_IN_FRAME),
		v.call(Viewport.RENDER_INFO_TYPE_SHADOW, Viewport.RENDER_INFO_PRIMITIVES_IN_FRAME),
		v.call(Viewport.RENDER_INFO_TYPE_SHADOW, Viewport.RENDER_INFO_DRAW_CALLS_IN_FRAME)])
```

والمكان الثاني هو المفرد Performance، وفيه المجاميع نفسها لكل النوافذ مع أرقام الزمن والذاكرة، مثل `Performance.RENDER_VIDEO_MEM_USED` الذي طبع ذاكرة الرسم. وفي المحرر تجد هذه الأرقام نفسها في لوحة Debugger ثم Monitors وأنت تشغل اللعبة، ورسماً بيانياً لكل منها. والقاعدة: عندما يبطئ مشهد ثلاثي الأبعاد، انظر إلى هذه الأرقام قبل أن تغير أي شيء، فهي تقول لك هل المشكلة في عدد الأجسام، أو في عدد المثلثات، أو في الظلال. وهذا بالضبط موضوع مقال الأداء في هذه المرحلة، حيث نبني بستاناً من آلاف النخيل بطيئاً عن قصد، ثم نصلحه خطوة خطوة بهذه الأرقام.

## ملفات المختبر وتشغيله

المختبر كله في مجلد `lab`: الملف `Dockerfile` ينزل Godot 4.7.2 الرسمي من [صفحة الإصدار](https://github.com/godotengine/godot/releases/tag/4.7.2-stable?ref=arabroot.io) ويتحقق منه بالبصمة SHA512، ويضيف Xvfb ومكتبة Mesa بجزأيها، والمجلد `game` فيه المشروع: `project.godot`، والمشهد الرئيسي الذي يضيف عقدة المختبر، والسكربت `lab.gd` الذي يبني كل شيء. والملف `run.sh` يشغل التجارب بالترتيب ويحفظ مخرج كل منها في ملف `out-*.txt` والإطارات في `shots`، وهذه الدالة التي يشغل بها كل تجربة:

```bash
# --init: Godot runs under a small init process, so the container stops cleanly when Godot quits.
lab() { MSYS_NO_PATHCONV=1 timeout 600 docker run --init --rm --name $N-$RANDOM -v "$W/game:/game" -v "$W/shots:/shots" "$IMG" bash -c \
  "Xvfb :99 -screen 0 960x540x24 > /dev/null 2>&1 & sleep 2; DISPLAY=:99 godot ${2:---rendering-driver vulkan} --path /game -- --lab $1 --shot /shots" 2>&1 \
  | grep -vE '^(ALSA|Godot Engine|WARNING: All audio|ERROR: Condition "status|libxkb|     at|   at|\s*$)'; }
```

في الدالة أعلاه لاحظ التالي:

- **الشاشة الوهمية:** Xvfb يعمل في الخلفية على الشاشة رقم 99، ثم يشغل Godot بنافذة عليها. ولم نستخدم الأداة `xvfb-run`، لأنها علقت دون أي مخرج في [مقال الصوت](https://arabroot.io/articles/%D8%A7%D9%84%D8%B5%D9%88%D8%AA-%D9%88%D8%A7%D9%84%D9%85%D9%88%D8%B3%D9%8A%D9%82%D9%89-%D9%81%D9%8A-%D8%A7%D9%84%D9%84%D8%B9%D8%A8%D8%A9-audio-buses-%D9%88lufs/)، فشغلنا Xvfb بأنفسنا كما فعلنا هناك.
- **الخيار `--init`:** يضع في الـ Container عملية صغيرة أولى تستقبل الإشارات وتنهي ما بقي من العمليات، فيتوقف الـ Container عندما ينتهي Godot، حتى لو بقي Xvfb يعمل في الخلفية.
- **العارض:** الافتراضي `--rendering-driver vulkan` للعارض ⁦Forward+⁩، والتجارب التي تقارن العارضين تمرر `--rendering-driver opengl3 --rendering-method gl_compatibility`.
- **الفلتر:** يحذف رسائل بطاقة الصوت التي لا توجد في الـ Container، وتحذيراً واحداً متكرراً عنها، ويترك كل خطأ آخر.

وتشغله كله من مجلد `lab` بالأمر `bash run.sh`. والتجارب التي فيها ظلال تأخذ بضع دقائق، أغلبها في ترجمة برامج الرسم في أول إطار، لأن Mesa تترجمها للمعالج. وإذا أردت أن تعدل الفناء وترى النتيجة، فعدل `lab.gd` وشغل التجربة وحدها، مثل `lab lights` بعد تعريف الدالة، أو افتح مجلد `game` في محرر Godot على جهازك، وشغل المشهد مع `-- --lab lights` في إعدادات التشغيل.

## أخطاء شائعة وكيف تقرأ أعراضها

- **المشهد جميل في المحرر ومظلم في اللعبة:** لا توجد WorldEnvironment ولا ضوء في المشهد، والمحرر كان يعرض سماء وشمساً للمعاينة فقط. أضفهما إلى المشهد من الأزرار أعلى نافذة 3D التي تنقل سماء المعاينة إلى المشهد.
- **جسم معدني أسود:** المعدن يعكس ما حوله، ولا شيء حوله. أضف سماء أو مسبار انعكاس ReflectionProbe، أو اخفض المعدنية إذا لم يكن معدناً أصلاً.
- **وجوه مفقودة ترى من خلالها داخل الجسم:** ترتيب الرؤوس معكوس أو مقياس سالب على محور واحد. أصلحه في برنامج النمذجة، ولا تكتف بتعطيل حذف الوجوه.
- **صندوق أو هرم يبدو منتفخاً بحواف ناعمة:** عموديات منعمة على شكل حاد. في الكود `set_smooth_group(-1)` قبل الرؤوس، وفي Blender Shade Flat أو Auto Smooth.
- **جسم بلون واحد رغم أن خامته صورة:** المجسم بلا UV. فك إحداثياته في Blender، أو استخدم Triplanar للأشكال البسيطة.
- **بلاط ممطوط على جدار طويل:** UV الافتراضي في BoxMesh يعطي كل وجه قطعة ثابتة من الصورة. استخدم Triplanar على إحداثيات العالم.
- **وميض وتمزق بين سطحين متلاصقين:** Z-fighting. أبعد أحدهما سنتيمتراً، أو استخدم Decal، ولا تخفض `near` في الكاميرا.
- **الأرض كلها اختفت وطبع المحرك `Condition "!res" is true`:** قيم `near` و`far` بعيدة جداً عن بعضهما. أعد `near` إلى 0.05 وقصر `far`.
- **أوامر الرسم أكثر بكثير من عدد الأجسام:** ظلال على أضواء كثيرة، أو زاوية رؤية واسعة جداً مع ظل الشمس، أو العارض Compatibility مع أكثر من ضوء على الجسم نفسه.
- **مئة جسم متشابه بمئة أمر رسم:** لكل جسم خامة مختلفة، ولو باللون نفسه. اجعلها خامة واحدة مشتركة ليجمعها ⁦Forward+⁩.

## قائمة فحص لأول مشهد ثلاثي الأبعاد

| السؤال                          | الإجابة الصحيحة غالباً                                                        | والسبب                                                            |
| ------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| أي عارض؟                        | ⁦Forward+⁩ لسطح المكتب، وCompatibility إذا كان الويب أو الأجهزة الضعيفة هدفاً | تغيير العارض لاحقاً يغير الإضاءة والألوان، كما رأينا في الفانوس   |
| هل في المشهد WorldEnvironment؟  | نعم، بسماء وضوء محيط                                                          | دونها المعادن سوداء والظلال قاتمة، وسماء المحرر لا تظهر في اللعبة |
| أي تحويل ألوان؟                 | AgX أو Filmic                                                                 | Linear يحرق الأجزاء الساطعة                                       |
| كم ضوءاً بظل؟                   | الشمس، وقليل من الأضواء القريبة المهمة                                        | كل ظل يرسم جزءاً من المشهد مرة أخرى                               |
| كم زاوية الرؤية؟                | بين 60 و75 لأغلب الألعاب                                                      | الزاوية الواسعة رفعت رسم الظلال من 15 إلى 27 أمراً                |
| كم near؟                        | 0.05 الافتراضية                                                               | القيم الصغيرة جداً تفسد العمق أو تمنع الرسم                       |
| كم تفصيلاً في المجسمات الجاهزة؟ | أقل ما يكفي للحجم على الشاشة                                                  | الكرة الافتراضية 4,224 مثلثاً، و16 في 8 تعطي 288                  |
| خامة لكل جسم أم مشتركة؟         | مشتركة كلما أمكن                                                              | 25 كرة: 25 أمر رسم بخامات منفصلة، وأمر واحد بخامة مشتركة          |

## تطبيق عملي

1. في التجربة `lights` أضف SpotLight3D يضيء الخيمة من أعلى بظل، وانظر كم أمراً يضيف إلى رسم الظلال، ثم عطل ظل الفانوس وقارن.
2. غير الدالة `pyramid` لتبني بيتاً بسقف مائل: صندوقاً وفوقه منشوراً، بعموديات مسطحة، واطبع عدد رؤوسه ومثلثاته قبل أن ترسمه وتوقع الرقم.
3. غير خشونة الكرة النحاسية من 0.25 إلى 0.05 ثم إلى 0.8، واحفظ الإطار في كل مرة، ثم افعل الشيء نفسه دون WorldEnvironment، وفسر الفرق.
4. شغل التجربة `zfight` بعد أن تغير السجادة لتكون مرفوعة 0.1 مليمتر، وابحث عن أبعد مسافة تبقى عندها سليمة.

## حذف المختبر Cleanup

```bash
docker image rm godot-lab:4.7.2-3d
rm -rf shots game/.godot out-*.txt
```

## الخلاصة Summary

- الصورة ثلاثية الأبعاد نتيجة خمسة أشياء معاً: المجسم والخامة والضوء والكاميرا والبيئة، وإذا خرجت خاطئة فابحث في المرحلة التي تخصها من مسار الرسم.
- الرأس في المحرك موضع مع عمودي ومع UV، ولذلك المكعب 24 رأساً لا 8، والخيمة 18 رأساً لخمس نقاط، والكرة الافتراضية 4,224 مثلثاً.
- العموديات تقرر الإضاءة: دونها لون مسطح، ومعكوسة تختفي الوجوه، ومنعمة على شكل حاد تنتفخ الحواف، و`generate_normals()` تنعم افتراضياً ما لم تضع `set_smooth_group(-1)`.
- المعدن يأخذ لونه مما يعكسه، فالكرة النحاسية كانت سوداء دون سماء، والخامة المشتركة جعلت 25 كرة أمر رسم واحداً في ⁦Forward+⁩.
- ظل الشمس أضاف 18 أمر رسم و18,534 مثلثاً لفناء فيه 9,260 مثلثاً، وزاوية الرؤية الواسعة رفعته إلى 27.
- سطحان في المكان نفسه يتداخلان، ومليمتر واحد كفى لإصلاحهما، و`near` صغيرة جداً مع `far` كبيرة جداً منعت رسم الأرضية كلها.
- المشهد نفسه كلف 7 أوامر رسم في ⁦Forward+⁩ و32 في Compatibility، وضوء الفانوس اختلف بينهما، فاختر العارض في أول يوم.

وبهذا عندك فناء تفهم كل رقم فيه، والخطوة التالية بإذن الله أن نأتي بنماذج حقيقية من Blender بهياكلها العظمية وحركاتها، ثم أن نقيس أداء مشهد كبير ونصلحه:

[![](https://arabroot.io/content/images/2026/11/blender-to-game-cover-cover.webp)دليلمن Blender إلى Godot: تجهيز النماذج والحركات Animationsنصنع نخلة أصلية بهيكل عظمي وحركتين في Blender دون واجهة، ونصدرها بصيغة glTF 2.0 إلى Godot، ثم نصنع أخطاء المقياس والمحاور والموضع وأسماء الحركات ودورانها عن قصد ونقيس أثر كل منها ونصلحه.](https://arabroot.io/articles/%D9%85%D9%86-blender-%D8%A7%D9%84%D9%89-godot-%D8%AA%D8%AC%D9%87%D9%8A%D8%B2-%D8%A7%D9%84%D9%86%D9%85%D8%A7%D8%B0%D8%AC-%D9%88%D8%A7%D9%84%D8%AD%D8%B1%D9%83%D8%A7%D8%AA-animations/)[![](https://arabroot.io/content/images/2026/11/game-performance-cover-cover.webp)دليلأداء اللعبة: قياس الإطارات Profiling وتحسينهانبني في Godot 4 بستاناً من 2,500 نخلة بطيئاً عن قصد، ثم نقيسه بأدوات المحرك ونصلحه في ست خطوات، ونعرف بالأرقام كم وفرت كل خطوة ومن أين، وما الثمن الذي دفعناه في رقم آخر.](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%A1-%D8%A7%D9%84%D9%84%D8%B9%D8%A8%D8%A9-%D9%82%D9%8A%D8%A7%D8%B3-%D8%A7%D9%84%D8%A7%D8%B7%D8%A7%D8%B1%D8%A7%D8%AA-profiling-%D9%88%D8%AA%D8%AD%D8%B3%D9%8A%D9%86%D9%87%D8%A7/)[![](https://arabroot.io/content/images/2026/11/game-math-cover-cover.webp)دليلرياضيات الألعاب: المتجهات Vectors والحركة والتصادمالمتجهات والحركة وحاصل الضرب النقطي واختبارات التصادم والارتداد والنفق، بلعبة صغيرة ومختبر Python يصنع الأخطاء الشائعة ثم يصلحها.](https://arabroot.io/articles/%D8%B1%D9%8A%D8%A7%D8%B6%D9%8A%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D9%84%D8%B9%D8%A7%D8%A8-%D8%A7%D9%84%D9%85%D8%AA%D8%AC%D9%87%D8%A7%D8%AA-vectors-%D9%88%D8%A7%D9%84%D8%AD%D8%B1%D9%83%D8%A9-%D9%88%D8%A7%D9%84%D8%AA%D8%B5%D8%A7%D8%AF%D9%85/)[![](https://arabroot.io/content/images/2026/11/godot-first-game-cover-cover.webp)دليلأول لعبة مع Godot: المشاهد والعقد وGDScriptنبني لعبة صغيرة كاملة في Godot 4 من ثلاثة مشاهد وأربعة سكربتات، ونفهم بها العقد والمشاهد والإشارات وحلقة اللعبة، ثم نشغلها في مختبر يلعبها فيه روبوت حتى تنتهي.](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D9%84%D8%B9%D8%A8%D8%A9-%D9%85%D8%B9-godot-%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D9%87%D8%AF-%D9%88%D8%A7%D9%84%D8%B9%D9%82%D8%AF-%D9%88gdscript/)[![](https://arabroot.io/content/images/2026/11/game-export-web-cover-cover.webp)دليلتصدير اللعبة من Godot إلى الويب والجوال وسطح المكتبماذا يحدث فعلاً عند تصدير لعبة Godot، ولماذا تحتاج نسخة الويب Headers خاصة أحياناً، وما تطلبه كل منصة ومتجر، مع مختبر يصدر لعبة واحدة إلى خمس منصات.](https://arabroot.io/articles/%D8%AA%D8%B5%D8%AF%D9%8A%D8%B1-%D8%A7%D9%84%D9%84%D8%B9%D8%A8%D8%A9-%D9%85%D9%86-godot-%D8%A7%D9%84%D9%89-%D8%A7%D9%84%D9%88%D9%8A%D8%A8-%D9%88%D8%A7%D9%84%D8%AC%D9%88%D8%A7%D9%84-%D9%88%D8%B3%D8%B7%D8%AD-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8/)

## سجل التحديثات Changelog

- 18 نوفمبر 2026: كتابة المقال، وبناء الفناء بالكود وتشغيل التجارب على Godot 4.7.2 في Docker، ورسم الإطارات بالعارضين ⁦Forward+⁩ على Vulkan وCompatibility على OpenGL بمكتبة Mesa 22.3.6.