# 蚀月遗钟 Eclipse Belfry

**Repository Path**: hujian219/eclipse-belfry-android

## Basic Information

- **Project Name**: 蚀月遗钟 Eclipse Belfry
- **Description**: 原创哥特横版探索动作游戏：Godot Android、宣传下载页、进度排行榜与玩家反馈。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> **源码与意见反馈**：[Gitee 仓库](https://gitee.com/hujian219/eclipse-belfry-android) · [Gitee APK 发行版](https://gitee.com/hujian219/eclipse-belfry-android/releases/tag/v0.7.8) · [玩家意见](https://belfry.47.101.190.127.nip.io/feedback.html)。发布与反馈服务说明见 [docs/GITEE-AND-FEEDBACK.md](docs/GITEE-AND-FEEDBACK.md)。

> **Godot v0.7.8 已上线**：新增取名首页、设备身份、HTTPS 进度同步及全服排行榜。宣传页和下载页：https://belfry.47.101.190.127.nip.io/ 。APK：`dist/releases/Eclipse-Belfry-Godot-v0.7.8-release.apk`。首次取名，后续自动保留；断网可玩，排行榜不是云存档。说明与验证：[docs/RELEASE-0.7.8-ONLINE-PORTAL.md](docs/RELEASE-0.7.8-ONLINE-PORTAL.md)。

> **Godot 迁移版 v0.7.7**：优化怪物巡逻、视线、攻击预警与硬直；人物步态、起落和连击时序优化。普通出口走入后自动切图，保留门锁条件。补齐 8 类场景图像；武器、护甲、饰品按各自品质染色，同名装备可有四档品质。行囊支持确认抛弃，装备留在地面且可重新拾取。入口 `godot-game/project.godot`；说明见 [godot-game/README.md](godot-game/README.md)，验收见 [docs/RELEASE-0.7.7-ACTIONS-WORLD.md](docs/RELEASE-0.7.7-ACTIONS-WORLD.md)。新版 APK 为 `dist/releases/Eclipse-Belfry-Godot-v0.7.7-release.apk`。下文保留 v0.6.0 WebView 历史说明。

# 蚀月遗钟 · Eclipse Belfry

一款原创 Android 横版探索动作游戏。玩家扮演钟猎人“弦”，进入被月蚀封闭的灰烬修道院，通过战斗、跳跃、闪避、装备升级与隐藏路线追查失落钟声。

项目使用 GitHub 开源的 [LittleJS](https://github.com/KilledByAPixel/LittleJS) 1.11.13（MIT）。游戏名称、世界、人物、Boss、关卡和图像均为本项目原创，不使用《恶魔城》的名称、角色或资源。

## 七章主线与三结局（0.6.0）

从灰烬修道院依次进入空壳书库、血蔷薇庭、沉没旧城、机巧骨塔、蚀月王宫与钟源深渊。七章分别配置地图、背景、Boss 与剧情；每章三枚月魂，前六章各有两枚隐藏钟舌。原第一章 HUD 三枚但只有两个拾取点的问题已修复。

- **旅途地图：** 顶部“图”或 M；查看章节路线、任务、能力、记忆档案与结局条件，可回访已开启章节。靠近 NPC、祭坛、钟舌或锚点，点击情境按钮或按 E 交互。Android 返回键可关闭背包、技能和地图。
- **继续游戏：** 地图现场与成长、背包统一自动保存，启动后点击“继续旅途”恢复。每三秒及重要事件保存；死亡或“返回检查点”保留已获取的物品与记忆。旧版技能与装备存档继续可用。
- **新能力：** 第二章后纸翼强化滑行，在风柱中按住跳跃上升；第三章后可在空中靠近锚点使用荆棘链；第四章后水下安全行动并按住跳跃上浮；第五章后获得逆摆，减慢敌人与机关。
- **六技能 / 三槽：** 月刃、钟震、月盾、回旋月轮、荆棘突袭、逆摆。旅途页更换技能，冷却期间不可换装；L/U/O 对应三个槽。十一项刻印新增第三击增伤、破盾反击与闪避后追斩。
- **十六种背包物品：** 六武器、五护甲、三饰品、两消耗品。武器差异包括轻剑连段、重刃较长前摇、月轮飞刃、长链攻击距离和钟锤震波；护甲以属性和简单视觉标记区分，尚未做逐件完整角色图集。
- **终局：** 击败第七章 Boss 后可选择续钟或长夜；找齐十二钟舌，并在第一、四、六章与见证者交谈，开放共鸣。终局后仍可回访并见证其他结局。
- **新增美术：** 六张章节背景与六名 Boss 的四帧动作图集，使用内置 image_gen 生成，原始 PNG 随 APK 离线打包；提示词与路径见 [CAMPAIGN-PROMPTS.md](docs/art/CAMPAIGN-PROMPTS.md)。背景按当前章节加载，保留缺图时的程序绘制后备场景。

`npm run test:campaign` 检查七章拾取、实际 Boss 伤害、结算、重新加载、十二钟舌、三结局、装配技能、纸翼/钩索/水下行动和横屏布局。自动化使用受控角色位置与冷却，不能代替人工完整通关、难度评价或小米真机验收。

## 第一章基础内容

- 钟楼前庭、圣像回廊、赎罪礼拜堂、沉钟之室四个主区域
- 藏骨密道、血月祭坛两个隐藏区域
- 左右移动、跳跃、剑击、无敌帧闪避、受伤震动和检查点
- 六个普通敌人、可破坏墙、尖刺、银钥门与 Boss“无面钟守”
- 夜露药剂、三枚月魂碎片和隐藏武器“断罪银刃”
- Android 刘海安全区、横屏触控按钮、离线运行

## 运行和构建

```sh
npm install
npm start
npm run check
npm test
npm run android:release
```

APK 输出至 `dist/releases/Eclipse-Belfry-Android-v0.6.0-release.apk`。构建启用 Release 混淆、资源压缩并关闭调试；脚本验证签名、版本和非调试标志。为覆盖已安装的测试版，仍使用原有内部测试证书，不能据此视为已通过小米应用商店审核；上架需要正式签名和真机验收。

0.1.2 修复已在 Android 14 ARM64 模拟器复现的原生启动崩溃：`onCreate` 在内容视图创建前调用 `Window.getInsetsController()`，导致 `PhoneWindow` 对尚未初始化的 `DecorView` 解引用。全屏操作改在内容创建后的生命周期回调执行，并从实际 `DecorView` 获取控制器。

同时关闭引擎重复的全局触摸转鼠标处理，保留游戏自己的 Pointer Events 控件，修复触摸“开始/继续”被默认事件拦截的问题。启动回归使用真实触摸 `tap()`，不再以鼠标 `click()` 替代。

同时新增跨启动诊断：保存未捕获的 Java 异常和未完成的启动阶段，并在 Android 11+ 读取系统退出原因。发生异常退出后，再次打开时先显示原生诊断界面，避免直接重复触发启动故障。诊断仅保存在应用私有目录，不上传、不请求存储权限。

## 跳跃滑行、背包与装备（0.5.0）

- 左下角为统一的左右移动与起跳三键。每次跳跃沿面朝方向略向前移，按住方向可加强位移；第二次跳跃在下降阶段提供约 0.5 秒的缓降滑行，落地或滑行时间耗尽后结束。鸦羽技能与斗篷可延长滑行。镜头会跟随高处的角色。
- 顶部“包”或键盘 B 打开背包，暂停战斗。按类别浏览，查看当前属性和换装后变化；支持武器、护甲、饰品替换，以及快捷道具选择。Esc 或“返回游戏”关闭。
- 共有 3 种武器、3 种护甲、2 种饰品、2 种消耗品。初始提供猎人直剑、刻月法刃、猎人长衣、钟卫锁甲、蚀月坠饰，以及 3 份夜露药剂和 1 份清灵露，可直接尝试不同配装。
- 断罪银刃由藏骨密道遗物获得；击败第二只蝙蝠掉落鸦羽斗篷，第二位斧卫掉落守钟印记；斧卫还会掉落清灵露。重复装备不叠加，消耗品最多堆叠 99 份。
- 药剂拾取后进入背包。右下角快捷道具键或 Q 使用已选择道具：夜露药剂恢复生命，清灵露减少所有技能的剩余冷却 3 秒。满血或没有技能正在冷却时不消耗对应道具；连续使用有 0.75 秒间隔。
- 近战伤害、技能伤害、生命上限、减伤、技能冷却、护盾量与滑行时间都会受装备影响。换装及技能重置不会凭空恢复生命。
- 技能树显示包含装备加成的三技能伤害与冷却，可免费重置刻印、返还技能点以重新配装。经验、装备、背包数量和快捷槽一并自动保存；兼容旧版技能存档。
- `npm run test:inventory` 验证前移起跳、滑行、武器伤害、护甲减伤、拾取入包、快捷使用、存档恢复和手机布局。

## 斜向跳跃与三技能操作（0.4.0，历史版本）

- 左拇指控制左右方向，方向区上方新增“左前跳 / 右前跳”：单次点击同时起跳并带出水平速度。右拇指操作常用跳跃、攻击和闪避，可以稳定实现“按住左方向 + 按右侧跳跃”。
- 起跳继承水平速度，松开方向后保持空中惯性；空中可左右转向，二段跳也可以改变方向。未输入方向且静止时仍原地起跳。落地才恢复地面减速。
- 每个手指单独跟踪，松开跳跃不会误释放方向；暂停、技能树和窗口失焦会清除触摸状态。方向键之间可以滑动切换。
- 三个主动技能默认可用，独立按键、独立冷却，可衔接或同时释放：
  - **月刃**：远程穿透攻击，基础伤害 2，基础冷却 4 秒；L/V 键。
  - **钟震**：半径 2.7 的近身范围攻击，基础伤害 3，冷却 6 秒；U 键。
  - **月盾**：持续 3 秒，最多吸收 25 点伤害，冷却 10 秒；O 键。护盾被打破后剩余伤害扣除生命。
- 技能树新增“震钟余威”和“月辉庇护”，分别强化钟震伤害、月盾吸收量。现有技能节点及经验存档继续保留；新增节点默认 0 级，共 8 个节点，上下滑动查看。
- `npm run test:combat` 覆盖左前跳、右前跳、空中惯性、左右手配合、触摸释放、三技能同时释放、独立冷却及护盾吸收。

## 操作与技能升级（0.3.0，历史版本）

- 左下角为左右移动和跳跃；离地后再点跳跃可二段跳，落地恢复次数。走出平台后保留一次空中跳跃。
- 右下角为闪避、月刃技能和普通攻击。月刃默认可用，向面朝方向发射穿透敌人的能量刃，基础伤害 2、冷却 4 秒；不能穿过封闭的银钥门和可破坏墙。按钮显示剩余冷却秒数。
- 顶部“技”打开技能树并暂停战斗，点“返回游戏”继续。进攻、生存、身法三条分支共六个节点，升级前置条件、等级上限和所需点数会直接显示。
- 初始获得 2 技能点；普通敌人提供 30 经验、斧卫 45、月魂 40、Boss 120。首次升级需要 60 经验，随后每级增加 20；每次升级获得 1 技能点。重玩章节可继续积累经验。
- 技能可提升月刃伤害、缩短月刃冷却、增加生命上限及药剂恢复、提高二段跳高度、缩短闪避冷却。
- 经验和已学习技能保存在本机，重新开始章节和再次打开应用均保留。存储不可用时仍能游戏和升级，技能树会显示保存失败提示；不申请额外权限。
- 键盘：A/D 或左右方向键移动，W/空格/上方向键跳跃，J/X 攻击，K/C 闪避，L/V 释放月刃，I 打开技能树，Esc 关闭技能树。

功能与布局回归：`npm run test:skills`，覆盖真实双指输入、二段跳次数、技能命中与冷却、经验升级、保存恢复、存储不可用，以及 844×390、667×375、568×320 横屏布局。

## 人物与怪物美术升级（0.2.0）

- 主角改为 16 帧角色图集，区分待机、跑步、跳跃上升/下降、挥剑、闪避与受伤。
- 幽魂、斧卫、恶魔蝙蝠和无面钟守采用详细的服饰、骨骼与金属绘制，合计 16 帧；斧卫和 Boss 有攻击前摇和收招。
- 重绘药瓶、钥匙、银剑与月魂道具，加入悬浮光晕、剑迹、闪避残影和命中停顿。
- 使用内置图像生成工具制作原创二维精灵；脚底锚点和裁切在运行时处理，旧静态角色图不进入新版 APK。
- 保留 0.1.2 的原生启动、音频降级和触屏菜单修复。

美术约束与提示集见 [SPRITE-PROMPTS.md](docs/art/SPRITE-PROMPTS.md)。画面回归运行 `npm run test:art`，输出截图在 `artifacts/art-v2-*.png`。

## Android 启动兼容修复（0.1.1）

- 游戏脚本通过 esbuild 合并为普通脚本，并转换为 Chrome/WebView 70 语法，避免旧版 WebView 无法解析较新的 JavaScript。移除了 `Array.at` 依赖；系统 WebView 仍需提供 Canvas 2D 等游戏所需 API。
- 引擎不再在脚本加载时创建音频设备；点击开始后才尝试启用游戏音效，音频或震动不可用时可继续游戏。
- WebView 初始化失败、游戏脚本启动失败、Android 8+ 渲染进程退出时显示原生重试界面，支持复制手机型号、Android 版本、WebView 版本和错误信息。重新加载会从标题画面开始，本章进度会重置。
- 补充 WebView 使用的 `INTERNET` 权限；游戏页面及资源仍全部来自 APK，资源请求不向网络回退。

启动回归测试：`npm run test:startup`。该测试需要 Playwright 和 Chrome，可通过 `PLAYWRIGHT_MODULE`、`CHROME_PATH` 指定本机路径。测试在桌面 Chromium 中模拟音频/API 缺失及脚本异常，不等同于小米真机验收。

如果手机依旧退出，操作方法见 [Android 闪退诊断](docs/ANDROID-TROUBLESHOOTING.md)。

完整故事、章节与升级规划见 `docs/GAME-DESIGN.md`。