دليل صنع السكنات

مرحباً في دليل إنشاء سكنات Manic EMU! 🎮 نظام السكنات في هذا المحاكي مبني على إطار DeltaSkin، ومتوافق بالكامل مع صيغة DeltaSkin الأساسية. إن أردت تعلم أساسيات DeltaSkin أولاً، نوصي بمراجعة الدليل الرسمي. إن كنت تصمّم في Figma، اطّلع على RetroSkinner. يحوّل تصاميم Figma مباشرة إلى ملفات سكن.

لكن انتظر—يقدّم Manic EMU مزايا أروع! ✨ مثل حركات الضغط، والتحجيم الحر، وقلب الشاشة، والمزيد. لنغص في كيفية استخدام هذه المزايا الحصرية:

---

📁 دليل إعداد info.json

معرّف نوع اللعبة (gameTypeIdentifier)

يستخدم Manic EMU معرّفات نوع لعبة مستقلة:

• Wii: public.aoshuang.game.wii
• NGC: public.aoshuang.game.ngc
• Amiga: public.aoshuang.game.amiga
• C64: public.aoshuang.game.c64
• NGP: public.aoshuang.game.ngp
• PCE: public.aoshuang.game.pce
• Symbian: public.aoshuang.game.symbian
• DOS: public.aoshuang.game.dos
• J2ME: public.aoshuang.game.j2me
• DOOM: public.aoshuang.game.doom
• JAGUAR: public.aoshuang.game.jaguar
• LYNX: public.aoshuang.game.lynx
• 7800: public.aoshuang.game.7800
• 5200: public.aoshuang.game.5200
• 2600: public.aoshuang.game.2600
• Arcade: public.aoshuang.game.arcade
• DC: public.aoshuang.game.dc
• PS1: public.aoshuang.game.ps1
• PM: public.aoshuang.game.pm
• VB: public.aoshuang.game.vb
• N64: public.aoshuang.game.n64
• SS: public.aoshuang.game.ss
• MD: public.aoshuang.game.md
• MCD: public.aoshuang.game.mcd
• 32X: public.aoshuang.game.32x
• MS: public.aoshuang.game.ms
• GG: public.aoshuang.game.gg
• SG-1000: public.aoshuang.game.sg1000
• MD: public.aoshuang.game.md
• PSP: public.aoshuang.game.psp
• 3DS: public.aoshuang.game.3ds
• NDS: public.aoshuang.game.ds
• GBA: public.aoshuang.game.gba
• GBC: public.aoshuang.game.gbc
• GB: public.aoshuang.game.gb
• NES: public.aoshuang.game.nes
• SNES: public.aoshuang.game.snes

💡 نصيحة: لضمان التوافق مع Delta وManic EMU معاً، استخدم معرّفات DeltaSkin مباشرة—سيتولى النظام التحويل التلقائي.

كذلك، بما أن بعض المنصات يمكنها استخدام أذرع متوافقة، يمكنك خلط سكنات منصات معيّنة في Manic EMU:

• GB GBC
• MD MCD 32X
• MS GG SG-1000
• NES FDS
• DOS DOOM

المعرّف الفريد للسكن (identifier)

عيّن معرّفاً فريداً عالمياً لسكنك! الأسماء المكررة قد تسبب فشل التحميل أو مشاكل في الذاكرة المؤقتة.

---

🎮 تنفيذ حركات الضغط

تريد ردود أزرار متحركة؟ خطوتان فقط:

1. فصل الطبقات: افصل خلفيات الأزرار عن مقدّماتها (راجع قالب سكن 3DS)
2. إعداد JSON: أضف حقلاً asset إلى الزر في info.json

مثال: إضافة تأثير ضغط لزر A

{
    "asset": {
        "normal": "a_button.pdf"
        // Reserve for future state expansions
    },
    "frame": {
        "height": 48,
        "width": 48,
        "x": 545,
        "y": 552
    },
    "inputs": ["a"]
}

---

🎚️ تنفيذ زر تبديل متحرّك

يفعّل وظيفة تبديل مع بقاء الحالة. للمرجع البصري، راجع سكن Atari 2600 الافتراضي.

مثال

{
    "asset":
    {
        "normal": "fuction_button.pdf",
        "selected": "fuction_button.pdf"
    },
    "frame":
    {
        "height": 40,
        "width": 20,
        "x": 30,
        "y": 569
    },
    "animation":
    {
        "type": "spring",
        "begin":
        {
            "height": 20,
            "width": 20,
            "x": 0,
            "y": 2
        },
        "end":
        {
            "height": 20,
            "width": 20,
            "x": 0,
            "y": 18
        }
    },
    "inputs": "menu",
    "selfRetracting": true
}

أُضيف كائن animation جديد (مدعوم حالياً لـ Switch Button فقط). animation:

• type يحدّد نوع منحنى الحركة. حالياً spring فقط مدعوم.
• begin يحدّد الإطار قبل بدء الحركة.
• end يحدّد الإطار عند انتهاء الحركة.

ملاحظة: الإحداثيات داخل begin وend نسبية إلى frame الأب.

asset: إضافة إلى مورد normal، أُضيف مورد selected. يتيح للعنصر عرض مورداً موافقاً في حالة selected (مدعوم حالياً لـ Switch Button فقط).

inputs: المحتوى متسق مع عناصر التحكم الأخرى، لكن هنا تُمرَّر سلاسل نصية فقط. يمكن فهمه على أنه الوظيفة المرتبطة بـ Switch Button. قد يكون أمر إدخال قياسياً مثل a أو b أو up أو down… أو أزرار وظائف مخصّصة الواردة في القسم التالي.

