文件调整
This commit is contained in:
-138
@@ -1,138 +0,0 @@
|
||||
# Dev-C++ 运行说明
|
||||
|
||||
本项目可以尝试在 Dev-C++ 中运行，但更推荐使用 VS Code 和 `build-mingw.ps1` 脚本。Dev-C++ 对资源文件、Unicode 入口和链接库的处理更容易出现环境差异。
|
||||
|
||||
## 1. 工程类型
|
||||
|
||||
新建工程时请选择：
|
||||
|
||||
```text
|
||||
Windows Application
|
||||
```
|
||||
|
||||
不要选择控制台程序。
|
||||
|
||||
## 2. 需要加入工程的源码
|
||||
|
||||
源文件：
|
||||
|
||||
```text
|
||||
src/source/stdafx.cpp
|
||||
src/source/Tetris.cpp
|
||||
src/source/TetrisLogic.cpp
|
||||
src/source/TetrisRender.cpp
|
||||
src/source/TetrisRogue.cpp
|
||||
```
|
||||
|
||||
头文件目录：
|
||||
|
||||
```text
|
||||
src/include
|
||||
```
|
||||
|
||||
建议把以下头文件加入工程树，便于查看：
|
||||
|
||||
```text
|
||||
src/include/stdafx.h
|
||||
src/include/Tetris.h
|
||||
src/include/TetrisLogicInternal.h
|
||||
src/include/targetver.h
|
||||
src/include/resource.h
|
||||
```
|
||||
|
||||
## 3. 资源文件
|
||||
|
||||
资源文件为：
|
||||
|
||||
```text
|
||||
src/resources/Tetris.rc
|
||||
```
|
||||
|
||||
如果 Dev-C++ 能正常编译资源，可以加入该文件。
|
||||
如果资源编译失败，可以先不加入资源文件，只编译 C++ 源码。这样程序主体仍可运行，但图标、菜单等资源可能不完整。
|
||||
|
||||
## 4. 编译设置
|
||||
|
||||
建议：
|
||||
|
||||
- C++ 标准：`C++17`
|
||||
- 工程类型：Windows 程序
|
||||
- 字符集：Unicode
|
||||
|
||||
建议预处理宏：
|
||||
|
||||
```text
|
||||
UNICODE
|
||||
_UNICODE
|
||||
_WINDOWS
|
||||
```
|
||||
|
||||
建议编译 / 链接参数：
|
||||
|
||||
```text
|
||||
-mwindows
|
||||
-municode
|
||||
```
|
||||
|
||||
## 5. 链接库
|
||||
|
||||
需要链接以下库：
|
||||
|
||||
```text
|
||||
winmm
|
||||
gdi32
|
||||
user32
|
||||
comdlg32
|
||||
ole32
|
||||
gdiplus
|
||||
shell32
|
||||
```
|
||||
|
||||
如果出现 `undefined reference`，优先检查这些库是否正确加入。
|
||||
|
||||
## 6. 资源目录
|
||||
|
||||
运行时请保留：
|
||||
|
||||
```text
|
||||
assets/icons/
|
||||
assets/images/
|
||||
assets/audio/
|
||||
assets/video/
|
||||
```
|
||||
|
||||
这些资源用于：
|
||||
|
||||
- 程序图标
|
||||
- 背景图片
|
||||
- 背景音乐
|
||||
- 视频复活
|
||||
|
||||
如果工作目录设置不正确，程序可能找不到这些资源。
|
||||
|
||||
## 7. 常见问题
|
||||
|
||||
### 资源文件编译失败
|
||||
|
||||
Dev-C++ 的 `windres` 对资源文件编码和路径比较敏感。可以先不加入 `Tetris.rc`，或者改用项目自带脚本构建。
|
||||
|
||||
### 无法识别 `_tWinMain`
|
||||
|
||||
说明工程类型或 Unicode 参数不正确。请确认使用 Windows Application，并启用 Unicode 相关宏和 `-municode`。
|
||||
|
||||
### 背景、音乐或视频缺失
|
||||
|
||||
说明运行目录找不到 `assets/`。建议从项目根目录运行，或保持 exe 与资源目录的相对位置。
|
||||
|
||||
### 链接失败
|
||||
|
||||
检查是否加入了 `winmm`、`gdiplus`、`shell32` 等库。
|
||||
|
||||
## 8. 建议
|
||||
|
||||
Dev-C++ 适合作为备用运行方式。
|
||||
如果要稳定构建、调试和课堂展示，建议优先使用：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
|
||||
```
|
||||
@@ -4,6 +4,31 @@ Tereis 是一个基于 C++、Win32 API、GDI/GDI+ 实现的桌面版俄罗斯方
|
||||
|
||||
项目在经典俄罗斯方块玩法上扩展了 Rogue 模式，加入等级成长、强化选择、主动技能、特殊方块、视频复活、鼠标交互和视觉特效。程序不依赖游戏引擎，主要使用 Win32 消息循环和 GDI 绘图完成。
|
||||
|
||||
## 快速运行
|
||||
|
||||
推荐在 Windows + PowerShell + MinGW-w64 环境下运行。
|
||||
|
||||
1. 确认 `g++.exe` 和 `windres.exe` 已加入 `PATH`，或安装在 `C:\mingw64\bin\`。
|
||||
2. 在项目根目录执行构建并运行：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
|
||||
```
|
||||
|
||||
3. 如只需构建，不启动程序：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
|
||||
```
|
||||
|
||||
构建产物位于：
|
||||
|
||||
```text
|
||||
.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
运行时请从项目根目录启动程序，确保 `assets/` 目录可被读取，否则背景图、音乐和复活视频可能无法加载。
|
||||
|
||||
## 功能概览
|
||||
|
||||
### 经典模式
|
||||
@@ -91,6 +116,85 @@ Rogue 模式是本项目的主要扩展玩法。
|
||||
- 双重抉择 / 命运轮盘：Space 标记，Enter 确认已选强化
|
||||
- 鼠标操作：直接点击升级卡片即可选择或标记
|
||||
|
||||
## 运行说明
|
||||
|
||||
### 方式一：PowerShell 一键运行
|
||||
|
||||
在项目根目录打开 PowerShell，执行：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
|
||||
```
|
||||
|
||||
该命令会先编译项目，编译成功后自动启动游戏窗口。
|
||||
|
||||
### 方式二：先构建再运行
|
||||
|
||||
先在项目根目录执行构建：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
|
||||
```
|
||||
|
||||
构建成功后运行生成的程序：
|
||||
|
||||
```powershell
|
||||
.\.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
### 方式三：VS Code 运行和调试
|
||||
|
||||
项目已经配置好 VS Code 任务：
|
||||
|
||||
- 按 `Ctrl + Shift + B` 执行默认构建任务 `build Tetris MinGW`
|
||||
- 在任务列表中运行 `run Tetris MinGW` 可构建并启动游戏
|
||||
- 在“运行和调试”中选择 `Debug Tetris MinGW` 可启动调试
|
||||
|
||||
调试需要系统能找到 `gdb.exe`。如果无法调试，请确认 MinGW 的 `bin` 目录已经加入 `PATH`。
|
||||
|
||||
### 方式四：Visual Studio 中运行
|
||||
|
||||
本项目没有提供 Visual Studio 的 `.sln` 或 `.vcxproj` 工程文件，推荐在 Visual Studio 中打开项目文件夹，然后通过终端调用已有构建脚本运行。
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 打开 Visual Studio。
|
||||
2. 选择 `文件 -> 打开 -> 文件夹`，打开项目根目录 `Tereis`。
|
||||
3. 打开 Visual Studio 内置终端，或在项目根目录单独打开 PowerShell。
|
||||
4. 确认 MinGW-w64 已安装，并且 `g++.exe`、`windres.exe` 可以被系统找到。
|
||||
5. 在终端中执行：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
|
||||
```
|
||||
|
||||
如果只想编译，不立即运行：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
|
||||
```
|
||||
|
||||
编译成功后，程序位置为：
|
||||
|
||||
```text
|
||||
.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
也可以在 Visual Studio 的终端中运行：
|
||||
|
||||
```powershell
|
||||
.\.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
注意：不要直接把 `src` 目录中的单个 `.cpp` 文件当作独立程序运行。本项目由多个源文件、资源文件和 `assets/` 资源目录共同组成，必须通过项目根目录下的 `build-mingw.ps1` 构建。
|
||||
|
||||
### 运行注意事项
|
||||
|
||||
- 推荐始终从项目根目录启动程序。
|
||||
- 不建议直接双击 `.vscode-build\mingw\Tetris.exe`，因为工作目录可能不正确，导致 `assets/` 资源加载失败。
|
||||
- 如果重新构建时提示 `Tetris.exe: Permission denied`，请先关闭正在运行的游戏窗口。
|
||||
- 程序使用 Win32 桌面窗口运行，不会显示控制台窗口。
|
||||
|
||||
## 项目结构
|
||||
|
||||
```text
|
||||
@@ -118,8 +222,7 @@ Tereis/
|
||||
├─ .vscode-build/ 本地构建输出目录
|
||||
├─ build-mingw.ps1 MinGW 构建脚本
|
||||
├─ README.md 项目说明
|
||||
├─ VSCode运行说明.md VS Code 构建运行说明
|
||||
└─ Dev-C++运行说明.md Dev-C++ 兼容运行说明
|
||||
└─ AGENTS.md 项目协作和代码生成约束
|
||||
```
|
||||
|
||||
## 构建环境
|
||||
@@ -161,6 +264,20 @@ powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
|
||||
```
|
||||
|
||||
也可以直接运行已生成的程序：
|
||||
|
||||
```powershell
|
||||
.\.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
如果使用 VS Code：
|
||||
|
||||
- `Ctrl + Shift + B` 执行默认构建任务 `build Tetris MinGW`
|
||||
- 运行任务 `run Tetris MinGW` 可构建并启动游戏
|
||||
- 调试配置 `Debug Tetris MinGW` 会先构建，再使用 `gdb.exe` 启动调试
|
||||
|
||||
注意：直接双击 `.vscode-build\mingw\Tetris.exe` 时，当前工作目录可能不是项目根目录，资源文件可能无法正常读取。推荐从项目根目录通过脚本或 VS Code 任务启动。
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 1. 提示 `Tetris.exe: Permission denied`
|
||||
|
||||
@@ -1,331 +0,0 @@
|
||||
# Rogue 事件系统 TODO 评估
|
||||
|
||||
本文档用于整理后续 Rogue 随机事件方向，先做设计评估，不进入代码实现。
|
||||
|
||||
当前项目已经具备的基础：
|
||||
|
||||
- `workRegion[20][10]` 棋盘格，可直接做障碍、垃圾行、局部清除、压实等棋盘改动。
|
||||
- Rogue 模式已有危险等级、底部封锁行、下落速度变化、强化池、主动技能、特殊方块、Hold、Next 预览。
|
||||
- 消行结算、方块生成、计时器、渲染反馈已经集中在少数文件中，适合加一层“事件状态 + 事件调度”。
|
||||
|
||||
当前项目暂缺的基础：
|
||||
|
||||
- 没有通用随机事件调度器。
|
||||
- 棋盘格目前主要用数字表示普通方块/彩虹方块，缺少石头、污染、尖刺、锁链、目标块等细分格子类型。
|
||||
- 不规划 Boss/敌人系统；事件只作为 Rogue 随机事件存在。
|
||||
- 没有完整的事件 UI 状态栏、倒计时提示和事件历史展示。
|
||||
|
||||
## 第一阶段：最适合当前项目，优先考虑
|
||||
|
||||
这些事件基本能复用现有棋盘、计时、方块生成、Hold/Next、消行和反馈系统，改动相对可控。
|
||||
|
||||
- [ ] 底部随机升起：底部生成 1-3 行障碍，带少量空洞。
|
||||
- 适合度：高。
|
||||
- 原因：类似垃圾行，可直接移动棋盘并填充底部。
|
||||
- 注意：需要避免无预警秒杀，可加 2-3 秒提示。
|
||||
|
||||
- [ ] 墙体收缩：左右各封锁 1 列，持续 20 秒。
|
||||
- 适合度：高。
|
||||
- 原因：已有底部封锁概念，可扩展为临时左右边界。
|
||||
- 注意：碰撞、落点、渲染都要读取临时边界，避免只画不挡。
|
||||
|
||||
- [ ] 断层错位：随机选择几行，整体左/右平移 1 格。
|
||||
- 适合度：高。
|
||||
- 原因：直接操作 `workRegion` 行数据。
|
||||
- 注意：边缘溢出的格子如何处理需要规则化，建议溢出消失或反向空洞补位。
|
||||
|
||||
- [ ] 塌方：场上悬空方块向下坠落，重新压实。
|
||||
- 适合度：高。
|
||||
- 原因：项目已有 `ApplyBoardGravity()`，可复用或扩展。
|
||||
- 注意：作为负面事件时可能反而帮助玩家，需要定位为混合事件。
|
||||
|
||||
- [ ] 地刺：底部若干格变成尖刺，占位但可被消行清除。
|
||||
- 适合度：中高。
|
||||
- 原因：本质是特殊障碍格。
|
||||
- 注意：需要新增格子类型和渲染颜色，但规则简单。
|
||||
|
||||
- [ ] 封印列：某一列暂时不能放置方块，持续数个方块。
|
||||
- 适合度：高。
|
||||
- 原因：可通过碰撞检测禁止当前方块固定到该列。
|
||||
- 注意：需要明确“不能经过”还是“不能落地占用”，建议先做“不能落地占用”。
|
||||
|
||||
- [ ] 强风：当前方块每隔 1 秒自动向左/右偏移。
|
||||
- 适合度：高。
|
||||
- 原因：已有左右移动和计时器。
|
||||
- 注意：偏移前必须做碰撞检测；建议只作用于活动方块。
|
||||
|
||||
- [ ] 重力紊乱：方块下落速度周期性忽快忽慢。
|
||||
- 适合度：高。
|
||||
- 原因：已有 `currentFallInterval` 和 Rogue 下落速度计算。
|
||||
- 注意：需要避免与狂热、时间缓流等强化互相覆盖。
|
||||
|
||||
- [ ] 旋转失灵：每隔一个方块，有一个方块不能旋转。
|
||||
- 适合度：高。
|
||||
- 原因：只需在 `Rotate()` 入口判断事件状态。
|
||||
- 注意：UI 要明确提示，避免像输入失效。
|
||||
|
||||
- [ ] 镜像操作：左右移动反转，持续 10 秒。
|
||||
- 适合度：高。
|
||||
- 原因：输入分发处交换左右移动即可。
|
||||
- 注意：鼠标或未来触控输入也要统一处理。
|
||||
|
||||
- [ ] 粘滞空气：横移延迟增加，持续 15 秒。
|
||||
- 适合度：中。
|
||||
- 原因：当前键盘输入看起来偏即时响应，若没有 DAS/ARR 机制，需要先补横移节流。
|
||||
- 注意：实现成本比描述略高。
|
||||
|
||||
- [ ] 超重方块：当前方块落地后锁定时间大幅缩短。
|
||||
- 适合度：中。
|
||||
- 原因：若当前没有锁定延迟，需要先引入 lock delay。
|
||||
- 注意：没有锁定延迟时可以降级为“触底立即固定”。
|
||||
|
||||
- [ ] 长条枯竭：一段时间内 I 方块出现率降低。
|
||||
- 适合度：高。
|
||||
- 原因：已有 Rogue 方块权重生成。
|
||||
- 注意：不要完全禁用 I，避免体验过硬。
|
||||
|
||||
- [ ] 蛇群：接下来 6 个方块更容易出现 S/Z。
|
||||
- 适合度：高。
|
||||
- 原因：同样是方块生成权重调整。
|
||||
|
||||
- [ ] 小块雨：连续掉落若干 1x1 或 1x2 小块。
|
||||
- 适合度：中高。
|
||||
- 原因：可以作为特殊临时方块池。
|
||||
- 注意：现有方块数组是 7 种 4x4，需要扩展临时形状或伪装为特殊类型。
|
||||
|
||||
- [ ] 石化块：接下来 3 个方块落地后部分格子变石头。
|
||||
- 适合度：中高。
|
||||
- 原因：固定阶段可替换格子类型。
|
||||
- 注意：需要新增石头格规则：是否可消行、是否可被技能清除。
|
||||
|
||||
- [ ] 幽灵块：方块预览正常，但落下时形状随机变化一次。
|
||||
- 适合度：中高。
|
||||
- 原因：消费 Next 后替换当前 `type`。
|
||||
- 注意：变化后要重新校验出生位置，避免直接死亡。
|
||||
|
||||
- [ ] 高压：30 秒内必须消除 4 行，否则加垃圾行。
|
||||
- 适合度：高。
|
||||
- 原因：已有总消行统计和计时器。
|
||||
- 注意：要记录事件期间消行数，不用全局总数直接判断。
|
||||
|
||||
- [ ] 单消惩罚：单行消除会额外生成 1 行垃圾。
|
||||
- 适合度：高。
|
||||
- 原因：接在消行结算后处理。
|
||||
- 注意：对新手很重，适合短持续或中后期。
|
||||
|
||||
- [ ] 禁止四消：四消不会得分，反而生成障碍，短期事件。
|
||||
- 适合度：中高。
|
||||
- 原因：消行奖励处可拦截。
|
||||
- 注意：与现有“雷霆四消/赌命四消”强化冲突，需要定义优先级。
|
||||
|
||||
- [ ] Hold 冻结：暂时无法使用 Hold。
|
||||
- 适合度：高。
|
||||
- 原因：`HoldCurrentPiece()` 可直接判断事件状态。
|
||||
|
||||
- [ ] 幽灵落点失效：影子落点隐藏。
|
||||
- 适合度：高。
|
||||
- 原因：渲染处跳过落点绘制。
|
||||
|
||||
- [ ] 预览故障：Next 队列隐藏或随机显示假预览。
|
||||
- 适合度：中高。
|
||||
- 原因：渲染和实际队列分离即可。
|
||||
- 注意：假预览要清楚是事件效果，否则会像 bug。
|
||||
|
||||
- [ ] 盲盒方块：下一个方块落下前不显示形状。
|
||||
- 适合度：高。
|
||||
- 原因：比假预览更简单，只隐藏下一块显示。
|
||||
|
||||
- [ ] 色彩错乱：方块颜色随机打乱，影响识别。
|
||||
- 适合度：高。
|
||||
- 原因：只影响渲染颜色表映射。
|
||||
|
||||
- [ ] 强化过热：主动技能冷却或充能需求翻倍，持续 30 秒。
|
||||
- 适合度：中高。
|
||||
- 原因：已有清屏炸弹、黑洞、空中换形等主动能力。
|
||||
- 注意：当前更像次数/充能，不一定是冷却；描述可改为“充能需求提高”。
|
||||
|
||||
- [ ] 能量泄露：玩家能量条持续下降，消行可补充。
|
||||
- 适合度：中。
|
||||
- 原因：当前没有统一能量条，但有技能充能概念。
|
||||
- 注意：除非先做能量资源，否则建议暂缓。
|
||||
|
||||
- [ ] 装备短路：随机一个强化暂时失效。
|
||||
- 适合度：中高。
|
||||
- 原因：已有强化等级字段，可加临时禁用表。
|
||||
- 注意：需要避免禁用核心 UI/基础能力导致解释困难。
|
||||
|
||||
- [ ] 贪婪试炼：期间消行奖励翻倍，但每 10 秒加 1 行垃圾。
|
||||
- 适合度：高。
|
||||
- 原因：得分/经验倍率和垃圾行都能复用。
|
||||
|
||||
- [ ] 混乱祝福：下落速度提高，但消行奖励翻倍。
|
||||
- 适合度：高。
|
||||
- 原因：与当前 Rogue 风险收益强化风格一致。
|
||||
|
||||
- [ ] 危险长条：下一个必定是 I，但落地后生成 1 行垃圾。
|
||||
- 适合度：高。
|
||||
- 原因：直接改 Next 队列并挂一个落地后副作用。
|
||||
|
||||
- [ ] 猎杀时刻：生成目标块，清除后给奖励，失败则加障碍。
|
||||
- 适合度：中高。
|
||||
- 原因：需要目标格类型，但玩法清晰，展示效果好。
|
||||
|
||||
- [ ] 极限压缩：场地高度降低，但所有消行计为双倍。
|
||||
- 适合度：中高。
|
||||
- 原因：已有底部封锁和奖励计算。
|
||||
- 注意：与常驻危险等级封锁叠加时要设上限。
|
||||
|
||||
## 第二阶段：可做，但需要先补系统能力
|
||||
|
||||
这些事件有价值，但依赖特殊格子、持续状态、倒计时 UI、事件优先级或更复杂的结算顺序。
|
||||
|
||||
- [ ] 裂缝：随机列变成危险列，若 10 秒内没消除该列附近，会生成障碍。
|
||||
- 依赖：危险列标记、倒计时、附近消行判定。
|
||||
|
||||
- [ ] 污染区：随机 3x3 区域被污染，污染格消除后会扩散一次。
|
||||
- 依赖：污染格类型、扩散结算、特殊渲染。
|
||||
- 风险：规则复杂，容易和普通消行/技能清除冲突。
|
||||
|
||||
- [ ] 脆弱方块：当前方块每旋转一次，随机掉落一个单格碎片。
|
||||
- 依赖：活动方块局部拆分或生成独立固定格。
|
||||
- 风险：要定义碎片是否立即固定、是否触发消行。
|
||||
|
||||
- [ ] 磁力干扰：方块靠近障碍块时会被吸附，加速锁定。
|
||||
- 依赖：障碍格类型、锁定延迟或特殊横移规则。
|
||||
- 风险：玩家可读性较差。
|
||||
|
||||
- [ ] 巨型块：下一个方块变成五格或六格异形块。
|
||||
- 依赖：扩展方块形状系统。
|
||||
- 风险：现有 `bricks[7][4][4][4]` 固定为 7 种，需要重构或另建临时形状。
|
||||
|
||||
- [ ] 爆裂块：下一个方块落地后随机炸掉相邻格子，可能好也可能坏。
|
||||
- 依赖：落地后局部爆破和反馈。
|
||||
- 备注：已有爆破核心，可复用特效和清除函数。
|
||||
|
||||
- [ ] 锁链块：方块落地后被锁住，只有相邻消行才能解除。
|
||||
- 依赖：锁链格类型、相邻消行判定。
|
||||
- 风险：若锁住后不能正常消行，规则会很绕。
|
||||
|
||||
- [ ] 连击试炼：规定时间内保持连击，断连则触发惩罚。
|
||||
- 依赖：连击生命周期定义。
|
||||
- 备注：已有 `comboChain`，但需要确认何时断连。
|
||||
|
||||
- [ ] 精准清理：只有消除指定发光行才算有效消行。
|
||||
- 依赖：目标行标记、奖励过滤。
|
||||
- 风险：需要处理非目标行消除是否仍清棋盘。
|
||||
|
||||
- [ ] 过载清除：消行后不会立即消失，而是延迟 2 秒，期间仍占位。
|
||||
- 依赖：延迟消行队列。
|
||||
- 风险：会影响核心俄罗斯方块节奏，改动较大。
|
||||
|
||||
- [ ] 腐蚀行：某些行如果长期不被消除，会逐渐变成石头。
|
||||
- 依赖：按行计时、石头格类型。
|
||||
|
||||
- [ ] 献祭规则：每消 3 行会摧毁一个随机强化效果，持续短时间。
|
||||
- 依赖：强化临时禁用/降级机制。
|
||||
- 风险：永久摧毁太重，建议先做短时封印。
|
||||
|
||||
- [ ] 迷雾：只显示当前方块附近区域。
|
||||
- 依赖：渲染遮罩。
|
||||
- 风险：实现不难，但视觉遮挡强，需要短时使用。
|
||||
|
||||
- [ ] 倒计时遮蔽：场地部分区域被 UI 遮挡，数秒后消失。
|
||||
- 依赖：渲染遮罩和事件 UI。
|
||||
- 风险：可能被认为是不公平遮挡。
|
||||
|
||||
- [ ] 假警报：显示即将生成垃圾行的预警，但部分是假的。
|
||||
- 依赖：预警 UI 和真假队列。
|
||||
- 风险：需要先有稳定的真实预警系统。
|
||||
|
||||
- [ ] 诅咒回响：最近一次选择的强化产生副作用。
|
||||
- 依赖：记录最近强化、为每类强化配置副作用。
|
||||
- 风险：内容量较大。
|
||||
|
||||
- [ ] 保险失效：复活、护盾、防死类强化暂时不可用。
|
||||
- 依赖：临时禁用强化系统。
|
||||
- 备注：当前已有复活/最后一搏类能力，适合在禁用系统完成后做。
|
||||
|
||||
- [ ] 超载窗口：所有强化效果增强，但结束后生成大量垃圾行。
|
||||
- 依赖：强化倍率覆盖层。
|
||||
- 风险：需要为每个强化定义“增强”含义。
|
||||
|
||||
- [ ] 债务事件：立刻获得奖励，但未来 60 秒内难度提高。
|
||||
- 依赖：奖励发放、难度临时增益。
|
||||
- 备注：适合作为事件选择，而不是无条件负面事件。
|
||||
|
||||
- [ ] 不稳定炸弹：给一个炸弹块，能清障碍，但倒计时结束会爆坏场地。
|
||||
- 依赖：临时特殊方块、倒计时、坏爆炸规则。
|
||||
|
||||
- [ ] 交易事件：牺牲一个强化，换取清屏/降难度。
|
||||
- 依赖：事件选择 UI、强化移除或临时禁用。
|
||||
|
||||
- [ ] 祝福陷阱：获得临时强力效果，结束后触发一次负面事件。
|
||||
- 依赖：事件链和延迟触发。
|
||||
|
||||
## 第三阶段：攻击型随机事件，可选做
|
||||
|
||||
这些事件原本偏“敌人攻击”风格，但本项目不做 Boss 机制。若保留，只作为普通随机事件触发，不做血量、阶段、护盾和敌人 UI。
|
||||
|
||||
- [ ] 炮击：指定列被标记，数秒后生成障碍块。
|
||||
- 适合度：中高。
|
||||
- 备注：可以和裂缝共用“列预警 + 延迟生成障碍”的逻辑。
|
||||
|
||||
- [ ] 毒液喷洒：随机格变污染块，消行时才清除。
|
||||
- 适合度：中。
|
||||
- 备注：依赖污染格系统。
|
||||
|
||||
- [ ] 目标块入侵：场上出现几个需要消行击破的目标块。
|
||||
- 适合度：中。
|
||||
- 备注：可复用猎杀时刻目标块。
|
||||
|
||||
- [ ] 护盾阶段：不做。
|
||||
- 原因：依赖 Boss 血量、阶段和伤害规则，已经超出当前项目方向。
|
||||
|
||||
- [ ] 反击规则：玩家每次消行，额外生成 1 行垃圾。
|
||||
- 适合度：中。
|
||||
- 备注：可作为短时高压事件，但要避免和“单消惩罚”重复。
|
||||
|
||||
- [ ] 蓄力攻击：倒计时结束后生成大量垃圾，消行可延缓倒计时。
|
||||
- 适合度：中高。
|
||||
- 备注：作为普通倒计时事件即可。
|
||||
|
||||
- [ ] 寄生核心：一个核心块出现，每隔一段时间向周围扩散障碍。
|
||||
- 依赖：核心格、扩散逻辑、清除判定。
|
||||
|
||||
- [ ] 锁定轰炸：玩家最近放置最多的列被优先攻击。
|
||||
- 依赖：记录落子列热度。
|
||||
- 备注：可作为高级普通事件。
|
||||
|
||||
## 建议实现顺序
|
||||
|
||||
- [ ] 设计并新增 `RogueEventState`：当前事件、剩余时间、剩余方块数、事件参数、临时倍率、禁用标记。
|
||||
- [ ] 新增事件调度入口：只在 Rogue 模式中按时间/危险等级触发，避免经典模式受影响。
|
||||
- [ ] 新增事件提示 UI：事件名、剩余秒数、简短效果；先用右侧反馈面板，不做复杂界面。
|
||||
- [ ] 先完成 6 个低风险事件作为 MVP：
|
||||
- [ ] 底部随机升起
|
||||
- [ ] 强风
|
||||
- [ ] 重力紊乱
|
||||
- [ ] 镜像操作
|
||||
- [ ] 长条枯竭
|
||||
- [ ] 高压
|
||||
- [ ] 再完成 4 个能体现肉鸽取舍的混合事件：
|
||||
- [ ] 贪婪试炼
|
||||
- [ ] 混乱祝福
|
||||
- [ ] 危险长条
|
||||
- [ ] 极限压缩
|
||||
- [ ] 然后补特殊格子系统：
|
||||
- [ ] 石头格
|
||||
- [ ] 尖刺格
|
||||
- [ ] 污染格
|
||||
- [ ] 目标格
|
||||
- [ ] 锁链格
|
||||
- [ ] 特殊格子系统稳定后，再做污染、猎杀、寄生核心、锁链块、石化块。
|
||||
- [ ] 攻击型随机事件最后做；如果时间有限，只保留“炮击/蓄力攻击/锁定轰炸”三个最容易解释的事件。
|
||||
|
||||
## 不建议优先做的事件
|
||||
|
||||
- [ ] 过载清除：会改动消行核心节奏，容易引入状态错乱。
|
||||
- [ ] 巨型块：需要扩展方块数据结构，投入高。
|
||||
- [ ] 磁力干扰：可读性弱，调参成本高。
|
||||
- [ ] 倒计时遮蔽：玩家体验可能偏负面。
|
||||
- [ ] 护盾阶段：需要 Boss 血量和阶段机制，当前项目明确不做。
|
||||
-147
@@ -1,147 +0,0 @@
|
||||
# VS Code 运行说明
|
||||
|
||||
本项目推荐使用 `VS Code + MinGW-w64 + PowerShell` 构建和调试。
|
||||
|
||||
## 1. 环境准备
|
||||
|
||||
需要安装：
|
||||
|
||||
- Visual Studio Code
|
||||
- Microsoft C/C++ 扩展
|
||||
- MinGW-w64
|
||||
- PowerShell
|
||||
|
||||
MinGW 中至少需要：
|
||||
|
||||
- `g++.exe`
|
||||
- `windres.exe`
|
||||
- `gdb.exe`，仅调试时需要
|
||||
|
||||
## 2. 打开项目
|
||||
|
||||
请在 VS Code 中打开项目根目录，也就是包含以下文件和目录的位置：
|
||||
|
||||
```text
|
||||
build-mingw.ps1
|
||||
src/
|
||||
assets/
|
||||
.vscode/
|
||||
README.md
|
||||
```
|
||||
|
||||
不要只打开 `src/` 子目录，否则 VS Code 任务和调试配置无法正常工作。
|
||||
|
||||
## 3. 使用 VS Code 任务构建
|
||||
|
||||
按：
|
||||
|
||||
```text
|
||||
Ctrl + Shift + B
|
||||
```
|
||||
|
||||
默认会执行项目中的 MinGW 构建任务。
|
||||
|
||||
也可以打开命令面板，选择：
|
||||
|
||||
```text
|
||||
Tasks: Run Task
|
||||
```
|
||||
|
||||
然后运行：
|
||||
|
||||
- `build Tetris MinGW`
|
||||
- `run Tetris MinGW`
|
||||
|
||||
## 4. 使用命令行构建
|
||||
|
||||
在 VS Code 终端中进入项目根目录，执行：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1
|
||||
```
|
||||
|
||||
构建后直接运行：
|
||||
|
||||
```powershell
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
|
||||
```
|
||||
|
||||
## 5. 调试
|
||||
|
||||
按 `F5`，选择：
|
||||
|
||||
```text
|
||||
Debug Tetris MinGW
|
||||
```
|
||||
|
||||
调试配置会先构建项目，再启动：
|
||||
|
||||
```text
|
||||
.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
如果提示找不到 `gdb.exe`，说明 MinGW 的调试器没有安装或没有加入 `PATH`。
|
||||
|
||||
## 6. 构建输出
|
||||
|
||||
最终程序：
|
||||
|
||||
```text
|
||||
.vscode-build\mingw\Tetris.exe
|
||||
```
|
||||
|
||||
构建中间文件：
|
||||
|
||||
```text
|
||||
.vscode-build\mingw\Tetris.utf8.rc
|
||||
.vscode-build\mingw\Tetris.res.o
|
||||
```
|
||||
|
||||
这些中间文件不需要手动维护。
|
||||
|
||||
## 7. 资源文件
|
||||
|
||||
项目运行依赖：
|
||||
|
||||
```text
|
||||
assets/icons/
|
||||
assets/images/
|
||||
assets/audio/
|
||||
assets/video/
|
||||
```
|
||||
|
||||
如果只移动 `Tetris.exe` 而不带 `assets/`，会影响背景图、音乐和视频复活功能。
|
||||
|
||||
## 8. 常见问题
|
||||
|
||||
### 找不到 `g++.exe`
|
||||
|
||||
处理方式：
|
||||
|
||||
- 将 MinGW 的 `bin` 目录加入系统 `PATH`
|
||||
- 或将 MinGW 安装到 `C:\mingw64\bin\`
|
||||
|
||||
### 找不到 `windres.exe`
|
||||
|
||||
资源文件无法编译，图标和菜单资源可能缺失。请检查 MinGW 安装是否完整。
|
||||
|
||||
### `Tetris.exe: Permission denied`
|
||||
|
||||
说明程序正在运行，构建时无法覆盖旧 exe。
|
||||
|
||||
处理方式：
|
||||
|
||||
1. 关闭游戏窗口
|
||||
2. 重新构建
|
||||
|
||||
### 鼠标点击、按钮或界面不是最新版
|
||||
|
||||
通常是因为构建失败后仍在运行旧 exe。请确认构建命令成功完成。
|
||||
|
||||
## 9. 推荐运行流程
|
||||
|
||||
1. 打开项目根目录
|
||||
2. 关闭旧的游戏窗口
|
||||
3. 执行构建
|
||||
4. 运行 `.vscode-build\mingw\Tetris.exe`
|
||||
5. 如果要调试，按 `F5`
|
||||
Reference in New Issue
Block a user