85 行
2.8 KiB
Markdown
85 行
2.8 KiB
Markdown
# Pingpang
|
||
|
||
乒乓球对战游戏 — Godot 4.6 + C++ GDExtension
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
pingpang/
|
||
├── CMakeLists.txt # CMake 构建配置
|
||
├── build-pingpang.bat # Windows 一键编译脚本
|
||
├── godot-cpp/ # Godot C++ 绑定（git submodule, 4.5 分支）
|
||
├── src/ # C++ 源码
|
||
│ ├── register_types.cpp/h # GDExtension 入口 + 类注册
|
||
│ ├── pingpong_ball.cpp/h # 球（移动、碰撞、得分检测）
|
||
│ ├── pingpong_paddle.cpp/h # 球拍（玩家输入 / AI）
|
||
│ └── pingpong_game.cpp/h # 游戏管理（计分、状态）
|
||
├── main/ # Godot 项目目录
|
||
│ ├── project.godot # Godot 项目配置
|
||
│ ├── pingpang.gdextension # GDExtension 加载配置
|
||
│ ├── scenes/
|
||
│ │ └── main.tscn # 主场景
|
||
│ ├── bin/ # 编译产物（gitignore）
|
||
│ │ └── pingpang.dll
|
||
│ └── .godot/ # Godot 编辑器数据（gitignore）
|
||
└── bin/ # 历史遗留（即将清理）
|
||
```
|
||
|
||
## 开发环境
|
||
|
||
| 工具 | 版本/路径 |
|
||
|---|---|
|
||
| Godot 编辑器 | 4.6 (`F:/PCL/MyDownload/Godot_v4.6-stable_win64.exe`) |
|
||
| CMake | VS 2026 自带 |
|
||
| Visual Studio | 2026 (`D:/Visual Studio/`) |
|
||
| godot-cpp | 4.5 分支 |
|
||
|
||
## 编译 & 运行
|
||
|
||
### 编译 C++ 扩展
|
||
|
||
```bash
|
||
# Windows: 双击运行
|
||
build-pingpang.bat
|
||
|
||
# 或手动
|
||
cmake -S . -B build -G "Visual Studio 18 2026" -A x64
|
||
cmake --build build --config Release
|
||
```
|
||
|
||
编译产物 `pingpang.dll` 会自动输出到 `main/bin/`。
|
||
|
||
### 打开 Godot 项目
|
||
|
||
1. 启动 Godot 4.6 编辑器
|
||
2. 导入项目 → 选择 `main/` 目录
|
||
3. 打开后直接按 F5 运行
|
||
|
||
## 核心类说明
|
||
|
||
### PingPongBall (CharacterBody2D)
|
||
- `speed: float` — 球速（默认 400）
|
||
- `reset()` — 重置到屏幕中央，随机方向发射
|
||
- `scored(which: int)` 信号 — 0=左边得分, 1=右边得分
|
||
|
||
### PingPongPaddle (CharacterBody2D)
|
||
- `speed: float` — 移动速度（默认 350）
|
||
- `is_player: bool` — true=玩家控制, false=AI
|
||
- `ball_path: NodePath` — AI 模式下追踪的球节点
|
||
|
||
### PingPongGame (Node2D)
|
||
- `left_score: int` / `right_score: int` — 当前比分
|
||
- `max_score: int` — 获胜分数（默认 5）
|
||
- `game_over(winner: int)` 信号 — 0=左边赢, 1=右边赢
|
||
|
||
## 协作指南
|
||
|
||
1. **添加新的 GDExtension 类**：
|
||
- 在 `src/` 创建 `.cpp`/`.h` 文件
|
||
- 在 `src/register_types.cpp` 中 `GDREGISTER_CLASS()`
|
||
- 在 `CMakeLists.txt` 的 `add_library()` 中添加源文件
|
||
|
||
2. **场景编辑**：在 Godot 编辑器中编辑 `main/scenes/main.tscn`，所有 C++ 类可在节点列表中直接创建
|
||
|
||
3. **提交代码前**：确保 `build-pingpang.bat` 编译通过
|