Godot RayCast2D实现智能敌人AI：从原理到实战完整指南

在游戏开发中，为敌人角色添加智能行为是提升游戏体验的关键环节。很多开发者在实现敌人AI时容易陷入复杂的状态机或行为树，但其实使用Godot内置的RayCast2D节点就能快速实现基础的敌人AI功能。本文将完整讲解如何利用RayCast2D为2D游戏中的敌人添加玩家检测和追踪能力，包含从原理到实战的全流程。

无论你是刚接触Godot的新手，还是希望优化现有敌人AI的开发者，都能通过本文掌握RayCast2D的核心用法。我们将从RayCast2D的基本概念开始，逐步构建一个完整的敌人AI系统，包含视觉检测、状态切换和智能移动等核心功能。

1. RayCast2D技术背景与核心概念

1.1 什么是RayCast2D

RayCast2D是Godot引擎中用于2D场景的射线检测组件。它的工作原理类似于现实世界中的手电筒光束——从指定起点发射一条射线，检测射线路径上是否与碰撞体相交。这种技术广泛应用于游戏开发的多个领域：

• 敌人AI：检测玩家是否在视线范围内
• 武器系统：判断子弹是否命中目标
• 环境交互：检测角色是否着地或碰到墙壁
• 谜题机制：激光反射、视线解谜等

与传统的距离检测相比，RayCast2D的优势在于能够检测视线是否被障碍物阻挡，更符合现实世界的视觉逻辑。

1.2 RayCast2D在敌人AI中的应用价值

在敌人AI设计中，RayCast2D主要解决以下核心问题：

1. 视线检测：敌人只能"看到"没有被障碍物阻挡的玩家
2. 距离感知：精确控制敌人的检测范围
3. 方向判断：确定玩家相对于敌人的方位
4. 多目标处理：通过多条射线实现更复杂的检测模式

传统的基于距离的检测方法简单但不够真实——敌人可能会"隔墙发现"玩家。而RayCast2D提供了更真实的视觉模拟，让游戏AI表现更加自然。

1.3 技术方案对比

在实现敌人AI时，开发者通常有几种选择：

对于大多数2D游戏的敌人AI需求，RayCast2D在真实性和实现复杂度之间提供了最佳平衡。

2. 环境准备与Godot项目设置

2.1 Godot版本与项目配置

本文基于Godot 4.2版本进行演示，但核心概念适用于Godot 3.x和4.x系列。建议使用较新的稳定版本以获得最佳开发体验。

创建新项目时的重要配置：

1. 渲染器选择：对于2D项目，建议使用兼容性渲染器以确保最大兼容性
2. 项目设置：确保"Layer Names"中已正确定义2D物理层，特别是为玩家、敌人、障碍物分配不同的碰撞层
3. 输入映射：提前设置好玩家控制所需的输入动作（如"ui_right", "ui_left", "ui_up", "ui_down"）

2.2 基础场景结构搭建

在开始实现敌人AI前，需要建立基础的场景结构：

# 主场景结构建议 Main (Node2D) ├── TileMap (环境地图，包含碰撞形状) ├── Player (CharacterBody2D) │ ├── Sprite2D │ └── CollisionShape2D └── Enemies (Node2D) └── Enemy (CharacterBody2D) ├── Sprite2D ├── CollisionShape2D └── RayCast2D (AI视觉检测)

2.3 碰撞层配置

正确的碰撞层配置是RayCast2D正常工作的关键：

1. 打开"项目设置" → "层名称" → "2D物理"

2. 设置层名称（示例配置）：

   • 第1层: player（玩家）
   • 第2层: enemy（敌人）
   • 第3层: obstacle（障碍物）
   • 第4层: collectible（可收集物品）

3. 为每个场景节点设置正确的碰撞层和掩码：

   • 玩家：层1，掩码2+3（与敌人和障碍物碰撞）
   • 敌人：层2，掩码1+3（与玩家和障碍物碰撞）
   • 障碍物：层3，掩码1+2（与玩家和敌人碰撞）