ملاحظة: بعض أزرار الوظائف المخصّصة تدعم ربط الحالة. مثلاً، إن ضُبط inputs على volume (التحكم بالكتم)، يستعلم النظام عن حالة الصوت في كل تحميل للسكن ويحدّث Switch Button المرتبط إلى الحالة الموافقة. راجع تأثير tvType في سكن Atari 2600 الافتراضي كمثال.

أزرار الوظائف المخصّصة التي تدعم ربط الحالة:

• reverseScreens
• volume
• toggleControlls
• toggleAnalog
• tvType
• leftDifficulty
• rightDifficulty

selfRetracting: يشير إلى ما إذا كان Switch Button يعود تلقائياً. راجع زر إعادة ضبط اللعبة على Atari 2600، الذي يرتد بعد الضغط، محاكياً مفتاحاً لحظياً.

---

⚙️ أزرار وظائف مخصّصة

يدعم Manic EMU اختصارات واسعة (راجع متطلبات الإصدار):

مدعومة في v1.2.3 فما فوق:

• flex: دخول إعدادات تخطيط السكن

أُضيفت في v1.2.4 فما فوق:

• quickSave: حفظ يدوي سريع
• quickLoad: تحميل يدوي سريع
• fastForward: اضغط مطوّلاً لأقصى تسريع
• toggleFastForward: اضغط للتنقّل بين معدلات السرعة
• reverseScreens: تبديل الشاشة الأساسية والثانوية
• volume: التحكم بالكتم
• saveStates: فتح قائمة حفظ الحالات
• cheatCodes: فتح قائمة رموز الغش
• skins: فتح قائمة السكنات
• filters: فتح قائمة الفلاتر
• screenshot: التقاط لقطة شاشة
• haptics: ضبط ردود الاهتزاز
• controllers: فتح قائمة الأذرع
• orientation: تغيير إعدادات الدوران
• functionLayout: دخول إعداد التخطيط
• restart: إعادة ضبط اللعبة
• resolution: تعيين دقة اللعبة
• quit: الخروج من اللعبة
• amiibo：تحميل Amiibos لـ 3DS
• homeMenu：العودة إلى Home Menu في 3DS

أُضيفت في v1.4.2 فما فوق：

• toggleControlls：إخفاء/إظهار عناصر التحكم
• blowing：محاكاة النفخ في الميكروفون
• palette：لوحة ألوان لـ GB وGBC وVB

أُضيفت في v1.5.0 فما فوق：

• swapDisk：التبديل إلى القرص التالي أو تغيير الوجه لـ FDS

أُضيفت في v1.5.5 فما فوق：

• shake：محاكاة الاهتزاز

أُضيفت في v1.6.0 فما فوق：

• toggleAnalog：تبديل وضع جهاز الإدخال، مثل التحويل إلى PlayStation Controller أو DualShock على PS1.

أُضيفت في v1.7.0 فما فوق：

• retroAchievements：فتح صفحة RetroAchievements.

جديد في v1.7.1 فما فوق:

• fastForward2x: اضغط مطوّلاً للتسريع بسرعة 2x
• fastForward3x: اضغط مطوّلاً للتسريع بسرعة 3x
• fastForward4x: اضغط مطوّلاً للتسريع بسرعة 4x
• airPlayScaling: ضبط كيفية تحجيم شاشة اللعبة أثناء AirPlay
• airPlayLayout: اختيار كيفية ترتيب الألعاب متعددة الشاشات (مثل NDS) أثناء AirPlay

جديد في v1.7.2 فما فوق:

• gameplayManuals：فتح كتيّبات اللعب

جديد في v1.7.3 فما فوق:

• triggerPro：تبديل إعدادات triggerPro

جديد في v1.8.3 فما فوق:

• tvType: التبديل بين وضع الألوان والأبيض والأسود لـ Atari 2600.
• leftDifficulty: مفتاح صعوبة اليسار لـ Atari 2600.
• rightDifficulty: مفتاح صعوبة اليمين لـ Atari 2600.

جديد في v1.9.0 فما فوق：

• screenScaling：تبديل وضع تمديد الشاشة
• j2meSettings：فتح صفحة إعدادات J2ME
• dosSettings：فتح صفحة إعدادات النواة لـ DOS
• insertDisc：إدخال القرص

جديد في v2.0.0 فما فوق：

• coreSettings：فتح إعدادات النواة
• rewind：اضغط مطوّلاً للترجيع

مثال: إضافة زر إعادة تشغيل

{
    "asset": { "normal": "button.pdf" },
    "frame": { ... },
    "inputs": [ "restart" ]
}

⚠️ تذكير حاسم تجنّب تعيين عدة وظائف لزر واحد! مثلاً:

// ❌ Dangerous Example!
{
    "inputs": [ "restart", "quit" ]
}

---

🎵 المؤثرات الصوتية

بدءاً من V1.9.0، يدعم Manic EMU مؤثرات صوتية لأزرار السكن. يمكنك تحويل ملفات الصوت إلى صيغة CAF، وإعادة تسميتها sound.caf، ووضعها في المجلد الجذر للسكن قبل تجميع كل شيء معاً.

---

📦 دليل تجميع السكن

جمّع سكنك في ثلاث خطوات:

1. ضع كل الأصول مسطّحة (بدون مجلدات أب)
2. حدّد كل الملفات واضغطها في ملف ZIP غير مشفّر
3. اختر الامتداد المفضّل: .manicskin أو .deltaskin

نوصي باستخدام قوالبنا الرسمية لضمان بنية صحيحة.

---

🎨 تنزيلات السكنات الرسمية

• ManicEMUSkins

---

ابدأ تصميم سكنك الفريد الآن! 🎨