Unicorn Overlord PC：PS4 游戏移植

项目简介

本项目把 PS4 版 Unicorn Overlord 移植到 64 位 Linux 与 Windows 上原生运行。

它不是模拟器，也不是反编译：PS4 与 PC 使用同类处理器（x86-64），因此游戏自己的可执行文件直接跑在 PC 的 CPU 上。PC 缺少的是 PS4 的操作系统与 GPU，项目正好补上这两块：

• 准备（scripts/）：读取游戏的 eboot.bin，修正地址并把游戏自带的系统模块链接成一个镜像。
• 加载器（src/probe.c）：把镜像载入内存，施加少量针对本作的代码补丁（例如渲染分辨率），再跳进游戏代码。
• 运行时（src/runtime_*.c）：实现游戏调用的约 700 个 PS4 系统函数，涵盖内存、线程、文件、音频、视频解码、手柄、存档，以及 PSN 的离线替身。
• GPU（gpu/）：使用 shadPS4 的视频核心把 PS4 的 GPU 命令与着色器转换为 Vulkan，并叠加本项目的多线程绘制管线。
• 启动程序（launcher/）：一次性安装 dump 后启动游戏；游戏内菜单为 Dear ImGui。

目前只支持 CUSA36381（Asia）app 01.04 这一个 dump（含 1.04 更新，日文/中文，或配合民间英文补丁使用英文）。项目仍在开发中：序章、第一章及其首场战斗已实际游玩，存档与读档可用，游戏导入的系统函数均已实现，但尚未通关，在中端笔记本上约 50-60 FPS。

主要功能

• 渲染分辨率：默认 1920×1080，可选 720p、900p（弱 GPU）、1800p、4K。所有尺寸都走游戏自身的 PS4 Pro 路径，2D 图层按目标尺寸布局，画面构图与 HUD 保持一致；1800p 与 4K 属于超采样（画面放大绘制后平均缩小到窗口），因此没有单独的抗锯齿选项。
• 超宽屏（实验性）：菜单中的 Aspect ratio、vw.ini 的 aspect_ratio= 或环境变量 VW_ASPECT_RATIO 可设 21:9、32:9 或任意 W:H（如 3440×1440 用 43:18）。两侧显示更多战斗地图与场景，菜单与文字仍保持 16:9。
• 覆盖菜单：游戏中按 Insert（手柄 R3+L2）呼出，含四个标签页——Image（显示模式、VSync、Anime4K、FSR 1 与 RCAS 锐化）、Performance（渲染分辨率、帧队列、GPU 回读）、Overlay（性能浮层）、Controls（键鼠与手柄按键映射、按键图标可选 Auto/PlayStation/Xbox/Nintendo、摇杆死区）。
• 多语言文本（实验性）：把 Switch 版民间翻译（如 Unicorn_US.CPK）或自制的 JSON 翻译放进 data/mods/，再把 Text Language 设为繁体或简体中文。
• DLC：把自己拥有的 DLC 包或其解包文件夹放入数据目录下的 dlc，下次启动时游戏即视为已拥有。
• 更新检查：启动时查找 GitHub 上的新版本并询问是否下载，更新会保留设置、存档与已安装的游戏，可在 Insert 菜单关闭。
• 键鼠操作：WASD 左摇杆、方向键右摇杆、Space 确认、左 Shift 取消、E/Q 方框/三角、1 与 3 对应 L1/R1、R 与 F 对应 L2/R2、Z 与 C 对应 L3/R3、IKJL 十字键、Enter 为 Options、Tab 触摸板、Insert 呼出移植菜单。

安装与使用

1. 到 Releases 下载 Windows 与 Linux 版本。
   • Linux：Unicorn-Overlord-x86_64.AppImage，chmod +x 后运行，data/ 目录保存在 .AppImage 旁边。
   • Windows：Unicorn-Overlord-PC-windows.zip，解压到独立文件夹后运行 Unicorn Overlord.exe，data/ 保存在同级目录，请一并保留 LICENSE 与 licenses/。
2. 环境要求：64 位 Linux，或 Windows 10（1903+）/11；支持 sparse buffers 的 Vulkan 1.3 GPU（AMD 与 NVIDIA 支持，Intel Gen12 之前的核显在 Linux 上不支持）；自备已合并 1.04 更新的 dump（或港版 1.05 包），文件夹内需有 eboot.bin、sce_module、sce_sys 和 .CPK 文件，约 7 GB。
3. 首次启动：选择 dump 文件夹，启动程序会校验标题与版本，安装到 data/game 并开始游戏。同盘安装使用硬链接，很快且不额外占空间；跨盘则复制约 7 GB 并显示进度，中途取消会在下次启动时继续。之后启动会直接进入游戏。
4. 从源码运行：

python launcher/unicorn_launcher.py

构建则用 bash build.sh，或 VW_GAME_DIR=/path/to/CUSA36381 bash run.sh 一步构建、准备并启动。

5. 修改分辨率后必须重启：在 Insert 菜单的 Performance 中改完，选 Apply and restart；若在游戏自身的 System → Options → PC 里修改，需关闭并重新启动游戏。

设置保存在数据目录的 vw.ini，Restore Defaults 会一并重置。

注意事项

• 不包含任何游戏文件，需要自己拥有并导出游戏副本。本项目与 Sony Interactive Entertainment、Atlus、Sega、Vanillaware 均无关联。
• 项目尚未完工，提交问题前请先阅读 docs/KNOWN_ISSUES.md；每次运行会在数据目录的 logs/ 写入日志，出错时启动程序可导出诊断 ZIP。
• 超宽屏支持与多语言翻译均为实验性功能，前者只在 16:9 笔记本上开发，尚未在超宽显示器上验证。
• 4K 下战斗地图需要绘制的像素最多增加约 1.8 倍，较慢的 GPU 在该分辨率下会更慢。
• 在高分辨率窗口下 Anime4K 会增加每帧 GPU 开销（1080p 下 Fast 约 3.3 ms、Quality 约 7.5 ms），Quality 更适合较强的显卡。
• 许可证为 GPL-2.0。

---

本作品整理自 GitHub 开源项目 hachi23/unicorn_overlord_pc，原作者 @hachi23，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。