> ## 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.

# من Blender إلى Godot: تجهيز النماذج والحركات Animations
- URL: https://arabroot.io/articles/من-blender-الى-godot-تجهيز-النماذج-والحركات-animations/
- Published: 2026-11-18T11:57:34.000Z
- Updated: 2026-11-18T12:56:43.000Z
- Description: نصنع نخلة أصلية بهيكل عظمي وحركتين في Blender دون واجهة، ونصدرها بصيغة glTF 2.0 إلى Godot، ثم نصنع أخطاء المقياس والمحاور والموضع وأسماء الحركات ودورانها عن قصد ونقيس أثر كل منها ونصلحه.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, تطوير الألعاب

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

وفي مقال أساسيات الألعاب ثلاثية الأبعاد في هذه المرحلة بنينا فناءً كاملاً بالكود، وعرفنا ما في المجسم من رؤوس وعموديات وUV، ولكن الألعاب الحقيقية لا تبني نماذجها بالكود، وإنما تأتي بها من برامج النمذجة، وأشهرها المجاني مفتوح المصدر Blender. وفي هذا المقال سوف نصنع نخلة أصلية في Blender 5.3، بهيكل عظمي Armature وحركتين، ونصدرها بصيغة glTF 2.0، ثم نستوردها في Godot 4.7.2 ونقيس ما وصل فعلاً. وكل شيء في المقال يعمل دون فتح الواجهة الرسومية لأي من البرنامجين: Blender ينفذ سكربت Python بالخيار `-b`، وGodot يستورد ويفحص ويرسم في Docker، فتستطيع أن تعيد كل نتيجة على جهازك بأمر واحد. ثم نصنع الأخطاء التي وصفناها عن قصد، خطأً خطأً، ونرى أثر كل منها في الأرقام وفي الصورة، ثم نصلحه.

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

- الطريق من Blender إلى المحرك: الصيغ المتاحة، ولماذا glTF 2.0 هي الصيغة الموصى بها.
- بناء نموذج بهيكل عظمي Armature وأوزان Weights وحركتين بسكربت Python، ومشكلة حقيقية ظهرت في الأوزان.
- إعدادات التصدير في Blender، وأحجام الملفات: `.glb` و`.gltf` والضغط Draco.
- ماذا يفعل Godot بالملف عند الاستيراد، وأين يحفظ النتيجة، وملف `.import`.
- ثلاث مشاكل في التحويلات Transforms: المقياس Scale، والمحاور Axis، والموضع Location، ولماذا «تطبيق التحويلات» Apply Transforms.
- الحركات Animations: أسماؤها، وطولها، والدوران Loop، وإطار زائد في كل دورة.
- قائمة فحص قبل كل تصدير.

## الطريق من Blender إلى المحرك

