GameJs — 基于 HTML Canvas 的 2D 游戏开发库

本仓库是开源同人游戏《Zelda: Mystery of Solarus DX》（简称 ZSDX）的游戏数据包，并非完整可执行程序。它需要配合开源类塞尔达 2D 游戏引擎 Solarus 才能运行。游戏数据以 Lua 脚本、图像、音频等资源形式组织，遵循 Solarus 引擎的任务（quest）数据结构。

README 明确指出，本仓库已迁移至 GitLab（https://gitlab.com/solarus-games/zsdx），原 GitHub 仓库不再更新。因此，若需获取最新代码或参与贡献，应访问 GitLab 上的新地址。

本数据包本身不包含引擎二进制，玩家需预先安装 Solarus 引擎。游戏内容为免费开源，具体玩法、剧情与关卡设计请以官方文档和实际运行为准。

玩法指南

本仓库为数据包，不直接提供玩法说明。根据 README，运行游戏需以下步骤：

1. 确保已安装 Solarus 引擎（solarus_run 可执行文件）。
2. 进入包含 data 子目录的仓库根目录。
3. 执行 solarus_run . 启动游戏；若引擎编译时默认任务路径为 .，也可直接运行 solarus_run。

游戏内容为类塞尔达 2D 动作冒险，具体操作、剧情与关卡请以游戏内提示和官方文档为准。

技术要点

• 主要语言：Lua，用于编写游戏逻辑、地图事件、敌人行为等。
• 引擎依赖：Solarus 引擎（C++ 编写），提供渲染、音频、输入、物理等底层能力。
• 构建系统：使用 CMake 管理构建流程，依赖 zip 工具生成 data.solarus 归档。
• 安装布局：默认安装到 /usr/local/share/solarus/zsdx/，并在 /usr/local/bin/ 生成启动脚本 zsdx。
• 路径解析：solarus_run 接受包含 data 子目录的路径，或包含 data.solarus 压缩包的路径。

构建与安装

README 提供了完整的构建与安装指引，适用于希望将游戏安装到系统的用户。

直接运行

无需构建，在仓库根目录执行：

solarus_run .

或（若引擎默认任务路径为 .）：

solarus_run

默认安装

需要 CMake 和 zip 工具：

cmake .
make
make install

默认安装到 /usr/local，生成：

• /usr/local/share/solarus/zsdx/data.solarus（数据归档）
• /usr/local/bin/zsdx（启动脚本）

之后可直接运行 zsdx 启动游戏。

自定义安装目录

通过 CMake 变量指定前缀，避免需要 root 权限：

cmake -D CMAKE_INSTALL_PREFIX=/home/your_directory .
make
make install

安装后的文件路径将基于指定前缀，启动脚本会自动使用正确的任务路径。