Skip to content

About

Native iPhone / iPad / Apple TV / Vision Pro port of Subarashiki Hibi

Resources

Stars

8 stars

Watchers

0 watching

Forks

Latest commit

 

History

36 Commits

Folders and files

Repository files navigation

美好的每一天 ~不连续存在~ · Apple 平台移植

项目仓库:galhack/Subahibi_iOS。 安装包:Releases。

把 ケロQ《素晴らしき日々 ~不連続存在~》(BGI/Ethornell 引擎,HD 版,产品名 SubarashikihibiHD) 原生移植到 iPhone、iPad、Mac、Apple TV、Apple Vision Pro。日文原版与【冥月·凌雪汉化组】中文补丁都可以游玩。

游戏本体和本篇汉化需由玩家自行取得并导入。 本仓库与应用仅内置本文署名的后日谈社区增量, 不附原游戏 EXE、游戏封包、音乐、影片、本篇汉化 EXE 或玩家存档。

项目及四个平台应用已内置 Knockin' on heaven's door 后日谈社区汉化, 导入自己的游戏本体和本篇汉化后,选择简体中文即可使用。启动器提供启用开关, 后日谈入口仍按原作进度开放。

致敬并感谢原社区汉化作者「笑笑竺斋」! 原汉化包出处:素晴日后日谈笑笑汉化补丁。 本项目保留原译文及剧情中的署名,仅进行 Apple 增量封装、加载与兼容字体适配。 使用方法见 后日谈补丁说明,资源位于 app/Resources/AfterstoryCHS。

各版本的改动与验证记录见 版本更新记录。


它是怎么工作的

  • 引擎:开源的 BGI 重实现 OpenBGI(C99,GPL-2.0), 本项目为它补上了这款游戏需要的部分:
    • 新增 1.647 引擎版本配置(指令集从原版 BGI.exe 中逐表恢复,见 tools/re/);
    • CompressedBG v2 图像解码(本作 5697 张图中有 5650 张是 v2,全部零失败);
    • 游戏用到而缺失的 3 条指令、1.647 的帧率与文字函数行为、直接从封包播放影片。
  • Apple 后端(engine/openbgi/src/os/apple/):引擎在独立线程运行;Metal 呈现; Core Text 渲染字形(日文用冬青黑体/明朝;中文按 GBK 解码,优先使用汉化包自带 font.ttf,缺字回退苹方); AudioToolbox 输出声音;pl_mpeg 解码 MPEG-1 影片;存档与游戏数据分离保存。
  • 中文补丁:应用会在首次选择中文时自动解开 BGI-CHS.exe 内的 Enigma Virtual Box 虚拟文件 (汉化剧本与图片),不需要在电脑上做任何预处理。
  • 应用外壳:SwiftUI + UIKit,一个工程同时构建 iOS/iPadOS、Mac(Mac Catalyst)、tvOS、visionOS 原生版本。

已在以下真机验证(2026-10):iPhone 16 Pro Max、iPad Pro、Apple TV 4K、Apple Vision Pro(原生 visionOS 应用), 日文与中文均可进入剧情;存档、读档跨重启可用;影片可从封包直接播放。


你需要准备

  1. 正版游戏的安装目录(含 sysprg.arc、system.arc、sysgrp.arc、data01000.arc … data05010.arc 等)。
  2. 想玩中文版时,目录中还需要汉化补丁的 BGI-CHS.exe 与 font.ttf(即"已打汉化补丁"的目录)。
  3. 一台装有 Xcode(含 iOS/tvOS/visionOS 平台)的 Mac;侧载 iPhone/iPad 也可以用 Sideloadly。
  4. 一个 Apple ID(免费账户即可,签名有效期 7 天,需定期重新安装;付费开发者账户为 1 年)。

需要的设备空间:游戏数据约 4.3 GB,中文补丁解包后另需约 350 MB。


构建与安装

直接下载安装包(v0.1.7)

无需自行构建时,可直接下载 v0.1.7 Release 中对应设备的文件:

设备 Release 安装包 安装方式
iPhone / iPad Subahibi-ios.ipa 使用 Sideloadly 和自己的 Apple ID 签名后侧载
Mac Subahibi-mac.zip 解压后打开应用,首次启动时选择游戏本体目录
Apple TV Subahibi-tvos.ipa 需自行签名安装;也可按下方 Xcode 步骤构建并安装
Vision Pro Subahibi-visionos.ipa 需自行签名安装;也可按下方 Xcode 步骤构建并安装

校验文件:SHA256SUMS.txt。 上述应用均已内置后日谈社区汉化,游戏本体与本篇汉化仍需自行导入。 使用现成安装包可以跳过下面的本地构建步骤;覆盖更新时保留原应用,避免删除已有数据和存档。

