地图检查错误

介绍在地图编译或在虚幻编辑器中运行地图检查时生成错误。

Choose your operating system:

Windows

macOS

Linux

虚幻引擎4拥有智能机制,当存在潜在问题时将以地图检查错误和警告的形式提醒用户,在了解问题诱因和修复方法之前便无需手动追踪问题。这些错误可自动追踪问题所在,便于开发者进行修复,避免对游戏造成严重影响。

执行地图检查

执行地图全部编译后将显示地图检查错误和警告,也可使用 关卡编辑器工具栏 中构建(Build)菜单内的 地图检查(Map Check) 选项单独执行。

错误

错误是可能导致执行失败的严重问题。继续开发前需要将问题修复。

光照

[LightActor] has same light GUID as [LightActor] (Duplicate and replace the orig with the new one)

复制并进行新旧替换。

警告

警告并不代表着严重问题,但可能导致游戏功能出现不正常或性能降低。它们需要修复,但并不是显著问题。

Actor

[Actor] : Large Actor casts a shadow and will cause an extreme performance hit unless bUseBooleanEnvironmentShadowing is set to true

一个大型Actor被设为投射阴影——这将导致严重的性能问题,需要将bUseBooleanEnvironmentShadowing设为true。

[Volume] causes damage, but has no damagetype defined.

体积设为输出伤害但伤害类型未定义时,将出现此警告。伤害类型十分重要,因为它将告知游戏代码如何处理Actor受到伤害后的反应。前往Actor的属性窗口 -> 物理体积(Physics Volume)设置 '伤害类型(DamageType)' 属性即可解决。

[Actor] : Brush has non-coplanar polygons

关卡中的笔刷拥有非共面多边形时会出现此警告,原因通常是在几何体模式中以极端方式使用笔刷编辑工具,导致关卡出现多边形丢失。删除笔刷然后重建即可消除此警告。

[Actor] in same location as [Another Actor]

一个Actor的所在位置和另一个Actor完全相同时将出现此警告。出现此警告的原因通常是意外进行了复制或粘贴操作。删除其中一个Actor即可消除警告,如果是有意放置重叠Actor的,可直接无视此警告。

[Actor] has invalid DrawScale/ DrawScale3D

DrawScale、DrawScale3D X、DrawScale3D Y或DrawScale 3D Z等于0时将出现此警告。这意味着Actor已经在某根轴上被缩放为0,因此将不会显示。将为0的DrawScale设为非零即可修复问题:选中Actor,在虚幻编辑器主窗口底部修改drawscale属性。

[Actor] is obsolete and must be removed!

关卡中的一个Actor实例被标记为弃用后将出现此警告,原因通常是关卡创建后一个Actor被标记为弃用,但地图却从未更新。删除Actor即可消除警告。

[Actor] bStatic true, but has Physics set to something other than PHYS_None!

Actor的bStatic标记被设为true但其物理(Physics)被设为PHYS_None时将出现此警告。因为bStatic代表Actor将不会移动,与物理(Physics)设为PHYS_None构成了矛盾。设置bStatic标记的Actor也不会被tick(更新)。前往Actor的属性并将物理(Physics)改为PHYS_None即可修复此问题。

[Actor] : Volume Actor has NULL collision component - please delete

指定的体积Actor拥有一个空(NULL)碰撞组件,可能需要删除。

[Actor] : Volume Actor has a collision component with 0 radius - please delete

指定体积Actor的碰撞组件半径为零,可能需要删除。

[Actor] (LOD [Index]) has hand-painted vertex colors that no longer match the original StaticMesh [StaticMesh]

实例的顶点颜色被绘制后原始网格体已发生变化——可能需要刷新。

[Actor] has collision enabled but StaticMesh [StaticMeshName] has no simple or complex collision.

需要将Actor上的碰撞已启用(Collision Enabled)设为无碰撞(No Collision),或为网格体添加碰撞(方法为添加简单碰撞形态,并/或在分段上启用碰撞)。

Actor casts dynamic shadows and has a BoundsScale greater than 1! This will have a large performance hit

这是严重的性能警告……需要将BoundsScale缩小为大于等于1,或移除动态阴影。

[ActorName] has WorldTrace blocked.It will be considered to be world geometry

BSP笔刷

[Brush Actor] : Brush has zero polygons - please delete!

此警告说明关卡中的笔刷没有与其相关的多边形。此笔刷毫无作用,需要删除。

Run 'Clean BSP Materials' to clear [count] references

此警告说明笔刷表面存在对BSP无帮助的材质引用,应用工具(Tools)-> '清除BSP材质(Clean BSP Materials)' 操作即可清除这些引用。

[Actor] : Brush has NULL BrushComponent property - please delete!

笔刷带有"无"约束实例("None" ConstraintInstance)组件时将出现此警告。在使用复制创建笔刷的旧地图中十分常见,删除引起警告的笔刷并新建一个笔刷即可修复。

[Brush] : Brush is planar

使用了平面笔刷——请注意,这可能导致碰撞问题。

摄像机

Camera has AspectRatio=0 - please set this to something non-zero

[ ]::[ ] is obsolete and must be removed (Class is abstract)

[ ]::[ ] is obsolete and must be removed (Class is deprecated)

植被

Foliage instances for a missing Static Mesh have been removed.

Foliage in this map is missing [MissingCount] cluster component(s) for Static Mesh [MeshName].Opening the Foliage tool will fix this problem.

地形

[LandscapeComponent] : Fixed up deleted layer weightmap

[LandscapeComponent] : Fixed up incorrect layer weightmap texture index

Fixed up shared weightmap texture for layer [Layer] in component [Component] (shares with [Name])

Landscape ([ProxyName]) has overlapping render components at location ([X,Y])