3. RayCast2D核心原理与参数详解

3.1 RayCast2D关键属性解析

RayCast2D节点的配置直接影响检测效果，以下是核心属性说明：

# 在敌人场景的_ready()函数中配置RayCast2D func _ready(): # 射线长度 - 控制敌人的视觉范围 $RayCast2D.target_position = Vector2(300, 0) # 300像素检测范围 # 碰撞掩码 - 指定检测哪些类型的物体 $RayCast2D.collision_mask = 1 + 4 # 检测玩家(层1)和可收集物(层4) # 排除自身碰撞 - 避免射线与敌人自身碰撞 $RayCast2D.exclude_parent = true # 启用检测 - 默认启用射线检测 $RayCast2D.enabled = true # 调试显示 - 开发期间可见射线 $RayCast2D.debug_shape_custom_color = Color.RED $RayCast2D.debug_shape_thickness = 2

target_position：射线目标位置，相对于RayCast2D节点的位置。这个向量决定了射线的方向和长度。例如Vector2(300, 0)表示向右发射300像素长的射线。

collision_mask：碰撞掩码，使用位运算指定检测哪些碰撞层。如果玩家在层1，障碍物在层3，则collision_mask = 1 + 8表示只检测玩家和障碍物。

exclude_parent：排除父节点碰撞，避免射线与包含RayCast2D的敌人自身发生碰撞。

3.2 射线检测的工作流程

RayCast2D的检测过程遵循以下流程：

1. 射线发射：每帧从RayCast2D节点的全局位置向target_position方向发射射线
2. 碰撞检测：检测射线路径上与collision_mask指定层中的碰撞体交集
3. 结果返回：如果有碰撞，返回碰撞点、碰撞法线、碰撞对象等信息
4. 状态更新：通过is_colliding()方法获取当前帧的碰撞状态

func _physics_process(delta): # 每帧更新射线方向（面向玩家或移动方向） update_ray_direction() # 检查是否有碰撞 if $RayCast2D.is_colliding(): var collider = $RayCast2D.get_collider() # 判断碰撞对象类型 if collider.is_in_group("player"): # 发现玩家，触发追踪行为 player_detected = true last_known_position = collider.global_position

3.3 多射线检测策略

单一射线检测存在视野狭窄的问题，实战中通常使用多条射线实现更自然的视觉检测：

# 多射线配置示例 var rays = [] # 射线数组 func setup_rays(): # 创建多条不同角度的射线 var directions = [ Vector2(1, 0), # 正前方 Vector2(0.87, 0.5), # 右前方30度 Vector2(0.5, 0.87), # 右前方60度 Vector2(0, 1), # 正上方（如果需要） Vector2(-0.5, 0.87) # 左前方60度 ] for dir in directions: var new_ray = RayCast2D.new() new_ray.target_position = dir * 250 # 250像素长度 new_ray.collision_mask = 1 # 只检测玩家 new_ray.enabled = true add_child(new_ray) rays.append(new_ray)

这种多射线配置让敌人拥有更宽的视野，减少因玩家恰好在射线间隙而无法被检测到的情况。

4. 完整敌人AI系统实现

4.1 敌人场景结构设计

创建完整的敌人场景结构，包含视觉、碰撞、AI组件：

# Enemy场景结构 Enemy (CharacterBody2D) ├── Sprite2D (敌人外观) ├── CollisionShape2D (圆形或矩形碰撞体) ├── RayCast2D (主检测射线) ├── DetectionArea (Area2D, 近距离检测区域) └── StateLabel (Label, 调试用状态显示)

为敌人创建基础脚本，定义AI状态机：

