الأخطاء — رموز الخطأ وطريقة إصلاحها

كلّ خطأ في محرك أقلامنا له رمز ثابت (مثل E101) ورسالة عربية. هذا المرجع يشرح كلّ رمز: ما سببه، وكيف تصلحه.

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

أخطاء التحليل — الأخطاء التركيبية

هذه الأخطاء تظهر قبل أن تعمل القصة. سببها خطأ في كتابة الرموز.

E101 — مقطع غير موجود

الرسالة: لا يوجد مقطع بهذا الاسم: {name}

السبب: أحلتَ إلى مقطع (-> اسم) لكن هذا المقطع غير موجود في الملف.

مثال الخطأ:

=== البداية ===

-> القصر

لا يوجد === القصر === في الملف.

الحل: تأكد أن اسم المقطع مكتوب بشكل مطابق. تذكر أن التشكيل يُنزع تلقائيًا.

E102 — اسم مقطع مكرر

الرسالة: اسم المقطع مكرّر: {name}

السبب: عرّفت مقطعين أو أكثر بنفس الاسم.

مثال الخطأ:

=== الغابة ===
الأشجار كثيفة.

=== الغابة ===
نفس الاسم مرة أخرى.

الحل: غيّر اسم أحد المقاطع. كل مقطع يحتاج اسمًا فريدًا.

E103 — ترويسة مقطع غير مغلقة

الرسالة: ترويسة المقطع غير مغلقة؛ أضف === في نهاية السطر.

السبب: بدأت سطرًا بـ === لكن لم تغلقه بـ ===.

مثال الخطأ:

=== البداية

الحل: أضف === في نهاية السطر:

=== البداية ===

E104 — خيار خارج أي مقطع

الرسالة: خيار خارج أيّ مقطع؛ ابدأ مقطعًا بـ === قبل كتابة الخيارات.

السبب: كتبت * أو + قبل أن تفتح مقطعًا بـ ===.

مثال الخطأ:

* [افتح الباب]
  -> الممر

الحل: افتح مقطعًا أولاً:

=== البداية ===

* [افتح الباب]
  -> تابع

E105 — شرط غير مكتمل

الرسالة: شرط غير مكتمل؛ القوس { لم يُغلق.

السبب: فتحت { لكن لم تغلقه بـ }.

مثال الخطأ:

{نقاط > ٥: أحسنت!

الحل: أضف } في نهاية الشرط:

{نقاط > ٥: أحسنت!}

E106 — لا توجد صورة بهذا الاسم

الرسالة: لا توجد صورة بهذا الاسم: {name}

السبب: كتبتَ صورة: الاسم داخل مقطع، لكنّك لم تُصرّح عن صورة بهذا الاسم في أعلى الملف.

مثال الخطأ:

=== البداية ===

صورة: بوابة_المدينة

وقفت أمام البوابة.

الحل: صرّح عن الصورة قبل المقاطع، بالاسم نفسه:

صورة بوابة_المدينة = "بوابة حجرية قديمة عند غروب الشمس"

=== البداية ===

صورة: بوابة_المدينة

وقفت أمام البوابة.

E107 — اسم الصورة مكرّر

الرسالة: اسم الصورة مكرّر: {name}

السبب: صرّحتَ عن صورتين بالاسم نفسه. الاسم هو ما يربط الوصف بالمشهد، فلا يصحّ أن يشير إلى شيئين.

مثال الخطأ:

صورة خريطة = "خريطة صفراء قديمة"
صورة خريطة = "خريطة ممزّقة الأطراف"

الحل: أعطِ كلّ صورة اسمًا خاصًّا بها:

صورة خريطة = "خريطة صفراء قديمة"
صورة خريطة_ممزقة = "خريطة ممزّقة الأطراف"

=== البداية ===

صورة: خريطة

وجدت الخريطة على الأرض.

E108 — تصريح الصورة بلا وصف

الرسالة: تصريح الصورة يحتاج وصفًا بين علامتَي اقتباس.

السبب: تصريح الصورة ناقص: ينقصه الاسم أو علامة = أو الوصف بين علامتَي اقتباس.

مثال الخطأ:

صورة بوابة_المدينة =

الحل: اكتب التصريح كاملًا — اسم، ثمّ =، ثمّ وصف بين علامتَي اقتباس:

صورة بوابة_المدينة = "بوابة حجرية قديمة عند غروب الشمس"

=== البداية ===

صورة: بوابة_المدينة

وقفت أمام البوابة.

أخطاء التجميع — أخطاء المعنى

هذه الأخطاء تظهر بعد التحليل. سببها مشكلة في المنطق أو المتغيرات.

E201 — تعبير غير مدعوم في الإسناد

الرسالة: تعبير غير مدعوم في الإسناد: {expr}. المدعوم: رقم أو نصّ أو صح/خطأ أو قيمة من قائمة.

السبب: حاولت إسناد قيمة معقدة إلى متغير.

مثال الخطأ:

متغير س = ٠
~ س = ص + ع

الحل: استخدم قيمة بسيطة:

متغير س = ٠
~ س = ٥

E202 — متغير غير معرف

الرسالة: متغير غير معرّف: {name}. أعلنه بـ متغير قبل استخدامه.

السبب: استخدمت متغيرًا لم تعلن عنه بـ متغير.

مثال الخطأ:

=== البداية ===

لديك {نقاط} نقطة.

الحل: أضف تعريف المتغير قبل المقاطع:

متغير نقاط = ٠

=== البداية ===

لديك {نقاط} نقطة.

E203 — نوع غير متطابق

الرسالة: نوع غير متطابق: المتغير {name} نوعه {expected}، والقيمة المسندة {got}.

السبب: حاولت إسناد قيمة من نوع مختلف عن النوع الذي عرّفت به المتغير.

مثال الخطأ:

متغير نقاط = ٠
~ نقاط = "كثير"

الحل: أسند قيمة من نفس النوع:

متغير نقاط = ٠
~ نقاط = ١٠

ملخص سريع