1. 先搞清楚“战斗网格”到底要解决什么问题在UE5里做CRPG的战斗系统很多人一上来就想着写技能、做特效、调动画。但真正决定战斗体验能不能“玩起来”的往往是那个看不见的底层结构——战斗网格。它决定了角色能站在哪、怎么移动、技能范围怎么算、敌人怎么寻路。如果你直接上手写代码很容易陷入一个误区把网格当成一个简单的“坐标点集合”来处理。结果就是角色移动时卡进模型里、技能范围判定不准、多个单位挤在一起、寻路计算慢到卡顿。这些问题在开发后期改起来几乎等于重做。所以这节课的核心不是教你画一个格子而是让你理解在UE5 C里一个服务于CRPG回合制或半即时制战斗的网格系统需要同时处理好数据、表现和逻辑这三层。数据层负责存储格子状态可走、阻挡、高台、危险区域表现层负责在编辑器里可视化这些格子调试用逻辑层则负责处理移动请求、范围查找和路径计算。我建议你先忘掉所有复杂的算法从最朴素的三个问题开始我的战斗场景大概多大这决定了网格的尺寸和格子数量一个格子应该对应游戏世界里的多大区域这决定了移动和技能判定的精度除了“能走”和“不能走”格子还需要记录哪些信息比如地形消耗、是否提供掩体、是否触发事件把这三个问题想清楚再动手写代码能省掉后面80%的返工时间。2. 设计网格的数据结构别只用二维数组确定了网格的物理尺寸和逻辑意义后接下来就是用C把它“描述”出来。新手最容易犯的错误就是直接用一个TArrayTArrayint32或者二维数组了事。这在小地图上或许能跑但一旦需要扩展功能比如给格子加多种状态、存储引用、支持动态阻挡代码就会变得难以维护。一个更健壮的做法是定义一个FGridCell结构体或类用它来封装一个格子的所有信息。然后用UE5的TArrayFGridCell来管理整个网格通过索引计算来模拟二维访问。// GridCell.h - 一个格子单元的基础定义 USTRUCT(BlueprintType) struct FGridCell { GENERATED_BODY() // 基础状态 UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Grid|Cell) bool bWalkable true; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Grid|Cell) bool bOccupied false; // 是否有单位占据 UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Grid|Cell) int32 TerrainCost 1; // 地形移动力消耗用于寻路算法 // 世界位置网格局部空间原点 格子索引 * 格子大小 UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Grid|Cell) FVector WorldPosition FVector::ZeroVector; // 可以扩展掩体类型、触发事件ID、环境效果等 // UPROPERTY() // int32 CoverType; // UPROPERTY() // FName LinkedEventId; };有了格子单元接下来需要网格管理器AGridManager继承自AActor。它负责创建网格、根据世界坐标查询格子、修改格子状态。// GridManager.h - 网格管理器的核心部分 UCLASS() class YOURPROJECT_API AGridManager : public AActor { GENERATED_BODY() public: AGridManager(); // 初始化网格通常在BeginPlay或由游戏模式调用 UFUNCTION(BlueprintCallable, Category Grid) void InitializeGrid(int32 InWidth, int32 InHeight, float InCellSize); // 根据世界坐标获取对应的格子索引或直接返回格子引用 UFUNCTION(BlueprintCallable, Category Grid) bool GetCellFromWorldLocation(const FVector WorldLocation, FGridCell OutCell) const; // 根据网格坐标获取格子 const FGridCell* GetCell(int32 X, int32 Y) const; // 检查一个网格坐标是否有效且在网格范围内 bool IsValidGridCoordinate(int32 X, int32 Y) const; protected: UPROPERTY(EditAnywhere, BlueprintReadOnly, Category Grid|Config) int32 GridWidth 10; UPROPERTY(EditAnywhere, BlueprintReadOnly, Category Grid|Config) int32 GridHeight 10; UPROPERTY(EditAnywhere, BlueprintReadOnly, Category Grid|Config) float CellSize 200.f; // 每个格子边长200单位厘米 UPROPERTY(EditAnywhere, BlueprintReadOnly, Category Grid|Config) FVector GridWorldOrigin FVector::ZeroVector; // 网格左下角或中心的世界坐标 private: // 存储所有格子的数组 TArrayFGridCell GridCells; // 内部方法将二维网格坐标转换为一维数组索引 int32 GetCellIndex(int32 X, int32 Y) const; };在InitializeGrid函数里你需要根据GridWidth和GridHeight预填充GridCells数组并计算每个FGridCell的WorldPosition。GetCellFromWorldLocation函数则是战斗逻辑中最常用的接口角色移动、技能释放都需要通过它来查询目标点对应哪个格子。注意这里GridWorldOrigin的设置很重要。我一般会把它设为战斗场景中一个预设锚点Actor的位置这样在编辑器中移动这个锚点整个网格就能跟着移动方便调试。3. 在编辑器中可视化调试网格数据层写好了但如果不能在编辑器里直观地看到网格调试起来会非常痛苦。你不可能每次都靠打印日志来猜角色站在哪个格子上。所以我们需要为AGridManager添加调试绘制功能。最直接的方法是重写AActor的DebugDraw相关函数或者自定义一个调试绘制函数。这里我们在AGridManager里添加一个方法用于在编辑器的视口中绘制网格线。// GridManager.cpp void AGridManager::DrawDebugGrid() const { if(!bEnableDebugDrawing) return; // 用一个布尔变量控制是否绘制 UWorld* World GetWorld(); if(!World) return; const FColor GridColor FColor::Green; // 网格线颜色 const float DebugLineThickness 1.0f; // 线粗 const float DebugLineDuration 0.0f; // 0.0f表示持续一帧适合在Tick中调用 // 绘制横向和纵向的网格线 for(int32 x 0; x GridWidth; x) { FVector Start GridWorldOrigin FVector(x * CellSize, 0, 0); FVector End Start FVector(0, GridHeight * CellSize, 0); DrawDebugLine(World, Start, End, GridColor, false, DebugLineDuration, 0, DebugLineThickness); } for(int32 y 0; y GridHeight; y) { FVector Start GridWorldOrigin FVector(0, y * CellSize, 0); FVector End Start FVector(GridWidth * CellSize, 0, 0); DrawDebugLine(World, Start, End, GridColor, false, DebugLineDuration, 0, DebugLineThickness); } // 可选绘制每个格子的中心点或状态如阻挡格子涂红 for(const FGridCell Cell : GridCells) { if(!Cell.bWalkable) { DrawDebugPoint(World, Cell.WorldPosition FVector(0,0,50), 10.0f, FColor::Red, false, DebugLineDuration); } } } // 在Tick中调用或者由蓝图事件触发 void AGridManager::Tick(float DeltaTime) { Super::Tick(DeltaTime); DrawDebugGrid(); }把bEnableDebugDrawing暴露为UPROPERTY(EditAnywhere)这样在编辑器里勾选就能立刻看到绿色的网格线覆盖在你的战斗场景上。红色点则表示不可行走的格子。这是最基础的调试视图。进阶一点你可以根据格子不同的TerrainCost用不同颜色绘制或者当鼠标悬停时高亮某个格子。可视化能极大提升你调整寻路参数、摆放阻挡物的效率。实测建议不要一开始就把调试绘制做得很复杂。先确保网格线能正确显示并且GridWorldOrigin和CellSize调整后网格能实时变化。这个基础视图稳定后再去加格子状态高亮、移动范围预览这些花哨功能。4. 实现坐标转换连接游戏世界与逻辑网格这是战斗系统所有逻辑的基石。你的角色在三维世界里移动FVector但你的技能范围、移动力计算都在二维逻辑网格(X, Y)索引上进行。所以必须有一套准确、高效的坐标转换机制。在AGridManager中实现这四个核心转换函数// GridManager.cpp // 1. 世界坐标 - 网格坐标 FIntPoint AGridManager::WorldLocationToGridCoordinate(const FVector WorldLocation) const { // 计算相对于网格原点的偏移量 FVector LocalOffset WorldLocation - GridWorldOrigin; // 除以格子大小并取整得到网格索引 int32 GridX FMath::FloorToInt(LocalOffset.X / CellSize); int32 GridY FMath::FloorToInt(LocalOffset.Y / CellSize); // 注意这里假设Z轴是高度网格是X-Y平面 return FIntPoint(GridX, GridY); } // 2. 网格坐标 - 世界坐标格子中心点 FVector AGridManager::GridCoordinateToWorldLocation(const FIntPoint GridCoord) const { // 计算格子中心的世界坐标 FVector WorldPos GridWorldOrigin; WorldPos.X (GridCoord.X 0.5f) * CellSize; WorldPos.Y (GridCoord.Y 0.5f) * CellSize; // Z轴高度可以根据需要从地面检测获得这里先设为0 WorldPos.Z 0; return WorldPos; } // 3. 检查网格坐标是否有效 bool AGridManager::IsValidGridCoordinate(int32 X, int32 Y) const { return (X 0 X GridWidth Y 0 Y GridHeight); } // 4. 世界坐标 - 格子引用最常用的查询函数 bool AGridManager::GetCellFromWorldLocation(const FVector WorldLocation, FGridCell OutCell) const { FIntPoint GridCoord WorldLocationToGridCoordinate(WorldLocation); if(IsValidGridCoordinate(GridCoord.X, GridCoord.Y)) { int32 Index GetCellIndex(GridCoord.X, GridCoord.Y); OutCell GridCells[Index]; return true; } return false; }这里有几个容易出错的细节取整方式使用FMath::FloorToInt还是FMath::RoundToInt这取决于你的网格原点定义和游戏规则。通常如果原点在格子角上用Floor如果在格子中心可能需要调整。我建议统一用Floor并规定原点在某个格子的角上这样计算最直观。Z轴处理我们的战斗网格通常是2D的X-Y平面但游戏世界是3D的。WorldLocationToGridCoordinate函数一般只关心X和Y分量。而GridCoordinateToWorldLocation返回的Z值通常需要通过LineTrace检测地面高度来获得真实的世界Z坐标否则角色可能会飘在空中或陷进地里。边界检查IsValidGridCoordinate一定要在每次通过计算得到的网格坐标访问数组前调用否则极有可能引发数组越界崩溃。5. 处理动态阻挡与格子状态更新静态的地形阻挡如山体、墙壁可以在初始化网格时通过扫描场景中的特定物体如带有NavModifier的Volume来设置bWalkable false。但战斗是动态的角色移动、召唤物出现、技能创造临时地形如冰墙都需要实时更新网格状态。我们需要在AGridManager中提供安全的格子状态更新接口// GridManager.h UFUNCTION(BlueprintCallable, Category Grid) bool SetCellWalkable(int32 X, int32 Y, bool bNewWalkable); UFUNCTION(BlueprintCallable, Category Grid) bool SetCellOccupied(int32 X, int32 Y, bool bNewOccupied, AActor* OccupyingActor nullptr); // GridManager.cpp bool AGridManager::SetCellWalkable(int32 X, int32 Y, bool bNewWalkable) { if(!IsValidGridCoordinate(X, Y)) return false; int32 Index GetCellIndex(X, Y); FGridCell Cell GridCells[Index]; // 可以在这里添加一些逻辑验证比如被占据的格子是否允许改变行走状态 Cell.bWalkable bNewWalkable; // 状态改变后可能需要通知寻路系统重新计算 OnGridCellChanged.Broadcast(X, Y); // 可以定义一个多播委托 return true; }对于“占据”状态需要更谨慎。一个格子被角色占据bOccupied true通常意味着其他角色不能移动到此格但可能允许远程技能穿过。你可以在FGridCell里增加一个AActor* OccupyingActor的弱引用TWeakObjectPtr这样就能知道是谁占着这个格子方便后续做更复杂的交互判断比如“推开”单位。动态更新的性能考量如果每帧都有大量格子状态变化比如大面积持续伤害技能频繁更新和广播事件可能会成为性能瓶颈。对此常见的优化策略有批量更新积累一帧内的所有更改在帧末如Tick结束时统一处理并广播一次事件。脏标记只标记格子状态“脏”了等寻路系统下次请求时再重新计算相关区域。分层网格对于像“毒雾”这种持续性的区域效果可以不用修改基础行走网格而是单独维护一个“效果网格”在寻路计算时合并考虑。对于中小型CRPG战斗第一种方法通常就足够了。记住一个原则不要过早优化。先把功能做正确用性能分析工具Unreal Insights找到真正的热点再针对性优化。6. 与角色移动组件的初步对接网格系统最终是为角色移动服务的。我们需要修改角色的移动逻辑让其遵循网格规则而不是UE5自带的CharacterMovementComponent的物理移动。一个常见的做法是创建一个自定义的UGridMovementComponent。这里我们先不实现完整的A*寻路只实现最基础的“向指定格子移动”的功能来验证网格系统是否工作正常。// GridMovementComponent.h UCLASS(ClassGroup(Custom), meta(BlueprintSpawnableComponent)) class YOURPROJECT_API UGridMovementComponent : public UActorComponent { GENERATED_BODY() public: UGridMovementComponent(); // 请求移动到目标网格坐标 UFUNCTION(BlueprintCallable, Category Grid Movement) void RequestMoveToCell(int32 TargetX, int32 TargetY); // 每帧更新处理移动插值 virtual void TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction) override; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Grid Movement) float MoveSpeed 500.0f; // 每秒移动多少单位世界坐标 protected: // 当前所在的网格坐标 UPROPERTY(BlueprintReadOnly, Category Grid Movement) FIntPoint CurrentGridCoord; // 目标世界位置正在移动时有效 FVector TargetWorldLocation; bool bIsMoving; // 对GridManager的引用 UPROPERTY() AGridManager* GridManager; void BeginPlay() override; }; // GridMovementComponent.cpp void UGridMovementComponent::BeginPlay() { Super::BeginPlay(); // 简单查找场景中的GridManager生产环境建议用更稳健的方式如游戏模式注册 TArrayAActor* FoundManagers; UGameplayStatics::GetAllActorsOfClass(GetWorld(), AGridManager::StaticClass(), FoundManagers); if(FoundManagers.Num() 0) { GridManager CastAGridManager(FoundManagers[0]); // 初始化角色起始位置对应的网格坐标 if(GridManager) { CurrentGridCoord GridManager-WorldLocationToGridCoordinate(GetOwner()-GetActorLocation()); // 通知GridManager此格子被占据 GridManager-SetCellOccupied(CurrentGridCoord.X, CurrentGridCoord.Y, true, GetOwner()); } } } void UGridMovementComponent::RequestMoveToCell(int32 TargetX, int32 TargetY) { if(!GridManager || !GridManager-IsValidGridCoordinate(TargetX, TargetY)) return; const FGridCell* TargetCell GridManager-GetCell(TargetX, TargetY); if(!TargetCell || !TargetCell-bWalkable || TargetCell-bOccupied) { // 移动请求被拒绝格子无效、不可行走或被占据 UE_LOG(LogTemp, Warning, TEXT(Move request to (%d, %d) denied!), TargetX, TargetY); return; } // 释放当前格子 GridManager-SetCellOccupied(CurrentGridCoord.X, CurrentGridCoord.Y, false, nullptr); // 占据目标格子 GridManager-SetCellOccupied(TargetX, TargetY, true, GetOwner()); // 设置移动状态和目标点 TargetWorldLocation GridManager-GridCoordinateToWorldLocation(FIntPoint(TargetX, TargetY)); bIsMoving true; CurrentGridCoord FIntPoint(TargetX, TargetY); } void UGridMovementComponent::TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction) { Super::TickComponent(DeltaTime, TickType, ThisTickFunction); if(bIsMoving) { AActor* Owner GetOwner(); FVector CurrentLocation Owner-GetActorLocation(); // 简单的线性插值移动 FVector NewLocation FMath::VInterpConstantTo(CurrentLocation, TargetWorldLocation, DeltaTime, MoveSpeed); Owner-SetActorLocation(NewLocation); // 判断是否到达目标允许一个很小的容差 if(FVector::DistSquared(NewLocation, TargetWorldLocation) 10.0f) { Owner-SetActorLocation(TargetWorldLocation); bIsMoving false; OnMoveFinished.Broadcast(CurrentGridCoord); // 可以定义委托通知移动完成 } } }把这个组件添加到你的战斗角色Actor上。然后在蓝图中你可以测试点击一个格子调用RequestMoveToCell角色应该会一格一格地移动过去。这就是很多战棋游戏里“格子移动”的雏形。避坑点这里为了演示移动是简单的直线插值。在真正的CRPG里移动可能需要播放行走动画、考虑移动路径下一课寻路的内容、以及处理移动过程中被阻挡等中断情况。先让这个最简单的版本跑通确保“请求-占据-移动-释放”这个状态循环是正确的这是后续所有复杂功能的基础。7. 常见问题与排查清单当你按照以上步骤搭建网格系统时肯定会遇到各种问题。下面是我在多次搭建类似系统后总结的排查顺序能帮你快速定位大部分bug。问题1网格线绘制不出来或者位置完全不对。先查GridWorldOrigin设置对了吗在编辑器里选中GridManager查看GridWorldOrigin的值并把它设在你期望的网格起始点比如场景中心。再查CellSize是不是太小或太大了默认200厘米在UE5中是一个比较适中的格子大小。如果网格线挤在一起或稀疏得离谱调整这个值。最后查bEnableDebugDrawing勾选了吗DrawDebugLine的Duration参数是不是负数确保在Tick中调用了DrawDebugGrid。问题2角色移动后坐标转换出错跑到奇怪的格子上去了。先查WorldLocationToGridCoordinate函数里的计算逻辑。确认LocalOffset计算正确世界坐标减原点。检查除CellSize后用的是Floor还是Round确保和你设计的原点对齐方式一致。再查角色本身的ActorLocation是脚底位置CapsuleComponent底部还是中心位置网格计算通常使用脚底位置。可以在转换前对角色位置做一个偏移校正。用调试在角色移动前后分别打印WorldLocation和转换后的GridCoord看是否符合预期。问题3两个角色可以走到同一个格子里。先查SetCellOccupied函数被正确调用了吗在RequestMoveToCell中释放旧格子和占据新格子的顺序是否正确确保在移动开始时释放在移动请求验证通过后立即占据。再查bOccupied状态在GetCell或移动请求判断时被读取了吗RequestMoveToCell里必须检查目标格子的bOccupied。并发问题如果是多人游戏或AI同时请求移动需要考虑简单的锁或队列防止同一帧内两个单位都判断格子为空然后同时占据。问题4性能感觉卡顿尤其是格子很多时。先查调试绘制。DrawDebugLine和DrawDebugPoint在开发期很方便但数量巨大时如100x100的网格会严重影响性能。通过bEnableDebugDrawing控制开关发布版本记得关闭。再查Tick中的逻辑。确保GridMovementComponent的Tick只在bIsMoving为真时进行插值计算。最后查算法复杂度。目前我们做的都是O(1)的数组查找和简单计算。如果未来实现A*寻路后卡顿那才是需要优化算法的时候。问题5网格和场景里的静态物体如墙壁对不上。这是数据初始化问题。你需要在AGridManager::InitializeGrid中通过物理扫描如BoxTrace或Overlap来检测每个格子中心点是否与阻挡体积重叠从而设置bWalkable。一个初始化流程建议创建空的网格数据。遍历每个格子从其世界坐标向下做一条短射线检测。如果检测到带有“阻挡”标签的物体将该格子设为bWalkable false。将初始化后的网格数据保存或可视化检查是否正确。把网格系统的基础打牢后续的寻路、技能范围、视野计算等所有战斗子系统才能稳定地构建在上面。下一课我们会基于这个网格实现最核心的A*寻路算法让角色真正能“绕过墙壁”找到目标。