عن المشروع

Dungeon هي لعبة تقمّص أدوار نصية محلية فردية تُقدَّم من تطبيق Node.js. تتطلب Node.js الإصدار 22.13 أو أحدث ولا تحتاج إلى تثبيت حزم؛ بعد نسخ .env.example إلى .env وتعبئة مفتاح مزوّد، يعمل الأمر npm start على تشغيل اللعبة على http://127.0.0.1:4317. يمكن ضبط الواجهة ونص الحملة بشكل مستقل على الإنجليزية أو الروسية. يبدأ اللاعبون حملة جديدة من قوالب مغامرات مدمجة أو مخصصة، مع محتوى منفصل للإعداد والسيناريو والشخصية ومحتوى سري اختياري خاص بمدير اللعبة فقط. تُخزَّن القوالب المخصصة في data/adventure-templates.json، ويمكن تعديلها أو نسخها دون كشف التعليمات المخفية، كما يمكن إعادة ضبط القوالب المدمجة. يستطيع عارض الاختبار كشف أسرار مدير اللعبة المُعدّة وحقائق العالم الخفية المثبتة فقط بعد تأكيد كشف الأحداث، دون تغيير الحملة. يتوفر إعداد النماذج عبر صفحة الإعدادات. وهو يدعم الاتصال بالمزوّدين Gemini وOpenRouter وOpenAI وAnthropic وDeepSeek وxAI، ومعرّفات نماذج مخصصة، وقوائم نماذج تُجلب من واجهات برمجة التطبيقات الرسمية للمزوّدين دون استدلال مدفوع؛ وتُخزَّن القوائم مؤقتًا لمدة ساعة. النموذج الافتراضي المطلوب هو Gemini gemini-3.8-flash. يتيح مفتاح Artificial Analysis API اختياريًا مراجع الأسعار، ويُخزَّن مؤقتًا لمدة ست ساعات، مع الرجوع إلى OpenRouter عند الحاجة. تشترك جميع استدعاءات النماذج في سجل إنفاق محلي، ويقدّر التطبيق الإنفاق المحلي فقط بدلًا من أن يكون فاتورة مزوّد على مستوى الحساب. يستخدم أسلوب اللعب شخصية لاعب واحدة. يبتكر مدير اللعبة التفاصيل ضمن الإعداد والتاريخ المثبت. تعرض الاختبارات ذات المغزى الصعوبة الأساسية والمعدِّلات الموسومة والمجموع قبل التقييد وفرصة النجاح ونتيجة d100 حقيقية؛ أما الأفعال التي تبلغ فرصتها المحسوبة 0 أو 100 بالمئة فتكون مضمونة ولا تستخدم نردًا. يمكن للاعبين طرح أسئلة خارج اللعبة، والاعتراض على الأحكام أو طلب التصحيحات/التراجع، وفحص معرفة الشخصية والعالم الموثقة المصدر، والبحث في اليوميات. الحفظ وإعادة التحميل تلقائيان. تُخزَّن بيانات الحملة في data/campaigns.sqlite، والإنفاق في data/spend-ledger.json، ونتائج المزوّد الخاصة في data/provider-results. يتضمن المستودع تحقق npm test وnpm run check باستخدام مزوّدين وهميين، مع اختبارات متصفح Playwright اختيارية عند ضبط DUNGEON_PLAYWRIGHT_PATH. تصف الوثائق قواعد التجربة ونتائج اختبار اللعب. وتنص على أن المشكلة الصعبة المتبقية هي الحكم الدلالي، ولا تضمن سلوك مدير لعب مثاليًا أو جودة لعب من المزوّد.