extends CharacterBody2D enum AIState {IDLE, PATROL, CHASE, RETURN} @export var patrol_speed: float = 50.0 @export var chase_speed: float = 150.0 @export var detection_range: float = 300.0 var current_state: AIState = AIState.IDLE var player_detected: bool = false var last_known_position: Vector2 var patrol_points: Array var current_patrol_index: int = 0 @onready var ray_cast: RayCast2D = $RayCast2D @onready var detection_area: Area2D = $DetectionArea func _ready(): # 初始化巡逻点（可根据实际场景调整） patrol_points = [global_position, global_position + Vector2(200, 0)] setup_ray_cast() setup_detection_area() func setup_ray_cast(): ray_cast.target_position = Vector2(detection_range, 0) ray_cast.collision_mask = 1 # 玩家层 ray_cast.exclude_parent = true func setup_detection_area(): var collision_shape = CollisionShape2D.new() var circle_shape = CircleShape2D.new() circle_shape.radius = 80 # 近距离检测半径 collision_shape.shape = circle_shape detection_area.add_child(collision_shape) # 连接区域信号 detection_area.body_entered.connect(_on_detection_area_body_entered) detection_area.body_exited.connect(_on_detection_area_body_exited)

4.2 状态机实现

敌人的AI行为通过状态机管理，每个状态对应不同的行为逻辑：

func _physics_process(delta): update_ray_direction() update_ai_state() handle_state_behavior(delta) move_and_slide() func update_ray_direction(): # 根据移动方向或玩家位置调整射线方向 if player_detected and last_known_position: var direction_to_player = (last_known_position - global_position).normalized() ray_cast.target_position = direction_to_player * detection_range elif current_state == AIState.PATROL: var patrol_direction = (patrol_points[current_patrol_index] - global_position).normalized() ray_cast.target_position = patrol_direction * detection_range func update_ai_state(): var can_see_player = check_player_visibility() match current_state: AIState.IDLE: if can_see_player: current_state = AIState.CHASE elif should_start_patrol(): current_state = AIState.PATROL AIState.PATROL: if can_see_player: current_state = AIState.CHASE elif reached_patrol_point(): advance_patrol_point() AIState.CHASE: if not can_see_player and not player_in_detection_area(): current_state = AIState.RETURN elif lost_player_for_too_long(): current_state = AIState.RETURN AIState.RETURN: if returned_to_start(): current_state = AIState.IDLE elif can_see_player: current_state = AIState.CHASE func handle_state_behavior(delta): match current_state: AIState.IDLE: velocity = Vector2.ZERO AIState.PATROL: var target_point = patrol_points[current_patrol_index] var direction = (target_point - global_position).normalized() velocity = direction * patrol_speed AIState.CHASE: if last_known_position: var direction = (last_known_position - global_position).normalized() velocity = direction * chase_speed AIState.RETURN: var start_position = patrol_points[0] var direction = (start_position - global_position).normalized() velocity = direction * patrol_speed

4.3 玩家检测逻辑

实现精确的玩家检测机制，结合射线和区域检测：

func check_player_visibility() -> bool: # 检查主射线是否碰撞到玩家 if ray_cast.is_colliding(): var collider = ray_cast.get_collider() if collider and collider.is_in_group("player"): last_known_position = collider.global_position return true # 检查其他射线（如果配置了多射线系统） for ray in rays: if ray.is_colliding(): var collider = ray.get_collider() if collider and collider.is_in_group("player"): last_known_position = collider.global_position return true return false func _on_detection_area_body_entered(body): if body.is_in_group("player"): player_detected = true # 即使射线被阻挡，近距离也能检测到玩家 last_known_position = body.global_position func _on_detection_area_body_exited(body): if body.is_in_group("player"): player_detected = false func player_in_detection_area() -> bool: var bodies = detection_area.get_overlapping_bodies() for body in bodies: if body.is_in_group("player"): return true return false

4.4 移动与寻路优化

为敌人添加智能移动行为，避免卡顿和不自然移动：

