Marry/CLAUDE.md

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++ 扩展

# 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 编译通过