关卡

Duplicate level info

存在两个世界信息......

Map should have KillZ set.

地图的KillZ在世界信息(WorldInfo)属性中设为默认值时将出现此警告。应该在所有关卡中合理指定所有KillZ,这样玩家不会一直下落到游戏世界边界。

光照

[Actor] : Light Actor has NULL LightComponent property - please delete!

光照Actor带有"无"光照组件("None" LightComponent)时将出现此警告。在使用复制创建Actor的旧地图中十分常见,删除引起警告的Actor并新建一个Actor即可修复。

Maps need lighting rebuilt

移动或修改光照Actor导致光照无效后将出现此警告。这可能引起问题,因为关卡中的渲染灯光未准确表现关卡的当前光照状况。前往构建(Build)菜单并重建地图光照即可解决此问题。

Component is a static type but has invalid lightmap settings! Indirect lighting will be black. Common causes are lightmap resolution of 0, LightmapCoordinateIndex out of bounds.

导航

Paths need to be rebuilt

粒子系统

[Actor] : Emitter Actor has NULL ParticleSystemComponent property - please delete!

发射器Actor带有"无"粒子系统组件("None" ParticleSystemComponent)时将出现此警告。在使用复制创 Actor的旧地图中十分常见,删除引起警告的Actor并新建一个Actor即可修复。

PSysComp has an empty parameter Actor reference at index [Index] ([Actor])

Param.Actor不应为空(NULL)。

PSysComp has an empty parameter material reference at index [Index] ([Actor])

Param.Material不应为空(NULL)。

骨骼网格体

[Actor] : SkeletalMeshActor has no PhysicsAsset assigned.

需要将物理资产(PhysicsAsset)指定到骨骼网格体的骨骼网格体组件(SkeletalMeshComponent)中,使骨骼网格体拥有准确的边界框。如边界框错误或不准确,网格体原点不在画面中时其将消失,或由于边界框过大而出现分辨率很低的阴影。

[Actor] : Skeletal Mesh Actor has NULL SkeletalMeshComponent property

指定的骨骼网格体Actor带有一个空骨骼网格体组件(NULL SkeletalMeshComponent)属性。

[Actor] : Skeletal Mesh Actor has NULL SkeletalMesh property

指定的骨骼网格体Actor带有一个空骨骼网格体(NULL SkeletalMesh)属性。

声音

[Actor] : Ambient sound Actor has NULL AudioComponent property - please delete!

环绕声Actor带有"无"音频组件("None" AudioComponent)时将出现此警告。在使用复制创建Actor的旧地图中十分常见,删除引起警告的Actor并新建一个Actor即可修复。

Ambient sound Actor's AudioComponent has a NULL SoundCue property!

环绕声Actor带有一个空声音提示(NULL SoundCue)属性时将出现此警告。由于Actor实际上并未播放声音,会导致出现问题。可以首先在通用浏览器中选择一个声音提示,然后前往Actor的属性窗口 ->音频类目(Audio Category)->音频组件(Audio Component)并设置 '声音提示(SoundCue)' 属性。

静态网格体

[Static Mesh Actor] : Static Mesh Actor has NULL StaticMesh property

关卡中的静态网格体Actor带有一个空静态网格体(NULL StaticMesh)属性时将出现此警告。这可能会导致问题,因为Actor存在并会占用内存,但实际上却没有静态网格体进行绘制。出现此警告的原因通常是在通用浏览器中选择静态网格体(StaticMesh)之前便先创建了静态网格体Actor。可以首先在通用浏览器中选择一个静态网格体,然后前往静态网格体Actor的属性窗口 ->静态网格体Actor类目(StaticMeshActor Category)->静态网格体组件(StaticMeshComponent)->静态网格体组件类目(StaticMeshComponent Category)并设置 '静态网格体(StaticMesh)' 属性。

[Actor] : Static Mesh Actor has NULL StaticMeshComponent property - please delete!

静态网格体Actor带有"无"静态网格体组件("None" StaticMeshComponent)组件时将出现此警告。在使用复制创建 Actor的旧地图中十分常见,删除引起警告的Actor并新建一个Actor即可修复。

[StaticMesh] has simple collision but is being scaled non-uniformly - collision creation will fail

简单碰撞无法用于非均匀缩放。请修正缩放或碰撞类型。

More overridden materials [Count] on Static Mesh component than are referenced [Count] in source mesh [StaticMesh]

[Count] element(s) with zero triangles in Static Mesh [StaticMesh]

体积

LevelGridVolumes are only allowed in the persistent level

关卡网格体积(LevelGridVolume)被放置到流送关卡后将出现此警告。这类体积只能放置在固定关卡中。将关卡网格体积移至固定关卡中即可修复此问题。

LevelStreamingVolume is not in the persistent level - please delete

关卡流送体积不存在于固定关卡中时将出现此警告。这可能会导致问题,因为检查流送关卡应被加载或卸载时不会考虑到体积。删除关卡流送体积并重建即可修复此问题。

No levels are associated with streaming volume.

没有关卡与关卡流送体积(LevelStreamingVolume)相关时将出现此警告,关卡流送体积不发挥作用。将关卡流送体积(LevelStreamingVolume)关联到流送关卡即可修复此问题。

未分类

Filename [Filename] is too long - this may interfere with cooking for consoles. Unreal filenames should be no longer than [Length] characters.

请将文件命名保持在指定长度内。

[ObjectName] : Externally referenced

信息

信息是不需要用户进行修复但需要了解的问题。

Actor

[Actor] : Repaired painted vertex colors

此Actor上的绘制顶点颜色已被修复。

欢迎帮助改进虚幻引擎文档!请告诉我们该如何更好地为您服务。
填写问卷调查
取消