func smooth_movement(direction: Vector2, speed: float, delta: float) -> Vector2: # 平滑移动，避免急停急转 var target_velocity = direction * speed velocity = velocity.lerp(target_velocity, 5 * delta) return velocity func avoid_obstacles() -> Vector2: # 简单的障碍物回避 var space_state = get_world_2d().direct_space_state var params = PhysicsRayQueryParameters2D.create(global_position, global_position + velocity.normalized() * 50) params.collision_mask = 4 # 障碍物层 var result = space_state.intersect_ray(params) if result: # 遇到障碍物，尝试左右绕行 var avoid_direction = velocity.normalized().rotated(PI/2) # 旋转90度 return avoid_direction * patrol_speed return velocity func reached_patrol_point() -> bool: if patrol_points.is_empty(): return false var current_target = patrol_points[current_patrol_index] return global_position.distance_to(current_target) < 10 func advance_patrol_point(): current_patrol_index = (current_patrol_index + 1) % patrol_points.size()

5. 高级AI功能扩展

5.1 视觉锥形检测

实现更真实的锥形视野，模拟人类视觉范围：

func is_in_vision_cone(target_position: Vector2, fov_angle: float = 60) -> bool: var direction_to_target = (target_position - global_position).normalized() var forward_direction = Vector2.RIGHT.rotated(rotation) var angle = forward_direction.angle_to(direction_to_target) var degrees = rad_to_deg(abs(angle)) return degrees <= fov_angle / 2 func cone_vision_check() -> bool: var player = get_tree().get_first_node_in_group("player") if not player: return false # 检查是否在视野锥形内 if not is_in_vision_cone(player.global_position, 90): return false # 检查视线是否被阻挡 var space_state = get_world_2d().direct_space_state var params = PhysicsRayQueryParameters2D.create(global_position, player.global_position) params.collision_mask = 4 # 障碍物层 params.exclude = [self] # 排除自身 var result = space_state.intersect_ray(params) return not result # 没有障碍物阻挡返回true

5.2 听觉检测系统

为敌人添加听觉感知，让玩家发出的声音也能被检测：

var hearing_range: float = 200.0 var noise_sources: Array = [] func check_hearing() -> bool: for noise_source in noise_sources: var distance = global_position.distance_to(noise_source.position) if distance <= hearing_range: # 检查是否有障碍物阻挡声音传播 if not is_sound_blocked(noise_source.position): last_known_position = noise_source.position return true return false func is_sound_blocked(source_position: Vector2) -> bool: var space_state = get_world_2d().direct_space_state var params = PhysicsRayQueryParameters2D.create(global_position, source_position) params.collision_mask = 4 # 障碍物层 var result = space_state.intersect_ray(params) return bool(result) # 有障碍物阻挡返回true # 玩家制造噪音时调用 func register_noise_source(position: Vector2, intensity: float = 1.0): # 根据声音强度调整检测范围 var effective_range = hearing_range * intensity if global_position.distance_to(position) <= effective_range: noise_sources.append({"position": position, "time": Time.get_ticks_msec()}) # 清理过时的噪音源 cleanup_old_noise_sources() func cleanup_old_noise_sources(): var current_time = Time.get_ticks_msec() noise_sources = noise_sources.filter(func(noise): return current_time - noise.time < 5000 # 5秒后忘记声音 )

5.3 行为记忆与学习

让敌人具备简单的记忆能力，提高AI智能度：

var memory_duration: float = 10.0 # 记忆持续时间 var player_memories: Array = [] # 玩家位置记忆 func add_player_memory(position: Vector2): var memory = { "position": position, "time": Time.get_ticks_msec(), "certainty": 1.0 # 确信度 } player_memories.append(memory) func update_memories(): var current_time = Time.get_ticks_msec() var expired_memories = [] for i in range(player_memories.size()): var memory = player_memories[i] var age = (current_time - memory.time) / 1000.0 # 转换为秒 # 随时间降低确信度 memory.certainty = max(0, 1.0 - age / memory_duration) if memory.certainty <= 0: expired_memories.append(i) # 移除过期的记忆（从后往前避免索引问题） for i in range(expired_memories.size() - 1, -1, -1): player_memories.remove_at(expired_memories[i]) func get_best_memory_position() -> Vector2: if player_memories.is_empty(): return global_position # 返回确信度最高的记忆位置 var best_memory = player_memories[0] for memory in player_memories: if memory.certainty > best_memory.certainty: best_memory = memory return best_memory.position