برنامج النمذجة يحفظ عمله بصيغته الخاصة، وBlender يحفظ ملف `.blend` فيه كل شيء: النماذج والخامات والإضاءة والكاميرات وإعدادات العرض وحتى تخطيط النوافذ. والمحرك لا يحتاج أغلب هذا، وإنما يحتاج المجسمات والخامات والهيكل العظمي والحركات، ولذلك نمر بصيغة وسيطة. ويذكر [توثيق صيغ 3D في Godot](https://docs.godotengine.org/en/stable/tutorials/assets%5Fpipeline/importing%5F3d%5Fscenes/available%5Fformats.html?ref=arabroot.io) الصيغ التي يقبلها المحرك كما يلي:

- **glTF 2.0 (الموصى بها):** صيغة مفتوحة من مجموعة Khronos، بنسختين: ملف ثنائي واحد `.glb` فيه كل شيء، أو ملف نصي `.gltf` بجانبه ملف بيانات `.bin` والصور منفصلة.
- **ملف `.blend` مباشرة:** يعمل بأن يستدعي Godot برنامج Blender في الخلفية ليصدر glTF نيابة عنك، ولذلك يحتاج Blender مثبتاً على جهاز كل من يفتح المشروع.
- **FBX:** مدعومة عبر مكتبة ufbx المضمنة في المحرك، وهي الصيغة الشائعة في المتاجر والبرامج التجارية.
- **DAE (Collada) وOBJ:** صيغ أقدم، والتوثيق يذكر أن OBJ لا تحمل نقاط الارتكاز ولا الهياكل العظمية ولا الحركات ولا خامات PBR.

وسوف نستخدم glTF 2.0 بصيغتها الثنائية، لأنها الموصى بها، ولأن ملفاً واحداً أسهل في التعامل والنقل. والشكل التالي يبين الطريق كاملاً كما سنمشي فيه:

![مخطط من اليمين إلى اليسار. Blender: ملف palm.blend فيه المجسم Palm والهيكل PalmRig والحركتان sway وgust، ويعمل بالأمر blender -b --python. سهم إلى المصدر glTF Exporter مع ثلاثة إعدادات: export_yup وexport_apply وexport_animation_mode. سهم إلى الملف palm.glb بحجم 53 كيلوبايت. سهم إلى مستورد Godot ومعه ملف palm.glb.import فيه إعدادات مثل root_scale وloop_mode. سهم إلى ملف palm.glb.scn في مجلد .godot/imported بحجم 16 كيلوبايت. سهم إلى المشهد في اللعبة: Node3D ثم PalmRig ثم Skeleton3D ثم MeshInstance3D وبجانبه AnimationPlayer. وتحت كل مرحلة الأخطاء التي تحدث فيها: المقياس والمحاور والموضع في Blender، والاسم والدوران في التصدير، والإعدادات في الاستيراد](https://arabroot.io/content/images/2026/11/blender-to-game-01-path.webp)

ثلاث محطات، ولكل محطة أخطاؤها وإعداداتها

## النخلة: نموذج أصلي من سكربت Python

أغلب الدروس تبدأ بنموذج جاهز يحمله القارئ من موقع ما، ونحن نريد أن نعرف كل رقم في النموذج ومن أين جاء، وألا يبقى في المقال ملف لا نملك رخصته، فبنينا النخلة كلها بسكربت `make_palm.py` يعمل داخل Blender. وواجهة Python في Blender اسمها `bpy`، وكل زر في الواجهة الرسومية له أمر مقابل فيها، فالسكربت يفعل ما كنت ستفعله بيدك، بالترتيب نفسه. والتشغيل من سطر الأوامر كما يلي:

```bash
blender -b --factory-startup --python make_palm.py -- /out
```

والخيار `-b` يشغل Blender في الخلفية Background دون أي نافذة، كما يشرح [توثيق خيارات سطر الأوامر في Blender](https://docs.blender.org/manual/en/latest/advanced/command%5Fline/arguments.html?ref=arabroot.io)، و`--factory-startup` يتجاهل إعداداتك الشخصية حتى تكون النتيجة نفسها على كل جهاز، وما بعد `--` يذهب إلى السكربت نفسه. والسكربت يصنع النخلة على أربع خطوات:

1. **المجسم:** جذع من عشرة أضلاع واثنتي عشرة حلقة بطول أربعة أمتار، يضيق قليلاً في أعلاه وينحني، وفوقه سبع سعفات، كل سعفة شريط من ستة أجزاء يمتد مترا ونصفاً ثم يتدلى. والسكربت يبني ذلك بمكتبة `bmesh` رأساً رأساً، كما بنينا الخيمة بالأداة SurfaceTool في مقال الأساسيات، ويكتب إحداثيات UV لكل وجه.
2. **الخامات:** خامتان، الجذع وعليه صورة لحاء بحجم 256 في 256 يرسمها السكربت بكسلاً بكسلاً، والسعف بلون أخضر.
3. **الهيكل العظمي Armature:** أربع عظام Bones متصلة على طول الجذع، اسمها Root وTrunk1 وTrunk2 وCrown، ثم ربط المجسم بالعظام بالأوزان التلقائية.
4. **الحركات:** حركتان، التمايل sway في ثانيتين يعود في آخرها إلى وضع البداية، والهبة gust في ثانية ونصف تنحني فيها النخلة بقوة ثم تعود.

وأهم جزء في السكربت هو ربط المجسم بالعظام، وهذا هو كما في الملف:

```python
    # skin the mesh to the bones with automatic weights (bone heat), as you would with Ctrl+P > With Automatic Weights
    bpy.ops.object.select_all(action='DESELECT')
    palm.select_set(True)
    rig.select_set(True)
    bpy.context.view_layer.objects.active = rig
    bpy.ops.object.parent_set(type='ARMATURE_AUTO')
    # bone heat can leave weights like 1.0000001; validate() clamps them (the glTF exporter would warn «Mesh Palm is not valid» otherwise)
    over = sum(1 for v in palm.data.vertices for g in v.groups if g.weight > 1.0)
    print("SKIN  weights above 1.0: %d, fixed by validate(): %s" % (over, palm.data.validate()))
```

والأوزان Weights هي الرقم الذي يقول لكل رأس في المجسم كم يتبع كل عظمة: رأس في أسفل الجذع يتبع Root بوزن 1، ورأس في المنتصف يتبع Trunk1 وTrunk2 بنصف ونصف، فإذا دارت العظمة تحرك معها الرأس بمقدار وزنه، وهذا ما يسمى الجلد Skinning. والأمر `parent_set` بالنوع `ARMATURE_AUTO` هو نفسه الاختيار With Automatic Weights من القائمة التي تفتحها Ctrl+P في الواجهة، ويشرحه [توثيق ربط المجسم بالهيكل في Blender](https://docs.blender.org/manual/en/latest/animation/armatures/skinning/parenting.html?ref=arabroot.io)، ويحسب الأوزان بطريقة تسمى حرارة العظام Bone Heat: كأن كل عظمة مصدر حرارة، وكل رأس يأخذ من كل عظمة بقدر ما يصله من حرارتها.

والسطران الأخيران لم يكونا في النسخة الأولى من السكربت، وإنما أضفناهما بعد مشكلة حقيقية: في أول تصدير طبع مصدر glTF تحذيراً لكل ملف يقول «Mesh Palm is not valid, and may be exported wrongly». وعندما طلبنا من Blender أن يفحص المجسم بالدالة `validate(verbose=True)` طبع 45 سطراً من هذا النوع:

```text
00:08.350  geom.mesh        | ERROR Vertex 151 deform group 3 has invalid weight 1.0000001
00:08.350  geom.mesh        | ERROR Vertex 152 deform group 3 has invalid weight 1.0000001
00:08.350  geom.mesh        | ERROR Vertex 153 deform group 3 has invalid weight 1.0000001
```

أي أن حساب حرارة العظام ترك أوزاناً أكبر من 1 بفرق في المنزلة السابعة بعد الفاصلة، وكلها للمجموعة رقم 3، أي العظمة Crown التي تحمل السعف. وهذا خطأ تقريب في الأعداد العشرية، من النوع الذي شرحناه في [مقال الأعداد العشرية](https://arabroot.io/articles/%D8%A7%D9%84%D8%A3%D8%B1%D9%82%D8%A7%D9%85-%D8%A7%D9%84%D8%B9%D8%B4%D8%B1%D9%8A%D8%A9-floating-point-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84/)، ولا يغير شكل النخلة، ولكن المصدر يفحص المجسم قبل التصدير ويحذرك، لأن الوزن الأكبر من 1 غير مسموح في glTF. والإصلاح أن تستدعي `validate()` بنفسك بعد الربط، فتقص الأوزان إلى 1، وفي الواجهة الرسومية يقابلها الأمر Normalize All من قائمة Weights في وضع رسم الأوزان. والقاعدة: لا تتجاهل تحذيرات المصدر لأن الملف خرج في النهاية، فهي أول مكان تظهر فيه المشكلة قبل أن تصل إلى اللعبة.

والمخرج الكامل لأول نسخة من النخلة كان كما يلي:

```text
Blender 5.3.0 | glTF exporter 5.3.43
SKIN  weights above 1.0: 45, fixed by validate(): True
BLEND ok           location (0.0, 0.0, 0.0) scale (1.0, 1.0, 1.0)  vertices 228 faces 162  height in Blender units 4.04  actions ['gust', 'sway']
WEIGHTS vertices per bone (weight > 0.01): {'Root': 49, 'Trunk1': 50, 'Trunk2': 46, 'Crown': 141}
INFO Draco is available, use library at /opt/blender/lib/libbf_intern_draco_bridge.so
INFO MeshOptimizer is available, use library at /opt/blender/lib/libbf_intern_meshopt_bridge.so
EXPORT palm.glb                       53200 bytes
EXPORT palm.gltf                      12756 bytes
EXPORT palm-draco.glb                 25180 bytes
Info: Saved as "palm.blend"
SAVE  palm.blend 105109 bytes
```

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

- **228 رأساً و162 وجهاً:** الجذع 130 رأساً و120 وجهاً رباعياً، والسعف 98 رأساً و42 وجهاً. وسوف نرى بعد قليل أن هذه الأرقام تتغير عند الوصول إلى Godot.
- **الارتفاع 4.04:** بوحدات Blender، وهي هنا متر لأن إعداد الوحدات في المشهد Metric بمقياس 1\. والأربعة أمتار هي الجذع، والزيادة من السعفات التي ترتفع قليلاً قبل أن تتدلى.
- **توزيع الأوزان:** العظمة Crown تحرك 141 رأساً، أي كل السعف وأعلى الجذع، وكل عظمة من الثلاث الأخرى حوالي خمسين رأساً، وبعض الرؤوس تتبع عظمتين في المناطق بينهما.
- **الحركتان:** sway وgust بالأسماء التي أعطيناها لهما، وسوف نرى ماذا يحدث دونها.

وهذه النخلة نفسها كما رسمها Blender بمحرك Cycles على المعالج، في الإطار 16 من حركة التمايل حيث تميل أكثر ما تميل، والسكربت `render_palm.py` في المختبر يرسمها بالأمر نفسه دون واجهة:

![صورة رسمها Blender 5.3 بمحرك Cycles: نخلة بجذع بني فيه حلقات أفقية داكنة من صورة اللحاء، وسبع سعفات خضراء تتدلى من أعلاه، تقف على أرض رملية وظل سعفها على الأرض، وخلفها سماء رمادية زرقاء](https://arabroot.io/content/images/2026/11/blender-to-game-02-blender.webp)

النخلة في Blender قبل أن تغادره: 228 رأساً وأربع عظام وحركتان

## التصدير بصيغة glTF 2.0: الإعدادات التي تهمك

مصدر glTF يأتي مع Blender نفسه، ويشرح خياراته [توثيق glTF 2.0 في Blender](https://docs.blender.org/manual/en/latest/addons/scene%5Fgltf2.html?ref=arabroot.io)، ونافذته في الواجهة من File ثم Export ثم glTF 2.0، وفيها عشرات الخيارات. والسكربت يستدعيه بالأمر `bpy.ops.export_scene.gltf`، وكل خيار في النافذة له اسم في هذا الأمر. وهذه الدالة التي تصدر كل نسخ النخلة:

```python
def export(name, **kw):
    path = os.path.join(OUT, name)
    opts = dict(filepath=path, export_format='GLB', export_animation_mode='ACTIONS', export_yup=True)
    opts.update(kw)
    bpy.ops.export_scene.gltf(**opts)
    print("EXPORT %-26s %9d bytes" % (name, os.path.getsize(path) if os.path.exists(path) else -1))
```

والخيارات التي تقرر أغلب ما سيحدث في المحرك هي هذه، وقيمها الافتراضية كما طبعها Blender 5.3 من تعريف الأمر نفسه:

| الخيار في السكربت                        | في النافذة                           | الافتراضي | ماذا يفعل                                                               |
| ---------------------------------------- | ------------------------------------ | --------- | ----------------------------------------------------------------------- |
| export\_format                           | Format                               | GLB       | ملف ثنائي واحد، أو GLTF\_SEPARATE لملف نصي وملف بيانات وصور منفصلة      |
| export\_yup                              | ⁦+Y Up⁩                              | True      | يحول المحور الأعلى من Z في Blender إلى Y في glTF                        |
| export\_apply                            | Apply Modifiers                      | False     | يطبق المعدلات Modifiers مثل Subdivision وTriangulate قبل التصدير        |
| export\_animation\_mode                  | Animation Mode                       | ACTIONS   | كل Action تصلح للكائن تصبح حركة مستقلة، أو NLA\_TRACKS لمسارات محرر NLA |
| export\_anim\_slide\_to\_zero            | Set all glTF Animation starting at 0 | False     | يبدأ كل حركة من الزمن 0 بدل زمن أول إطار فيها                           |
| export\_draco\_mesh\_compression\_enable | Compression                          | False     | يضغط المجسمات بطريقة Draco                                              |

ولاحظ أن الخيار `export_apply` في الجدول اسمه في النافذة Apply Modifiers، وهو غير «تطبيق التحويلات» Apply Transforms الذي سنتحدث عنه، فهذا يطبق المعدلات فقط، أما التحويلات فتطبقها أنت في Blender قبل التصدير، وهذا مصدر خلط شائع.

ثم صدر السكربت النخلة نفسها بثلاث طرق لنقارن الأحجام، والجدول التالي من المخرج ومن قائمة الملفات:

| الملف                             | الحجم                                 | ملاحظة                                                        |
| --------------------------------- | ------------------------------------- | ------------------------------------------------------------- |
| palm.blend                        | 105,109 بايت                          | ملف العمل في Blender، ومعه صورة اللحاء مضمنة                  |
| palm.glb                          | 53,200 بايت                           | كل شيء في ملف واحد                                            |
| palm.gltf \+ palm.bin \+ bark.png | 12,756 + 39,412 + 5,031 = 57,199 بايت | نص JSON يمكن قراءته ومراجعته في Git، والبيانات والصورة منفصلة |
| palm-draco.glb                    | 25,180 بايت                           | أقل من النصف، ولكن انتظر قسم Draco                            |

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

## ماذا يفعل Godot بالملف؟ الاستيراد Import

عندما تضع `palm.glb` في مجلد المشروع، لا يقرؤه Godot في كل مرة تشغل فيها اللعبة، وإنما يستورده مرة واحدة: يحوله إلى مشهد بصيغة المحرك الخاصة، ويحفظه في المجلد المخفي `.godot/imported`، ويكتب بجانب الملف الأصلي ملفاً صغيراً اسمه `palm.glb.import` فيه إعدادات الاستيراد. والمختبر يستورد المشروع من سطر الأوامر بالأمر `godot --headless --import`، وهو ما يحدث في المحرر عندما تعود إلى نافذته بعد أن أضفت الملف. وهذه إعدادات الاستيراد الافتراضية للملف كما كتبها Godot 4.7.2:

```ini
[params]
nodes/root_type=""
nodes/root_name=""
nodes/root_script=null
mesh_library/use_node_names_as_mesh_names=false
array_mesh/deduplicate_surfaces=true
nodes/apply_root_scale=true
nodes/root_scale=1.0
nodes/import_as_skeleton_bones=false
nodes/use_name_suffixes=true
nodes/use_node_type_suffixes=true
meshes/ensure_tangents=true
meshes/generate_lods=true
meshes/create_shadow_meshes=true
meshes/light_baking=1
meshes/lightmap_texel_size=0.2
meshes/force_disable_compression=false
skins/use_named_skins=true
animation/import=true
animation/fps=30
animation/trimming=false
animation/remove_immutable_tracks=true
animation/import_rest_as_RESET=false
import_script/path=""
materials/extract=0
materials/extract_format=0
materials/extract_path=""
_subresources={}
gltf/naming_version=2
gltf/embedded_image_handling=1
gltf/texture_map_mode=1
```

ولن تحتاج أغلبها، ولكن بعضها يفسر ما سنراه، ويشرحها [توثيق إعدادات استيراد 3D](https://docs.godotengine.org/en/stable/tutorials/assets%5Fpipeline/importing%5F3d%5Fscenes/import%5Fconfiguration.html?ref=arabroot.io):

- **`nodes/root_scale`:** يضرب المشهد كله في رقم، وسوف نستخدمه لإصلاح النخلة المصنوعة بالسنتيمتر.
- **`nodes/use_name_suffixes`:** يجعل المستورد يقرأ لواحق في أسماء العقد والحركات، مثل `-col` لتوليد شكل تصادم من المجسم، و`-loop` لجعل الحركة تدور.
- **`meshes/generate_lods`:** يولد نسخاً أبسط من كل مجسم للمسافات البعيدة تلقائياً، وهذا موضوع في مقال الأداء.
- **`animation/fps=30`:** المستورد يعيد أخذ عينات الحركات 30 مرة في الثانية.
- **`_subresources={}`:** هنا تحفظ الإعدادات الخاصة بكل حركة وكل مجسم وكل خامة داخل الملف، وهي فارغة الآن، وسوف نكتب فيها إصلاح الدوران.
- **`gltf/embedded_image_handling=1`:** يستخرج الصور المضمنة في الملف إلى ملفات بجانبه.

والقيمة الأخيرة تفسر ملفاً لم نضعه في المشروع: بعد الاستيراد ظهر بجانب كل ملف `.glb` ملف صورة باسمه، مثل `palm_bark.png` بحجم 5,031 بايت، وهو صورة اللحاء التي كانت مضمنة. وهذه الملفات من المشروع، وترفعها إلى Git مع النموذج. وأما ما كتبه Godot في مجلد الاستيراد فهو كما يلي:

```text
--- .godot/imported
16326 palm.glb.scn
2020 palm_bark.png.ctex
16325 palm.gltf.scn
```

النخلة التي كانت 53,200 بايت أصبحت مشهداً بحجم 16,326 بايت، والسبب أن Godot يضغط بيانات الرؤوس افتراضياً عند الاستيراد، وهذا ما يعطله الإعداد `meshes/force_disable_compression` إذا احتجت الدقة الكاملة. ولاحظ أن نسخة `.gltf` المنفصلة أعطت المشهد نفسه تقريباً، بفارق بايت واحد، فالصيغة التي تختارها للنقل لا تغير ما يصل إلى اللعبة. ولا ترفع مجلد `.godot` إلى Git، لأن كل جهاز يعيد بناءه من الملفات الأصلية وملفات `.import`.

### ماذا وصل فعلاً؟

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

```text
palm.glb               size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
    palm (Node3D)
      PalmRig (Node3D)  pos (0.00, 0.00, 0.00)  rot° (0.00, 0.00, 0.00)  scale (1.00, 1.00, 1.00)
        Skeleton3D (Skeleton3D)  pos (0.00, 0.00, 0.00)  rot° (0.00, 0.00, 0.00)  scale (1.00, 1.00, 1.00)
          Palm (MeshInstance3D)  pos (0.00, 0.00, 0.00)  rot° (0.00, 0.00, 0.00)  scale (1.00, 1.00, 1.00)
      AnimationPlayer (AnimationPlayer)
    skeleton: 4 bones ["Root", "Trunk1", "Trunk2", "Crown"]
    mesh Palm: 2 surfaces, 604 vertices, skin: true
      surface 0: material Trunk  cull_mode 0  texture palm_bark.png 256x256
      surface 1: material Leaves  cull_mode 2  texture none
    animation "gust"           length 1.533 s  loop_mode 0  tracks 3
    animation "sway"           length 2.033 s  loop_mode 0  tracks 3
```

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

- **الحجم:** 4.04 متر ارتفاعاً كما في Blender، وأسفل النخلة عند y=0، أي أنها تقف على الأرض حيث تضعها.
- **شجرة العقد:** الكائن PalmRig في Blender أصبح عقدة Node3D، وتحته Skeleton3D فيه العظام الأربع بأسمائها، وتحته المجسم Palm في عقدة MeshInstance3D مربوطة بالهيكل، وبجانبها AnimationPlayer فيه الحركتان. وهذا هو الشكل الذي تتوقعه دائماً من نموذج بهيكل عظمي.
- **604 رؤوس بدل 228:** كما رأينا في المكعب في مقال الأساسيات، الرأس في المحرك موضع مع عمودي ومع UV، والنخلة مظللة بعموديات مسطحة، فكل وجه له رؤوسه، والجذع فيه درز UV حيث يلتقي أول ضلع بآخره، والسطحان منفصلان. ولذلك لا تقارن عدد الرؤوس في Blender بعدده في المحرك، وإنما قارن عدد المثلثات.
- **الخامتان:** الجذع `cull_mode 0` أي أن الوجوه الخلفية تحذف، والسعف `cull_mode 2` أي أن الوجهين يرسمان، لأن السعفة مستوى واحد يجب أن يرى من الجهتين. وفي أول تصدير كانت الخامتان كلتاهما على 2، لأن Blender يترك الخيار Backface Culling معطلاً في كل خامة افتراضياً، والمصدر ينقل ذلك إلى glTF كخامة برسم الوجهين. ويحذر توثيق Godot من ذلك صراحة، لأنه يرسم الوجوه الخلفية بلا فائدة، والإصلاح في Blender نفسه: فعل Backface Culling في كل خامة لجسم مغلق، كما فعلنا للجذع، ثم صدر من جديد.
- **الحركتان:** بأسمائهما، ولكن طول sway ثانيتان وجزء من ثلاثين، لا ثانيتان، ولا تدور أي منهما، وسوف نعود إليهما في قسم الحركات.

## التحويلات Transforms: المقياس والمحاور والموضع

كل كائن في Blender له تحويل Transform من ثلاثة أجزاء: الموضع Location والدوران Rotation والمقياس Scale، وهو منفصل عن بيانات المجسم نفسه. فإذا كبرت نخلة إلى الضعف بالمقياس، بقيت رؤوسها في البيانات كما هي، وتغير رقم المقياس في الكائن فقط. وهذا مريح في أثناء العمل، ولكنه يعني أن الشكل الذي تراه نتيجة رقمين: البيانات والتحويل، وأن أي برنامج يقرأ أحدهما دون الآخر يرى شيئاً مختلفاً. والأمر «تطبيق التحويلات» Apply Transforms، الذي تفتحه في Blender بالاختصار Ctrl+A ويشرحه [توثيق Apply في Blender](https://docs.blender.org/manual/en/latest/scene%5Flayout/object/editing/apply.html?ref=arabroot.io)، ينقل التحويل إلى البيانات نفسها ويعيد التحويل إلى قيمه المحايدة: الموضع 0 والدوران 0 والمقياس 1\. ويوصي [توثيق اعتبارات تصدير النماذج](https://docs.godotengine.org/en/stable/tutorials/assets%5Fpipeline/importing%5F3d%5Fscenes/model%5Fexport%5Fconsiderations.html?ref=arabroot.io) بتطبيق التحويلات قبل التصدير. والسؤال الذي يطرحه الجميع: لماذا، ما دام النموذج يبدو صحيحاً؟ والإجابة في التجارب الثلاث التالية.

صدر السكربت النخلة بخمس نسخ أخرى غير الصحيحة، وكل نسخة فيها قرار واحد خاطئ، وهذه أسطر Blender لها:

```text
BLEND offset       location (3.0, 2.0, 0.0) scale (1.0, 1.0, 1.0)  vertices 228 faces 162  height in Blender units 4.04  actions ['gust', 'sway']
BLEND cm           location (0.0, 0.0, 0.0) scale (1.0, 1.0, 1.0)  vertices 228 faces 162  height in Blender units 404.44  actions ['gust', 'sway']
BLEND cm-scaled    location (0.0, 0.0, 0.0) scale (0.01, 0.01, 0.01)  vertices 228 faces 162  height in Blender units 4.04  actions ['gust', 'sway']
BLEND cm-applied   location (0.0, 0.0, 0.0) scale (1.0, 1.0, 1.0)  vertices 228 faces 162  height in Blender units 4.04  actions ['gust', 'sway']
```

والنسخة الخامسة `palm-zup.glb` هي النخلة الصحيحة نفسها، صدرت مع `export_yup=False`. وهذه أحجامها كما قاسها Godot بعد الاستيراد:

```text
palm.glb               size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
palm-zup.glb           size (3.06, 3.14, 4.04)  min (-1.34, -1.57, 0.00)  max (1.72, 1.57, 4.04)
palm-offset.glb        size (3.06, 4.04, 3.14)  min (4.66, 0.00, -5.57)  max (7.72, 4.04, -2.43)
palm-cm.glb            size (306.32, 404.44, 314.20)  min (-134.32, 0.00, -157.10)  max (172.00, 404.44, 157.10)
palm-cm-scaled.glb     size (0.03, 0.04, 0.03)  min (-0.01, 0.00, -0.02)  max (0.02, 0.04, 0.02)
palm-cm-applied.glb    size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
```

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

![إطار حقيقي من Godot: أرض رملية عليها أربع حلقات حمراء في صف، وكبسولة زرقاء بطول إنسان. على الحلقة الأولى من اليسار نخلة واقفة صحيحة. على الحلقة الثانية نخلة نائمة على جنبها وسعفها على الأرض، وهي النسخة المصدرة دون +Y Up. الحلقة الثالثة فارغة، والنخلة التي يفترض أن تكون عليها تقف بعيداً إلى يمينها وخلفها بثلاثة أمتار ومترين. على الحلقة الرابعة نخلة واقفة صحيحة الشكل، وهي نسخة السنتيمتر بمقياس 0.01 غير مطبق. وتحت الإطار أربعة عناوين بالعربية لكل نسخة](https://arabroot.io/content/images/2026/11/blender-to-game-03-lineup.webp)

أربع نسخ من النخلة نفسها، كل واحدة وضعت في Godot على حلقتها الحمراء

### المحاور Axis: النخلة النائمة

Blender يجعل المحور Z هو الأعلى، وGodot وglTF يجعلان Y هو الأعلى، والخيار `export_yup` في المصدر يحول بينهما بأن يدير المشهد كله 90 درجة حول المحور X. فإذا عطلته وصلت النخلة إلى Godot كما هي في أرقام Blender، فارتفاعها 4.04 على المحور Z، أي على الأرض، كما ترى في الحجم (3.06, 3.14, 4.04) وفي النخلة النائمة في الصورة. وهذا الخطأ لا يحدث بالإعدادات الافتراضية، ولكنه يحدث عندما تجرب الخيارات لتصلح مشكلة أخرى، أو مع برامج نمذجة تجعل Z الأعلى وتصدر دون تحويل. والإصلاح أن تعيد الخيار، لا أن تدير النخلة في Godot بـ 90 درجة، لأن الدوران عندها يبقى في العقدة، وكل حركة وكل شكل تصادم تبنيه عليها يحمل هذا الدوران معه.

وهناك اتجاه ثان يخلط فيه كثيرون: الأمام. يذكر التوثيق أن النماذج التي لها أمام، مثل الشخصيات، يجب أن تنظر في اتجاه ⁦+Z⁩ في Godot، أي عكس اتجاه الكاميرا، حتى ترى الشخصية وجهها للكاميرا افتراضياً، وهذا يعني في Blender أن الأمام هو ⁦-Y⁩. فإذا صممت شخصية تنظر إلى ⁦+Y⁩ في Blender، فستمشي في اللعبة إلى الخلف. والنخلة لا أمام لها، فلم نحتج إلى ذلك هنا، ولكن تذكره في أول شخصية تصدرها.

### الموضع Location: النخلة البعيدة عن مكانها

النسخة `palm-offset.glb` هي النخلة التي تركها صاحبها حيث صممها في Blender، على بعد 3 أمتار إلى الجانب ومترين إلى الخلف من مركز المشهد. وفي الصورة الحلقة الثالثة فارغة، والنخلة بعيدة عنها، لأن موضعها في Blender أصبح جزءاً من النموذج: عندما تضعها في Godot عند نقطة ما، تظهر على بعد ثلاثة أمتار منها، وعندما تديرها تدور حول تلك النقطة البعيدة لا حول جذعها. ولاحظ أن الإزاحة في Blender كانت (3, 2, 0)، وأن المحور Y في Blender أصبح ⁦-Z⁩ في Godot بعد تحويل المحاور، فالنخلة إلى الخلف لا إلى الأعلى.

وفي الأرقام شيء آخر أغرب: الصندوق المحيط يبدأ عند x=4.66، والنخلة الصحيحة تبدأ عند -1.34، والفرق 6 أمتار لا 3، وكذلك على المحور Z، الفرق 4 أمتار لا 2\. أي أن الإزاحة حسبت مرتين في الصندوق، بينما الرسم في الصورة صحيح بإزاحة واحدة. وسبب ذلك في طريقة glTF مع المجسمات المربوطة بهيكل عظمي: موضع المجسم يأتي من العظام عند الرسم، والمصدر يضع الرؤوس في البيانات في مكانها النهائي، ثم يبقى تحويل الكائن على العقدة الأب أيضاً، فكل حساب يجمع بيانات المجسم مع تحويل العقدة، مثل الصندوق المحيط، يرى التحويل مرتين. وسوف ترى في القسم التالي أن هذا ليس تفصيلاً في طريقة الحساب.

### المقياس Scale: النخلة بحجم برج

النسخة الأخطر هي `palm-cm.glb`: نخلة صممها صاحبها كأن الوحدة سنتيمتر، فطولها 404 وحدات، وهذا يحدث كثيراً مع النماذج المنقولة من برامج أو متاجر تعمل بالسنتيمتر. وGodot يعتبر الوحدة متراً، كما يذكر توثيق مقدمة 3D، فوصلت نخلة طولها 404 أمتار. والصورة التالية تبينها بجانب النخلة الصحيحة والكبسولة، ثم بعد الإصلاح من إعدادات الاستيراد:

![إطاران حقيقيان من Godot من الكاميرا نفسها. الأيمن قبل الإصلاح: جذع ضخم ثماني الأضلاع بني بحلقات داكنة يملأ نصف الإطار ويخرج من أعلاه، وبجانبه على اليمين نخلة صغيرة طولها أربعة أمتار وكبسولة زرقاء بطول إنسان. والأيسر بعد ضبط root_scale على 0.01 في إعدادات الاستيراد: نخلتان بالحجم نفسه في عمق الإطار، والكبسولة بجانب إحداهما](https://arabroot.io/content/images/2026/11/blender-to-game-04-scale.webp)

نخلة مصممة بالسنتيمتر وصلت بطول 404 أمتار، ثم بعد ضبط root\_scale على 0.01

وأول ما يفكر فيه أغلب الناس أن يصغروا الكائن في Blender بمقياس 0.01 حتى يبدو بالحجم الصحيح، وهذه النسخة `palm-cm-scaled.glb`، وهي في الصف السابق النخلة الرابعة، وتبدو صحيحة تماماً. ولكن الصندوق المحيط الذي قاسه Godot لها 0.03 في 0.04 في 0.03 متر، أي أربعة سنتيمترات، لأن المقياس حسب مرتين كما حدث مع الإزاحة. ولنعرف هل هذا يؤثر في اللعبة، طلبنا من Godot أن يبني شكل تصادم Collision Shape من المجسم بالدالة `create_convex_collision()`، وهي ما يفعله الأمر Mesh ثم Create Collision Shape في المحرر، والمخرج كان كما يلي:

```text
palm.glb               size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
      PalmRig (Node3D)  pos (0.00, 0.00, 0.00)  rot° (0.00, 0.00, 0.00)  scale (1.00, 1.00, 1.00)
    convex collider from the mesh: size (3.06, 4.04, 3.14)
palm-cm-scaled.glb     size (0.03, 0.04, 0.03)  min (-0.01, 0.00, -0.02)  max (0.02, 0.04, 0.02)
      PalmRig (Node3D)  pos (0.00, 0.00, 0.00)  rot° (-0.00, 0.00, 0.00)  scale (0.01, 0.01, 0.01)
    convex collider from the mesh: size (0.03, 0.04, 0.03)
palm-cm-applied.glb    size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
      PalmRig (Node3D)  pos (0.00, 0.00, 0.00)  rot° (0.00, 0.00, 0.00)  scale (1.00, 1.00, 1.00)
    convex collider from the mesh: size (3.06, 4.04, 3.14)
```

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

- **النخلة الصحيحة:** شكل التصادم بحجمها، 3.06 في 4.04 في 3.14.
- **النخلة بمقياس غير مطبق:** العقدة PalmRig تحمل المقياس 0.01، والنخلة ترسم بأربعة أمتار، ولكن شكل التصادم الذي بني منها أربعة سنتيمترات، أي أن اللاعب سوف يمشي من خلال جذعها، والرصاصة سوف تعبرها، ولن تعرف السبب بالنظر إلى الصورة.
- **بعد تطبيق المقياس:** السكربت طبق المقياس على الكائنين بالأمر `transform_apply(scale=True)`، وهو الاختصار Ctrl+A ثم Scale، فأصبحت البيانات نفسها بالمتر والمقياس 1، وعادت الأرقام كلها مثل النخلة الصحيحة تماماً.

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

وإذا وصلك نموذج بالسنتيمتر ولا تستطيع تعديله في Blender، مثل نموذج من متجر، فالإصلاح في Godot هو الإعداد `nodes/root_scale` في إعدادات الاستيراد، وفي المحرر تجده في لوحة Import باسم Root Scale. وجعلناه 0.01 للنسخة `palm-cm.glb` في ملف `.import` ثم أعدنا الاستيراد:

```text
/game/models/palm-cm.glb.import:nodes/root_scale=0.01
palm-cm.glb            size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
```

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

💡

لتعرف وحدة نموذج وصلك دون أن تفتح Blender، استورده وانظر إلى ارتفاعه في Godot: إنسان بطول 180 متراً يعني سنتيمترات، وبطول 0.018 يعني أن أحداً صغره مرتين. والمختبر يطبع ذلك لكل ملف بالتجربة `inspect`، فتستطيع أن تضيف إليها ملفك.

## الحركات Animations: الأسماء والطول والدوران

الحركة في Blender اسمها Action: مجموعة منحنيات Curves، كل منحنى يغير خاصية واحدة لعظمة واحدة مع الزمن، مثل دوران Trunk1 حول المحور X. والمصدر بالوضع `ACTIONS` يصدر كل Action تصلح للهيكل كحركة مستقلة في glTF، والمستورد في Godot يضعها كلها في عقدة AnimationPlayer. ولكل حركة في السكربت مفاتيح Keyframes بالإطار والزاوية:

```python
    plans = [
        (action_names[0], [(1, 0), (16, 3), (31, 0), (46, -3), (61, 0)]),
        (action_names[1], [(1, 0), (10, 12), (30, -4), (46, 0)]),
    ]
    for act_name, keys in plans:
        rig.animation_data_create()
        rig.animation_data.action = bpy.data.actions.new(act_name or "PalmRigAction")   # no name: what Blender itself would call it
        for bi, bname in enumerate(["Trunk1", "Trunk2", "Crown"]):
            pb = rig.pose.bones[bname]
            pb.rotation_mode = 'XYZ'
            for frame, deg in keys:
                pb.rotation_euler = (math.radians(deg * (bi + 1) / 2), 0, 0)
                pb.keyframe_insert("rotation_euler", frame=frame)
        rig.animation_data.action.use_fake_user = True
```

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

- **التمايل sway:** من الإطار 1 إلى 61 بسرعة 30 إطاراً في الثانية، أي ثانيتان، يميل إلى الأمام 3 درجات ثم يعود ثم إلى الخلف ثم يعود، والإطار الأخير مثل الأول تماماً حتى يدور دون انتقال مفاجئ.
- **كل عظمة تميل أكثر من التي تحتها:** نصف الزاوية لـ Trunk1، والزاوية كاملة لـ Trunk2، ومرة ونصف لـ Crown، وبما أن كل عظمة تحمل ما فوقها، يتجمع الميل في الأعلى كما يحدث في نخلة حقيقية.
- **المستخدم الوهمي Fake User:** الحركة التي لا يستخدمها أي كائن يحذفها Blender عند الحفظ، و`use_fake_user` هو زر الدرع بجانب اسم الحركة في الواجهة، يبقيها في الملف حتى لو لم تكن الحركة الحالية للهيكل.

### الأسماء: PalmRigAction\_001

عندما تنشئ حركة جديدة في Blender دون أن تسميها، يعطيها اسم الكائن مع كلمة Action، ثم يضيف `.001` للثانية. والنسخة `palm-names.glb` فيها الحركتان نفسيهما بالأسماء التي يعطيها Blender، وهذا ما وصل:

```text
palm-names.glb         size (3.06, 4.04, 3.14)  min (-1.34, 0.00, -1.57)  max (1.72, 4.04, 1.57)
    animation "PalmRigAction"  length 2.033 s  loop_mode 0  tracks 3
    animation "PalmRigAction_001" length 1.533 s  loop_mode 0  tracks 3
```

والنقطة أصبحت شرطة سفلية، لأن أسماء الحركات في Godot لا تقبل بعض الرموز. والمشكلة ليست في شكل الاسم، وإنما في الكود: عندما تكتب `$AnimationPlayer.play("sway")` فإنك تربط الكود باسم الحركة، فإذا وصلت الحركة باسم آخر لم تعمل، وإذا أعاد الفنان ترتيب الحركات تبدلت الأسماء. ولذلك سم كل حركة في Blender باسم قصير بالإنجليزية يصف ما تفعله، مثل idle وwalk وsway، قبل أول تصدير.

### الدوران Loop وإطار زائد في كل دورة

الحركة sway وصلت بالقيمة `loop_mode 0`، أي أنها لا تدور، فهذا ما يحدث عندما تشغلها، والتجربة `anim` تشغلها 4.5 ثوان بسرعة ثابتة 30 إطاراً في الثانية، وتطبع موضع أعلى الجذع على المحور Z بالمتر كل نصف ثانية:

```text
--- palm.glb
  t=0.0 z=-0.000  t=0.5 z=+0.100  t=1.0 z=+0.010
  t=1.5 z=-0.104  t=2.0 z=-0.003  t=2.5 z=-0.000
  t=3.0 z=-0.000  t=3.5 z=-0.000  t=4.0 z=-0.000
  t=4.5 z=-0.000
    frames 56-64 (1.87-2.13 s): -0.027 -0.018 -0.011 -0.005 -0.003 -0.000 -0.000 -0.000 -0.000
    playing: false  current_animation: ""  position 2.033 s
```

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

1. **من الاسم في Blender:** يذكر [توثيق لواحق الأسماء في الاستيراد](https://docs.godotengine.org/en/stable/tutorials/assets%5Fpipeline/importing%5F3d%5Fscenes/node%5Ftype%5Fcustomization.html?ref=arabroot.io) أن الحركة التي يبدأ اسمها أو ينتهي بالكلمة loop أو cycle تستورد وهي تدور. وسمينا الحركة في النسخة `palm-loop.glb` باسم `sway-loop`، فوصلت باسم `sway` وقيمة `loop_mode 1`، أي أن المستورد حذف اللاحقة وفعل الدوران. والتوثيق يذكر أن ذلك يحتاج في Blender إلى محرر NLA، ولكن في تجربتنا بالوضع ACTIONS الافتراضي كفى الاسم وحده مع Blender 5.3 وGodot 4.7.2.
2. **من إعدادات الاستيراد:** في المحرر تفتح نافذة Advanced Import Settings للملف، وتختار الحركة، وتجعل Loop Mode على Linear. وهذا يكتب في `_subresources` في ملف `.import`، وفعلنا ذلك للنسخة الأصلية `palm.glb` فأصبحت `loop_mode 1` دون أن نغير شيئاً في Blender. وميزة هذه الطريقة أن الإعداد يبقى بعد كل تصدير جديد، لأن ملف `.import` منفصل عن النموذج.
3. **من الكود:** `animation.loop_mode = Animation.LOOP_LINEAR` بعد تحميل المشهد. وهي أسوأ الثلاث، لأن من يقرأ النموذج في المحرر لا يرى أنها تدور.

وبعد أن دارت الحركة ظهرت مشكلة أصغر: طولها 2.033 ثانية لا 2.000\. والسبب أن أول إطار في Blender رقمه 1 لا 0، والمصدر يحسب الزمن من رقم الإطار، فالمفتاح الأول عند 1 على 30 من الثانية والأخير عند 61 على 30، أي 2.033\. ويحسب Godot طول الحركة من الصفر إلى آخر مفتاح، فتبدأ كل دورة بإطار ثابت قبل أن يبدأ أول مفتاح. ولنرى أثر ذلك، صدرنا النسخة `palm-loop-zero.glb` مع الخيار `export_anim_slide_to_zero=True` الذي ينقل أول مفتاح إلى الزمن 0، فأصبح الطول 2.000 بالضبط، وهذا مخرج النسختين جنباً إلى جنب:

```text
--- palm-loop.glb
  t=0.0 z=-0.000  t=0.5 z=+0.100  t=1.0 z=+0.010
  t=1.5 z=-0.104  t=2.0 z=-0.003  t=2.5 z=+0.100
  t=3.0 z=+0.021  t=3.5 z=-0.101  t=4.0 z=-0.005
  t=4.5 z=+0.093
    frames 56-64 (1.87-2.13 s): -0.027 -0.018 -0.011 -0.005 -0.003 -0.000 +0.002 +0.004 +0.007
--- palm-loop-zero.glb
  t=0.0 z=-0.000  t=0.5 z=+0.101  t=1.0 z=-0.000
  t=1.5 z=-0.102  t=2.0 z=-0.000  t=2.5 z=+0.101
  t=3.0 z=-0.000  t=3.5 z=-0.102  t=4.0 z=-0.000
  t=4.5 z=+0.101
    frames 56-64 (1.87-2.13 s): -0.018 -0.011 -0.005 -0.003 -0.000 +0.003 +0.006 +0.011 +0.018
```

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

- **النسخة التي تبدأ من الصفر:** القيم تتكرر بدقة كل ثانيتين: +0.101 عند 0.5 و2.5 و4.5، والصفر عند كل ثانية كاملة.
- **النسخة الأصلية:** عند 1.0 ثانية القيمة +0.010 لا صفر، فهي متأخرة إطاراً واحداً منذ البداية، وعند 3.0 ثوان +0.021، أي أنها تأخرت إطاراً آخر في الدورة الثانية، وهكذا كل دورة. وحول نهاية الدورة الأولى تتحرك ببطء أكثر، فالخطوات 0.002 لكل إطار بدل 0.003.

وفي التمايل الهادئ لن يلاحظ أحد ذلك، ولكن في حركة مشي يتكرر فيها الإطار الزائد عند كل خطوتين، يبدو كتوقف قصير متكرر، وفي حركة تريد أن تتزامن مع الموسيقى يتراكم التأخير. والإصلاح بأحد أمرين: أن تبدأ الحركات في Blender من الإطار 0، أو أن تفعل خيار `export_anim_slide_to_zero`، وفي النافذة اسمه Set all glTF Animation starting at 0.

والشكل التالي يجمع إطارين حقيقيين من الحركة في Godot، عند أقصى الميل إلى الأمام وإلى الخلف، مع منحنى أعلى الجذع في النسخ الثلاث:

![في الأعلى إطاران حقيقيان من Godot للنخلة من الجانب: عند 0.5 ثانية تميل إلى اليسار، وعند 1.5 ثانية تميل إلى اليمين. وفي الأسفل رسم خطي لموضع أعلى الجذع بالمتر من 0 إلى 4.5 ثانية لثلاث نسخ. الخط الرمادي palm.glb يتمايل دورة واحدة ثم يبقى عند الصفر بعد ثانيتين. الخط البرتقالي sway-loop يستمر ولكنه يتأخر إطاراً في كل دورة. الخط الأخضر بعد slide to zero يتكرر بدقة كل ثانيتين](https://arabroot.io/content/images/2026/11/blender-to-game-05-sway.webp)

التمايل في Godot: دورة واحدة ثم توقف، ثم يدور متأخراً إطاراً في كل دورة، ثم يدور بدقة

## الضغط Draco: ملف أصغر لا يفتح

في نافذة التصدير خيار Compression يضغط المجسمات بطريقة Draco من Google، وفي مخرج Blender رأيت أن الجذع ضغط من 24,112 بايت إلى 4,388، أي بنسبة 5.5، وأن الملف كله أصبح 25,180 بايت بدل 53,200\. ويبدو هذا مكسباً واضحاً، إلى أن تستورده في Godot 4.7.2:

```text
ERROR: glTF: Can't import file 'palm-draco', required extension 'KHR_draco_mesh_compression' is not supported. Are you missing a GLTFDocumentExtension plugin?
ERROR: Error importing 'res://models/palm-draco.glb'.
```

والرسالة واضحة: Draco امتداد Extension لصيغة glTF، والملف يعلن أنه يحتاجه، وGodot لا يدعمه في نسخته الرسمية، فرفض الملف كله، والتجربة `inspect` لم تجد ما تحمله. والضغط Draco مفيد على الويب حيث يحمل المتصفح النموذج في كل زيارة، أما في محرك يستورد النموذج مرة واحدة ثم يضغطه بطريقته، كما رأينا في المشهد المستورد بحجم 16 كيلوبايت، فلا فائدة منه. وتذكر أن الحجم الذي يهمك في اللعبة هو حجم ما في `.godot/imported` بعد التصدير، لا حجم الملف في مجلد العمل.

## وماذا عن استيراد ملف .blend مباشرة؟

يستطيع Godot أن يستورد ملف `.blend` مباشرة، فتحفظ في Blender وتعود إلى المحرر فتجد التغيير، دون خطوة تصدير. ويشرح التوثيق أن ذلك يعمل بأن يشغل المحرر برنامج Blender في الخلفية ليصدر glTF نيابة عنك، أي أن كل ما في هذا المقال يبقى صحيحاً، والفرق أن الإعدادات تكون في نافذة الاستيراد في Godot بدل نافذة التصدير في Blender. ويحتاج ذلك Blender 3.0 أو أحدث، والتوثيق ينصح بنسخة 3.5 أو أحدث، وبالنسخة الرسمية من blender.org لا حزم التوزيعات ولا Flatpak، ومسار البرنامج في إعدادات المحرر. والسلبية الأهم أن كل من يفتح المشروع، ومنه خادم البناء Build Server الذي يصدر اللعبة، يحتاج Blender مثبتاً بالنسخة نفسها تقريباً. ولذلك تستخدمه أغلب الفرق الصغيرة في أثناء التطوير، وتحفظ ملفات glTF في المشروع عندما يستقر النموذج.

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

المختبر في مجلد `lab`، وفيه صورتان: الأولى في `blender/Dockerfile`، تنزل Blender 5.3.0 الرسمي من [صفحة إصدارات Blender](https://download.blender.org/release/Blender5.3/?ref=arabroot.io) وتتحقق منه ببصمة SHA256 المنشورة بجانبه، والثانية في `Dockerfile`، وهي صورة Godot 4.7.2 نفسها التي استخدمناها في مقال الأساسيات، مع Mesa التي ترسم بالمعالج. والملف `run.sh` يمر بالخطوات بالترتيب، وأولها تشغيل Blender دون واجهة:

```bash
echo "### 1. Blender: build the palm, skin it, animate it, export glTF 2.0 variants"
MSYS_NO_PATHCONV=1 docker run --rm --name $N-blender -v "$W/blender:/src" -v "$W/models:/out" "$BLENDER" \
  blender -b --factory-startup --python /src/make_palm.py -- /out 2>&1 \
  | grep -vE '^\s*$|Read prefs|INFO: (Start|Extract|Prim|Finish)|Deprecation|use_nodes|invalid weight' | tee out-01-blender.txt
rm -f models/palm.blend1      # Blender keeps the previous save as .blend1
cp models/*.glb models/palm.gltf models/palm.bin models/bark.png game/models/
```

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

- **مجلدان مشتركان:** السكربتات في `blender` للقراءة، والنتائج تكتب في `models`، فتبقى على جهازك بعد أن يحذف الـ Container نفسه.
- **الفلتر:** يحذف سطور التقدم المتكررة من المصدر، وتحذيراً من Blender عن خاصية `use_nodes` في الخامات أنها سوف تحذف في Blender 6.0، والسطور الخمسة والأربعين عن الأوزان التي عالجناها.
- **الملف `palm.blend1`:** عندما يحفظ Blender فوق ملف موجود يبقي النسخة السابقة بهذا الامتداد، ولا نحتاجها.
- **النسخ إلى `game/models`:** نسخ الملفات المصدرة فقط إلى مشروع Godot، لا ملف `.blend`، لأن Godot سيحاول استيراده ويحتاج Blender لذلك.

وبقية الخطوات تستورد المشروع، ثم تشغل التجارب `inspect` و`anim` و`frames`، ثم تعدل ملفي `.import` بالأمر `sed` وتعيد الاستيراد، وهو ما يحدث عندما تغير الإعداد في لوحة Import في المحرر وتضغط Reimport. وتشغله كله بالأمر `bash run.sh` من مجلد `lab`، وأول تشغيل ينزل Blender بحجم 407 ميجابايت، وبعدها تأخذ الخطوات كلها بضع دقائق. وفي بداية الملف يحذف `run.sh` المجلدين `game/.godot` و`game/models` حتى يبدأ كل تشغيل باستيراد نظيف، لأن إعدادات الإصلاح التي كتبها التشغيل السابق في ملفات `.import` ستغير النتائج إذا بقيت.

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

- **النموذج نائم على جنبه:** صدر دون `+Y Up`، أو من برنامج يجعل Z الأعلى دون تحويل. أعد التصدير بالخيار، ولا تدره في Godot.
- **النموذج أكبر بمئة مرة أو أصغر بمئة مرة:** عمل صاحبه بالسنتيمتر، أو صغره بمقياس لم يطبقه. طبق المقياس في Blender بـ Ctrl+A ثم Scale، أو استخدم Root Scale في الاستيراد إذا لم تملك الملف الأصلي.
- **اللاعب يمر من خلال نموذج يبدو صحيحاً:** تحويل غير مطبق على الهيكل العظمي، فشكل التصادم المبني من المجسم أصغر أو في مكان آخر. افحص حجم الشكل بالأرقام لا بالعين.
- **النموذج بعيد عن المكان الذي وضعته فيه ويدور حول نقطة بعيدة:** ترك صاحبه الكائن بعيداً عن مركز المشهد في Blender. انقله إلى المركز أو طبق الموضع.
- **الحركة تعمل مرة ثم تتوقف:** لم يفعل أحد الدوران. اللاحقة `-loop` في اسمها، أو Loop Mode في إعدادات الاستيراد.
- **الحركة تدور بتوقف قصير في كل دورة:** تبدأ من الإطار 1 في Blender فطولها أكبر بإطار. ابدأها من 0 أو فعل Set all glTF Animation starting at 0.
- **الكود لا يجد الحركة:** اسمها في Godot ليس ما تظن، مثل `PalmRigAction_001`. سمها في Blender، واطبع `get_animation_list()` إذا شككت.
- **Godot يرفض الملف ويذكر `KHR_draco_mesh_compression`:** صدر بالضغط Draco. أعد التصدير دونه.
- **المصدر يقول `Mesh ... is not valid`:** افحص المجسم بـ `validate` أو بأدوات Clean Up في Blender، وفي حالتنا كانت أوزاناً أكبر من 1 بعد الأوزان التلقائية.
- **كل الخامات مرسومة من الوجهين:** Backface Culling معطل في خامات Blender افتراضياً. فعله لكل جسم مغلق قبل التصدير.

## قائمة فحص قبل كل تصدير

| في Blender                               | كيف تتحقق                                    | إذا نسيتها                                         |
| ---------------------------------------- | -------------------------------------------- | -------------------------------------------------- |
| الوحدات Metric بمقياس 1، والنموذج بالمتر | إنسان طوله حوالي 1.8 في لوحة Dimensions      | نموذج بطول 404 أمتار                               |
| المقياس والدوران مطبقان                  | Scale (1, 1, 1) وRotation (0, 0, 0) لكل كائن | شكل تصادم وصندوق محيط بأحجام خاطئة                 |
| النموذج عند مركز المشهد وأسفله على الأرض | Location (0, 0, 0) ونقطة الأصل عند القاعدة   | يظهر بعيداً عن مكانه ويدور حول نقطة أخرى           |
| الأمام في اتجاه ⁦-Y⁩ للشخصيات            | الشخصية تنظر نحوك في المنظر الأمامي Front    | تمشي في اللعبة إلى الخلف                           |
| الأوزان سليمة                            | لا تحذير «is not valid» من المصدر            | رؤوس تتحرك بشكل غريب أو تحذير لا تفهمه             |
| Backface Culling للأجسام المغلقة         | الخيار في لوحة الخامة                        | رسم وجوه لا يراها أحد                              |
| الحركات بأسماء واضحة وتبدأ من 0          | قائمة Actions، وأول مفتاح عند الإطار 0       | أسماء مثل PalmRigAction\_001 وإطار زائد في كل دورة |
| الحركات التي تدور تنتهي حيث بدأت         | أول مفتاح وآخر مفتاح متطابقان                | انتقال مفاجئ في وضع النموذج عند كل دورة            |
| التصدير glTF Binary دون Draco            | امتداد الملف .glb وخيار Compression معطل     | ملف لا يستورده Godot                               |

## تطبيق عملي

1. أضف إلى `make_palm.py` حركة ثالثة باسم `idle-loop` تبدأ من الإطار 0، وصدر، ثم تحقق في مخرج `inspect` أن طولها بالضبط ما توقعت وأنها تدور.
2. أضف إلى النخلة مجسماً منفصلاً للجذع باسم `Trunk-col`، وصدر، وانظر في شجرة العقد في Godot ماذا أصبح بسبب اللاحقة `-col`.
3. صدر النخلة الصحيحة مع `export_yup=False` ثم أصلحها بتدوير العقدة في Godot 90 درجة، وابن منها شكل تصادم بالتجربة نفسها، وقارن حجمه بالنخلة الصحيحة.
4. افتح `palm.gltf` في محرر نصوص، وابحث عن `"animations"`، واقرأ أول زمن وآخر زمن في حركة sway، وطابقهما مع 2.033 ثانية.

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

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

## الخلاصة Summary

- glTF 2.0 هي الصيغة الموصى بها من Blender إلى Godot، والملف `.glb` أصغر من النسخة المنفصلة، وكلاهما أعطى المشهد المستورد نفسه بحجم 16 كيلوبايت.
- المشاكل تحدث في ثلاث محطات: الملف في Blender، وإعدادات التصدير، وإعدادات الاستيراد في ملف `.import`.
- الأوزان التلقائية تركت 45 وزناً أكبر من 1 بفرق صغير، فحذر المصدر من أن المجسم غير سليم، و`validate()` أصلحها.
- تصدير دون `+Y Up` أنام النخلة، وموضع غير مطبق أبعدها ثلاثة أمتار، ونموذج بالسنتيمتر وصل بطول 404 أمتار.
- المقياس غير المطبق على الهيكل رسم النخلة صحيحة، ولكن شكل التصادم الذي بني منها كان 4 سنتيمترات، والتطبيق بـ Ctrl+A أعاد كل الأرقام صحيحة.
- Root Scale بقيمة 0.01 أصلح النخلة المصممة بالسنتيمتر من إعدادات الاستيراد دون Blender.
- الحركات تصل دون دوران، واللاحقة `-loop` أو Loop Mode في الاستيراد تدورها، والحركة التي تبدأ من الإطار 1 تتأخر إطاراً في كل دورة حتى تفعل Set all glTF Animation starting at 0.
- الضغط Draco صغر الملف إلى أقل من النصف، وGodot 4.7.2 رفضه كله.

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

[![](https://arabroot.io/content/images/2026/11/game-3d-basics-cover-cover.webp)دليلأساسيات 3D في الألعاب: المجسمات Meshes والخامات والإضاءةنبني فناءً صغيراً ثلاثي الأبعاد بالكود في Godot 4 ونرسمه إطاراً حقيقياً، ثم نقرأ من المحرك نفسه ما يكلفه كل مجسم وخامة وضوء وظل، ونصنع أخطاء العموديات وUV والعمق التي يقع فيها كل مبتدئ.](https://arabroot.io/articles/%D8%A7%D8%B3%D8%A7%D8%B3%D9%8A%D8%A7%D8%AA-3d-%D9%81%D9%8A-%D8%A7%D9%84%D8%A7%D9%84%D8%B9%D8%A7%D8%A8-%D8%A7%D9%84%D9%85%D8%AC%D8%B3%D9%85%D8%A7%D8%AA-meshes-%D9%88%D8%A7%D9%84%D8%AE%D8%A7%D9%85%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%A7%D8%B6%D8%A7%D8%A1%D8%A9/)[![](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/)

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

- 18 نوفمبر 2026: كتابة المقال، وبناء النخلة وتصديرها بـ Blender 5.3.0 (مصدر glTF 5.3.43) دون واجهة في Docker، واستيرادها وفحصها ورسمها في Godot 4.7.2.