Guide des skins maison

Bienvenue dans le guide de création de skins Manic EMU ! 🎮 Le système de skins repose sur le framework DeltaSkin, et reste pleinement compatible avec le format de base DeltaSkin. Pour les bases, voyez le tutoriel officiel. Si vous dessinez dans Figma, jetez un œil à RetroSkinner. Il transforme vos designs Figma en fichiers de skin.

Manic EMU va plus loin. ✨ Animations à l’appui, mise à l’échelle libre, retournement d’écran, et plus. Voici comment utiliser ces fonctions exclusives :

📁 Guide de configuration info.json

Identifiant de type de jeu (`gameTypeIdentifier`)

Manic EMU utilise des identifiants de type de jeu indépendants :

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

💡 Astuce : pour rester compatible avec Delta et Manic EMU, utilisez directement les identifiants DeltaSkin — le système convertit tout seul.

Certaines plateformes acceptent des manettes compatibles : vous pouvez mélanger certains skins dans Manic EMU :

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

Identifiant unique du skin (`identifier`)

Donnez à votre skin un identifiant globalement unique. Un doublon peut faire échouer le chargement ou casser le cache.

🎮 Animations à l’appui

Un retour dynamique sur les boutons ? Deux étapes :

Séparation des calques : séparez fonds et premiers plans des boutons (voir le modèle 3DS Skin)
Configuration JSON : ajoutez un champ asset au bouton dans info.json

Exemple : effet d’appui sur le bouton A

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

🎚️ Bouton interrupteur animé

Active un basculeur avec persistance d’état. Pour un exemple visuel, voyez le skin Atari 2600 par défaut.

Exemple

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

Un objet animation a été ajouté (pris en charge uniquement pour le Switch Button pour l’instant). animation:

type définit la courbe d’animation. Seul spring est pris en charge.
begin définit le frame avant le début de l’animation.
end définit le frame à la fin de l’animation.

Note : les coordonnées dans begin et end sont relatives au frame parent.

asset: En plus de l’asset normal, un asset selected a été ajouté. Le contrôle peut afficher une ressource correspondante à l’état selected (pris en charge uniquement pour le Switch Button pour l’instant).

inputs: Le contenu est le même que pour les autres contrôles, mais ici seuls des chaînes sont acceptées. C’est la fonction liée au Switch Button. Ce peut être une commande standard, comme a, b, up, down…, ou un bouton de fonction personnalisé présenté plus bas.

Note : certains boutons de fonction personnalisés gèrent la liaison d’état. Si inputs vaut volume (muet), le système interroge l’état du volume à chaque chargement du skin et met à jour le Switch Button lié. Voyez l’effet tvType du skin Atari 2600 par défaut.

Boutons de fonction personnalisés avec liaison d’état :

reverseScreens
volume
toggleControlls
toggleAnalog
tvType
leftDifficulty
rightDifficulty

selfRetracting: Indique si le Switch Button se réinitialise tout seul. Voyez le bouton reset du jeu sur Atari 2600, qui revient après l’appui, comme un interrupteur momentané.

⚙️ Boutons de fonction personnalisés

Manic EMU prend en charge de nombreux raccourcis (vérifiez la version) :

Pris en charge en v1.2.3 et plus :

flex: entrer dans les réglages de disposition du skin

Ajoutés en v1.2.4 et plus :

quickSave: sauvegarde manuelle rapide
quickLoad: chargement manuel rapide
fastForward: maintenir pour l’avance maximale
toggleFastForward: tapoter pour cycler les vitesses
reverseScreens: inverser les écrans principal/secondaire
volume: contrôle du muet
saveStates: ouvrir la liste des sauvegardes d’état
cheatCodes: ouvrir la liste des cheats
skins: ouvrir la liste des skins
filters: ouvrir la liste des filtres
screenshot: prendre une capture
haptics: régler le retour haptique
controllers: ouvrir la liste des manettes
orientation: changer la rotation
functionLayout: entrer dans la configuration de disposition
restart: réinitialiser le jeu
resolution: régler la résolution du jeu
quit: quitter le jeu
amiibo：charger des Amiibos pour 3DS
homeMenu：retour au menu d’accueil 3DS

Ajoutés en v1.4.2 et plus :

toggleControlls：masquer/afficher les commandes
blowing：simuler un souffle dans le micro
palette：palette pour GB GBC VB

Ajoutés en v1.5.0 et plus :

swapDisk：passer au disque suivant, ou changer de face pour FDS

Ajoutés en v1.5.5 et plus :

shake：simulation de secousse

Ajoutés en v1.6.0 et plus :

toggleAnalog：changer le mode du périphérique d’entrée, comme passer à une PlayStation Controller ou DualShock sur PS1.

Ajoutés en v1.7.0 et plus :

retroAchievements：ouvrir la page RetroAchievements.

Nouveaux en v1.7.1 et plus :

fastForward2x: maintenir pour avancer à 2×
fastForward3x: maintenir pour avancer à 3×
fastForward4x: maintenir pour avancer à 4×
airPlayScaling: régler l’échelle de l’écran de jeu pendant AirPlay
airPlayLayout: choisir la disposition des jeux multi-écrans (comme NDS) pendant AirPlay

Nouveaux en v1.7.2 et plus :

gameplayManuals：ouvrir les manuels de jeu

Nouveaux en v1.7.3 et plus :

triggerPro：changer les configs TriggerPro

Nouveaux en v1.8.3 et plus :

tvType: basculer couleur / noir et blanc pour Atari 2600.
leftDifficulty: interrupteur de difficulté gauche pour Atari 2600.
rightDifficulty: interrupteur de difficulté droit pour Atari 2600.

Nouveaux en v1.9.0 et plus :

screenScaling：changer le mode d’étirement de l’écran
j2meSettings：ouvrir la page de réglages J2ME
dosSettings：ouvrir la page de réglages du cœur DOS
insertDisc：insérer le disque

Nouveaux en v2.0.0 et plus :

coreSettings：ouvrir les réglages du cœur
rewind：maintenir pour rembobiner

Exemple : ajouter un bouton Restart

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

⚠️ Rappel critique
N’assignez pas plusieurs fonctions à un seul bouton. Par exemple :

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

🎵 Effets sonores

À partir de la V1.9.0, Manic EMU prend en charge les effets sonores des boutons de skin. Convertissez vos fichiers audio au format CAF, renommez-les sound.caf, et placez-les à la racine du skin avant de tout empaqueter.

📦 Guide d’empaquetage

Empaquetez le skin en trois étapes :

Placez tous les assets à plat (sans dossiers parents)
Sélectionnez tous les fichiers et compressez en ZIP non chiffré
Choisissez l’extension : .manicskin ou .deltaskin

Nous recommandons les modèles officiels pour une structure correcte.

🎨 Téléchargements des skins officiels

ManicEMUSkins

À vous de concevoir un skin unique. 🎨