6. 调试与优化技巧

6.1 可视化调试工具

开发期间添加调试显示，便于理解AI行为：

func _draw(): if Engine.is_editor_hint(): return # 绘制视野范围 draw_arc(Vector2.ZERO, detection_range, -PI/4, PI/2, 32, Color(1, 0, 0, 0.3), 2) # 绘制射线方向 if ray_cast.enabled: var end_point = ray_cast.target_position draw_line(Vector2.ZERO, end_point, Color.GREEN, 2) # 绘制当前状态 var state_text = AIState.keys()[current_state] draw_string(SystemFont.new(), Vector2(-20, -40), state_text, HORIZONTAL_ALIGNMENT_CENTER) func _process(delta): if Input.is_action_just_pressed("debug_toggle"): # 切换调试显示 queue_redraw()

6.2 性能优化策略

确保AI系统在各种设备上都能流畅运行：

# AI更新频率控制 var ai_update_interval: float = 0.1 # 每0.1秒更新一次AI var time_since_last_update: float = 0.0 func _physics_process(delta): time_since_last_update += delta # 限制AI更新频率，减少性能开销 if time_since_last_update >= ai_update_interval: update_ai_logic() time_since_last_update = 0.0 # 移动逻辑每帧都需要更新 update_movement(delta) func update_ai_logic(): # 将昂贵的AI计算放在这里，减少调用频率 update_ray_direction() update_ai_state() update_memories() # 距离-based LOD（Level of Detail）系统 func should_update_ai() -> bool: var player = get_tree().get_first_node_in_group("player") if not player: return false var distance_to_player = global_position.distance_to(player.global_position) # 根据距离调整更新频率 if distance_to_player > 500: return get_process_delta_time() >= 0.5 # 远距离每0.5秒更新 elif distance_to_player > 200: return get_process_delta_time() >= 0.2 # 中距离每0.2秒更新 else: return true # 近距离每帧更新

6.3 常见问题排查

RayCast2D使用中的典型问题及解决方案：

func validate_raycast_setup(): # 射线配置验证函数 if not ray_cast: push_error("RayCast2D节点未找到或未正确设置") return false if ray_cast.target_position == Vector2.ZERO: push_warning("RayCast2D的target_position为零向量，射线将无法检测") return false if ray_cast.collision_mask == 0: push_warning("RayCast2D的collision_mask为0，不会检测任何碰撞层") return false if not ray_cast.enabled: push_warning("RayCast2D未启用，检测功能被关闭") return false return true # 在_ready()中调用验证 func _ready(): if not validate_raycast_setup(): # 尝试自动修复常见问题 auto_fix_raycast_issues() func auto_fix_raycast_issues(): if ray_cast.collision_mask == 0: # 设置默认碰撞掩码（检测玩家层） ray_cast.collision_mask = 1 if ray_cast.target_position == Vector2.ZERO: # 设置默认检测范围 ray_cast.target_position = Vector2(300, 0)

7. 实战案例：潜行游戏敌人AI

7.1 场景搭建与配置

创建完整的潜行游戏示例，展示RayCast2D在实际项目中的应用：

