kys-cpp 金庸群侠传 C++ 复刻版

项目简介

kys-cpp 是经典国产武侠 RPG《金庸群侠传》的 C++ 复刻版，后缀 cpp 用于区别于其他语言的复刻实现。项目已完工，基于 SDL3 重写，支持 Windows、macOS 与 Linux 多平台。

核心特色

多样化的战斗系统

除了经典的回合制战斗外，还实现了：

• 半即时战斗：带进度条，介于回合与即时之间
• 两种完全即时战斗：分别模仿《黑帝斯》和《只狼》的战斗节奏

玩家可在游戏设置中随时切换战斗模式。

纸片 3D 视觉风格

当前开发分支为「纸片」，尝试在素材限制下营造真 3D 效果，风格接近《纸片马力欧》与《饥荒》。2x 高清素材通过深度学习模型放大，并加入伪光照处理。

自研脚本系统

剧情脚本使用作者自研的类 C 风格脚本语言 Cifa 执行，简繁转换则采用自编的 SimpleCC 替代依赖复杂的 OpenCC。

编译与运行

Windows

建议先安装 vcpkg 并安装依赖：

.\vcpkg install sdl3 sdl3-ttf sdl3-mixer[fluidsynth,mpg123] sdl3-image[png,webp] sqlite3 libiconv asio picosha2 yaml-cpp glaze

获取子模块后，用 Visual Studio 打开 kys.sln，编译 x64 配置即可。

macOS

brew install cmake sdl3 sdl3_image sdl3_ttf sdl3_mixer sqlite yaml-cpp glaze

随后通过 CMake 构建：

mkdir -p src/build
cmake -S src -B src/build
cmake --build src/build -j8

运行

运行时需将资源目录作为命令行参数传入，例如：

./src/build/kys kys-cpp-4in1/game

若提示找不到字体或资源，通常是资源根目录多套了一层，请确认传入的是具体游戏目录。

授权说明

项目以 BSD 3-Clause License 发布，但附加两条限制：代码一般可自由使用甚至商用；但若用于金庸武侠题材游戏，则严禁任何形式的牟利行为。

适用人群

适合对 C++ 游戏开发、SDL3、经典 RPG 复刻感兴趣的开发者，也适合作为完整游戏项目的架构学习案例。