Sync fork develop with upstream: release 0.22.0 (#1305)

.github/workflows/ci-build-test.yml

@@ -1,10 +1,22 @@
 name: CI Build and Test
 
+# Changes that only touch the documentation skip this workflow: the docs folder,
+# mkdocs.yml and the Markdown files at the repository root. Markdown files elsewhere
+# (for example template resources under Sources) still run it. The MkDocs build has
+# its own workflow.
 on:
   push:
     branches: [master, develop]
+    paths-ignore:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - '*.md'
   pull_request:
     branches: [master, develop]
+    paths-ignore:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - '*.md'
 
 jobs:
   python-script-tests:

.github/workflows/swiftformat-lint.yml

@@ -3,6 +3,11 @@ name: Formatting Validation
 on:
   pull_request:
     branches: [master, develop]
+    # Documentation-only changes have no Swift to lint.
+    paths-ignore:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - '*.md'
 
 jobs:
   lint:

CHANGELOG.md

@@ -1,4 +1,14 @@
 # Changelog
+## v0.22.0 - 2026-10-04
+### 🐞 Fixes
+- [Patch] Remember failed texture writes per export, not per Blender session (#1263) (fa706bf…)
+### 📚 Docs
+- [Docs] Updated engine architecture docs (#1286) (3ff79c0…)
+- [Docs] Actors and locks: benchmark, lock census of the frame and rules (#1294) (0e652b3…)
+### 🚀 Features
+- [Feature] Keep an export's assets in a folder of their own (#1268) (3c006f5…)
+- [Feature] Animation foundation and character deformation stack: pose layers, physics pose, compute skinning, DQS/DDM, morph targets, pose drivers, XPBD muscles, ML deformer, motion-capture seams (#1259) (ae6df3e…)
+- [Feature] Reach IK: a target per chain, in world, model, shoulder or ground space (#1283) (7f63272…)
 ## v0.21.0 - 2026-09-26
 ### 🐞 Fixes
 - [Bugfix] Restore StarterDemo keyboard input (014a559…)

Examples/CodeComponents/SamplePluginPackage/Package.swift

@@ -1,3 +1,13 @@
+//
+//  Package.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 // swift-tools-version: 6.0
 
 import PackageDescription

Examples/CodeComponents/SamplePluginPackage/Sources/SampleEditorPluginPackage/SampleMenus.swift

@@ -1,3 +1,13 @@
+//
+//  SampleMenus.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import SamplePluginPackage
 import UntoldComponentKit
 

Examples/CodeComponents/SamplePluginPackage/Sources/SamplePluginPackage/GeneratedGeometry.swift

@@ -1,3 +1,13 @@
+//
+//  GeneratedGeometry.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 import ModelIO
 import simd

Examples/CodeComponents/SamplePluginPackage/Sources/SamplePluginPackage/PulseClock.swift

@@ -1,3 +1,13 @@
+//
+//  PulseClock.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 
 /// A clock shared by everything that pulses, so it all moves in step. It stands in for a

Examples/CodeComponents/SamplePluginPackage/Sources/SamplePluginPackage/SplinePath.swift

@@ -1,3 +1,13 @@
+//
+//  SplinePath.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 import MetalKit
 import ModelIO

Examples/CodeComponents/SamplePluginPackage/Sources/SamplePluginPackage/Torus.swift

@@ -1,3 +1,13 @@
+//
+//  Torus.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 import MetalKit
 import ModelIO

Examples/CodeComponents/SampleProject/Sources/SampleProject/AppDelegate.swift

@@ -1,3 +1,13 @@
+//
+//  AppDelegate.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 //
 //  AppDelegate.swift
 //  SampleProject

Examples/CodeComponents/SampleProject/Sources/SampleProject/GameScene.swift

@@ -1,3 +1,13 @@
+//
+//  GameScene.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 //
 //  GameScene.swift
 //  SampleProject

Examples/CodeComponents/SampleProject/Sources/SampleProject/GameSceneUtils.swift

@@ -1,3 +1,13 @@
+//
+//  GameSceneUtils.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 //
 //  GameSceneUtils.swift
 //  SampleProject

Examples/CodeComponents/SampleProject/Sources/SampleProject/GameViewController.swift

@@ -1,3 +1,13 @@
+//
+//  GameViewController.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 //
 //  GameViewController.swift
 //  SampleProject

Examples/CodeComponents/SampleProject/Sources/SampleProjectPlugins/Bobber.swift

@@ -1,3 +1,13 @@
+//
+//  Bobber.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import SamplePluginPackage
 import simd
 import UntoldComponentKit

Examples/CodeComponents/SampleProject/Sources/SampleProjectPlugins/GameRules.swift

@@ -1,3 +1,13 @@
+//
+//  GameRules.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import UntoldComponentKit
 import UntoldEngine
 

Examples/CodeComponents/SampleProject/Sources/SampleProjectPlugins/SampleTools.swift

@@ -1,3 +1,13 @@
+//
+//  SampleTools.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 // Editor-only. The editor compiles this folder with UNTOLD_EDITOR defined; the game does not,
 // so nothing below ends up in the game binary.
 #if UNTOLD_EDITOR

Examples/CodeComponents/SampleProject/Sources/SampleProjectPlugins/SpawnPoint.swift

@@ -1,3 +1,13 @@
+//
+//  SpawnPoint.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 import simd
 import UntoldComponentKit

Examples/CodeComponents/SampleProject/Sources/SampleProjectPlugins/Spinner.swift

@@ -1,3 +1,13 @@
+//
+//  Spinner.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import simd
 import UntoldComponentKit
 import UntoldEngine

Examples/RenderingExtensions/ApplicationLocal/Shaders/TintSurface.metal

@@ -1,3 +1,13 @@
+//
+//  TintSurface.metal
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 #include <metal_stdlib>
 #include <UntoldEngineShaderSupport/UntoldModelSurface.h>
 

Examples/RenderingExtensions/ApplicationLocal/TintSurfaceRenderExtension.swift

@@ -1,3 +1,13 @@
+//
+//  TintSurfaceRenderExtension.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 import simd
 import UntoldEngine

Examples/RenderingExtensions/SwiftPackagePlugin/Package.swift

@@ -1,3 +1,13 @@
+//
+//  Package.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 // swift-tools-version: 6.0
 
 import PackageDescription

Examples/RenderingExtensions/SwiftPackagePlugin/Sources/WaterRenderPlugin/Shaders/WaterRenderPlugin.metal

@@ -1,3 +1,13 @@
+//
+//  WaterRenderPlugin.metal
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 #include <metal_stdlib>
 #include <UntoldEngineShaderSupport/UntoldModelSurface.h>
 

Examples/RenderingExtensions/SwiftPackagePlugin/Sources/WaterRenderPlugin/WaterRenderPlugin.swift

@@ -1,3 +1,13 @@
+//
+//  WaterRenderPlugin.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Foundation
 import Metal
 import simd

Examples/RenderingExtensions/SwiftPackagePlugin/Tests/WaterRenderPluginTests/WaterRenderPluginTests.swift

@@ -1,3 +1,13 @@
+//
+//  WaterRenderPluginTests.swift
+//  UntoldEngine
+//
+// Copyright (C) Untold Engine Studios
+//
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 import Metal
 import UntoldEngine
 import WaterRenderPlugin