شرح قائمة توافق ألعاب shadPS4 وطريقة إرسال تقارير الألعاب

<header class="shad-header">

    <div class="shad-header-icon">PS4</div>

    <h2><div class="separator" style="clear: both; text-align: center;"><a href="https://blogger.googleusercontent.com/img/a/AVvXsEhpNvqPjc2CCs09CXeYwhWhesmDqNEAr9Bh88CJrTUp7aw7kNR3fr-ulMsmITA1PGkswjn5dl-Y51oWLKL65a7Du68B4xFxdIrcEHku87AuBmk72P3PWEjcjOTxh9uUhRyw3E4M1OKfYqkj2YTi9TMceyaowrvPwmBzCx_hbuymdU74qXVkSONvPiKEZT8" style="margin-left: 1em; margin-right: 1em;"><img alt="" data-original-height="63" data-original-width="259" height="78" src="https://blogger.googleusercontent.com/img/a/AVvXsEhpNvqPjc2CCs09CXeYwhWhesmDqNEAr9Bh88CJrTUp7aw7kNR3fr-ulMsmITA1PGkswjn5dl-Y51oWLKL65a7Du68B4xFxdIrcEHku87AuBmk72P3PWEjcjOTxh9uUhRyw3E4M1OKfYqkj2YTi9TMceyaowrvPwmBzCx_hbuymdU74qXVkSONvPiKEZT8" width="320" /></a></div></h2>

    <div class="warning-box">
        قائمة التوافق ليست قسمًا للدعم الفني أو النقاش العام. هي مخصصة لتقارير
        الاختبار الموثقة باستخدام إصدار رئيسي من المحاكي ونسخة لعبة قانونية
        غير معدلة.
    </div>

</header>

<section class="section-card">

    <h3>ما هي قائمة توافق shadPS4؟</h3>

    <p>
        قائمة التوافق الرسمية هي مستودع على GitHub يجمع تقارير المستخدمين
        والمطورين عن حالة الألعاب عند تشغيلها على محاكي shadPS4.
    </p>

    <p>
        يساعد كل تقرير الفريق في تحديد ما إذا كانت اللعبة تعمل بالكامل،
        أو تدخل إلى اللعب مع مشاكل، أو تتوقف عند القوائم، أو تفشل قبل الإقلاع.
    </p>

    <div class="note-box">
        وجود لعبة في القائمة لا يعني أنها تعمل بالسرعة الكاملة أو دون أخطاء.
        يجب قراءة التصنيف والتعليقات والسجل المرفق بالتقرير.
    </div>

</section>

<section class="section-card">

    <h3>شرح حالات توافق الألعاب</h3>

    <div class="status-grid">

        <div class="status-card status-playable">
            <strong>status-playable</strong>

            <p>
                اللعبة قابلة للعب دون مشكلة كبيرة تمنع التقدم أو إكمالها.
            </p>
        </div>

        <div class="status-card status-ingame">
            <strong>status-ingame</strong>

            <p>
                تصل اللعبة إلى أسلوب اللعب، لكنها تعاني مشاكل جوهرية قد تمنع
                التقدم أو تجعل التجربة غير مستقرة.
            </p>
        </div>

        <div class="status-card status-menus">
            <strong>status-menus</strong>

            <p>
                تصل اللعبة إلى القوائم، لكنها تتجمد أو تنهار عند محاولة بدء
                اللعب أو الانتقال إلى المرحلة التالية.
            </p>
        </div>

        <div class="status-card status-boots">
            <strong>status-boots</strong>

            <p>
                تعرض اللعبة صورة أو صوتًا، لكنها تنهار أو تتجمد قبل الوصول
                إلى القائمة الرئيسية.
            </p>
        </div>

        <div class="status-card status-nothing">
            <strong>status-nothing</strong>

            <p>
                تنهار اللعبة عند التشغيل أو تتوقف على شاشة سوداء دون إخراج
                مرئي أو صوتي مفيد.
            </p>
        </div>

    </div>

    <div class="warning-box">
        الأعطال، والتجمد، وتلف الخامات، وانفجار المجسمات، ومشاكل الصوت
        الأساسية قد تجعل اللعبة ضمن تصنيف <code>status-ingame</code>
        حتى لو أمكن الوصول إلى أسلوب اللعب.
    </div>