# StealthEnemy.gd - 潜行游戏专用敌人AI extends CharacterBody2D enum StealthState {NORMAL, ALERTED, SEARCHING, INVESTIGATING} @export var normal_speed: float = 40.0 @export var alerted_speed: float = 120.0 @export var fov_angle: float = 90.0 @export var hearing_sensitivity: float = 1.0 # 听觉敏感度 var stealth_state: StealthState = StealthState.NORMAL var suspicion_level: float = 0.0 # 怀疑度 var investigation_target: Vector2 # 多射线视野系统 var vision_rays: Array = [] func _ready(): setup_advanced_vision_system() setup_stealth_detection() func setup_advanced_vision_system(): # 创建5条射线模拟锥形视野 var angles = [-45, -22.5, 0, 22.5, 45] # 角度值 for angle in angles: var ray = RayCast2D.new() var direction = Vector2.RIGHT.rotated(deg_to_rad(angle)) ray.target_position = direction * detection_range ray.collision_mask = 1 + 4 # 玩家+障碍物 ray.enabled = true add_child(ray) vision_rays.append(ray) func setup_stealth_detection(): # 设置光感检测区域 var light_detection_area = Area2D.new() var collision_shape = CollisionShape2D.new() var circle_shape = CircleShape2D.new() circle_shape.radius = 150 collision_shape.shape = circle_shape light_detection_area.add_child(collision_shape) light_detection_area.body_entered.connect(_on_light_area_body_entered) add_child(light_detection_area)

7.2 潜行检测逻辑

实现基于光线和声音的潜行检测机制：

func update_stealth_detection(): var player = get_tree().get_first_node_in_group("player") if not player: return # 基础视线检测 var direct_line_of_sight = has_direct_line_of_sight(player.global_position) # 光线等级检测（玩家是否在阴影中） var light_level = get_light_level_at(player.global_position) var visibility_modifier = 1.0 - light_level # 光线越暗越难被发现 # 移动速度影响（移动越快越容易被发现） var movement_penalty = player.velocity.length() / 100.0 # 距离因素 var distance_factor = 1.0 - min(global_position.distance_to(player.global_position) / detection_range, 1.0) if direct_line_of_sight: # 直接视线发现玩家 suspicion_level += (0.3 + movement_penalty * 0.2 + distance_factor * 0.2) * visibility_modifier * get_delta_time() else: # 间接发现（声音、影子等） suspicion_level += (movement_penalty * 0.1) * visibility_modifier * get_delta_time() # 怀疑度衰减 suspicion_level = max(0, suspicion_level - 0.1 * get_delta_time()) update_stealth_state_based_on_suspicion() func has_direct_line_of_sight(target_position: Vector2) -> bool: # 检查多条射线是否有任意一条看到玩家 for ray in vision_rays: if ray.is_colliding(): var collider = ray.get_collider() if collider and collider.is_in_group("player"): return true return false func get_light_level_at(position: Vector2) -> float: # 简化版光线检测，实际项目中可能需要更复杂的光照系统 var space_state = get_world_2d().direct_space_state var params = PhysicsRayQueryParameters2D.create(global_position, position) params.collision_mask = 4 # 障碍物层 var result = space_state.intersect_ray(params) if result: return 0.3 # 有障碍物阻挡，光线较暗 else: return 0.8 # 无阻挡，光线较亮

7.3 状态机与行为树集成

将RayCast2D检测与更复杂的AI行为系统结合：

func update_stealth_state_based_on_suspicion(): match stealth_state: StealthState.NORMAL: if suspicion_level > 0.7: stealth_state = StealthState.ALERTED on_alert_raised() elif suspicion_level > 0.3: stealth_state = StealthState.INVESTIGATING start_investigation() StealthState.INVESTIGATING: if suspicion_level > 0.7: stealth_state = StealthState.ALERTED on_alert_raised() elif suspicion_level < 0.1: stealth_state = StealthState.NORMAL stop_investigation() StealthState.ALERTED: if suspicion_level < 0.3: stealth_state = StealthState.SEARCHING start_searching() StealthState.SEARCHING: if suspicion_level > 0.5: stealth_state = StealthState.ALERTED on_alert_raised() elif is_search_complete(): stealth_state = StealthState.NORMAL stop_searching() func on_alert_raised(): # 警报行为：呼叫同伴，加速移动等 broadcast_alert_to_allies() current_speed = alerted_speed func start_investigation(): # 调查行为：走向可疑位置，短暂停留 investigation_target = last_known_position move_to_position(investigation_target) func broadcast_alert_to_allies(): var allies = get_tree().get_nodes_in_group("enemies") for ally in allies: if ally != self: ally.receive_alert(global_position)

