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

النخلة: نموذج أصلي من سكربت Python
أغلب الدروس تبدأ بنموذج جاهز يحمله القارئ من موقع ما، ونحن نريد أن نعرف كل رقم في النموذج ومن أين جاء، وألا يبقى في المقال ملف لا نملك رخصته، فبنينا النخلة كلها بسكربت make_palm.py يعمل داخل Blender. وواجهة Python في Blender اسمها bpy، وكل زر في الواجهة الرسومية له أمر مقابل فيها، فالسكربت يفعل ما كنت ستفعله بيدك، بالترتيب نفسه. والتشغيل من سطر الأوامر كما يلي:
blender -b --factory-startup --python make_palm.py -- /outوالخيار -b يشغل Blender في الخلفية Background دون أي نافذة، كما يشرح توثيق خيارات سطر الأوامر في Blender، و--factory-startup يتجاهل إعداداتك الشخصية حتى تكون النتيجة نفسها على كل جهاز، وما بعد -- يذهب إلى السكربت نفسه. والسكربت يصنع النخلة على أربع خطوات:
- المجسم: جذع من عشرة أضلاع واثنتي عشرة حلقة بطول أربعة أمتار، يضيق قليلاً في أعلاه وينحني، وفوقه سبع سعفات، كل سعفة شريط من ستة أجزاء يمتد مترا ونصفاً ثم يتدلى. والسكربت يبني ذلك بمكتبة
bmeshرأساً رأساً، كما بنينا الخيمة بالأداة SurfaceTool في مقال الأساسيات، ويكتب إحداثيات UV لكل وجه. - الخامات: خامتان، الجذع وعليه صورة لحاء بحجم 256 في 256 يرسمها السكربت بكسلاً بكسلاً، والسعف بلون أخضر.
- الهيكل العظمي Armature: أربع عظام Bones متصلة على طول الجذع، اسمها Root وTrunk1 وTrunk2 وCrown، ثم ربط المجسم بالعظام بالأوزان التلقائية.
- الحركات: حركتان، التمايل sway في ثانيتين يعود في آخرها إلى وضع البداية، والهبة gust في ثانية ونصف تنحني فيها النخلة بقوة ثم تعود.
وأهم جزء في السكربت هو ربط المجسم بالعظام، وهذا هو كما في الملف:
# 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، ويحسب الأوزان بطريقة تسمى حرارة العظام Bone Heat: كأن كل عظمة مصدر حرارة، وكل رأس يأخذ من كل عظمة بقدر ما يصله من حرارتها.
والسطران الأخيران لم يكونا في النسخة الأولى من السكربت، وإنما أضفناهما بعد مشكلة حقيقية: في أول تصدير طبع مصدر glTF تحذيراً لكل ملف يقول «Mesh Palm is not valid, and may be exported wrongly». وعندما طلبنا من Blender أن يفحص المجسم بالدالة validate(verbose=True) طبع 45 سطراً من هذا النوع:
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 التي تحمل السعف. وهذا خطأ تقريب في الأعداد العشرية، من النوع الذي شرحناه في مقال الأعداد العشرية، ولا يغير شكل النخلة، ولكن المصدر يفحص المجسم قبل التصدير ويحذرك، لأن الوزن الأكبر من 1 غير مسموح في glTF. والإصلاح أن تستدعي validate() بنفسك بعد الربط، فتقص الأوزان إلى 1، وفي الواجهة الرسومية يقابلها الأمر Normalize All من قائمة Weights في وضع رسم الأوزان. والقاعدة: لا تتجاهل تحذيرات المصدر لأن الملف خرج في النهاية، فهي أول مكان تظهر فيه المشكلة قبل أن تصل إلى اللعبة.
والمخرج الكامل لأول نسخة من النخلة كان كما يلي:
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 في المختبر يرسمها بالأمر نفسه دون واجهة:

