Ryujinx الأدلة واستكشاف الأخطاء

حلول عملية خطوة بخطوة للإعداد والأخطاء الشائعة وأفضل الممارسات.

تثبيت مفاتيح المنتج والبرنامج الثابت

  1. Dump prod.keys وtitle.keys from a Nintendo Switch you own using homebrew tools.
  2. Open Ryujinx, go to File, then Open Ryujinx Folder, وcopy keys into the system folder.
  3. أو استخدم Tools أو Actions ثم Install الرئيسيةs إن وفرته نسختك.
  4. ثبّت البرنامج الثابت عبر Tools → Install Firmware واختر ZIP أو مجلداً أو XCI.
  5. Restart the emulator when prompted. Outdated keys cause RYU-0003 firmware parsing errors.

إضافة مجلدات الألعاب

  1. افتح Options → Settings → Game Directories.
  2. انقر Add واختر المجلد الذي يحتوي .nsp أو .xci أو .nca.
  3. انقر Apply وOK. تُعاد فحص المكتبة تلقائياً.
  4. إن لم تظهر ألعاب، تأكد من المفاتيح وإمكانية قراءة المسارات.

اختيار واجهة الرسومات المناسبة

Open Options, Settings, Graphics. Try Vulkan first on modern GPUs. Switch to OpenGL if you see Vulkan initialization failures or missing vulkan-1.dll errors. macOS builds use Metal. Update GPU drivers before testing.

شاشة سوداء مع صوت (NVIDIA)

عطّل أدوات التراكب غير المتوافقة، امسح ذاكرة التظليل وتأكد من تثبيت البرنامج الثابت.

تحسين FPS وتقليل التقطعات

  • فعّل التجميع غير المتزامن للتظليل في إعدادات الرسومات.
  • دع PPTC يُبنى عند الإطلاق الأول؛ لا تحذف مجلدات التخزين أثناء الجلسة.
  • خفّض تكبير الدقة عند حد GPU؛ أغلق التطبيقات الخلفية عند حد CPU.
  • Use Vulkan on Steam Deck Linux builds for best results.
  • أبقِ 8 غيغابايت الذاكرة على الأقل؛ يُوصى بـ 16 غيغابايت.

إعداد أجهزة التحكم

  1. Options → Settings → Input، اختر Player 1.
  2. Pick your device: Xbox, DualSense, Pro Controller, or keyboard.
  3. عيّن الأزرار واحفظ واختبر في اللعبة. ألغِ الربط عبر clear في الواجهة.

تثبيت التعديلات وDLC

Right-click a title or use the manager to install NSP updates وDLC. Place RomFS or Exefs mods in the mod folder path shown in settings. Enable cheats from the per-game menu when supported.

شرح تحذيرات مضاد الفيروسات

Heuristic scanners flag unknown emulators. Verify SHA-256 hashes, download from trusted release pages only, وavoid repacks. If you quarantined a good build, restore it after hash confirmation وadd a folder exclusion.

مرجع سريع للمشاكل الشائعة

المحاكي لا يفتح على Windows

Install the latest .NET Desktop Runtime when prompted. Run from a normal user folder, not Program Files.

مفاتيح مفقودة أو أخطاء مجمع

Refresh prod.keys وtitle.keys from your console dump. Reinstall game updates if NCA verification fails.

اللعبة عالقة عند 30 FPS

بعض الألعاب تحدّ معدل الإطارات بالتصميم. استخدم VSync وحد الإطارات؛ ألغِ الحد فقط إن دعمت اللعبة ذلك.

تعطل بعد التحديث

امسح ذاكرة التظليل وPPTC لذلك العنوان وأعد البناء. تأكد من تطابق البرنامج الثابت.

أفضل الممارسات

  • انسخ احتياطياً للحفظ قبل التحديثات الكبرى.
  • Keep GPU drivers وRyujinx builds current.
  • استخدم Canary فقط إن قبلت تراجعات عرضية.
  • اقرأ ملاحظات كل لعبة في قوائم التوافق قبل جلسات طويلة.
تنزيل