# fngame

**Repository Path**: ypopenclaw/fngame

## Basic Information

- **Project Name**: fngame
- **Description**: 怀旧游戏厅 —— 把飞牛 NAS 变成怀旧游戏厅：内置开源/免费自制怀旧游戏（红白机/GBA/GB）+ 棋牌台球休闲游戏，手机打开飞牛 App 即点即玩。免费开源，不含任何商业 ROM/BIOS。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2026-09-27
- **Last Updated**: 2026-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 怀旧游戏厅（FNGAME）—— 把飞牛 NAS 变成一间怀旧游戏厅

> 仓库名 **FNGAME** ｜ 飞牛应用 ID（包名）：`gamehall`
> 手机打开飞牛 App 即点即玩 · 免费开源 · **不含任何商业 ROM / BIOS**

## 📌 项目简介

「怀旧游戏厅」跑在飞牛 NAS（fnOS）上：手机打开飞牛 App 就能玩**红白机(NES)、GBA、GB/GBC** 的怀旧小游戏，还内置了**台球、象棋**等休闲游戏。

- 首页就是**四个大入口**（红白机 / GBA / GB·GBC / 桌面小游戏），**点一下就玩**；黑底霓虹像素风，手机竖屏体验。
- 游戏是在**手机的浏览器里运行**（WebAssembly 模拟器），**NAS 只负责发文件、存存档** —— 几乎不占 NAS 的 CPU/内存。
- 内置游戏全部为**开源 / 免费可再分发**的自制(homebrew)作品；带**中文简介**与**操作说明**。
- 游戏目录可**自定义**（把你自己的游戏放进去），配图文教程；带**排行榜**（真实游玩计数）。

## 🔓 开源与可信（为什么可以放心用）

- **完全开源**：MIT 许可，全部源码都在仓库里，可逐行审计、可自行编译打包（`tools/build.sh`）
- **无后门、无遥测**：不含统计上报、埋点、广告、云同步或第三方 SDK；不需要注册账号
- **数据只在你自己的 NAS 上**：游玩记录 / 存档都保存在本机
- **不含任何商业游戏 ROM / BIOS**：内置游戏均为**开源或免费可再分发**的自制作品，许可与原作者见 `gamehall/app/roms/授权与来源.txt`
- **唯一外部连接**：从 **EmulatorJS 官方 CDN** 拉取模拟器内核（发生在客户端手机浏览器；本应用自带代理以便国内网络访问）

## ✨ 功能

- 🕹️ **怀旧游戏机**：红白机 NES / GBA / GB·GBC（均为**免 BIOS** 机种），每机种内置 4 款游戏
- 🎲 **休闲游戏**：台球、中国象棋、国际象棋、五子棋、黑白棋、纸牌接龙、21 点、记忆翻牌（**手机点划操作**，不用手柄，自带音效）
- 📱 **手机友好**：游戏内「← 返回游戏厅」按钮，并**接管手机返回键**（返回只关游戏、不退出应用）
- 🏆 **排行榜**：统计每款游戏有多少人在玩 / 玩了多少次
- 📁 **游戏目录自选**：应用内可浏览存储空间、新建文件夹、改保存目录
- 📝 **中文简介 + 🎮 操作说明**：每款游戏都有，玩法一眼看懂
- 📱 **手机优先**：网页即用，可选「添加到主屏幕」当 PWA

## 🎮 内置游戏与授权

**怀旧游戏机（12 款）** —— 来源数据库：Homebrew Hub (hh.gbdev.io)