التصدير بصيغة glTF 2.0: الإعدادات التي تهمك
مصدر glTF يأتي مع Blender نفسه، ويشرح خياراته توثيق glTF 2.0 في Blender، ونافذته في الواجهة من File ثم Export ثم glTF 2.0، وفيها عشرات الخيارات. والسكربت يستدعيه بالأمر bpy.ops.export_scene.gltf، وكل خيار في النافذة له اسم في هذا الأمر. وهذه الدالة التي تصدر كل نسخ النخلة:
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:
[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:
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 في مجلد الاستيراد فهو كما يلي:
--- .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 تحمل كل نسخة من النخلة كما يحملها أي مشهد في اللعبة، ثم تطبع شجرة العقد، والصندوق المحيط بكل المجسمات في إحداثيات العالم، والهيكل العظمي، والخامات، والحركات. وهذا مخرجها للنسخة الصحيحة:
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، ينقل التحويل إلى البيانات نفسها ويعيد التحويل إلى قيمه المحايدة: الموضع 0 والدوران 0 والمقياس 1. ويوصي توثيق اعتبارات تصدير النماذج بتطبيق التحويلات قبل التصدير. والسؤال الذي يطرحه الجميع: لماذا، ما دام النموذج يبدو صحيحاً؟ والإجابة في التجارب الثلاث التالية.
صدر السكربت النخلة بخمس نسخ أخرى غير الصحيحة، وكل نسخة فيها قرار واحد خاطئ، وهذه أسطر Blender لها:
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 بعد الاستيراد:
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 متر بحجم إنسان:

المحاور 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 أمتار. والصورة التالية تبينها بجانب النخلة الصحيحة والكبسولة، ثم بعد الإصلاح من إعدادات الاستيراد:

وأول ما يفكر فيه أغلب الناس أن يصغروا الكائن في Blender بمقياس 0.01 حتى يبدو بالحجم الصحيح، وهذه النسخة palm-cm-scaled.glb، وهي في الصف السابق النخلة الرابعة، وتبدو صحيحة تماماً. ولكن الصندوق المحيط الذي قاسه Godot لها 0.03 في 0.04 في 0.03 متر، أي أربعة سنتيمترات، لأن المقياس حسب مرتين كما حدث مع الإزاحة. ولنعرف هل هذا يؤثر في اللعبة، طلبنا من Godot أن يبني شكل تصادم Collision Shape من المجسم بالدالة create_convex_collision()، وهي ما يفعله الأمر Mesh ثم Create Collision Shape في المحرر، والمخرج كان كما يلي:
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 ثم أعدنا الاستيراد:
/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، فلا يتكرر الخطأ الذي رأيناه. ويحذر التوثيق مع ذلك من أن تغيير المقياس بعد الاستيراد قد يسبب في حالات نادرة مشاكل في دقة الأعداد العشرية في الرسم أو الفيزياء، ولذلك الحل الأفضل يبقى أن يعمل صاحب النموذج بالمتر من البداية.
inspect، فتستطيع أن تضيف إليها ملفك.الحركات Animations: الأسماء والطول والدوران
الحركة في Blender اسمها Action: مجموعة منحنيات Curves، كل منحنى يغير خاصية واحدة لعظمة واحدة مع الزمن، مثل دوران Trunk1 حول المحور X. والمصدر بالوضع ACTIONS يصدر كل Action تصلح للهيكل كحركة مستقلة في glTF، والمستورد في Godot يضعها كلها في عقدة AnimationPlayer. ولكل حركة في السكربت مفاتيح Keyframes بالإطار والزاوية:
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، وهذا ما وصل:
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 بالمتر كل نصف ثانية:
--- 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 ثانية. وهناك ثلاث طرق لجعلها تدور:
- من الاسم في Blender: يذكر توثيق لواحق الأسماء في الاستيراد أن الحركة التي يبدأ اسمها أو ينتهي بالكلمة loop أو cycle تستورد وهي تدور. وسمينا الحركة في النسخة
palm-loop.glbباسمsway-loop، فوصلت باسمswayوقيمةloop_mode 1، أي أن المستورد حذف اللاحقة وفعل الدوران. والتوثيق يذكر أن ذلك يحتاج في Blender إلى محرر NLA، ولكن في تجربتنا بالوضع ACTIONS الافتراضي كفى الاسم وحده مع Blender 5.3 وGodot 4.7.2. - من إعدادات الاستيراد: في المحرر تفتح نافذة Advanced Import Settings للملف، وتختار الحركة، وتجعل Loop Mode على Linear. وهذا يكتب في
_subresourcesفي ملف.import، وفعلنا ذلك للنسخة الأصليةpalm.glbفأصبحتloop_mode 1دون أن نغير شيئاً في Blender. وميزة هذه الطريقة أن الإعداد يبقى بعد كل تصدير جديد، لأن ملف.importمنفصل عن النموذج. - من الكود:
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 بالضبط، وهذا مخرج النسختين جنباً إلى جنب:
--- 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، عند أقصى الميل إلى الأمام وإلى الخلف، مع منحنى أعلى الجذع في النسخ الثلاث:

الضغط Draco: ملف أصغر لا يفتح
في نافذة التصدير خيار Compression يضغط المجسمات بطريقة Draco من Google، وفي مخرج Blender رأيت أن الجذع ضغط من 24,112 بايت إلى 4,388، أي بنسبة 5.5، وأن الملف كله أصبح 25,180 بايت بدل 53,200. ويبدو هذا مكسباً واضحاً، إلى أن تستورده في Godot 4.7.2:
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 وتتحقق منه ببصمة SHA256 المنشورة بجانبه، والثانية في Dockerfile، وهي صورة Godot 4.7.2 نفسها التي استخدمناها في مقال الأساسيات، مع Mesa التي ترسم بالمعالج. والملف run.sh يمر بالخطوات بالترتيب، وأولها تشغيل Blender دون واجهة:
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 |
تطبيق عملي
- أضف إلى
make_palm.pyحركة ثالثة باسمidle-loopتبدأ من الإطار 0، وصدر، ثم تحقق في مخرجinspectأن طولها بالضبط ما توقعت وأنها تدور. - أضف إلى النخلة مجسماً منفصلاً للجذع باسم
Trunk-col، وصدر، وانظر في شجرة العقد في Godot ماذا أصبح بسبب اللاحقة-col. - صدر النخلة الصحيحة مع
export_yup=Falseثم أصلحها بتدوير العقدة في Godot 90 درجة، وابن منها شكل تصادم بالتجربة نفسها، وقارن حجمه بالنخلة الصحيحة. - افتح
palm.gltfفي محرر نصوص، وابحث عن"animations"، واقرأ أول زمن وآخر زمن في حركة sway، وطابقهما مع 2.033 ثانية.
حذف المختبر Cleanup
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 رفضه كله.
وبهذا تعرف ما يحدث لنموذجك في كل محطة، وفي المقال التالي من هذه المرحلة بإذن الله نضع آلافاً من هذه النخيل في بستان واحد، ونقيس كم يكلف كل منها، ونصلح المشهد حتى يعطي عدد الإطارات الذي نريده:
دليلأساسيات 3D في الألعاب: المجسمات Meshes والخامات والإضاءةنبني فناءً صغيراً ثلاثي الأبعاد بالكود في Godot 4 ونرسمه إطاراً حقيقياً، ثم نقرأ من المحرك نفسه ما يكلفه كل مجسم وخامة وضوء وظل، ونصنع أخطاء العموديات وUV والعمق التي يقع فيها كل مبتدئ.
دليلأداء اللعبة: قياس الإطارات Profiling وتحسينهانبني في Godot 4 بستاناً من 2,500 نخلة بطيئاً عن قصد، ثم نقيسه بأدوات المحرك ونصلحه في ست خطوات، ونعرف بالأرقام كم وفرت كل خطوة ومن أين، وما الثمن الذي دفعناه في رقم آخر.
دليلرياضيات الألعاب: المتجهات Vectors والحركة والتصادمالمتجهات والحركة وحاصل الضرب النقطي واختبارات التصادم والارتداد والنفق، بلعبة صغيرة ومختبر Python يصنع الأخطاء الشائعة ثم يصلحها.
دليلأول لعبة مع Godot: المشاهد والعقد وGDScriptنبني لعبة صغيرة كاملة في Godot 4 من ثلاثة مشاهد وأربعة سكربتات، ونفهم بها العقد والمشاهد والإشارات وحلقة اللعبة، ثم نشغلها في مختبر يلعبها فيه روبوت حتى تنتهي.سجل التحديثات Changelog
- 18 نوفمبر 2026: كتابة المقال، وبناء النخلة وتصديرها بـ Blender 5.3.0 (مصدر glTF 5.3.43) دون واجهة في Docker، واستيرادها وفحصها ورسمها في Godot 4.7.2.