# 二哥学园

**Repository Path**: egg2bot/erge-academy

## Basic Information

- **Project Name**: 二哥学园
- **Description**: 《二哥学园》是一款极简符号化的Console游戏。玩家操控一个代表“蛋”（二哥）的字符，在由文字符号构成的世界中滚动、跳跃，吸收代表负面情绪的“毒素”（梗），积蓄能量并最终破壳进化。游戏通过纯字幕叙事，内核致敬经典，旨在用最低的开销演绎当代压力图鉴，实现开发与叙事解耦。本仓库为核心程序原型。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-01-11
- **Last Updated**: 2026-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 二哥学园 (Erge Academy)

![游戏结束画面示例](https://foruda.gitee.com/images/1772995926768194945/e25297a9_5631341.png "游戏结束示例")

#### 介绍
《二哥学园》是一款极简符号化的控制台(Console)游戏。您将操控一个代表“蛋”（二哥）的字符 `二`，在由文字符号构成的动态世界中**滚动、跳跃**，吸收代表负面情绪的“毒素”（如 `毒`、`梗`、`压`），积蓄能量并最终**破壳进化**。

游戏通过纯字幕叙事，内核致敬经典《恐龙跳跃》，旨在用最低的系统开销，演绎一份当代“压力图鉴”。核心程序与叙事美术解耦，为社区共创留下空间。

#### 🎮 核心玩法与设计
*   **核心循环**：**滚动吸收（承受）→ 能量积蓄（成长）→ 破壳进化（抗衡）**。最终目标是对抗终极挑战。
*   **核心机制**：
    *   **二哥**：初始形态为 `二`。通过吸收毒素（绿色字符）进化：`二` → `哥` → `勇` → `神`。
    *   **障碍物 (`#`)**：从右侧出现，向左移动。碰到则游戏结束。
    *   **毒素 (`毒`/`梗`/`压`等)**：从右侧飘来，是进化的唯一途径。主动跳跃收集它们！
*   **艺术风格**：**极简符号化**。整个游戏世界由点、线、字符构成，用有限的颜色代表情绪（如红色障碍代表压力，绿色毒素代表可吸收的“梗”）。

#### 🚀 当前状态与近期里程碑
项目已从“概念定调”阶段正式进入“原型开发”，并完成了**可玩的基础版本**，后续持续迭代。

*   **最新进展（v0.3-alpha）**：
    *   ✅ **完成英文本地化**：替换所有中文 UI、提示和字符为英文，使用符号化角色（E→g→G→!）和毒素（T,S,A,R,X），适配纯英文 TTY 环境，同时保留全部游戏机制（上帝模式、测试模式、GPIO 等）。（2026-03-17，[提交 10746cf](https://gitee.com/egg2bot/erge-academy/commit/10746cfa279d8cc1d3288b9966f75f0b4dcb95ed)）
    *   ✅ **集成 Windows 音效（物理压缩救场）**：新增 `biu.wav`（毒素吸收）和 `gun.wav`（障碍碰撞），采用物理压缩大幅降低延迟，改善游戏听觉反馈。（2026-03-14，[提交 80c2359](https://gitee.com/egg2bot/erge-academy/commit/80c23590a22efab015290372745480b092281e33)）
    *   ✅ **压缩音效文件**：将 `biu.wav` 从 165KB 压缩至 27.5KB，`gun.wav` 从 181KB 压缩至 32KB，解决播放延迟问题。（2026-03-15，[提交 f5c2043](https://gitee.com/egg2bot/erge-academy/commit/f5c2043fdea9451cd5743c62ed55cce707e8a547)、[提交 97c0c21](https://gitee.com/egg2bot/erge-academy/commit/97c0c21e4641abac2b464ddab459bb9def9986f9)）
    *   ✅ **实现真正的跨平台运行**：移除顶层 Unix 模块导入，修复 Windows 兼容性问题，一份代码可在 Windows CMD、WSL、VisionFive 2 上无缝运行。（2026-03-14，[提交 b07dbfc](https://gitee.com/egg2bot/erge-academy/commit/b07dbfc5e67bd28724737a1955fb03728c3dcb00)）
    *   ✅ **支持 GPIO 传感器控制**：在 VisionFive 2 开发板上通过敲击传感器实现跳跃，拓展硬件交互场景，并完善串口调试说明。（2026-03-14，[提交 35d7210](https://gitee.com/egg2bot/erge-academy/commit/35d7210d8296eb83f40a4b7e620cf2ddd32c41c5)）
    *   ✅ **修复终端退出后输入异常**：优化游戏结束后的终端恢复逻辑，确保退出后控制台输入正常。（2026-03-09，[提交 bec9ec2](https://gitee.com/egg2bot/erge-academy/commit/bec9ec2fd835609d35505ffa7b9aa0e128b09071)）
    *   ✅ **优化开场动画字符显示**：提升动画稳定性和视觉效果。（2026-03-09，[提交 bec9ec2](https://gitee.com/egg2bot/erge-academy/commit/bec9ec2fd835609d35505ffa7b9aa0e128b09071)）
    *   ✅ **界面优化：添加毒素收集进度提示**：在状态栏显示当前毒素数量与下一进化形态所需数量，让玩家更清晰了解成长路径。（2026-03-08，[提交 31ca909](https://gitee.com/egg2bot/erge-academy/commit/31ca9093081adb819a14f178daea3454cfee9181)）

*   **版本更新（v0.2-alpha）**：
    *   ✅ 实现角色跳跃、障碍躲避、毒素收集的完整循环。
    *   ✅ 引入**参数配置文件 (`game_params.py`)**，重力、速度、关卡难度均可调。
    *   ✅ 增加**安全距离检查**，避免多个障碍物并行生成造成的“绝杀”情况。
    *   ✅ 设计三个难度递进的关卡：新手村、社会毒打、卷王之路。
    *   ✅ 添加测试模式 (`-t`) 和新手保护期，方便调试和上手。
    *   ✅ **新增上帝模式 (`-g` / `--god`)**：开启后角色不会因碰撞障碍物死亡，方便玩家探索关卡、练习操作或测试后期内容。该功能源于社区用户需求，并已在实践中验证可完整通关、体验所有进化形态（详见 [讨论记录 #IFTNRH](https://gitee.com/egg2bot/erge-academy/issues/IFTNRH)）。
    *   📌 **首次通关记录**：存活2分钟，进入第二关“社会毒打”。（详情见 [提交记录 88e5522](https://gitee.com/egg2bot/erge-academy/commit/88e5522d5b68db71432a56532346f67b0f82c5be)）


#### 🛠️ 安装与运行
1.  **确保环境**：需要 Python 3.6 或更高版本。
2.  **克隆仓库**：
    ```bash
    git clone https://gitee.com/egg2bot/erge-academy.git
    cd erge-academy
    ```
3.  **直接运行**（标准模式）：
    ```bash
    python3 run.py
    ```
4.  **测试模式**（新手保护期更长，可按 `T` 键主动添加毒素用于调试）：
    ```bash
    python3 run.py -t
    ```
5.  **上帝模式**（不死之身，适合探索关卡和练习）：
    ```bash
    python3 run.py -g
    ```

    ![god模式游戏界面](https://foruda.gitee.com/images/1773030998454804195/e1850a8c_5631341.png "god模式游戏界面")

    ![卷王之路](https://foruda.gitee.com/images/1773031073463188099/9a1d1882_5631341.png "卷王之路")

6.  **操作说明**：
    *   **左右移动**：`A` / `D` 或 方向键 `←` / `→`
    *   **跳跃**：`空格键` 或 `W` 或 方向键 `↑`
    *   **快速下落**：`S` 或 方向键 `↓`
    *   **退出游戏**：`Q`

    > **提示**：请确保终端窗口大小至少为 **80x25** 以保证画面显示正常。

#### 🧩 如何参与贡献
我们非常欢迎社区的参与，共同让“二哥”变得更有趣！您的需求和建议是项目改进的重要动力（例如上帝模式的诞生）。
1.  **调优参数**：所有游戏平衡参数都在 `game_params.py` 中，您可以修改并测试，找到更佳的难度曲线。
2.  **反馈问题**：在 [Issues](https://gitee.com/egg2bot/erge-academy/issues) 中提出您遇到的Bug或建议。
3.  **扩展内容**：可以基于现有框架，增加新的“毒素”类型、设计新关卡或Boss战。
4.  **提交代码**：
    *   Fork 本仓库
    *   新建您的特性分支 (`git checkout -b feature/AmazingFeature`)
    *   提交您的修改 (`git commit -m 'Add some AmazingFeature'`)
    *   推送到分支 (`git push origin feature/AmazingFeature`)
    *   打开一个 Pull Request

#### 📚 项目文档与历史
项目的设计思路和重要决策都记录在案，供参与者参考：
*   **[项目规划与验证 (#IDIY2T)](https://gitee.com/egg2bot/erge-academy/issues/IDIY2T)**：记录了从《滚蛋》到《二哥学园》的创意诞生、风格定调和初始仓库规划。
*   **[项目复盘 (#IFTIWK)](https://gitee.com/egg2bot/erge-academy/issues/IFTIWK)**：总结了从原型到可玩版本的迭代过程、遇到的问题和后续优化方向。
*   **[上帝模式添加指南 (#IFTNRH)](https://gitee.com/egg2bot/erge-academy/issues/IFTNRH)**：记录了上帝模式从用户需求提出、代码实现、问题修复到最终测试通过的完整过程，是社区驱动开发的典型案例。

#### 📄 开源协议
本项目采用 **MIT License**，欢迎自由使用、修改和分发。