ECSCombat icon indicating copy to clipboard operation
ECSCombat copied to clipboard

Upgrade project to Unity ECS 2025 (v1.3.2)

Open kstars111 opened this issue 3 months ago • 0 comments

Major migration from ECS 0.17.0-preview.42 to ECS 1.3.2, updating all deprecated APIs and patterns to modern ECS 2025 standards.

Package Updates:

  • com.unity.entities: 0.17.0-preview.42 → 1.3.2
  • com.unity.burst: 1.4.11 → 1.8.12
  • com.unity.rendering.hybrid → com.unity.entities.graphics: 1.3.2
  • Removed com.unity.dots.editor (deprecated)

Conversion System Migration (39 files):

  • Migrated all IConvertGameObjectToEntity to Baker<T> pattern
  • Replaced GameObjectConversionSystem with Baker.Bake() method
  • Updated entity retrieval to use GetEntity(TransformUsageFlags.None)
  • Converted EntityManager.AddComponentData() to Baker.AddComponent()
  • Converted EntityManager.AddBuffer() to Baker.AddBuffer()

System API Updates (25+ files):

  • Replaced GetComponentDataFromEntity<T>() with SystemAPI.GetComponent<T>()
  • Replaced GetBufferFromEntity<T>() with GetBufferLookup<T>()
  • Updated component writes to use SystemAPI.SetComponent() or SystemAPI.GetComponentRW<T>()
  • Migrated BufferFromEntity to BufferLookup in IJob structs

System Architecture Updates:

  • Migrated ComponentSystem to SystemBase (3 files)
  • Added .Run() to Entities.ForEach blocks in migrated systems
  • Updated World.GetOrCreateSystem<T>() to World.GetOrCreateSystemManaged<T>() (19 files)
  • Removed deprecated [AlwaysUpdateSystem] attribute (6 files)

Namespace Updates (11 files):

  • Changed using Unity.Rendering to using Unity.Entities.Graphics

Transform System Updates:

  • Updated Translation/Rotation/Scale to LocalTransform.FromPositionRotationScale()
  • Modernized transform component usage in effect systems

Rendering Updates:

  • Migrated RenderMesh to RenderMeshUtility.AddComponents() in Bakers
  • Updated rendering setup to use RenderMeshDescription and MaterialMeshInfo

All systems now compile with ECS 2025 and follow modern DOTS patterns.

kstars111 avatar Nov 08 '25 21:11 kstars111