</section>

<section class="section-card">

    <h3>المعلومات المطلوبة في كل تقرير</h3>

    <p>
        يجب أن يحتوي تقرير اللعبة على المعلومات الأساسية التالية:
    </p>

    <ul class="clean-list required-list">
        <li><b>اسم اللعبة</b> كاملًا.</li>
        <li><b>Game ID</b> أو رقم <code>CUSA</code>.</li>
        <li><b>إصدار اللعبة</b> الذي جرى اختباره.</li>
        <li><b>إصدار محاكي shadPS4</b>.</li>
        <li><b>حالة التوافق</b> المناسبة.</li>
        <li><b>نظام التشغيل</b>: Windows أو Linux أو macOS.</li>
        <li><b>سجل المحاكي</b> دون تعديل.</li>
        <li><b>صور للمشكلة</b> عند الحاجة.</li>
        <li><b>وصف واضح</b> لما حدث أثناء الاختبار.</li>
    </ul>

    <div class="report-template">Title: Game Name

Game ID: CUSA00000 Game Version: 1.00 Emulator Version: shadPS4 v0.16.0 Compatibility Status: status-ingame Operating System: Windows 11 Description: The game reaches gameplay but crashes when loading the second stage.

Attachments:

shad_log.txt
Screenshot.png

  <h3>استخدم الإصدارات الرئيسية فقط</h3>

  <p>
      تقبل القائمة تقارير الألعاب المبنية على الإصدارات الرئيسية الرسمية
      من shadPS4، مثل:
  </p>

  <div class="report-template">shadPS4 v0.16.0</div>

  <p>
      لا ينبغي إرسال تقرير توافق مبني على Build تجريبي عشوائي أو Commit
      يومي، لأن نتائجه قد تتغير بسرعة ولا تمثل الإصدار الرئيسي للمحاكي.
  </p>

  <div class="note-box">
      الهدف هو جعل نتائج القائمة قابلة للمقارنة وإعادة الاختبار على نفس
      الإصدار الذي يستخدمه بقية المستخدمين.
  </div>

  <h3>لا ترسل تقريرًا مكررًا للعبة نفسها</h3>

  <p>
      يجب إرسال تقرير واحد فقط لكل رقم <code>CUSA</code> ونظام تشغيل.
  </p>

  <h4>متى يُسمح بوجود أكثر من تقرير؟</h4>

  <ul class="clean-list safe-list">
      <li>
          إذا كان نظام التشغيل مختلفًا، فيمكن وجود تقرير منفصل لكل من
          Windows وLinux وmacOS.
      </li>

      <li>
          إذا كانت اللعبة تملك أرقام CUSA مختلفة حسب المنطقة أو الإصدار،
          فيمكن إرسال تقرير لكل رقم.
      </li>
  </ul>

  <h4>ماذا أفعل إذا كان التقرير موجودًا؟</h4>

  <p>
      لا تفتح Issue جديدًا. أضف تعليقًا إلى التقرير القديم يتضمن:
  </p>

  <ul class="clean-list">
      <li>الإصدار الرئيسي الجديد من shadPS4.</li>
      <li>الحالة الجديدة للعبة.</li>
      <li>وصف التغيير أو المشكلة.</li>
      <li>صورًا جديدة عند الحاجة.</li>
      <li>ملف Log جديدًا وكاملًا.</li>
  </ul>

  <div class="warning-box">
      عند تحديث تقريرك لا تعدّل المنشور الأصلي. أضف تعليقًا جديدًا حتى يكون
      سجل تغير توافق اللعبة واضحًا بين إصدارات المحاكي.
  </div>

  <h3>يجب استخدام نسخة لعبة غير معدلة</h3>

  <p>
      يقبل المستودع التقارير المبنية على نسخ ألعاب سليمة وغير معدلة فقط.
  </p>

  <ul class="clean-list danger-list">
      <li>لا تستخدم Patches تغير سلوك اللعبة.</li>
      <li>لا تستخدم Mods أثناء اختبار التوافق.</li>
      <li>لا تستخدم ملفات لعبة معاد تجميعها.</li>
      <li>لا تحول النسخة إلى <code>FPKG</code> ثم ترسل تقريرًا رسميًا.</li>
      <li>لا تستخدم أي نسخة مقرصنة أو مجهولة المصدر.</li>
  </ul>

  <div class="danger-box">
      القرصنة ممنوعة بالكامل. التقارير المرتبطة بنسخ مقرصنة ستُحذف، وقد
      يُحظر صاحبها من مستودع shadPS4.
  </div>

  <h3>لا تغير الإعدادات المؤثرة في سلوك اللعبة</h3>

  <p>
      بعض الإعدادات تغير طريقة تشغيل اللعبة، ولذلك لا تصلح نتائجها لتحديد
      حالة التوافق الرسمية.
  </p>

  <h4>إعدادات تؤدي إلى رفض التقرير</h4>

  <ul class="clean-list danger-list">
      <li><code>Enable PS4 Neo Mode</code></li>
      <li><code>Enable Devkit Console Mode</code></li>
      <li>تعديل <code>Vblank Frequency</code></li>
  </ul>

  <h4>إعدادات تجريبية مسموحة</h4>

  <ul class="clean-list safe-list">
      <li><code>Readbacks</code></li>
      <li><code>Readback Linear Images</code></li>
      <li><code>Direct Memory Access</code></li>
  </ul>

  <div class="note-box">
      التقارير التي تستخدم الإعدادات التجريبية المسموحة قد تحصل على تصنيف
      <code>experimental</code> لتسهيل تمييزها عن نتائج الإعدادات الافتراضية.
  </div>

  <h3>لا تعدّل ملف Log قبل رفعه</h3>

  <p>
      يجب رفع سجل shadPS4 كما أنشأه المحاكي دون حذف الأسطر المتكررة أو
      اختصار المحتوى يدويًا.
  </p>

  <ul class="clean-list">
      <li>لا تحذف الأسطر المتكررة.</li>
      <li>لا تنسخ آخر جزء من السجل فقط.</li>
      <li>لا تعدّل رسائل الخطأ.</li>
      <li>لا تستبدل أسماء الملفات داخل السجل.</li>
      <li>لا تحول السجل إلى صورة.</li>
  </ul>

  <div class="warning-box">
      إذا تجاوز السجل <span class="ltr-value">100 MB</span> ولم يظهر
      Crash Assert بسببه، يسمح باستخدام Log Filter، لكن يجب توضيح ذلك
      داخل التقرير.
  </div>

  <h3>التعليقات ليست للدعم الفني</h3>

  <p>
      قسم التعليقات في تقارير التوافق ليس مكانًا لطرح الأسئلة أو طلب حلول
      إعدادات اللعبة.
  </p>

  <ul class="clean-list danger-list">
      <li>لا تسأل عن طريقة تشغيل اللعبة.</li>
      <li>لا تطلب إعدادات لزيادة الفريمات.</li>
      <li>لا ترسل تعليقًا مثل: اللعبة لا تعمل عندي.</li>
      <li>لا تحول التقرير إلى نقاش عام.</li>
  </ul>

  <p>
      استخدم التعليقات فقط عند اختبار اللعبة على إصدار رئيسي جديد، وأرفق
      سجلًا جديدًا يثبت النتيجة.
  </p>

  <h3>ملفات نظام PS4 المطلوبة</h3>

  <p>
      يستطيع shadPS4 تحميل بعض مكتبات نظام PlayStation 4. ويجب استخراجها
      من جهاز PS4 تملكه بصورة قانونية ثم وضعها داخل المجلد:
  </p>

  <div class="report-template">shadPS4/sys_modules/</div>

  <div class="module-grid">
      <div class="module-name">libSceAudiodec.sprx</div>
      <div class="module-name">libSceCesCs.sprx</div>
      <div class="module-name">libSceFont.sprx</div>
      <div class="module-name">libSceFontFt.sprx</div>
      <div class="module-name">libSceFreeTypeOt.sprx</div>
      <div class="module-name">libSceJpegDec.sprx</div>
      <div class="module-name">libSceJpegEnc.sprx</div>
      <div class="module-name">libSceJson.sprx</div>
      <div class="module-name">libSceJson2.sprx</div>
      <div class="module-name">libSceLibcInternal.sprx</div>
      <div class="module-name">libSceNgs2.sprx</div>
      <div class="module-name">libScePngEnc.sprx</div>
      <div class="module-name">libSceRtc.sprx</div>
      <div class="module-name">libSceSystemGesture.sprx</div>
      <div class="module-name">libSceUlt.sprx</div>
  </div>

  <div class="danger-box">
      هذه الملفات محمية بحقوق النشر، ولا ينبغي تحميلها من مواقع خارجية.
      استخرجها من جهاز PlayStation 4 الذي تملكه قانونيًا.
  </div>

  <div class="note-box">
      غياب المكتبات المطلوبة قد يؤدي إلى انهيار اللعبة أو فقدان الصوت
      أو فشل عرض الخطوط، وبالتالي قد تصبح نتيجة اختبار التوافق غير صحيحة.
  </div>

  <h3>خطوات إرسال تقرير صحيح</h3>

  <ol class="clean-list required-list">
      <li>حدّث shadPS4 إلى أحدث إصدار رئيسي.</li>
      <li>استخدم نسخة لعبة قانونية وغير معدلة.</li>
      <li>ثبت ملفات النظام المطلوبة داخل <code>sys_modules</code>.</li>
      <li>أعد إعدادات المحاكي المؤثرة إلى الوضع الافتراضي.</li>
      <li>شغّل اللعبة وحدد المرحلة التي تصل إليها.</li>
      <li>أغلق المحاكي بعد ظهور المشكلة.</li>
      <li>احتفظ بملف Log كامل دون تعديل.</li>
      <li>ابحث عن رقم CUSA في مستودع التوافق.</li>
      <li>حدّث التقرير القديم أو افتح تقريرًا جديدًا عند عدم وجوده.</li>
      <li>أرفق المعلومات والصور والسجل المطلوب.</li>
  </ol>

  <h3>الخلاصة</h3>

  <p>
      قائمة توافق shadPS4 ليست مجرد قائمة توضح الألعاب التي تعمل؛ بل قاعدة
      اختبار تساعد المطورين على مقارنة سلوك الألعاب بين الإصدارات والأنظمة.
  </p>

  <ul class="clean-list">
      <li>استخدم إصدارًا رئيسيًا رسميًا فقط.</li>
      <li>لا ترسل نسخ ألعاب معدلة أو مقرصنة.</li>
      <li>لا تغير الإعدادات التي تؤثر في سلوك اللعبة.</li>
      <li>ارفع السجل كاملًا دون تعديل.</li>
      <li>لا تكرر تقرير CUSA نفسه على النظام نفسه.</li>
      <li>استخدم التعليقات لتحديث النتائج فقط.</li>
      <li>استخرج ملفات النظام من جهاز PS4 الذي تملكه.</li>
  </ul>

  <h3>الروابط الرسمية</h3>

  <ul class="clean-list">

      <li>
          <a href="https://github.com/shadps4-compatibility/shadps4-game-compatibility" rel="noopener noreferrer" target="_blank">
              مستودع توافق ألعاب shadPS4 الرسمي
          </a>
      </li>

      <li>
          <a href="https://shadps4.net/compatibility/" rel="noopener noreferrer" target="_blank">
              قائمة توافق الألعاب على موقع shadPS4
          </a>
      </li>

      <li>
          <a href="https://github.com/shadps4-emu/shadPS4" rel="noopener noreferrer" target="_blank">
              مستودع محاكي shadPS4 الرسمي
          </a>
      </li>

      <li>
          <a href="https://github.com/shadps4-emu/shadPS4/wiki" rel="noopener noreferrer" target="_blank">
              موسوعة shadPS4 الرسمية</a></li></ul></section>