微信小游戏 FlappyBird 示例（FlappyBird）

Aquaria 是一款由 Bit Blot 开发的 2D 水下动作冒险游戏，其源码在 icculus.org 上以开源形式发布。由于原仓库长期缺乏维护，AquariaOSE 分支接手了后续的维护工作。根据 README 的说明，这一分支相较原版加入了较多增强，但具体增强项在 README 中并未逐条列出，需要进一步核验。

需要特别注意的是，本仓库只包含 Aquaria 的 C/C++ 源码以及必要的构建脚本，不包含任何图像文件和音频文件。因此，它并不是一个开箱即用的完整游戏，而是一份需要与原版商业游戏数据配合使用的源码工程。

技术要点

从 README 的构建说明可以确认以下技术依赖：

• 语言与构建：C/C++ 源码，使用 CMake 生成构建文件，make 完成编译。
• 依赖库：Lua 5.1、libogg、libvorbis、OpenAL、SDL 1.2。Debian 系对应的包名为 build-essential cmake liblua5.1-0-dev libogg-dev libvorbis-dev libopenal-dev libsdl1.2-dev。
• 编译选项：通过 ccmake 可以指定编译期选项；Windows 构建或希望自包含的 Linux 构建，建议把 AQUARIA_INTERNAL_* 系列 CMake 变量设为 TRUE，以使用内置依赖。
• 数据路径相关选项：AQUARIA_DEFAULT_DATA_DIR 用于设定默认游戏数据目录，AQUARIA_EXTRA_DATA_DIR 用于指定打包时额外文件的安装位置。
• 手柄震动：SDL 1.2 本身不支持震动，README 提供了一个 Linux 下的临时方案，通过 AQUARIA_EVENT_JOYSTICK0 环境变量把手柄索引映射到 /dev/input/event* 设备节点。

构建与运行

README 给出的标准构建步骤如下：

1. 安装依赖：C++ 编译器以及上述若干库。
2. 创建并进入构建目录：mkdir cmake-build && cd cmake-build。
3. 运行 cmake ..；若需指定编译选项，改用 ccmake ..。
4. 若缺少依赖，安装后重新运行 cmake。
5. 执行 make。
6. 构建成功后，当前目录下会生成 aquaria 可执行文件。

运行前必须先拥有原版完整游戏（Windows、Linux 或 macOS 版本均可）。README 给出了三种配置方式：

• 快速上手：把编译出的可执行文件复制到 Aquaria 根目录，再把仓库 files 目录内的所有文件复制过去并覆盖同名文件。注意不要删除安装目录中的任何文件，只是替换其中一部分；在 macOS 上用 Finder 操作时要小心，它会替换整个文件夹而不是合并。
• 频繁更新或参与开发：Linux/macOS 下设置 AQUARIA_DATA_PATH 指向安装目录，并在该目录内创建指向仓库 files 目录的 override 符号链接；Windows 下建议使用 junction（硬链接扩展工具）把 files 链接到编译输出目录。
• Linux 打包维护者：固定 AQUARIA_DEFAULT_DATA_DIR，确保包内包含 files 目录的全部文件，并用 AQUARIA_EXTRA_DATA_DIR 指定这些额外文件的安装位置；同时需要保证 ~/.Aquaria/_mods/*/scripts/ 下的 mod 脚本与仓库 game_scripts/_mods 保持同步。

若想游玩随附的默认 mod，还需把 game_scripts/_mods 复制到本地的 _mods 目录。遇到问题时，README 指向 IRC 频道 #bitblot @ irc.esper.net 获取支持。