8. 最佳实践与工程建议

8.1 性能优化策略

在大型项目中管理多个敌人的AI性能：

# AI管理器 - 集中管理所有敌人的AI更新 extends Node var enemies: Array = [] var update_index: int = 0 var updates_per_frame: int = 3 # 每帧更新3个敌人 func _ready(): # 收集场景中的所有敌人 enemies = get_tree().get_nodes_in_group("enemies") func _process(delta): # 分帧更新，避免单帧性能峰值 for i in range(updates_per_frame): if update_index >= enemies.size(): update_index = 0 if update_index < enemies.size(): var enemy = enemies[update_index] if is_instance_valid(enemy): enemy.low_frequency_ai_update() update_index += 1 # 在敌人脚本中分离高频和低频更新 func low_frequency_ai_update(): # 昂贵的计算放在这里 update_vision_cone() update_pathfinding() update_decision_making() func high_frequency_ai_update(delta): # 必须每帧更新的内容 update_movement(delta) handle_animation()

8.2 可配置化设计

创建可配置的AI系统，便于设计和平衡调整：

# EnemyConfig.gd - AI配置资源 extends Resource @export_group("视觉设置") @export var detection_range: float = 300.0 @export var fov_angle: float = 90.0 @export var vision_update_rate: float = 0.1 @export_group("听觉设置") @export var hearing_range: float = 200.0 @export var hearing_sensitivity: float = 1.0 @export_group("移动设置") @export var patrol_speed: float = 50.0 @export var chase_speed: float = 150.0 @export var acceleration: float = 500.0 @export_group("行为设置") @export var suspicion_decay_rate: float = 0.1 @export var max_suspicion: float = 1.0 @export var search_duration: float = 10.0 # 在敌人脚本中使用配置 @export var ai_config: EnemyConfig func _ready(): if ai_config: apply_ai_config() func apply_ai_config(): detection_range = ai_config.detection_range fov_angle = ai_config.fov_angle hearing_range = ai_config.hearing_range patrol_speed = ai_config.patrol_speed chase_speed = ai_config.chase_speed

8.3 测试与调试体系

建立完善的AI测试框架：

# AI测试工具 func run_ai_tests(): test_vision_detection() test_movement_pathfinding() test_state_transitions() test_performance_metrics() func test_vision_detection(): # 测试视线检测功能 var test_positions = [ Vector2(100, 0), # 正前方，应该检测到 Vector2(0, 100), # 正上方，不在视野内 Vector2(-50, 0) # 后方，不应该检测到 ] for test_pos in test_positions: var can_see = cone_vision_check(test_pos) print("位置 %s 检测结果: %s" % [test_pos, can_see]) func generate_ai_debug_report(): # 生成AI状态报告 var report = { "current_state": AIState.keys()[current_state], "suspicion_level": suspicion_level, "player_detected": player_detected, "last_known_position": last_known_position, "vision_checks_per_second": vision_check_count / time_elapsed, "performance_rating": calculate_performance_rating() } return report

通过本文的完整讲解，你应该已经掌握了使用Godot的RayCast2D实现智能敌人AI的核心技术。从基础的射线检测到高级的潜行游戏AI系统，这些技术可以灵活组合应用在不同类型的2D游戏中。

关键是要根据实际游戏需求合理设计AI行为，避免过度复杂化。对于大多数项目来说，简单的射线检测配合状态机就能提供足够智能的敌人行为。记得在开发过程中持续测试和调整参数，确保AI既具有挑战性又不会让玩家感到不公平。