Panduan skin buatan sendiri

Selamat datang di Panduan Pembuatan Skin Manic EMU! 🎮 Sistem skin emulator ini dibangun di atas kerangka DeltaSkin, jadi sepenuhnya kompatibel dengan format dasar DeltaSkin. Jika ingin mempelajari dasar DeltaSkin dulu, kami sarankan tutorial resmi. Jika mendesain di Figma, lihat RetroSkinner. Alat itu membantu mengubah desain Figma langsung menjadi berkas skin.

Tunggu dulu—Manic EMU punya fitur yang lebih keren! ✨ Misalnya animasi tekan, penskalaan bebas, pembalikan layar, dan lainnya. Mari masuk ke cara memakai fitur eksklusif ini:

📁 Panduan konfigurasi info.json

Pengidentifikasi jenis game (`gameTypeIdentifier`)

Manic EMU memakai pengidentifikasi jenis game yang independen:

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

💡 Tips: agar kompatibel dengan Delta dan Manic EMU, pakai langsung pengidentifikasi DeltaSkin—sistem akan mengonversi otomatis.

Selain itu, karena beberapa platform bisa memakai kontroler yang kompatibel, kamu bisa mencampur skin platform tertentu di Manic EMU:

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

Pengidentifikasi unik skin (`identifier`)

Berikan pengidentifikasi yang unik secara global pada skin-mu. Nama ganda bisa menyebabkan gagal memuat atau masalah cache.

🎮 Menerapkan animasi tekan

Ingin umpan balik tombol yang dinamis? Cukup dua langkah:

Pisahkan layer: pisahkan latar dan latar depan tombol (lihat Templat Skin 3DS)
Konfigurasi JSON: tambahkan field asset pada tombol di info.json

Contoh: menambah efek tekan pada tombol A

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

🎚️ Penerapan tombol Switch beranimasi

Mengaktifkan fungsi toggle dengan state yang bertahan. Untuk referensi visual, lihat skin default Atari 2600.

Contoh

{
    "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
}

Objek animation baru telah ditambahkan (saat ini hanya didukung untuk Switch Button). animation:

type menentukan jenis kurva animasi. Saat ini hanya spring yang didukung.
begin menentukan frame sebelum animasi mulai.
end menentukan frame saat animasi selesai.

Catatan: koordinat di dalam begin dan end relatif terhadap frame induknya.

asset: Selain aset normal, aset selected telah ditambahkan. Ini memungkinkan kontrol menampilkan sumber daya yang sesuai saat berada di state selected (saat ini hanya didukung untuk Switch Button).

inputs: Isinya konsisten dengan kontrol lain, tetapi di sini hanya string yang bisa dilewatkan. Bisa dipahami sebagai fungsi yang terikat ke Switch Button. Ini bisa berupa perintah operasi standar, seperti a, b, up, down…, atau Tombol Fungsi Kustom yang dibahas di bagian berikutnya.

Catatan: beberapa tombol fungsi kustom mendukung pengikatan state. Misalnya, jika inputs disetel ke volume (kontrol senyap), sistem akan menanyakan state volume setiap kali skin dimuat dan memperbarui Switch Button yang terikat ke state yang sesuai. Lihat efek tvType di skin default Atari 2600 sebagai contoh.

Tombol Fungsi Kustom yang mendukung pengikatan state meliputi:

reverseScreens
volume
toggleControlls
toggleAnalog
tvType
leftDifficulty
rightDifficulty

selfRetracting: Menunjukkan apakah Switch Button akan mereset otomatis. Lihat tombol reset game di Atari 2600, yang memantul setelah ditekan, mensimulasikan efek sakelar momen.

⚙️ Tombol fungsi kustom

Manic EMU mendukung banyak aksi pintasan (periksa persyaratan versi):

Didukung di v1.2.3 dan di atasnya:

flex: masuk ke pengaturan tata letak skin

Ditambah di v1.2.4 dan di atasnya:

quickSave: save manual cepat
quickLoad: load manual cepat
fastForward: tahan untuk percepat maksimum
toggleFastForward: ketuk untuk memutar laju kecepatan
reverseScreens: tukar layar utama/sekunder
volume: kontrol senyap
saveStates: buka daftar save state
cheatCodes: buka daftar kode cheat
skins: buka daftar skin
filters: buka daftar filter
screenshot: ambil tangkapan layar
haptics: atur umpan balik getar
controllers: buka daftar kontroler
orientation: ubah pengaturan rotasi
functionLayout: masuk ke konfigurasi tata letak
restart: reset game
resolution: atur resolusi game
quit: keluar dari game
amiibo：muat Amiibo untuk 3DS
homeMenu：kembali ke Home Menu 3DS

Ditambah di v1.4.2 dan di atasnya：

toggleControlls：sembunyikan/tampilkan kontrol
blowing：simulasikan tiupan ke mikrofon
palette：palet untuk GB GBC VB

Ditambah di v1.5.0 dan di atasnya：

swapDisk：ganti ke disc berikutnya atau ganti sisi untuk FDS

Ditambah di v1.5.5 dan di atasnya：

shake：simulasi goyangan

Ditambah di v1.6.0 dan di atasnya：

toggleAnalog：ganti mode perangkat input, seperti ke PlayStation Controller atau DualShock di PS1.

Ditambah di v1.7.0 dan di atasnya：

retroAchievements：buka halaman RetroAchievements.

Baru di v1.7.1 dan di atasnya:

fastForward2x: tahan untuk percepat 2×
fastForward3x: tahan untuk percepat 3×
fastForward4x: tahan untuk percepat 4×
airPlayScaling: atur bagaimana layar game diskalakan saat AirPlay
airPlayLayout: pilih bagaimana game multi-layar (seperti NDS) disusun saat AirPlay

Baru di v1.7.2 dan di atasnya:

gameplayManuals：buka Gameplay Manuals

Baru di v1.7.3 dan di atasnya:

triggerPro：ganti konfigurasi TriggerPro

Baru di v1.8.3 dan di atasnya:

tvType: ganti antara mode warna dan hitam-putih untuk Atari 2600.
leftDifficulty: sakelar kesulitan kiri untuk Atari 2600.
rightDifficulty: sakelar kesulitan kanan untuk Atari 2600.

Baru di v1.9.0 dan di atasnya：

screenScaling：ganti mode rentangan layar
j2meSettings：buka halaman pengaturan J2ME
dosSettings：buka halaman pengaturan core untuk DOS
insertDisc：masukkan disc

Baru di v2.0.0 dan di atasnya：

coreSettings：buka pengaturan core
rewind：tahan untuk rewind

Contoh: menambah tombol Restart

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

⚠️ Pengingat penting Jangan tetapkan beberapa fungsi ke satu tombol. Misalnya:

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

🎵 Efek suara

Mulai V1.9.0, Manic EMU mendukung efek suara untuk tombol skin. Kamu bisa mengonversi berkas audio ke format CAF, mengganti namanya menjadi sound.caf, dan menempatkannya di direktori root skin sebelum mengemas semuanya.

📦 Panduan pengemasan skin

Kemas skin-mu dalam tiga langkah:

Letakkan semua aset datar (tanpa folder induk)
Pilih semua berkas dan kompres menjadi berkas ZIP tidak terenkripsi
Pilih ekstensi yang kamu suka: .manicskin atau .deltaskin

Kami sarankan memakai templat resmi kami untuk memastikan strukturnya benar.

🎨 Unduhan skin resmi

ManicEMUSkins

Mulai desain skin unikmu sekarang! 🎨