| 机种 | 游戏 | 作者 | 许可 |
|---|---|---|---|
| 红白机 NES | Nova the Squirrel | NovaSquirrel | GPL-3.0 |
| 红白机 NES | Thwaite | Damian Yerrick | GPL-3.0 |
| 红白机 NES | Cybercoaster | — | CC-BY-4.0 |
| 红白机 NES | RHDE: Furniture Fight | Damian Yerrick | 自由发布（见来源） |
| GBA | Apotris | Akouzoukos | GPL-3.0 |
| GBA | µCity Advance | AntonioND | GPL-3.0-or-later |
| GBA | Minicraft for GBA | — | GPL-3.0-or-later |
| GBA | MeteoRain | — | MIT |
| GB / GBC | 贪吃蛇 Snake | Yvar de Groot | WTFPL-2.0 |
| GB / GBC | Rebound（打砖块） | — | MIT |
| GB / GBC | Big2Small | mdsteele | GPL-3.0-or-later |
| GB / GBC | 2048gb | — | Zlib |

**休闲游戏（8 款）** —— 均为本项目**自研**或使用许可明确的开源组件

| 游戏 | 说明 | 授权 |
|---|---|---|
| 🎱 台球 | 自研 2D 物理 | 本项目（MIT） |
| 🀄 中国象棋 | 自研规则 + AI | 本项目（MIT） |
| ♟️ 国际象棋 | 界面自研 + 引擎 [chess.js](https://github.com/jhlywa/chess.js) | chess.js = BSD-2 |
| ⚫ 五子棋 / ⚪ 黑白棋 | 自研 + AI | 本项目（MIT） |
| 🎴 纸牌接龙 / 🃏 21点 / 🧠 记忆翻牌 | 自研 | 本项目（MIT） |

## 📸 截图

| 首页（四个入口） | 红白机 NES | 桌面小游戏（8 款） |
| --- | --- | --- |
| ![首页](screenshots/home.png) | ![红白机](screenshots/nes.png) | ![桌面小游戏](screenshots/casual.png) |

| 台球 | 中国象棋 | 国际象棋 |
| --- | --- | --- |
| ![台球](screenshots/pool.png) | ![象棋](screenshots/xiangqi.png) | ![国际象棋](screenshots/chess.png) |

| 排行榜 | 设置（游戏目录 + 图文教程） | 纸牌接龙 |
| --- | --- | --- |
| ![排行榜](screenshots/rank.png) | ![设置](screenshots/settings.png) | ![接龙](screenshots/solitaire.png) |

## 🚀 安装

1. 到 **Releases** 下载 `fn-gamehall-<版本>.fpk`（当前版本 **0.6.5**）
2. 飞牛应用中心 →「**手动安装**」→ 选择安装包
3. 打开「怀旧游戏厅」即可

> 自行打包：`tools/build.sh`（需要 fnOS 自带的 `fnpack`，通常在 `/usr/local/bin/fnpack`）

## 📁 游戏目录 & 自己加游戏

- **默认目录**：`/vol2/1000/Games`（可在应用内「⚙️ 设置」里改）
- **加游戏**：把游戏文件（`.nes` / `.gba` / `.gb` / `.gbc`）放进该目录 → 重进应用即会刷新出现
- 传输方式：飞牛 App「文件」上传，或电脑通过 SMB（`\\NAS的IP`）拷进去
- 应用内「找游戏」入口整理了开源/自制游戏下载站（Homebrew Hub、itch.io、pdroms 等）

## ⚖️ 版权声明

- 本应用只是**播放器**，**不提供任何游戏文件**
- **不含任何商业 ROM / BIOS**
- 内置游戏均为开源/免费自制作品，原作者署名与许可见 `gamehall/app/roms/授权与来源.txt`
- 你自行添加的游戏文件，请务必**从合法渠道获取**；如需游玩经典商业游戏，请使用**你自己卡带的合法备份**
- 「找游戏」只连**开源 / 自制**资源站，不提供、不引导任何盗版资源
- 本应用与任天堂（Nintendo）等厂商**无任何关联**

## 🙏 致谢

- [EmulatorJS](https://emulatorjs.org/)（GPL-3.0）—— 客户端模拟器内核
- [chess.js](https://github.com/jhlywa/chess.js)（BSD-2）—— 国际象棋规则引擎
- 所有内置游戏的原作者（见 `授权与来源.txt`）
- 自制游戏数据库：[Homebrew Hub](https://hh.gbdev.io)

## 📄 许可

[MIT](LICENSE)