Godot实战（一）—— 用C#构建2D躲避游戏的核心机制

1. 环境准备与项目初始化第一次打开Godot引擎时那个简洁的界面可能会让你有点不知所措。别担心我们一步步来。点击New Project按钮给你的游戏项目起个名字比如DodgeTheCreeps。建议专门创建一个空文件夹来存放项目文件这样管理起来更方便。在项目设置中有几个关键参数需要调整进入Project - Project Settings找到Display - Window选项卡将Width设为480Height设为720在Stretch选项中Mode选择2dAspect选择keep这些设置确保了游戏在不同尺寸的屏幕上都能保持正确的比例。我刚开始用Godot时经常忽略这个步骤结果游戏在不同设备上显示效果千奇百怪后来才发现是这里没设置好。2. 创建玩家角色2.1 构建玩家场景在Scene面板中我们首先需要创建一个Area2D节点作为玩家角色的根节点。为什么选择Area2D而不是Sprite因为Area2D可以检测碰撞这对我们的躲避游戏至关重要。接下来添加这些子节点AnimatedSprite - 用于显示角色动画CollisionShape2D - 定义碰撞区域设置AnimatedSprite时我建议先准备好角色素材。你可以自己绘制简单的角色动画或者使用网上找到的免费素材。记得把Scale设为(0.5, 0.5)这样角色大小更合适。2.2 编写玩家移动代码玩家控制是游戏的核心我们使用C#来实现。创建一个Player.cs脚本核心代码如下[Export] public int Speed 400; // 玩家移动速度 public override void _Process(double delta) { var velocity Vector2.Zero; if (Input.IsActionPressed(move_right)) velocity.X 1; if (Input.IsActionPressed(move_left)) velocity.X - 1; if (Input.IsActionPressed(move_down)) velocity.Y 1; if (Input.IsActionPressed(move_up)) velocity.Y 1; if (velocity.Length() 0) { velocity velocity.Normalized() * Speed; GetNodeAnimatedSprite(AnimatedSprite).Play(); } else { GetNodeAnimatedSprite(AnimatedSprite).Stop(); } Position velocity * (float)delta; Position new Vector2( Mathf.Clamp(Position.x, 0, ScreenSize.x), Mathf.Clamp(Position.y, 0, ScreenSize.y) ); }这段代码实现了基本的WASD或方向键控制。Normalized()确保斜向移动时速度不会叠加Clamp()则防止角色跑出屏幕。3. 敌人生成系统3.1 创建敌人场景敌人我们使用RigidBody2D作为根节点这样可以利用物理引擎的特性。关键设置包括将Gravity Scale设为0敌人就不会下落取消勾选Mask属性的第一个框防止敌人互相碰撞添加VisibilityNotifier2D用于敌人离开屏幕时自动销毁敌人的动画可以多样化一些比如添加fly、swim、walk三种动画类型。在代码中随机选择一种public override void _Ready() { var animSprite GetNodeAnimatedSprite(AnimatedSprite); string[] mobTypes animSprite.Frames.GetAnimationNames(); animSprite.Animation mobTypes[GD.Randi() % mobTypes.Length]; }3.2 敌人生成逻辑在主场景中我们使用Path2D和PathFollow2D来生成敌人。这个设计很巧妙Path2D定义生成路径PathFollow2D可以在路径上随机定位。关键代码public void OnMobTimerTimeout() { var mob (Mob)MobScene.Instance(); var mobSpawnLocation GetNodePathFollow2D(MobPath/MobSpawnLocation); mobSpawnLocation.Offset GD.Randi(); float direction mobSpawnLocation.Rotation Mathf.Pi / 2; direction (float)GD.RandRange(-Mathf.Pi / 4, Mathf.Pi / 4); mob.Position mobSpawnLocation.Position; mob.Rotation direction; var velocity new Vector2((float)GD.RandRange(150.0, 250.0), 0); mob.LinearVelocity velocity.Rotated(direction); AddChild(mob); }这里有几个值得注意的点使用GD.Randi()实现随机位置方向计算考虑了路径的切线方向速度也加入了随机性让游戏更有趣4. 碰撞检测与游戏逻辑4.1 玩家碰撞处理当敌人碰到玩家时我们需要触发游戏逻辑。在Player.cs中添加[Signal] public delegate void Hit(); public void OnPlayerBodyEntered(PhysicsBody2D body) { Hide(); EmitSignal(nameof(Hit)); GetNodeCollisionShape2D(CollisionShape2D).SetDeferred(disabled, true); }这里使用了Godot的信号系统当碰撞发生时发出Hit信号。SetDeferred确保在物理回调中安全地修改碰撞属性。4.2 游戏状态管理主场景需要管理游戏状态包括开始、结束和计分public void NewGame() { Score 0; var player GetNodePlayer(Player); player.Start(GetNodePosition2D(StartPosition).Position); GetNodeTimer(StartTimer).Start(); GetTree().CallGroup(mobs, queue_free); } public void GameOver() { GetNodeTimer(MobTimer).Stop(); GetNodeTimer(ScoreTimer).Stop(); }NewGame()会重置分数、玩家位置并清除所有现存敌人。GameOver()则停止所有计时器。5. 用户界面实现5.1 HUD设计使用CanvasLayer创建游戏UI包含以下元素分数显示(ScoreLabel)游戏消息(Message)开始按钮(StartButton)关键功能实现public async void ShowGameOver() { ShowMessage(Game Over); await ToSignal(GetNodeTimer(MessageTimer), timeout); GetNodeLabel(Message).Text Dodge the\nCreeps!; GetNodeLabel(Message).Show(); await ToSignal(GetTree().CreateTimer(1), timeout); GetNodeButton(StartButton).Show(); }这个异步方法实现了游戏结束时的UI流程显示Game Over - 短暂等待 - 显示标题 - 显示开始按钮。5.2 分数系统分数系统由ScoreTimer驱动每秒增加1分public void OnScoreTimerTimeout() { Score; GetNodeHUD(HUD).UpdateScore(Score); }HUD的UpdateScore方法简单更新Label文本public void UpdateScore(int score) { GetNodeLabel(ScoreLabel).Text score.ToString(); }6. 游戏测试与优化完成所有功能后我们需要进行测试。点击编辑器右上角的Play按钮选择Main.tscn作为主场景。测试时注意以下几点玩家移动是否流畅敌人生成位置是否合理碰撞检测是否准确游戏状态转换是否正确如果发现敌人生成太密集可以调整MobTimer的Wait Time属性。游戏难度也可以通过修改敌人速度范围来调整。7. 常见问题解决在实际开发中我遇到过几个典型问题C#脚本修改后不生效这是因为Godot需要重新构建项目程序集。点击编辑器右上方的Build按钮或者使用底部的MSBuild工具。信号连接失败C#中信号连接要特别注意方法签名匹配。如果遇到问题可以尝试手动连接而不是依赖自动生成。性能问题当敌人数量很多时可能会影响性能。解决方案是优化碰撞形状使用简单几何体限制同时存在的敌人数量使用对象池技术重用敌人实例跨平台问题如果计划发布到移动设备需要考虑触控输入。可以添加虚拟摇杆或者将屏幕分为左右区域分别控制移动方向。8. 扩展思路基础版本完成后可以考虑添加更多功能多种敌人类型不同敌人可以有不同速度、大小和分数价值。道具系统添加临时加速、无敌等道具丰富游戏性。音效和背景音乐Godot的AudioStreamPlayer很容易实现音效。存档系统使用Godot的ConfigFile保存最高分等数据。粒子效果玩家被击中或获得道具时添加视觉效果。实现这些扩展时建议保持代码模块化。比如把道具系统单独做成一个场景和脚本这样不会影响现有功能的稳定性。