Poradnik własnych skórek

Witaj w poradniku tworzenia skórek Manic EMU. 🎮 System skórek tego emulatora opiera się na frameworku DeltaSkin i jest w pełni zgodny z jego bazowym formatem. Jeśli chcesz najpierw poznać podstawy DeltaSkin, polecamy oficjalny tutorial. Projektujesz w Figma? Zobacz nasz RetroSkinner. Zamienia projekty Figma bezpośrednio w pliki skórek.

Manic EMU idzie dalej. ✨ Animacje naciśnięć, swobodne skalowanie, odwracanie ekranów i więcej. Oto jak korzystać z tych ekskluzywnych funkcji:

📁 Przewodnik konfiguracji info.json

Identyfikator typu gry (`gameTypeIdentifier`)

Manic EMU używa niezależnych identyfikatorów typu gry:

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

💡 Wskazówka: żeby skórka działała i w Delta, i w Manic EMU, używaj identyfikatorów DeltaSkin — system sam zrobi konwersję.

Niektóre platformy mogą korzystać ze zgodnych padów, więc w Manic EMU możesz mieszać skórki:

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

Unikalny identyfikator skórki (`identifier`)

Nadaj skórce globalnie unikalny identyfikator. Duplikaty mogą zepsuć ładowanie albo cache.

🎮 Animacje naciśnięć

Chcesz dynamiczny feedback przycisków? Dwa kroki:

Rozdzielenie warstw: tło i pierwszy plan przycisku osobno (zobacz szablon skórki 3DS)
Konfiguracja JSON: dodaj pole asset do przycisku w info.json

Przykład: efekt naciśnięcia na przycisku A

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

🎚️ Animowany przycisk przełącznika

Włącza przełączanie ze zachowaniem stanu. Wizualnie: domyślna skórka Atari 2600.

Przykład

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

Dodano nowy obiekt animation (obecnie tylko dla Switch Button). animation:

type określa krzywą animacji. Obecnie obsługiwane jest tylko spring.
begin to ramka przed startem animacji.
end to ramka po zakończeniu animacji.

Uwaga: współrzędne w begin i end są względne wobec nadrzędnego frame.

asset: Oprócz zasobu normal dodano selected. Kontrolka może pokazać odpowiadający zasób w stanie selected (obecnie tylko dla Switch Button).

inputs: Treść jak w innych kontrolkach, ale tutaj można przekazać tylko string. To funkcja przypisana do Switch Button. Może to być standardowe polecenie, np. a, b, up, down…, albo własne przyciski funkcji z następnej części.

Uwaga: niektóre własne przyciski funkcji obsługują wiązanie stanu. Na przykład, jeśli inputs to volume (wyciszenie), system przy każdym załadowaniu skórki odczyta stan głośności i zaktualizuje powiązany Switch Button. Zobacz efekt tvType w domyślnej skórce Atari 2600.

Własne przyciski funkcji z wiązaniem stanu:

reverseScreens
volume
toggleControlls
toggleAnalog
tvType
leftDifficulty
rightDifficulty

selfRetracting: Czy Switch Button sam wraca do pozycji. Zobacz przycisk resetu gry na Atari 2600, który odbija się po naciśnięciu i naśladuje chwilowy przełącznik.

⚙️ Własne przyciski funkcji

Manic EMU obsługuje rozbudowane skróty (sprawdź wymagania wersji):

Obsługiwane od v1.2.3:

flex: wejdź w ustawienia układu skórki

Dodane od v1.2.4:

quickSave: szybki ręczny zapis
quickLoad: szybkie ręczne wczytanie
fastForward: przytrzymaj dla maksymalnego przyspieszenia
toggleFastForward: stuknij, by przełączać prędkości
reverseScreens: zamień ekran główny i dodatkowy
volume: wyciszenie
saveStates: otwórz listę stanów
cheatCodes: otwórz listę cheatów
skins: otwórz listę skórek
filters: otwórz listę filtrów
screenshot: zrób zrzut
haptics: ustaw feedback wibracyjny
controllers: otwórz listę padów
orientation: zmień ustawienia obrotu
functionLayout: wejdź w konfigurację układu
restart: zresetuj grę
resolution: ustaw rozdzielczość gry
quit: wyjdź z gry
amiibo：załaduj Amiibo na 3DS
homeMenu：wróć do Home Menu 3DS

Dodane od v1.4.2：

toggleControlls：ukryj/pokaż kontrolki
blowing：symuluj dmuchanie w mikrofon
palette：paleta dla GB GBC VB

Dodane od v1.5.0：

swapDisk：wymień na następną płytę albo zmień stronę FDS

Dodane od v1.5.5：

shake：symulacja wstrząsu

Dodane od v1.6.0：

toggleAnalog：przełącz tryb urządzenia wejściowego, np. na PlayStation Controller albo DualShock na PS1.

Dodane od v1.7.0：

retroAchievements：otwórz stronę RetroAchievements.

Nowość od v1.7.1:

fastForward2x: przytrzymaj, by przyspieszyć 2×
fastForward3x: przytrzymaj, by przyspieszyć 3×
fastForward4x: przytrzymaj, by przyspieszyć 4×
airPlayScaling: skalowanie obrazu gry podczas AirPlay
airPlayLayout: układ gier wieloekranowych (np. NDS) podczas AirPlay

Nowość od v1.7.2:

gameplayManuals：otwórz podręczniki rozgrywki

Nowość od v1.7.3:

triggerPro：przełącz konfiguracje TriggerPro

Nowość od v1.8.3:

tvType: przełącz kolor i czerń-biel na Atari 2600.
leftDifficulty: lewy przełącznik trudności Atari 2600.
rightDifficulty: prawy przełącznik trudności Atari 2600.

Nowość od v1.9.0:

screenScaling：przełącz tryb rozciągania ekranu
j2meSettings：otwórz stronę ustawień J2ME
dosSettings：otwórz stronę ustawień rdzenia DOS
insertDisc：włóż płytę

Nowość od v2.0.0:

coreSettings：otwórz ustawienia rdzenia
rewind：przytrzymaj, by przewinąć wstecz

Przykład: przycisk restartu

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

⚠️ Krytyczne przypomnienie Nie przypisuj wielu funkcji do jednego przycisku. Na przykład:

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

🎵 Efekty dźwiękowe

Od V1.9.0 Manic EMU obsługuje dźwięki przycisków skórki. Przekonwertuj pliki audio do formatu CAF, nazwij je sound.caf i umieść w katalogu głównym skórki przed spakowaniem.

📦 Pakowanie skórki

Spakuj skórkę w trzech krokach:

Umieść wszystkie zasoby płasko (bez folderów nadrzędnych)
Zaznacz wszystkie pliki i skompresuj do niezaszyfrowanego ZIP
Wybierz rozszerzenie: .manicskin albo .deltaskin

Polecamy oficjalne szablony, żeby struktura była poprawna.

🎨 Oficjalne skórki

ManicEMUSkins

Zacznij projektować swoją unikalną skórkę. 🎨