1. 生成 Xcode 工程

git clone https://github.com/galhack/Subahibi_iOS.git
cd Subahibi_iOS
SUBAHIBI_TEAM=<你的 Team ID> tools/apple/gen_project.sh
open app/Subahibi.xcodeproj

Team ID 可在 Xcode › Settings › Accounts 中查看(免费账户的个人团队也有 Team ID)。 也可以把它写进 app/.team(单行,不会提交到 git),之后直接运行 tools/apple/gen_project.sh。 脚本会自动下载 XcodeGen(仅在本机 build/ 目录中)。工程无需额外安装 Metal 工具链或任何第三方库。

2. Mac 版

tools/apple/build_mac.sh          # 生成 build/Subahibi-mac.zip(本机签名,内置后日谈社区汉化)

解压后把 Subahibi.app 拖到「应用程序」。首次打开如被系统拦截,请右键 › 打开(该应用未经公证)。 也可以在 Xcode 中选择 "My Mac (Mac Catalyst)" 直接运行。Mac 版无需 Apple ID。

启动后点「选择游戏目录…」,指向电脑上的游戏安装目录即可,不需要复制数据;选择会被记住。 存档、汉化解包保存在 ~/Library/Application Support/Subahibi/。

3. 安装到 iPhone / iPad / Apple TV / Vision Pro

用 Xcode(四种设备都适用,Apple TV / Vision Pro 推荐此方式)

  1. 用数据线或同一局域网把设备与 Mac 配对(Apple TV 与 Vision Pro 在 Xcode › Window › Devices and Simulators 中配对)。
  2. 在 Xcode 顶部选择目标设备,点击 Run(▶)。首次需要在设备上开启"开发者模式",并在 设置 › 通用 › VPN 与设备管理 中信任你的开发者证书。

用 Sideloadly(iPhone / iPad)

tools/apple/build_ipa.sh ios      # 生成 build/Subahibi-ios.ipa(未签名,内置后日谈社区汉化)

在 Sideloadly 中选择该 IPA、你的设备和 Apple ID,点击 Start。

免费 Apple ID 每台设备最多同时保留 3 个侧载应用,若安装失败请先删除一个旧的侧载应用。


导入游戏数据

应用第一次打开时会提示"尚未找到游戏文件"。把整个游戏目录放进应用即可,目录名随意。

设备 推荐方式
iPhone / iPad 数据线连接 Mac → 访达 › 选中设备 › 文件 › 「美好的每一天」→ 把游戏目录拖进去
Vision Pro 用隔空投送把游戏目录发到 Vision Pro,保存到「文件 › 我的 Apple Vision Pro › 美好的每一天」;或用下面的局域网传输
Apple TV 只能用局域网传输(tvOS 没有文件管理)
任意设备 局域网传输(见下)

局域网传输

  1. 在设备上打开应用,打开「局域网接收游戏文件」,记下屏幕上显示的 地址 和 配对码。

  2. 在同一网络的 Mac 上运行(只需系统自带的 Python 3):

    python3 tools/push_data.py --host <设备地址> --code <配对码> /path/to/你的游戏目录

    脚本只发送需要的文件(.arc 封包、BGI-CHS.exe、font.ttf、BGI.gdb、BGI.hvl), 设备上已有且大小相同的文件会跳过,中断后重新运行即可续传。

  3. 传完后在应用里点「重新检查」。

配对码每次开启服务都会重新生成;连续输错 5 次会自动更换配对码并暂停接收。

开发者:用 devicectl 直接推送

已连接 Xcode 的设备也可以直接把文件写进应用的数据容器(iPhone/iPad/Vision Pro 写到 Documents/Game, Apple TV 写到 Library/Caches/Game):

xcrun devicectl device copy to --device <设备> \
  --source data01000.arc --source ... \
  --destination Documents/Game \
  --domain-type appDataContainer --domain-identifier org.local.subahibi.<Team ID>

开始游戏

在启动页选择语言(检测到汉化补丁时可选「简体中文」),点「开始游戏」。 首次选择中文时会先解开汉化补丁(几秒钟)。

操作方式

输入 对应
轻点 鼠标左键(推进文字、选择)
双指轻点 鼠标右键(游戏菜单 / 隐藏文字框)
上下滑动 鼠标滚轮(向下滑 = 打开回想)
长按 按住 Ctrl(快进),松手停止
Mac / iPad 鼠标与触控板 与 PC 版相同:按下、拖动(如回想滚动条)、左右键、滚轮
硬件键盘 Enter、空格、Esc、方向键、Ctrl(按住快进)、Page Up/Down 等
Apple TV 遥控器 触控板移动指针,按下 = 左键,返回键 = 右键,上/下键 = 滚轮,播放/暂停 = 按住快进
游戏手柄 左摇杆移动指针,A = 左键,B = 右键,RT = 快进,十字键上/下 = 滚轮
Vision Pro 注视 + 捏合 = 轻点;其余同触控

