KHMelonMix 开源项目教程

KHMelonMix 开源项目教程

KHMelonMix Kingdom Hearts 358/2 Days - Melon Mix (DS Emulator) 项目地址: https://gitcode.com/gh_mirrors/kh/KHMelonMix

1. 项目介绍

KHMelonMix 是一个基于 melonDS 的开源项目，旨在将《王国之心》系列中的 DS 游戏（如《王国之心 358/2 天》和《王国之心 Re:Coded》）转换为可在 PC 上运行的游戏。该项目通过修改 melonDS 模拟器，使其更适合这些特定游戏的体验，包括单屏幕显示和适合普通控制器的控制方式。

2. 项目快速启动

2.1 下载与安装

首先，从 GitHub 仓库下载最新版本的 KHMelonMix：

git clone https://github.com/vitor251093/KHMelonMix.git
cd KHMelonMix

2.2 构建项目

2.2.1 Linux 系统

在 Ubuntu 22.04 上安装依赖：

sudo apt install cmake extra-cmake-modules libcurl4-gnutls-dev libpcap0.8-dev libsdl2-dev qtbase5-dev qtbase5-private-dev qtmultimedia5-dev libarchive-dev libzstd-dev qt6-base-dev qt6-base-private-dev qt6-multimedia-dev

编译项目：

cmake -B build -DUSE_QT6=ON
cmake --build build -j$(nproc --all)

2.2.2 Windows 系统

安装 MSYS2，打开 MSYS2 MinGW 64-bit 终端，更新包并安装依赖：

pacman -Syu
pacman -S git
pacman -S mingw-w64-x86_64-cmake mingw-w64-x86_64-SDL2 mingw-w64-x86_64-toolchain mingw-w64-x86_64-qt6-static mingw-w64-x86_64-qt6-base mingw-w64-x86_64-qt6-multimedia mingw-w64-x86_64-libarchive mingw-w64-x86_64-zstd

编译项目：

cmake -B build -DUSE_QT6=ON
cmake --build build
cd build
./tools/msys-dist.sh

2.3 运行游戏

将《王国之心 358/2 天》的 NDS 文件重命名为 days.nds，并放入 roms 文件夹中，然后运行 MelonMix_KHDays.bat（Windows）或 MelonMix_KHDays.sh（Linux）。

3. 应用案例和最佳实践

3.1 游戏体验优化

KHMelonMix 通过优化控制和显示方式，使得《王国之心》系列 DS 游戏在 PC 上的体验更加流畅。用户可以根据自己的控制器设置推荐绑定，提升游戏操作的便捷性。

3.2 Steam Deck 兼容

KHMelonMix 的 AppImage 版本与 Steam Deck 兼容。用户只需下载 AppImage 文件，设置执行权限，即可在 Steam Deck 上运行《王国之心》DS 游戏。

4. 典型生态项目

4.1 melonDS

melonDS 是 KHMelonMix 的基础项目，是一个开源的 Nintendo DS 模拟器。KHMelonMix 在此基础上进行了特定游戏的优化，使其更适合《王国之心》系列 DS 游戏的运行。

4.2 Kingdom Hearts 社区

KHMelonMix 项目得到了《王国之心》社区的大力支持，社区成员提供了大量的测试和反馈，帮助项目不断改进和完善。

通过以上步骤，您可以轻松地在 PC 上运行《王国之心》系列的 DS 游戏，享受更加优化的游戏体验。

KHMelonMix Kingdom Hearts 358/2 Days - Melon Mix (DS Emulator) 项目地址: https://gitcode.com/gh_mirrors/kh/KHMelonMix