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

# تصدير اللعبة من Godot إلى الويب والجوال وسطح المكتب
- URL: https://arabroot.io/articles/تصدير-اللعبة-من-godot-الى-الويب-والجوال-وسطح-المكتب/
- Published: 2026-11-12T19:02:43.000Z
- Updated: 2026-11-12T22:20:59.000Z
- Description: ماذا يحدث فعلاً عند تصدير لعبة Godot، ولماذا تحتاج نسخة الويب Headers خاصة أحياناً، وما تطلبه كل منصة ومتجر، مع مختبر يصدر لعبة واحدة إلى خمس منصات.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, تطوير الألعاب

تنتهي من لعبتك الصغيرة على جهازك، تضغط زر التشغيل في المحرر فتعمل كما تريد، ثم يطلب صديق يستخدم Windows أن يجربها، ويسأل قريب عن رابط يفتحه من جواله، ويقترح عليك زميل أن ترفعها على Steam أو itch.io. وهنا تكتشف أن اللعبة التي تعمل في محرر Godot على جهازك ليست بعد شيئاً تستطيع أن ترسله لأحد، فاللاعب لا يملك المحرر، ولا يعرف ما هو ملف `project.godot`، ولن يفتح مجلداً فيه الكود والمشاهد ليشغله. والخطوة التي تحول المشروع إلى برنامج يعمل عند اللاعب اسمها التصدير Export، وهي في الغالب آخر ما يتعلمه المطور وأول ما يتعثر فيه عندما يقترب موعد النشر.

وفي [مقال محركات الألعاب](https://arabroot.io/articles/%D9%85%D8%AD%D8%B1%D9%83%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D9%84%D8%B9%D8%A7%D8%A8-godot-%D9%88unity-%D9%88unreal-%D9%88%D8%AA%D8%B1%D8%A7%D8%AE%D9%8A%D8%B5%D9%87%D8%A7/) ذكرنا أن التصدير إلى المنصات جزء من الأجزاء الستة التي يعطيك إياها المحرك، وفي هذا المقال سوف نفتح هذا الجزء من الداخل: ماذا يحدث فعلاً عند التصدير، ولماذا تحتاج ملفاً حجمه 1.2 جيجابايت لتصدر لعبة حجمها أقل من 120 كيلوبايت، ثم نصدر لعبة صغيرة كتبناها لهذا المقال إلى خمس منصات من سطر الأوامر، ونشغلها على Linux وWindows وفي المتصفح، ونرى بأعيننا الأخطاء التي سوف تقابلك.

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

- ما الذي يحدث عند التصدير، ولماذا لا ترسل المشروع كما هو.
- قوالب التصدير Export Templates وإعدادات التصدير Export Presets.
- مختبر: لعبة واحدة تصدر إلى الويب وLinux وWindows وmacOS داخل Docker.
- تشغيل النسخ المصدرة دون Godot، والفرق الذي يظهر في الخط العربي.
- التصدير إلى الويب: WebAssembly، وحجم التحميل، والضغط على السيرفر.
- لماذا تحتاج بعض نسخ الويب Headers خاصة، وما علاقة ذلك بثغرة Spectre.
- سطح المكتب: التوقيع Code Signing على Windows والتوثيق Notarization على macOS.
- الجوال: ما تحتاجه لتصدر إلى Android وiOS.
- النشر في المتاجر: Steam وitch.io وGoogle Play وApp Store.

## ماذا يحدث عند التصدير؟

أبسط طريقة لتوزيع لعبة على الكمبيوتر هي أن تضع برنامج Godot نفسه في مجلد المشروع بجانب `project.godot`، ثم تضغط المجلد كله وترسله، وهذه الطريقة تعمل فعلاً كما تذكر [صفحة التصدير في توثيق Godot](https://docs.godotengine.org/en/stable/tutorials/export/exporting%5Fprojects.html?ref=arabroot.io). ولكن لها مشاكل واضحة: فاللاعب يستلم المحرر كاملاً بأدواته وواجهته، ويستلم كل ملفات مشروعك مكشوفة كما كتبتها، والمحرر نفسه أكبر وأبطأ من نسخة مبنية للتشغيل فقط، ولا يوجد شيء من هذا يصلح للجوال أو للمتصفح أصلاً.

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

والصورة التالية تبين ما حدث للعبتنا في المختبر عند تصديرها إلى أربع منصات:

![رسم يبين مجلد المشروع فيه project.godot وmain.tscn وmain.gd والخطوط، يدخل إلى خطوة التصدير بالأمر godot --headless --export-release، فتخرج حزمة اللعبة pck بحجم 118 KB، وتوزع على أربع منصات: Windows بملف date-basket.exe حجمه 104.1 MB، وLinux بملف date-basket.x86_64 حجمه 70.2 MB، والويب بملف index.wasm حجمه 37.7 MB مع index.js وindex.html، وmacOS بملف zip فيه تطبيق .app بصيغة Universal](https://arabroot.io/content/images/2026/11/game-export-web-01-export.webp)

التصدير يضع حزمة لعبتك الصغيرة بجانب نسخة جاهزة من المحرك لكل منصة، والأحجام من مخرج المختبر.

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

- **حزمة اللعبة واحدة:** ملف PCK حجمه 118.5 كيلوبايت في كل المنصات، لأن لعبتنا صغيرة: كود GDScript ومشهد واحد وخط عربي.
- **الحجم الحقيقي هو المحرك:** ملف Windows وحده 104.1 ميجابايت، وهو تقريباً حجم القالب نفسه، ولو صدرت لعبة أخرى لكان بالحجم نفسه.
- **الأمر واحد لكل المنصات:** لا تحتاج أن تكون على Windows لتصدر له، فكل ما في المختبر صدر من Container يعمل على Linux.

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

## قوالب التصدير Export Templates

قوالب التصدير ملفات تنزلها مرة واحدة لكل إصدار من Godot، ويجب أن يطابق إصدارها إصدار المحرر الذي تصدر منه حرفاً بحرف، فالمحرر 4.7.2 يبحث عنها في مجلد اسمه `4.7.2.stable` ولا يقبل غيره. وتنزلها من المحرر من قائمة Editor ثم Manage Export Templates، وفي الإصدارات الحديثة يمكنك أن تختار المنصات التي تحتاجها فقط، أو تنزل ملفاً واحداً بامتداد `.tpz` فيه كل القوالب لكل المنصات من [صفحة إصدار Godot 4.7.2 على GitHub](https://github.com/godotengine/godot/releases/tag/4.7.2-stable?ref=arabroot.io).

وفي المختبر نزلنا الملف الكامل، وحجمه 1,281,349,702 بايت أي حوالي 1.2 جيجابايت، وتحققنا منه بقيمة SHA512 المنشورة في صفحة الإصدار، ثم أخرجنا منه القوالب التي نحتاجها فقط، والمخرج سوف يكون كما يلي:

```text
### templates used (from the 1.2 GB file)
4.7.2.stable
      70.1 MB  linux_release.x86_64
     117.9 MB  macos.zip
       0.0 MB  version.txt
       9.8 MB  web_nothreads_release.zip
       9.8 MB  web_release.zip
     104.2 MB  windows_release_x86_64.exe
       0.2 MB  windows_release_x86_64_console.exe
```

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

- **اسم المجلد:** السطر الثاني هو محتوى `version.txt`، وهو الاسم الذي يبحث عنه المحرر بالضبط.
- **قالبان للويب:** `web_release.zip` للنسخة التي تستخدم خيوط التنفيذ Threads، و`web_nothreads_release.zip` للنسخة التي لا تستخدمها، وسوف نرى الفرق بينهما بالتفصيل.
- **قالب macOS أكبر من غيره:** 117.9 ميجابايت مضغوطاً، لأنه يحمل المحرك لمعالجات Intel وApple Silicon معاً.
- **قالب الكونسول Console:** ملف صغير حجمه 0.2 ميجابايت يشغل اللعبة ويعرض مخرجها في نافذة الأوامر، وسوف نستعمله لقراءة مخرج اللعبة على Windows.

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

💡

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

## إعدادات التصدير Export Presets

إعداد التصدير Preset هو مجموعة خيارات محفوظة لمنصة واحدة: اسم المنصة، ومكان الملف الناتج، والخيارات الخاصة بها مثل المعمارية Architecture والتوقيع وشكل صفحة الويب. وتنشئها من نافذة Project ثم Export في المحرر، فيحفظها Godot في ملف `export_presets.cfg` بجانب `project.godot`. والميزة المهمة هنا أن الملف نص عادي تستطيع أن تحفظه في Git وتستعمله في خط بناء آلي Pipeline يصدر اللعبة دون أن يفتح أحد المحرر، وهذا ما فعلناه في المختبر. وهذا ملف إعدادات المختبر كاملاً:

```ini
[preset.0]

name="Web (threads)"
platform="Web"
runnable=false
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/web-threads/index.html"

[preset.0.options]

variant/thread_support=true
html/head_include="<script>window.__lab=[];[\"log\",\"warn\",\"error\"].forEach(function(k){var o=console[k];console[k]=function(){window.__lab.push(k+\": \"+Array.prototype.join.call(arguments,\" \"));o.apply(console,arguments);};});</script>"

[preset.1]

name="Web (no threads)"
platform="Web"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/web-nothreads/index.html"

[preset.1.options]

variant/thread_support=false
html/head_include="<script>window.__lab=[];[\"log\",\"warn\",\"error\"].forEach(function(k){var o=console[k];console[k]=function(){window.__lab.push(k+\": \"+Array.prototype.join.call(arguments,\" \"));o.apply(console,arguments);};});</script>"

[preset.2]

name="Linux"
platform="Linux"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/linux/date-basket.x86_64"

[preset.2.options]

binary_format/architecture="x86_64"
binary_format/embed_pck=false

[preset.3]

name="Windows"
platform="Windows Desktop"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/windows/date-basket.exe"

[preset.3.options]

binary_format/architecture="x86_64"
binary_format/embed_pck=false
debug/export_console_wrapper=2

[preset.4]

name="macOS"
platform="macOS"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/macos/date-basket.zip"

[preset.4.options]

application/bundle_identifier="io.arabroot.datebasket"
```

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

- **إعدادان للويب:** الأول بالخيار `variant/thread_support=true` والثاني دونه، والقيمة الافتراضية في Godot 4.7 هي دون Threads.
- **الخيار `html/head_include`:** سطر JavaScript يضيفه Godot إلى صفحة الويب، وقد وضعناه لنجمع رسائل اللعبة من المتصفح ونطبعها في المختبر، ولا تحتاجه في لعبتك.
- **الخيار `binary_format/embed_pck=false`:** يجعل حزمة اللعبة ملفاً منفصلاً بجانب البرنامج، وإذا جعلته `true` دخلت الحزمة داخل الملف التنفيذي فيصبح ملفاً واحداً.
- **الخيار `debug/export_console_wrapper=2`:** يطلب ملف الكونسول دائماً حتى في نسخة Release، والقيمة الافتراضية تصدره مع نسخة Debug فقط.
- **معرف الحزمة `application/bundle_identifier`:** إلزامي لنسخة macOS، وهو اسم فريد بصيغة النطاق المعكوس.

وهل هذا الملف آمن لتضعه في Git؟ نعم، لأن Godot يفصل الخيارات السرية مثل كلمات مرور التوقيع ومفاتيح التشفير في ملف آخر هو `.godot/export_credentials.cfg`، وهذا الملف لا تضعه في Git ولا ترسله لأحد، والسبب أن فيه ما يثبت هويتك كناشر أمام المتاجر وأنظمة التشغيل.

## التصدير من سطر الأوامر

قد تصدر لعبتك في البداية من نافذة Export في المحرر بضغطة زر، وهذا مناسب لأول نسخة، ولكن عندما تصدر لأربع منصات بعد كل تعديل صغير سوف تحتاج أن يتم ذلك آلياً، في سكربت على جهازك أو في خط بناء Pipeline على سيرفر مثل GitHub Actions أو Gitea Actions. ويعطيك Godot لذلك ثلاثة أوامر يذكرها [توثيق سطر الأوامر](https://docs.godotengine.org/en/stable/tutorials/editor/command%5Fline%5Ftutorial.html?ref=arabroot.io):

- **الأمر `--export-release`:** يصدر اللعبة بقالب Release، وهو ما توزعه على اللاعبين، ويتبعه اسم الإعداد كما في `export_presets.cfg` ثم مسار الملف الناتج.
- **الأمر `--export-debug`:** نفس السابق بقالب Debug، وتستعمله لنسخة تجريبية ترسلها لمن يختبر اللعبة معك، لأن رسائل الأخطاء فيها أوضح.
- **الأمر `--export-pack`:** يصدر حزمة اللعبة فقط دون المحرك، بصيغة PCK أو ZIP بحسب امتداد الملف، وتستعمله للتحديثات والمحتوى الإضافي DLC، فاللاعب عنده المحرك أصلاً ويحتاج الحزمة الجديدة فقط.

وكل هذه الأوامر تحتاج أن تكون القوالب مثبتة على الجهاز الذي يصدر، وأن تضيف الخيار `--headless` على السيرفر حتى لا يحاول Godot فتح نافذة، كما فعلنا في المختبر. وهناك تفصيل يقع فيه الكثيرون في أول سكربت: المسار النسبي بعد اسم الإعداد يحسب من مجلد المشروع الذي فيه `project.godot`، لا من المجلد الذي شغلت منه الأمر، والمجلد الذي يوضع فيه الملف يجب أن يكون موجوداً قبل التصدير، ولذلك ينشئ سكربت المختبر مجلدات `build` أولاً ثم يمرر مسارات كاملة. وإذا كان في اسم الإعداد مسافة مثل `"Web (no threads)"` فضعه بين علامتي تنصيص، وإلا ظن Godot أن الكلمة الثانية هي مسار الملف.

## المختبر: لعبة واحدة إلى خمس منصات

لكي نرى التصدير بأعيننا كتبنا لعبة صغيرة اسمها «سلة التمر»: حبات تمر تسقط من نخلة، وسلة تتحرك وحدها لتلتقطها، ولا تحتاج اللعبة لاعباً حتى تعمل في المختبر دون شاشة. وتطبع اللعبة في البداية اسم المنصة التي تعمل عليها، ثم تطبع بعد ست ثوان عدد الإطارات Frames التي رسمتها وعدد الحبات التي التقطتها والتي سقطت على الأرض، ثم تغلق نفسها. وتكتب اللعبة على الشاشة سطرين بالعربية: الأول بالخط الافتراضي للمحرك، والثاني بخط IBM Plex Sans Arabic وضعناه داخل المشروع، وسوف نعرف سبب ذلك بعد قليل.

وهذا ملف المشروع، وفيه أن اللعبة تستخدم طريقة الرسم Compatibility لأنها الوحيدة التي تعمل في المتصفح:

```ini
; A tiny original game for the export lab: a basket catches falling dates.
config_version=5

[application]
config/name="Date Basket"
run/main_scene="res://main.tscn"
config/features=PackedStringArray("4.7", "GL Compatibility")

[display]
window/size/viewport_width=640
window/size/viewport_height=360
window/stretch/mode="canvas_items"

[rendering]
renderer/rendering_method="gl_compatibility"
renderer/rendering_method.mobile="gl_compatibility"
```

وهذا كود اللعبة كاملاً:

```gdscript
extends Node2D
# Date Basket: dates fall from the palm, the basket moves by itself to catch them (no input needed, so it runs headless too).
# Every line that starts with "LAB" is what the lab reads on each platform.

const W := 640.0
const H := 360.0
const FALL := 160.0        # px per second
const BASKET_SPEED := 220.0
const RUN_FOR := 6.0       # seconds, then report

var rng := RandomNumberGenerator.new()
var dates: Array[Vector2] = []
var basket_x := W / 2.0
var spawn_in := 0.0
var t := 0.0
var frames := 0
var caught := 0
var missed := 0
var reported := false
var score_label: Label

func _ready() -> void:
	rng.seed = 7
	Engine.max_fps = 60
	var plex: FontFile = load("res://fonts/IBMPlexSansArabic-Regular.ttf")
	_label("بالخط الافتراضي: سلة التمر", Vector2(16, 10), null)
	_label("بخط مضمن في اللعبة: سلة التمر", Vector2(16, 44), plex)
	score_label = _label("", Vector2(16, 78), plex)
	var f := ["web", "threads", "nothreads", "pc", "linux", "windows", "template", "release", "debug"]
	var on := f.filter(func(x): return OS.has_feature(x))
	print("LAB platform=%s features=%s" % [OS.get_name(), ",".join(on)])
	print("LAB renderer=%s driver=%s cpus=%d" % [RenderingServer.get_current_rendering_method(),
		RenderingServer.get_current_rendering_driver_name(), OS.get_processor_count()])

func _label(text: String, pos: Vector2, font: Font) -> Label:
	var l := Label.new()
	l.text = text
	l.position = pos
	l.add_theme_font_size_override("font_size", 22)
	l.add_theme_color_override("font_color", Color("#3b2a1a"))
	if font:
		l.add_theme_font_override("font", font)
	add_child(l)
	return l

func _process(delta: float) -> void:
	t += delta
	frames += 1
	spawn_in -= delta
	if spawn_in <= 0.0:
		dates.append(Vector2(rng.randf_range(40.0, W - 40.0), 110.0))
		spawn_in = 0.5
	# the basket walks toward the lowest date
	if not dates.is_empty():
		var target := dates[0].x
		basket_x = move_toward(basket_x, target, BASKET_SPEED * delta)
	for i in range(dates.size() - 1, -1, -1):
		dates[i].y += FALL * delta
		if dates[i].y >= H - 34.0:
			if absf(dates[i].x - basket_x) <= 40.0:
				caught += 1
			else:
				missed += 1
			dates.remove_at(i)
	score_label.text = "في السلة: %d   على الأرض: %d" % [caught, missed]
	queue_redraw()
	if t >= RUN_FOR and not reported:
		reported = true
		print("LAB after %.1f s: frames=%d caught=%d missed=%d" % [t, frames, caught, missed])
		if "--shot" in OS.get_cmdline_user_args():   # godot ... -- --shot : save what the window shows next to the program
			await RenderingServer.frame_post_draw
			get_viewport().get_texture().get_image().save_png(OS.get_executable_path().get_base_dir().path_join("shot.png"))
		if not OS.has_feature("web"):
			get_tree().quit()

func _draw() -> void:
	draw_rect(Rect2(0, 0, W, H), Color("#f3e3c3"))
	draw_rect(Rect2(0, H - 24, W, 24), Color("#c8a46e"))
	draw_rect(Rect2(W - 70, 100, 14, H - 124), Color("#7a5230"))       # palm trunk
	draw_circle(Vector2(W - 63, 100), 34, Color("#4f7a3a"))           # palm crown
	for d in dates:
		draw_circle(d, 7, Color("#6b3a1e"))
	draw_rect(Rect2(basket_x - 40, H - 40, 80, 16), Color("#a0662f"))
```

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

- **الدالة `OS.has_feature`:** تسأل عن وسوم المنصة Feature Tags مثل `web` و`windows` و`threads`، وهي الطريقة الصحيحة لكتابة كود يختلف بين المنصات، فلا تقم بفحص اسم النظام بنص ثابت، والسبب أن الوسوم تغطي حالات مثل «متصفح يعمل على Android» بوسم واحد `web_android`.
- **الحركة مضروبة في delta:** كل ما يتحرك يضرب في زمن الإطار، كما شرحنا في [مقال حلقة اللعبة](https://arabroot.io/articles/%D8%AD%D9%84%D9%82%D8%A9-%D8%A7%D9%84%D9%84%D8%B9%D8%A8%D8%A9-game-loop-%D9%88%D8%A7%D9%84%D8%A7%D8%B7%D8%A7%D8%B1%D8%A7%D8%AA-frames/)، حتى تتحرك اللعبة بالسرعة نفسها على الأجهزة المختلفة.
- **الخيار `--shot`:** إذا شغلت اللعبة مع هذا الخيار حفظت صورة لما على الشاشة بجانب البرنامج، وسوف نستعمله على Windows.

ونشغل Godot 4.7.2 داخل Docker حتى لا تحتاج تثبيت شيء على جهازك، والـ Image تنزل النسخة الرسمية من GitHub وتتحقق منها:

```dockerfile
# Godot 4.7.2 (official Linux build from GitHub) in a small image, checked against the release's SHA512 sums.
# The export templates are not in the image: run.sh downloads them once into cache/ and mounts them.
FROM debian:bookworm-slim
ARG GODOT=4.7.2-stable
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip libfontconfig1 \
 && rm -rf /var/lib/apt/lists/*
WORKDIR /opt/godot
RUN curl -fsSLO https://github.com/godotengine/godot/releases/download/${GODOT}/Godot_v${GODOT}_linux.x86_64.zip \
 && curl -fsSLO https://github.com/godotengine/godot/releases/download/${GODOT}/SHA512-SUMS.txt \
 && grep " Godot_v${GODOT}_linux.x86_64.zip$" SHA512-SUMS.txt | sha512sum -c - \
 && unzip -q Godot_v${GODOT}_linux.x86_64.zip && rm Godot_v${GODOT}_linux.x86_64.zip \
 && mv Godot_v${GODOT}_linux.x86_64 /usr/local/bin/godot
WORKDIR /lab
```

وهذا السكربت يعمل داخل الـ Container، ويصدر اللعبة إلى كل إعداد بالأمر `--export-release`، ثم يعرض الملفات الناتجة وأحجامها:

```bash
#!/bin/bash
# Inside the container: export the same project to five platforms, one preset at a time, then list what came out.
set -e
cd /lab
rm -rf build && mkdir -p build/web-threads build/web-nothreads build/linux build/windows build/macos
export_one() {   # $1 = project folder, $2 = preset name, $3 = output file
  local s e ok
  s=$(date +%s.%N)
  godot --headless --path "$1" --export-release "$2" "$3" > /tmp/export.log 2>&1 && ok=ok || ok=FAILED
  e=$(date +%s.%N)
  printf '### %-17s %s in %.1f s\n' "$2" "$ok" "$(awk "BEGIN{print $e - $s}")"
  # keep Godot's own messages, drop the progress lines and the C++ source locations
  sed 's/\x1b\[[0-9;]*m//g' /tmp/export.log | grep -vE '^\s*at:|^\[|^Godot Engine|^\s*$|^savepack' | head -6
}
export_one game "Web (threads)"    /lab/build/web-threads/index.html
export_one game "Web (no threads)" /lab/build/web-nothreads/index.html
export_one game "Linux"            /lab/build/linux/date-basket.x86_64
export_one game "Windows"          /lab/build/windows/date-basket.exe
export_one game "macOS"            /lab/build/macos/date-basket.zip
echo "### macOS again, on a copy of the project with the setting the error asks for"
cp -r game /tmp/game && echo 'textures/vram_compression/import_etc2_astc=true' >> /tmp/game/project.godot
export_one /tmp/game "macOS" /lab/build/macos/date-basket.zip
echo "### inside the macOS zip"
unzip -l build/macos/date-basket.zip | awk 'NR>3 && $1 ~ /^[0-9]+$/ && $4 != "" && $0 !~ /\/$/ {printf "%10s  %s\n", $1, substr($0, index($0, $4))}' | grep -v ' files$' | head -14
echo "### files"
cd build && find . -type f | sort | while read f; do printf '%10s  %s\n' "$(numfmt --to=iec --suffix=B --format='%.1f' $(stat -c %s "$f"))" "${f#./}"; done
```

وهذا السكربت الذي تشغله أنت من مجلد المختبر بالأمر `bash run.sh`، وهو ينزل القوالب مرة واحدة، ثم يصدر، ثم يشغل النسخ الناتجة على Linux وWindows وفي المتصفح:

```bash
#!/bin/bash
# The export lab, from this folder:  bash run.sh
# 1. download the official 4.7.2 export templates once (1.2 GB) and check them against the release's SHA512 sums
# 2. export the game to Web (with and without threads), Linux, Windows and macOS inside Docker
# 3. run the Linux build in a clean container and the Windows build on this machine
# 4. serve the two Web builds with and without the isolation headers and open them in headless Chrome (node web-check.mjs)
set -eo pipefail
V=4.7.2-stable; T=4.7.2.stable
mkdir -p cache
if [ ! -f cache/templates/$T/version.txt ]; then
  [ -f cache/templates.tpz ] || curl -fsSL -o cache/templates.tpz https://github.com/godotengine/godot/releases/download/$V/Godot_v${V}_export_templates.tpz
  curl -fsSL https://github.com/godotengine/godot/releases/download/$V/SHA512-SUMS.txt | grep " Godot_v${V}_export_templates.tpz$" | sed 's#Godot_v.*#cache/templates.tpz#' > cache/sum.txt
  sha512sum -c cache/sum.txt
  mkdir -p cache/templates/$T
  unzip -q -j -o cache/templates.tpz -d cache/templates/$T templates/version.txt templates/web_release.zip templates/web_nothreads_release.zip \
    templates/linux_release.x86_64 templates/windows_release_x86_64.exe templates/windows_release_x86_64_console.exe templates/macos.zip
fi
{ echo "### templates used (from the 1.2 GB file)"; cat cache/templates/$T/version.txt; ls -l cache/templates/$T | awk 'NR>1 {printf "%10.1f MB  %s\n", $5/1048576, $9}'; } | tee out-01-templates.txt
docker build -q -t export-lab:1 . > /dev/null
MSYS_NO_PATHCONV=1 docker run --rm -v "$(pwd -W 2>/dev/null || pwd):/lab" -v "$(pwd -W 2>/dev/null || pwd)/cache/templates:/root/.local/share/godot/export_templates" \
  export-lab:1 bash export.sh 2>&1 | tee out-02-export.txt
echo "### Linux build in a clean container (no Godot installed there)" | tee out-03-run.txt
MSYS_NO_PATHCONV=1 docker run --rm -v "$(pwd -W 2>/dev/null || pwd)/build/linux:/game" debian:bookworm-slim /game/date-basket.x86_64 --headless 2>&1 | grep -E "LAB|Godot Engine|ERROR" | tee -a out-03-run.txt
echo "### Windows build on this machine" | tee -a out-03-run.txt
./build/windows/date-basket.console.exe --headless 2>&1 | grep -E "LAB|Godot Engine|ERROR" | tee -a out-03-run.txt
echo "### the same Windows build with a real window (6 s), saving build/windows/shot.png" | tee -a out-03-run.txt
./build/windows/date-basket.console.exe -- --shot 2>&1 | grep -E "LAB|WARNING" | tee -a out-03-run.txt
node web-check.mjs | tee out-04-web.txt
```

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

```text
### Web (threads)     ok in 22.4 s
### Web (no threads)  ok in 14.1 s
### Linux             ok in 11.0 s
### Windows           ok in 16.4 s
### macOS             FAILED in 16.1 s
ERROR: Cannot export project with preset "macOS" due to configuration errors:
Cannot export for universal or arm64 if ETC2 ASTC texture format is disabled. Enable it in the Project Settings (Rendering > Textures > VRAM Compression > Import ETC2 ASTC).
ERROR: Project export for preset "macOS" failed.
```

نسخة macOS لم تصدر، والرسالة واضحة: لا يمكن التصدير إلى macOS بصيغة Universal أو لمعالجات arm64 إذا كانت صيغة ضغط الخامات ETC2 ASTC معطلة، والحل كما تقول الرسالة أن تفعلها من إعدادات المشروع. والسبب أن أجهزة Mac الحديثة تعمل بمعالجات Apple Silicon، وكروت الشاشة فيها تفهم صيغة ضغط الخامات Texture Compression المستخدمة في الجوال لا صيغة أجهزة الكمبيوتر التقليدية، ولذلك يرفض Godot أن يصدر لعبة قد لا تظهر خاماتها على نصف أجهزة Mac. ولاحظ أن الخطأ ظهر وقت التصدير لا وقت التشغيل، وهذا من حسن الحظ، فأسوأ الأخطاء هي التي يكتشفها اللاعب.

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

```text
### macOS again, on a copy of the project with the setting the error asks for
### macOS             ok in 33.8 s
### inside the macOS zip
         9  Date Basket.app/Contents/PkgInfo
    121324  Date Basket.app/Contents/Resources/Date Basket.pck
       229  Date Basket.app/Contents/Resources/PrivacyInfo.xcprivacy
     67500  Date Basket.app/Contents/Resources/icon.icns
      1779  Date Basket.app/Contents/Info.plist
 170963648  Date Basket.app/Contents/MacOS/Date Basket
      3179  Date Basket.app/Contents/_CodeSignature/CodeResources
```

نجح التصدير هذه المرة، وفي محتوى الملف المضغوط لاحظ التالي:

- **التطبيق مجلد:** تطبيق macOS هو مجلد ينتهي بـ `.app`، وفيه البرنامج في `Contents/MacOS` وحزمة اللعبة في `Contents/Resources`.
- **البرنامج حجمه حوالي 163 ميجابايت:** 170,963,648 بايت، لأنه برنامج واحد فيه نسختان من المحرك، واحدة لمعالجات Intel وواحدة لمعالجات Apple Silicon.
- **المجلد `_CodeSignature`:** وقع Godot التطبيق توقيعاً محلياً Ad-hoc دون أن نطلب ذلك، وهذا التوقيع لا يثبت هويتك أمام Apple، وسوف نعود إليه في قسم macOS.

وفي نهاية المخرج قائمة بكل الملفات الناتجة وأحجامها:

```text
### files
   118.5KB  linux/date-basket.pck
    70.2MB  linux/date-basket.x86_64
    57.8MB  macos/date-basket.zip
    11.7KB  web-nothreads/index.apple-touch-icon.png
     3.0KB  web-nothreads/index.audio.position.worklet.js
     7.2KB  web-nothreads/index.audio.worklet.js
     5.6KB  web-nothreads/index.html
     5.6KB  web-nothreads/index.icon.png
   273.3KB  web-nothreads/index.js
   118.5KB  web-nothreads/index.pck
    21.0KB  web-nothreads/index.png
    37.7MB  web-nothreads/index.wasm
    11.7KB  web-threads/index.apple-touch-icon.png
     3.0KB  web-threads/index.audio.position.worklet.js
     7.2KB  web-threads/index.audio.worklet.js
     5.6KB  web-threads/index.html
     5.6KB  web-threads/index.icon.png
   307.3KB  web-threads/index.js
   118.5KB  web-threads/index.pck
    21.0KB  web-threads/index.png
    37.1MB  web-threads/index.wasm
    49.0KB  windows/date-basket.console.exe
   104.1MB  windows/date-basket.exe
   118.5KB  windows/date-basket.pck
```

ولاحظ أن ملف PCK بالحجم نفسه 118.5 كيلوبايت في Linux وWindows والويب، وأن كل ما عداه هو المحرك: 70.2 ميجابايت في Linux، و104.1 ميجابايت في Windows، و37.7 ميجابايت في الويب، و57.8 ميجابايت لملف macOS المضغوط. وإذا كانت هذه الأحجام تزعجك فاعلم أن لعبة كاملة فيها صور وأصوات سوف تكون حزمتها أكبر من المحرك بكثير، وأن Godot يسمح ببناء قوالب مخصصة تحذف منها أجزاء المحرك التي لا تستخدمها، وهذا موضوع متقدم لا تحتاجه في أول لعبة.

## هل تعمل النسخ المصدرة دون Godot؟

التصدير نجح، ولكن السؤال الحقيقي هو هل تعمل اللعبة على جهاز لا يوجد فيه Godot؟ ولذلك شغلنا نسخة Linux في Container جديد من Debian لم يثبت فيه شيء، وشغلنا نسخة Windows على جهاز Windows 11 عادي، والمخرج سوف يكون كما يلي:

```text
### Linux build in a clean container (no Godot installed there)
Godot Engine v4.7.2.stable.official.ed1daf0bf - https://godotengine.org
LAB platform=Linux features=threads,pc,linux,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=8
LAB after 6.0 s: frames=352 caught=6 missed=3
### Windows build on this machine
Godot Engine v4.7.2.stable.official.ed1daf0bf - https://godotengine.org
LAB platform=Windows features=threads,pc,windows,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=8
LAB after 6.0 s: frames=356 caught=7 missed=3
```

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

- **تعمل دون أي تثبيت:** البرنامج وحزمته يكفيان، ولم نحتج مكتبة إضافية في Debian.
- **وسوم المنصة:** `template` تعني أنها نسخة مصدرة لا المحرر، و`release` تعني قالب Release، و`pc` تعني جهاز كمبيوتر، ومن هذه الوسوم تبني كودك عندما تريد سلوكاً مختلفاً لكل منصة.
- **النتيجة ليست متطابقة تماماً:** في Linux رسمت اللعبة 352 إطاراً والتقطت 6 حبات، وفي Windows رسمت 356 إطاراً والتقطت 7\. والسبب أن منطق اللعبة في `_process` يعتمد على زمن كل إطار، وهذا الزمن يختلف قليلاً بين جهاز وآخر، فتصل الحبة السابعة إلى السلة قبل الثانية السادسة على جهاز وبعدها على آخر. وإذا كانت لعبتك تحتاج نتيجة متطابقة على كل الأجهزة، في لعبة جماعية مثلاً، فضع المنطق في خطوة الفيزياء الثابتة كما شرحنا في مقال حلقة اللعبة.

ثم شغلنا نسخة Windows نفسها في نافذة حقيقية لمدة ست ثوان:

```text
### the same Windows build with a real window (6 s), saving build/windows/shot.png
WARNING: Your video card drivers are known to have low quality OpenGL 3.3 support, switching to ANGLE.
LAB platform=Windows features=threads,pc,windows,template,release
LAB renderer=gl_compatibility driver=opengl3_angle cpus=8
LAB after 6.0 s: frames=269 caught=7 missed=3
```

ظهر تحذير لم نره في التشغيل دون شاشة: Godot وجد أن تعريف كرت الشاشة Driver في هذا الجهاز معروف بدعم ضعيف لـ OpenGL 3.3، فانتقل وحده إلى ANGLE، وهي طبقة تترجم أوامر OpenGL إلى Direct3D 11 الذي يدعمه Windows بشكل أفضل. وهذا سلوك افتراضي في Godot على Windows فقط، يتحكم فيه الإعداد `rendering/gl_compatibility/fallback_to_angle` كما في [توثيق إعدادات المشروع](https://docs.godotengine.org/en/stable/classes/class%5Fprojectsettings.html?ref=arabroot.io#class-projectsettings-property-rendering-gl-compatibility-fallback-to-angle)، وهو أحد الأسباب التي تجعلك تجرب لعبتك على أجهزة حقيقية مختلفة قبل النشر، فعدد الإطارات هنا كان 269 في ست ثوان، أقل من التشغيل دون شاشة لأن الرسم الحقيقي يأخذ وقتاً.

والصورة التالية هي ما حفظته اللعبة من شاشتها في هذا التشغيل:

![لقطة من لعبة سلة التمر على Windows: خلفية رملية، ونخلة على اليمين، وحبتا تمر تسقطان، وسلة بنية في الأسفل، وفي الأعلى ثلاثة أسطر عربية واضحة: بالخط الافتراضي: سلة التمر، ثم بخط مضمن في اللعبة: سلة التمر، ثم في السلة: 6 على الأرض: 3](https://arabroot.io/content/images/2026/11/game-export-web-02-windows-build.webp)

نسخة Windows: السطر الأول بالخط الافتراضي يظهر بالعربية بشكل صحيح، لأن Godot استعار خطاً عربياً من Windows.

لاحظ أن السطر الأول ظهر بالعربية صحيحاً رغم أن الخط الافتراضي في Godot لا يحتوي حروفاً عربية، والسبب أن Godot يستعمل خطوط النظام بديلاً Fallback عندما لا يجد الحرف في خطك، كما يذكر [توثيق الخطوط في Godot](https://docs.godotengine.org/en/stable/tutorials/ui/gui%5Fusing%5Ffonts.html?ref=arabroot.io). وهذا يعني أن لعبتك قد تبدو سليمة على جهازك وعلى Windows، ثم تظهر حروفها مربعات فارغة في مكان آخر، وهذا ما حدث فعلاً في المتصفح.

## التصدير إلى الويب: WebAssembly وWebGL 2

نسخة الويب هي أسهل نسخة يجربها الناس، رابط يفتحونه من أي جهاز دون تثبيت ودون متجر، ولذلك هي غالباً أول ما تنشره. وتعمل لعبة Godot في المتصفح لأن المحرك نفسه مبني بلغة WebAssembly، وهي صيغة كود يشغلها المتصفح بسرعة قريبة من البرامج العادية، والرسم يتم بـ WebGL 2.0، ولذلك يشترط [توثيق التصدير إلى الويب](https://docs.godotengine.org/en/stable/tutorials/export/exporting%5Ffor%5Fweb.html?ref=arabroot.io) أن يدعم المتصفح الاثنين، وأن تستخدم لعبتك طريقة الرسم Compatibility، فطرق الرسم الأخرى Forward+ وMobile لا تعمل في المتصفح. وإذا كنت تكتب لعبتك بـ C# فانتبه إلى أن مشاريع C# في Godot 4 لا تصدر إلى الويب حالياً بحسب التوثيق نفسه.

وهذا ما يحمله المتصفح لتعمل لعبتنا، مع حجم ملف المحرك بعد ضغطه بطريقتين:

```text
### 1. What the browser downloads (no-threads build)
index.apple-touch-icon.png   0.01 MB
index.audio.position.worklet.js   0.00 MB
index.audio.worklet.js     0.01 MB
index.html                 0.01 MB
index.icon.png             0.01 MB
index.js                   0.27 MB
index.pck                  0.12 MB
index.png                  0.02 MB
index.wasm                37.68 MB   gzip 9.68 MB (26%)   brotli 6.77 MB (18%)
```

![رسم أعمدة أفقية: ملف المحرك index.wasm حجمه 37.68 MB، ومضغوطاً بـ gzip 9.68 MB أي 26 بالمئة، ومضغوطاً بـ Brotli 6.77 MB أي 18 بالمئة، وملف index.js حجمه 0.27 MB، وحزمة اللعبة index.pck حجمها 0.12 MB، مع ملاحظة أن الحجم كله تقريباً هو المحرك](https://arabroot.io/content/images/2026/11/game-export-web-04-web-size.webp)

لعبتك أقل من 1% مما يحمله المتصفح، والضغط على السيرفر يخفض التحميل إلى ربعه أو أقل.

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

- **ملف `index.wasm`:** هو المحرك نفسه، وحجمه 37.68 ميجابايت، وهو ما ينتظره اللاعب قبل أن يرى أي شيء.
- **الضغط يغير كل شيء:** بالضغط gzip نزل الحجم إلى 26% من أصله، وبالضغط Brotli إلى 18%، وهذا يطابق ما يذكره توثيق Godot من أن ملف WebAssembly يضغط إلى حوالي ربع حجمه.
- **ملفات أخرى صغيرة:** `index.js` يحمل المحرك ويشغله، و`index.html` هي الصفحة، وملفات `audio.worklet` للصوت، والصور للأيقونة وشاشة البداية.

ولذلك فإن أول ما تفعله قبل أن تفكر في تصغير لعبتك هو أن تتأكد أن السيرفر يرسل ملف wasm مضغوطاً، فبعض الاستضافات تضغط الملفات وحدها مثل GitHub Pages، وبعضها لا يضغطها مثل itch.io وGitLab Pages كما يذكر التوثيق، وعندها تحتاج أن ترفع نسخة مضغوطة مسبقاً إذا كانت الاستضافة تدعم ذلك. وتأكد أيضاً أن السيرفر يرسل ملف wasm بنوع المحتوى `application/wasm`، وفي المختبر كتبنا سيرفراً صغيراً بـ Node يفعل ذلك.

وقد تسأل: لماذا لا أفتح ملف `index.html` بالضغط عليه مرتين وأنتهي؟ والإجابة أن ملفات التصدير صممت لتأتي من سيرفر ويب كما يذكر التوثيق، بأنواع محتوى صحيحة وبالـ Headers التي تحتاجها نسخة Threads، ولذلك جرب نسخة الويب دائماً من خلال سيرفر ولو على جهازك. ومستودع Godot نفسه فيه سكربت Python صغير اسمه `serve.py` يذكره التوثيق لهذا الغرض، ويرسل Headers العزل أيضاً، ولكنه للتجربة فقط، أما النشر الحقيقي فيكون على سيرفر مثل Nginx أو Apache أو على استضافة الملفات الثابتة.

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

ثم فتحنا نسخة الويب في متصفح Chrome دون شاشة Headless، وهذا ما ظهر على الشاشة:

![لقطة من لعبة سلة التمر في المتصفح: الخلفية الرملية والنخلة وحبات التمر والسلة كما في Windows، ولكن السطر العربي الأول بالخط الافتراضي ظهر مربعات فارغة بدل الحروف، بينما السطر الثاني بالخط المضمن في اللعبة وسطر النتيجة ظهرا بالعربية بشكل صحيح](https://arabroot.io/content/images/2026/11/game-export-web-03-web-build.webp)

نسخة الويب: السطر الأول بالخط الافتراضي صار مربعات، لأن المتصفح لا يعطي Godot خطوط النظام.

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

⚠️

ضع في لعبتك خطاً عربياً داخل المشروع، واجعله خط الواجهة كلها من إعدادات الثيم Theme، ولا تعتمد على خطوط الجهاز. واختر خطاً برخصة تسمح بتضمينه في الألعاب مثل رخصة SIL Open Font License التي يأتي بها IBM Plex Sans Arabic الذي استعملناه، وضع نص الرخصة مع لعبتك.

## لماذا تحتاج بعض نسخ الويب Headers خاصة؟

صدرنا نسختين للويب، واحدة تستخدم Threads وواحدة لا تستخدمها، والفرق بينهما يظهر عندما تضعهما على سيرفر. وخيوط التنفيذ Threads في المتصفح تعتمد على شيء اسمه `SharedArrayBuffer`، وهو ذاكرة مشتركة بين أكثر من خيط تنفيذ، والمتصفحات اليوم لا تعطي هذه الذاكرة لأي صفحة، وإنما للصفحة المعزولة Cross-Origin Isolated فقط، والصفحة تكون معزولة عندما يرسل السيرفر معها Header اسمه `Cross-Origin-Opener-Policy: same-origin` وآخر اسمه `Cross-Origin-Embedder-Policy: require-corp`.

📜

في يناير 2018 كشفت ثغرة Spectre أن صفحة ويب تستطيع أن تقرأ ما ليس لها من الذاكرة إذا استطاعت قياس الزمن بدقة عالية، و`SharedArrayBuffer` يسمح ببناء مؤقت دقيق جداً، فعطلته المتصفحات كلها تقريباً، كما أعلنت Mozilla في [مدونتها الأمنية في 3 يناير 2018](https://blog.mozilla.org/security/2018/01/03/mitigations-landing-new-class-timing-attack/?ref=arabroot.io). ثم أعادته Chrome على أجهزة الكمبيوتر في الإصدار 68 بعد أن عزلت كل موقع في عملية منفصلة، وفي Chrome 92 أصبح متاحاً للصفحات المعزولة فقط، كما في [إعلان Chrome](https://developer.chrome.com/blog/enabling-shared-array-buffer?ref=arabroot.io)، وهذا هو الشرط الذي ما زلنا نعيش معه اليوم كما يشرح [توثيق MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global%5FObjects/SharedArrayBuffer?ref=arabroot.io).

ولكي نرى ماذا يعني هذا عملياً، شغل سكربت `web-check.mjs` سيرفرين على جهازك: الأول عادي، والثاني يرسل هذين الـ Headers، ثم فتح كل نسخة على كل سيرفر في Chrome وقرأ ما كتبته اللعبة. وهذا السكربت كاملاً:

```javascript
// Serve the two Web builds from a plain server and from one that sends the cross-origin isolation headers,
// open each in headless Chrome, and report what the game printed (or why it did not start).
//   node web-check.mjs          (needs Chrome and scripts/lab/browser.mjs from this repository)
import { createServer } from 'node:http';
import { readFileSync, existsSync, statSync, readdirSync } from 'node:fs';
import { join, extname, resolve, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
import { gzipSync, brotliCompressSync, constants } from 'node:zlib';
import { launch } from '../../../../scripts/lab/browser.mjs';

const here = dirname(fileURLToPath(import.meta.url));
const build = resolve(here, 'build');
const TYPES = { '.html': 'text/html', '.js': 'text/javascript', '.wasm': 'application/wasm', '.pck': 'application/octet-stream', '.png': 'image/png', '.json': 'application/json' };
const ISOLATION = { 'Cross-Origin-Opener-Policy': 'same-origin', 'Cross-Origin-Embedder-Policy': 'require-corp' };

function serve(port, isolate) {
  const srv = createServer((req, res) => {
    const f = join(build, decodeURIComponent(req.url.split('?')[0]).replace(/\/$/, '/index.html'));
    if (!f.startsWith(build) || !existsSync(f) || statSync(f).isDirectory()) { res.writeHead(404).end(); return; }
    res.writeHead(200, { 'Content-Type': TYPES[extname(f)] || 'application/octet-stream', 'Cache-Control': 'no-store', ...(isolate ? ISOLATION : {}) });
    res.end(readFileSync(f));
  });
  return new Promise(r => srv.listen(port, '127.0.0.1', () => r(srv)));
}

const mb = (n) => (n / 1048576).toFixed(2) + ' MB';
console.log('### 1. What the browser downloads (no-threads build)');
for (const f of readdirSync(join(build, 'web-nothreads')).sort()) {
  const buf = readFileSync(join(build, 'web-nothreads', f));
  const line = `${f.padEnd(24)} ${mb(buf.length).padStart(9)}`;
  if (f.endsWith('.wasm')) {
    const gz = gzipSync(buf, { level: 9 }).length, br = brotliCompressSync(buf, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length;
    console.log(`${line}   gzip ${mb(gz)} (${Math.round(gz / buf.length * 100)}%)   brotli ${mb(br)} (${Math.round(br / buf.length * 100)}%)`);
  } else console.log(line);
}

const plain = await serve(8601, false), isolated = await serve(8602, true);
const b = await launch({ port: 9999, width: 640, height: 360, args: ['--enable-unsafe-swiftshader', '--use-angle=swiftshader'] });
const runs = [
  ['web-nothreads', 8601, 'a plain server'], ['web-nothreads', 8602, 'a server with COOP/COEP'],
  ['web-threads', 8601, 'a plain server'], ['web-threads', 8602, 'a server with COOP/COEP'],
];
let n = 1;
try {
  for (const [dir, port, how] of runs) {
    n++;
    console.log(`### ${n}. ${dir} on ${how}`);
    const start = Date.now();
    await b.goto(`http://127.0.0.1:${port}/${dir}/index.html`, { wait: 200 });
    let first = 0, done = false;
    for (let i = 0; i < 120 && !done; i++) {
      const s = await b.evaluate(`({ lab: (window.__lab || []).filter(l => l.includes('LAB')).length,
        notice: (() => { const e = document.getElementById('status-notice'); return e && getComputedStyle(e).display !== 'none' && e.textContent.trim() ? e.textContent.trim() : ''; })() })`);
      if (s.lab && !first) first = Date.now() - start;
      done = s.lab >= 3 || !!s.notice;
      if (!done) await b.sleep(250);
    }
    const r = await b.evaluate(`({ isolated: self.crossOriginIsolated, sab: typeof SharedArrayBuffer,
      notice: (() => { const e = document.getElementById('status-notice'); return e && getComputedStyle(e).display !== 'none' ? e.innerText.trim() : ''; })(), lab: window.__lab || [] })`);
    console.log(`crossOriginIsolated=${r.isolated}  SharedArrayBuffer=${r.sab}`);
    if (r.notice) console.log('the page shows instead of the game:\n' + r.notice.split('\n').map(l => '  ' + l.trim()).filter(l => l.trim()).join('\n'));
    for (const l of r.lab.filter(l => l.includes('LAB'))) console.log(l.replace(/^log: /, ''));
    if (first) console.log(`first LAB line after ${(first / 1000).toFixed(1)} s`);
    if (dir === 'web-nothreads' && port === 8601) await b.shot(resolve(here, '../images/03-web-build.webp'));
    if (dir === 'web-threads' && port === 8601) await b.shot(resolve(here, '../images/05-web-threads-error.webp'));
  }
} finally { await b.close(); plain.close(); isolated.close(); }
```

والمخرج للنسخة دون Threads سوف يكون كما يلي:

```text
### 2. web-nothreads on a plain server
crossOriginIsolated=false  SharedArrayBuffer=undefined
LAB platform=Web features=web,nothreads,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=2
LAB after 6.0 s: frames=343 caught=6 missed=3
first LAB line after 5.2 s
### 3. web-nothreads on a server with COOP/COEP
crossOriginIsolated=true  SharedArrayBuffer=function
LAB platform=Web features=web,nothreads,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=2
LAB after 6.0 s: frames=339 caught=6 missed=3
first LAB line after 2.6 s
```

النسخة دون Threads عملت على السيرفرين، ولاحظ أن `SharedArrayBuffer` غير موجود أصلاً على السيرفر العادي، ومع ذلك لم تحتجه اللعبة. أما النسخة التي تستخدم Threads فهذا ما حدث لها:

```text
### 4. web-threads on a plain server
crossOriginIsolated=false  SharedArrayBuffer=undefined
the page shows instead of the game:
  Error
  The following features required to run Godot projects on the Web are missing:
  Cross-Origin Isolation - Check that the web server configuration sends the correct headers.
  SharedArrayBuffer - Check that the web server configuration sends the correct headers.
### 5. web-threads on a server with COOP/COEP
crossOriginIsolated=true  SharedArrayBuffer=function
LAB platform=Web features=web,threads,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=2
LAB after 6.0 s: frames=341 caught=6 missed=3
first LAB line after 2.1 s
```

على السيرفر العادي لم تبدأ اللعبة أصلاً، وظهرت مكانها هذه الرسالة:

![صفحة داكنة في وسطها مربع أحمر فيه كلمة Error ثم نص: The following features required to run Godot projects on the Web are missing، وتحته سطران: Cross-Origin Isolation - Check that the web server configuration sends the correct headers، وSharedArrayBuffer - Check that the web server configuration sends the correct headers](https://arabroot.io/content/images/2026/11/game-export-web-05-web-threads-error.webp)

نسخة Threads على سيرفر لا يرسل Headers العزل: هذا كل ما يراه اللاعب.

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

![جدول من أربع خانات: صف النسخة دون Threads تعمل على السيرفر العادي وعلى السيرفر الذي يرسل Headers العزل، وصف النسخة مع Threads لا تبدأ على السيرفر العادي برسالة أن Cross-Origin Isolation وSharedArrayBuffer مفقودتان، وتعمل على السيرفر الذي يرسل COOP same-origin وCOEP require-corp، مع ملاحظة عن متى تحتاج Threads وأن خيار PWA يضيف Service Worker يحاكي هذه الـ Headers](https://arabroot.io/content/images/2026/11/game-export-web-06-web-headers.webp)

نتيجة التجارب الأربع في المختبر: النسخة دون Threads تعمل في كل مكان.

فقد يتساءل البعض: لماذا لا أرسل الـ Headers دائماً وأنتهي؟ والإجابة أن العزل له ثمن، فالصفحة المعزولة لا تستطيع أن تحمل محتوى من موقع آخر إلا إذا سمح ذلك الموقع بذلك صراحة، وهذا يعني أن الإعلانات وأدوات الطرف الثالث في الغالب لن تعمل في صفحة لعبتك، وكثير من مواقع الألعاب تعرض لعبتك داخل iframe لا تتحكم في Headers صفحته. ولهذا السبب أضاف Godot في الإصدار 4.3 التصدير دون Threads وجعله الطريقة الافتراضية، كما شرح الفريق في [تقرير تطوير التصدير إلى الويب في 4.3](https://godotengine.org/article/progress-report-web-export-in-4-3/?ref=arabroot.io)، ويذكر التوثيق أنه أكثر توافقاً مع itch.io ومواقع مثل Poki وCrazyGames ومع متصفحات macOS وiOS.

ومتى تحتاج Threads إذن؟ عندما تستخدم خيوط التنفيذ في كودك فعلاً، أو تحتاج صوتاً من نوع Stream بزمن تأخير منخفض، أو تستخدم إضافات GDExtension، فهذه الحالات الثلاث هي التي يربطها التوثيق بالعزل. وإذا احتجتها ولم تكن تتحكم في السيرفر، ففعل خيار Progressive Web App في إعدادات التصدير، فهو يضيف Service Worker يحاكي وجود هذه الـ Headers، بشرط أن تعمل الصفحة على HTTPS، والسبب أن المتصفح لا يعطي هذه الميزات إلا لسياق آمن Secure Context، ويستثنى من ذلك `localhost` في الغالب، ولهذا عملت تجاربنا على جهازنا دون شهادة.

## ما الذي يختلف في المتصفح؟

حتى بعد أن تعمل لعبتك في المتصفح، هناك أشياء تعمل على الكمبيوتر وتختلف في الويب لأسباب أمنية، ويجمعها توثيق Godot في قسم القيود Limitations، وأهمها ما يلي:

- **التبويب غير النشط:** يوقف المتصفح اللعبة عندما ينتقل اللاعب إلى تبويب آخر، فتتوقف `_process` و`_physics_process`، وقد ينقطع اتصال اللعبة الجماعية إذا طال ذلك.
- **ملء الشاشة وحبس مؤشر الفأرة:** لا يسمح بهما المتصفح إلا استجابة لحدث من اللاعب، أي من داخل دالة مثل `_input`، لا من كود يعمل وحده عند بداية اللعبة.
- **الصوت:** المتصفحات تمنع تشغيل الصوت قبل أن يتفاعل اللاعب مع الصفحة، ولذلك ابدأ لعبتك بشاشة تطلب ضغطة زر قبل الموسيقى.
- **الشبكة:** لا يوجد اتصال منخفض المستوى بـ TCP أو UDP في المتصفح، والمتاح هو HTTP وWebSocket وWebRTC فقط.
- **حفظ اللعبة:** ملفات `user://` تحفظ في IndexedDB الخاصة بالمتصفح، فإذا كان اللاعب في وضع التصفح الخفي أو منع ملفات تعريف الارتباط Cookies ضاع حفظه.

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

## سطح المكتب: Windows وLinux وmacOS

التصدير إلى الكمبيوتر هو الأبسط تقنياً كما رأينا، فالقالب والحزمة يكفيان، ولكن الفرق الحقيقي بين المنصات الثلاث يظهر في المعمارية وفي التوقيع.

**المعمارية Architecture:** يصدر Godot لـ Windows بثلاث معماريات: x86\_64 وهي الافتراضية ومعالجات أغلب الأجهزة، وx86\_32 للأنظمة القديمة ذات 32 بت التي لم تعد Microsoft تدعمها، وarm64 لأجهزة Windows بمعالجات ARM مثل Snapdragon X Elite، كما في [توثيق التصدير إلى Windows](https://docs.godotengine.org/en/stable/tutorials/export/exporting%5Ffor%5Fwindows.html?ref=arabroot.io). وفي Linux تتوفر قوالب رسمية لـ x86\_64 وx86\_32 وarm64 وarm32، فتستطيع أن تصدر لعبتك لـ Raspberry Pi بقالب رسمي، أما المعماريات الأخرى مثل RISC-V فتبني قوالبها بنفسك. وفي macOS يكون التطبيق Universal دائماً مع القوالب الرسمية كما رأينا في المختبر.

**دمج الحزمة في البرنامج:** إذا أردت ملفاً واحداً بدل البرنامج والحزمة ففعل خيار دمج الحزمة Embed PCK، ولكن انتبه إلى أن التوثيق يحدد حجم الملف المدمج بحوالي 3.89 جيجابايت، فإذا كانت لعبتك كبيرة فاتركها ملفين.

**التوقيع على Windows:** يستطيع Godot أن يوقع البرنامج وقت التصدير بأداة SignTool من Windows SDK، أو بأداة osslsigncode إذا كنت تصدر من نظام آخر، ويحتاج ذلك شهادة توقيع كود Code Signing Certificate. والتوقيع يثبت للاعب اسم الناشر، ولكنه لا يمنع وحده تحذير Microsoft Defender SmartScreen، فهذا التحذير يظهر كما يشرح [توثيق Microsoft](https://learn.microsoft.com/en-us/windows/security/operating-system-security/virus-and-threat-protection/microsoft-defender-smartscreen/?ref=arabroot.io) لكل ملف ليس في قائمة الملفات المعروفة التي ينزلها كثير من المستخدمين، ولعبتك الجديدة ليست في هذه القائمة بكل تأكيد. ولذلك نبه اللاعبين في صفحة التنزيل إلى أن هذه الرسالة متوقعة، أو انشر على متجر مثل Steam يثبت اللعبة بنفسه.

**التوقيع والتوثيق على macOS:** هنا القواعد أشد، فبحسب [توثيق التصدير إلى macOS](https://docs.godotengine.org/en/stable/tutorials/export/exporting%5Ffor%5Fmacos.html?ref=arabroot.io) لا يشغل macOS افتراضياً إلا التطبيقات الموقعة والموثقة Notarized، والتطبيق غير الموثق الذي ينزل من الإنترنت يمنعه Gatekeeper. والتوثيق Notarization هو أن ترسل تطبيقك إلى Apple لتفحصه آلياً ثم تلصق نتيجة الفحص به، ويحتاج حساب Apple Developer وشهادة Developer ID. ويمكنك أن توقع وتوثق من Linux وWindows أيضاً بأداة rcodesign، فلا تحتاج جهاز Mac لهذه الخطوة. أما التوقيع المحلي Ad-hoc الذي وضعه Godot في المختبر فيجعل تشغيل التطبيق أسهل على من يعرف طريقة تجاوز التحذير، ولكنه لا يغني عن التوثيق إذا كنت تبيع لعبتك للناس.

⚠️

إذا صدرت لعبة macOS من Windows بصيغة مجلد `.app` مباشرة فلن تعمل على Mac، لأن نظام ملفات Windows لا يحفظ صلاحية التشغيل Executable للبرنامج داخل المجلد. صدرها بصيغة `.zip` كما فعلنا في المختبر، أو أضف الصلاحية بالأمر `chmod +x` على جهاز Mac أو Linux.

## الجوال: Android وiOS

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

**Android:** بحسب [توثيق التصدير إلى Android](https://docs.godotengine.org/en/stable/tutorials/export/exporting%5Ffor%5Fandroid.html?ref=arabroot.io) تحتاج OpenJDK 17 وAndroid SDK، والتوثيق يذكر الحزم بأرقامها، ومنها Build-Tools 35.0.1 ومنصة android-35، ثم تضع مساريهما في إعدادات المحرر. وتصدر من Windows أو Linux أو macOS، وينتج التصدير ملف APK تثبته على جوالك للتجربة. أما متجر Google Play فيشترط منذ أغسطس 2021 أن ترفع التطبيقات الجديدة بصيغة AAB، ولكي تصدر AAB تحتاج بناء Gradle الذي يذكره التوثيق. وكل تطبيق Android يجب أن يوقع بمفتاح من ملف Keystore، وتنشئه بأداة `keytool`، واحفظ هذا الملف وكلمة مروره في مكان آمن خارج المشروع، والسبب أنه ما يثبت أن التحديث القادم منك أنت.

**iOS:** هنا لا يوجد بديل عن جهاز Mac، فبحسب [توثيق التصدير إلى iOS](https://docs.godotengine.org/en/stable/tutorials/export/exporting%5Ffor%5Fios.html?ref=arabroot.io) يجب أن يكون التصدير من macOS وعليه Xcode. ولا ينتج Godot تطبيقاً جاهزاً لـ iOS، وإنما مشروع Xcode تفتحه في Xcode وتبنيه وترفعه منه، ويحتاج التصدير معرف الفريق App Store Team ID ومعرف الحزمة Bundle Identifier، ولن يكمل التصدير دونهما.

ولاحظ أن نسخة الويب تعمل على الجوال أيضاً، فإذا كانت لعبتك صغيرة ولا تريد المتاجر بعد فرابط الويب طريقة سريعة لتصل إلى الجوال، مع أن التوثيق يذكر أن النسخ الأصلية Native على Android وiOS أسرع منها بفارق كبير، لأن WebAssembly أبطأ من الكود الأصلي ولأن أداء الجوال محدود أصلاً.

## النشر في المتاجر

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

![أربع بطاقات: Android يحتاج OpenJDK 17 وAndroid SDK، وAPK للتجربة وAAB لمتجر Google Play، وتوقيع بمفتاح Keystore، ورسوم Google Play 25 دولاراً مرة واحدة. iOS يحتاج جهاز Mac عليه Xcode، وGodot يصدر مشروع Xcode، وTeam ID ومعرف الحزمة، ورسوم Apple 99 دولاراً كل سنة. Windows وmacOS التصدير من أي نظام، وتوقيع يثبت اسم الناشر وSmartScreen يحذر من ملف جديد، وتوقيع وتوثيق Notarization لـ macOS وإلا منعها Gatekeeper، ورسوم Steam 100 دولار لكل لعبة. الويب أي سيرفر ملفات ثابتة دون توقيع ولا متجر، وضغط ملف wasm، وHeaders العزل مع Threads فقط، وitch.io تختار أنت نسبتهم](https://arabroot.io/content/images/2026/11/game-export-web-07-stores.webp)

ما تطلبه كل منصة، والرسوم من صفحات المتاجر الرسمية في نوفمبر 2026.

- **Steam:** بعد أن تكمل التسجيل في Steamworks تدفع 100 دولار عن كل لعبة جديدة تنشرها، كما في [صفحة رسوم Steam Direct](https://partner.steamgames.com/doc/gettingstarted/appfee?ref=arabroot.io).
- **itch.io:** أنت من يختار النسبة التي تذهب إلى الموقع من كل عملية بيع، ويسمونها مشاركة الإيراد المفتوحة Open Revenue Sharing كما في [أسئلة المطورين في itch.io](https://itch.io/docs/creators/faq?ref=arabroot.io)، وهو مكان ممتاز لأول نسخة ويب من لعبتك.
- **Google Play:** رسوم تسجيل 25 دولاراً مرة واحدة لحساب المطور، كما في [صفحة إنشاء حساب المطور](https://support.google.com/googleplay/android-developer/answer/6112435?ref=arabroot.io)، مع التحقق من هويتك.
- **App Store:** برنامج Apple Developer رسومه 99 دولاراً كل سنة، كما في [صفحة البرنامج](https://developer.apple.com/programs/whats-included/?ref=arabroot.io)، وهو الحساب نفسه الذي تحتاجه لتوثيق تطبيق macOS.

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

## أخطاء شائعة

- **إصدار القوالب لا يطابق المحرر:** إذا ترقيت إلى إصدار جديد من Godot فنزل قوالبه أيضاً، فالمحرر لا يستعمل قوالب إصدار آخر.
- **الاعتماد على خطوط الجهاز:** النص العربي الذي يظهر سليماً على جهازك قد يصبح مربعات في المتصفح كما رأينا، فضع خطاً عربياً داخل المشروع دائماً.
- **تفعيل Threads دون سبب:** النسخة دون Threads تعمل على أي سيرفر، والنسخة معها لا تبدأ أصلاً إذا غابت Headers العزل.
- **نسيان ضغط ملف wasm:** 37.7 ميجابايت دون ضغط مقابل أقل من 10 مع الضغط، والفرق يشعر به كل لاعب على اتصال بطيء.
- **تجربة اللعبة في المحرر فقط:** مشاكل مثل الخطوط وصيغ الخامات وANGLE لا تظهر إلا في النسخة المصدرة على جهاز حقيقي، فصدر وجرب مبكراً لا في ليلة النشر.
- **رفع ملف `export_credentials.cfg` إلى Git:** فيه كلمات مرور التوقيع، وهو داخل مجلد `.godot` الذي يجب أن يكون في `.gitignore` أصلاً.
- **ضياع مفتاح Android:** احفظ ملف Keystore وكلمة مروره في نسخة احتياطية Backup خارج جهازك.

## تطبيق عملي

1. احذف الخط من السطر الثاني في `main.gd` ليصبح بالخط الافتراضي، ثم شغل `bash run.sh`، وافتح الصورة `images/03-web-build.webp` لترى أن السطرين صارا مربعات في المتصفح.
2. غير `binary_format/embed_pck` إلى `true` في إعداد Linux، وصدر مرة أخرى، وقارن عدد الملفات وحجمها.
3. أضف إلى السيرفر في `web-check.mjs` ضغط gzip لملف wasm، وقس الفرق في زمن ظهور أول سطر من اللعبة.

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

القوالب التي نزلها المختبر تأخذ 1.2 جيجابايت في مجلد `cache`، والنسخ المصدرة حوالي 310 ميجابايت في مجلد `build`، فاحذفهما مع الـ Image:

```bash
rm -rf cache build
docker image rm export-lab:1
```

## الخلاصة Summary

- التصدير يضع حزمة لعبتك PCK بجانب قالب تصدير، وهو المحرك مبنياً دون المحرر لكل منصة، والقالب متطابق في كل الألعاب.
- في المختبر كانت حزمة اللعبة 118.5 كيلوبايت، والمحرك 104.1 ميجابايت على Windows و70.2 على Linux و37.7 في الويب.
- نسخة macOS تحتاج تفعيل صيغة الخامات ETC2 ASTC، ونسخة iOS تحتاج جهاز Mac وXcode، ونسخة Android تحتاج JDK وAndroid SDK.
- Godot يستعير خطوط النظام على الكمبيوتر والجوال لا في المتصفح، ولذلك ظهر النص العربي بالخط الافتراضي مربعات في الويب، والحل خط عربي داخل المشروع.
- نسخة الويب دون Threads تعمل على أي سيرفر، والنسخة مع Threads تحتاج Headers العزل COOP وCOEP بسبب قيود ما بعد Spectre.
- ضغط ملف wasm على السيرفر يخفض التحميل من 37.7 ميجابايت إلى 9.7 بالضغط gzip و6.8 بالضغط Brotli.
- التوقيع يثبت اسمك على Windows، والتوقيع والتوثيق شرط عملي على macOS، ورسوم المتاجر منفصلة عن رخصة المحرك.

وفي المقالات القادمة بإذن الله نبني أول لعبة كاملة مع Godot خطوة خطوة، ونخصص مقالاً للواجهة والنص العربي في الألعاب:

[![](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-engines-cover-cover.webp)دليلمحركات الألعاب: Godot وUnity وUnreal وتراخيصهاما الذي يعطيك محرك الألعاب حتى لا تكتبه بنفسك، وكيف تعمل حلقة اللعبة في مختبر Godot حقيقي، وماذا تدفع لكل محرك ومتى.](https://arabroot.io/articles/%D9%85%D8%AD%D8%B1%D9%83%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D9%84%D8%B9%D8%A7%D8%A8-godot-%D9%88unity-%D9%88unreal-%D9%88%D8%AA%D8%B1%D8%A7%D8%AE%D9%8A%D8%B5%D9%87%D8%A7/)[![](https://arabroot.io/content/images/2026/11/game-loop-cover-cover.webp)دليلكيف تعمل اللعبة من الداخل؟ حلقة اللعبة Game Loopلماذا تتحرك الشخصية بالسرعة نفسها على شاشة 144 هرتز وحاسوب بطيء: نبني حلقة اللعبة من الصفر حتى الخطوة الثابتة والاستيفاء، ونقيس كل طريقة في مختبر.](https://arabroot.io/articles/%D8%AD%D9%84%D9%82%D8%A9-%D8%A7%D9%84%D9%84%D8%B9%D8%A8%D8%A9-game-loop-%D9%88%D8%A7%D9%84%D8%A7%D8%B7%D8%A7%D8%B1%D8%A7%D8%AA-frames/)

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

- نوفمبر 2026: كتابة المقال، وتصدير المختبر بـ Godot 4.7.2 وقوالبه الرسمية داخل Docker Engine 29.8.0، وتشغيل النسخ على Linux وWindows 11 وChrome 157، ومراجعة رسوم المتاجر من صفحاتها الرسمية في 12 نوفمبر 2026.