游戏结束(标题选 EXIT)后应用会提示退出,再次游玩请重新打开应用。


存档

  • 存档与游戏数据分开保存(iPhone/iPad/Vision Pro 在 Application Support,Mac 在 ~/Library/Application Support/Subahibi,Apple TV 在缓存区),日文版与中文版各自独立 (汉化版存档含 GBK 文本,原版作品同样不能混用)。
  • 首次启动时会把游戏目录中的 BGI.gdb(全局设定、已读记录、CG 收集)复制一份作为起点, 电脑上的进度因此可以带过来。
  • 删除应用会同时删除存档。iPhone/iPad 可在访达中备份应用数据。

已知限制

  • 免费 Apple ID 签名 7 天后过期,需要重新安装(不会删除已导入的数据和存档)。
  • Apple TV:tvOS 只允许应用写入缓存区,游戏数据、汉化解包与存档都保存在那里; 系统空间紧张时可能被清除(届时需重新传输数据,存档也会丢失),重要进度请留意。
  • Vision Pro 的注视不会产生"悬停",按钮的高亮会在点击时才出现。
  • 0.1.7 已内置后日谈社区汉化;其余未汉化内容仍取决于玩家导入的本篇补丁。
  • 游戏目录中的 fcxzzd.arc 是与游戏无关的文本文件,不需要也不会被传输。

开发与调试

路径 内容
engine/openbgi/ OpenBGI 引擎(上游版本见 engine/UPSTREAM_COMMIT)及本项目修改
engine/openbgi/src/os/apple/ Apple 平台后端
app/ XcodeGen 工程定义、Swift 外壳、EVB 解包器
tools/re/ 原版 BGI.exe 分析脚本(操作码表恢复、缺失指令普查等)
tools/sim/ 无头模拟构建与场景脚本
tools/apple/ 工程生成、IPA 打包、图标生成
tools/check/ 图像解码全量检查、截断模糊测试、EVB 比对

在 Mac 上不用模拟器即可运行同一套 Apple 后端:

cd engine/openbgi && make PLATFORM=apple CC=clang VORBIS=stb bin/openbgi-hosttest
bin/openbgi-hosttest /path/to/game --seconds=60 --script="wait 10 click 640 480 shot out.png"
bin/openbgi-hosttest /path/to/game --overlay=<解包后的汉化目录> --font=/path/to/game/font.ttf --chinese ...

真机/模拟器上可用环境变量做无人值守测试:SUBAHIBI_AUTOSTART=ja|zh 跳过启动页, SUBAHIBI_SCRIPT="wait 6 click 640 480 shot title" 注入输入并把截图写到 Documents/Debug/。

引擎测试与大图加载回归测试:

cd engine/openbgi
make -j8 PLATFORM=apple CC=clang VORBIS=stb test
# 可选:用自己购买的游戏验证全部 10 张超过 32 MiB 的图片
BGI_GAME_DIR=/absolute/path/to/game bin/test_imageload

tests/imageload.c 默认生成临时图片,覆盖同步加载、等待加载和缓存命中, 不含游戏素材。内存检查可用 make -B 重建该测试,并设置 OPT="-O1 -g -fsanitize=address,undefined -fno-omit-frame-pointer"; 完成后用默认编译选项重新构建,避免混用带检查器的目标文件。

本仓库忽略游戏目录、封包、凭证、签名文件、构建结果、agents.md / AGENTS.md 及 IMPLEMENTATION_PLAN.md。公开源码不包含本地调试报告和存档。


许可

  • 本项目代码(含引擎修改与 Apple 后端、应用外壳)以 GPL-2.0 发布,见 LICENSE。
  • 第三方组件(OpenBGI、pl_mpeg、stb_vorbis、参照 GARbro 的 CBG v2 算法)见 THIRD_PARTY_NOTICES.md。
  • 《素晴らしき日々 ~不連続存在~》及其一切内容版权归 ケロQ 所有;中文补丁归【冥月·凌雪汉化组】所有, 请遵守其声明(勿用于商业用途)。本项目与上述权利人无关,仅供已购买正版的玩家在自己的设备上游玩。
  • 后日谈社区汉化致敬原作者 笑笑竺斋,出处为 素晴日后日谈笑笑汉化补丁。 社区译文及字体等资源保留原署名,不因随项目发布而改变其原有权利归属。

About

Native iPhone / iPad / Apple TV / Vision Pro port of Subarashiki Hibi

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages