自制皮肤指南

Guides

欢迎来到Manic EMU皮肤制作指南！🎮 本模拟器的皮肤系统基于DeltaSkin框架，因此基础格式与DeltaSkin完全兼容。如果你想先学习DeltaSkin的基础知识，推荐访问官方教程哦~

不过，Manic EMU还提供了更多炫酷功能！✨ 比如按压动效、自由缩放、屏幕翻转等。下面将为你逐一揭秘这些特色功能的使用方法：

📁 info.json配置详解

游戏类型标识符（gameTypeIdentifier）

Manic EMU使用独立的游戏类型标识符：

  • 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
  • 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的标识符，系统会自动转换兼容。

皮肤唯一标识（identifier）

请为你的皮肤设置全局唯一的标识符！如果与其他皮肤重名，可能会导致加载失败或缓存异常哦~

🎮 按压动效实现

想让按钮按下时有酷炫反馈？只需两步：

  1. 图层分离：将按钮背景与前景图层分开（参考3DS皮肤模板）
  2. JSON配置：在info.json中为按钮添加asset字段

示例：为A键添加按压效果

1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "asset": {
        "normal": "a_button.pdf" 
        // 预留其他状态 将来会进行扩充
    },
    "frame": {
        "height": 48,
        "width": 48,
        "x": 545,
        "y": 552
    },
    "inputs": ["a"]
}

⚙️ 自定义功能按键

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：3DS游戏加载Amiibo
  • homeMenu：3DS游戏回到Home Menu

v1.4.2及以上版本新增：

  • toggleControlls：隐藏/显示按钮
  • blowing：模拟对mic吹气
  • palette：调色板

v1.5.0及以上版本新增：

  • swapDisk：切换光盘或者FDS的软盘翻面

v1.5.5及以上版本新增：

  • shake：模拟摇晃设备

v1.6.0及以上版本新增：

  • toggleAnalog：切换输入模式，如PS1切换PlayStation Controller或DualShock

v1.7.0及以上版本新增：

  • retroAchievements：打开复古成就页面

v1.7.1及以上版本新增：

  • fastForward2x：长按以2x倍速快进
  • fastForward3x：长按以3x倍速快进
  • fastForward4x：长按以4x倍速快进
  • airPlayScaling：设置AirPlay时游戏画面的缩放模式
  • airPlayLayout：设置多屏游戏(如NDS)AirPlay时游戏画面的布局样式

v1.7.2及以上版本新增：

  • gameplayManuals：打开游戏手册

示例：添加重启游戏按钮

1
2
3
4
5
{
    "asset": { "normal": "button.pdf" },
    "frame": { ... },
    "inputs": [ "restart" ]
}

⚠️ 重要提醒
请避免为单个按钮分配多个功能！例如下方配置可能会导致意外行为：

1
2
3
4
// ❌ 危险示范！
{
    "inputs": [ "restart", "quit" ]
}

📦 皮肤打包指南

只需三步完成打包：

  1. 将所有资源文件平铺存放（不要使用文件夹进行包裹）
  2. 选中所有文件压缩为非加密ZIP文件
  3. 选择你喜欢的后缀：.manicskin 或 .deltaskin 均可

推荐参考我们的官方模板，确保层级结构正确~

🎨 官方模板下载

点击对应机型快速获取模板文件：

现在就开始设计你的专属皮肤吧！🎨 遇到问题欢迎通过GitHub Issues反馈哦~