[Readme] Updated startergame and demo game with examples

Author: untoldengine

README.md

@@ -147,22 +147,7 @@ If you run into any issues or have questions, please don’t hesitate to open an
 
 ---
 
-## High-Level API Overview
-
-The Untold Engine offers an intuitive API for game development. Here's a quick look:
-
-```swift
-let stadium = createEntity()
-setEntityMesh(entityId: stadium, filename: "stadium", withExtension: "usdc")
-translateBy(entityId: stadium, position: simd_float3(0.0, 0.0, 0.0))
 
-let player = createEntity()
-setEntityMesh(entityId: player, filename: "redplayer", withExtension: "usdc", flip: false)
-setEntityAnimations(entityId: player, filename: "running", withExtension: "usdc", name: "running")
-changeAnimation(entityId: player, name: "running") // Start animation
-setEntityKinetics(entityId: player) // Enable Physics System
-```
----
 
 # Untold Engine Architecture — Summary  
 
@@ -187,35 +172,50 @@ This separation of entities, components, and systems keeps the codebase modular,
 
 ---
 
-## Using the Untold Engine
+## Using the Untold Engine  
 
-The Untold Engine is powered by modular systems that simplify game development. Click on the links to get started.
+The Untold Engine is powered by modular systems that simplify game development. Click on the links to get started.  
 
-### Editor & Workflow
+### Editor & Workflow  
 
-⚠️ **Important** The Editor is now the primary way to initialize and manage entities.  
+⚡ **For your convenience**: The Untold Engine provides an Editor that makes it easy to import assets, set up entities, and manage scenes — all without writing code.  
 
 - [Editor Overview](docs/editoroverview.md): Walkthrough of Scene Graph, Inspector, Gizmos, Materials, Lighting, Post-Processing, Asset Browser, and Console.  
 - [How to Import Assets](docs/importingassetseditor.md): Learn how to set asset paths and import models, materials, and animations.  
 
-### How-To Guides
-- [Adding a model using the Editor](docs/addModelUsingEditor.md): Learn how to add a model using the editor 
-- [Adding an animation using the Editor](docs/addAnimationsUsingEditor.md): Learn how to link an animation to the model using the editor (Coming Soon)
+### How-To Guides  
+- [Adding a model using the Editor](docs/addModelUsingEditor.md)  
+- [Adding an animation using the Editor](docs/addAnimationsUsingEditor.md) (Coming Soon)  
 
-⚠️ **Important**: Entities should be created and configured in the Editor. Code is used for gameplay logic only.  
+💡 **Note**: The Editor is optional. You can also load models, link animations, attach components, and configure entities directly in code. See the **Systems** section below for details.  
 
-### Systems 
-- [Registration-ECS System](docs/UsingRegistrationSystem.md): Handles the creation of entities and components
-- [Rendering System](docs/UsingRenderingSystem.md): Render 3D models with support for PBR and custom shaders.
-- [Transform System](docs/UsingTransformSystem.md): Manage entity positions, rotations, and scales.
-- [Animation System](docs/UsingAnimationSystem.md): Add life to your models with skeletal animations.
-- [Physics System](docs/UsingPhysicsSystem.md): Simulate gravity, forces, and movement.
-- [Input System](docs/UsingInputSystem.md): Capture keyboard and mouse interactions.
-- [Steering System](docs/UsingSteeringSystem.md): Implement intelligent behaviors like path-following.
-- [Scenegraph](docs/UsingScenegraph.md): Enables parent-child relationships between entities
-- [Shaders](docs/shaders.md): Add or modify shaders to fit your game's stye.
+### Systems  
+- [Registration-ECS System](docs/UsingRegistrationSystem.md): Handles the creation of entities and components.  
+- [Rendering System](docs/UsingRenderingSystem.md): Render 3D models with support for PBR and custom shaders.  
+- [Transform System](docs/UsingTransformSystem.md): Manage entity positions, rotations, and scales.  
+- [Animation System](docs/UsingAnimationSystem.md): Add life to your models with skeletal animations.  
+- [Physics System](docs/UsingPhysicsSystem.md): Simulate gravity, forces, and movement.  
+- [Input System](docs/UsingInputSystem.md): Capture keyboard and mouse interactions.  
+- [Steering System](docs/UsingSteeringSystem.md): Implement intelligent behaviors like path-following.  
+- [Scenegraph](docs/UsingScenegraph.md): Enables parent-child relationships between entities.  
+- [Shaders](docs/shaders.md): Add or modify shaders to fit your game’s style.  
+- [Importing Assets](docs/ImportingAssetFiles.md): Importing assets into your game project.  
 
-- [Importing Assets](docs/ImportingAssetFiles.md): Importing assets into your game project
+## High-Level API Overview
+
+The Untold Engine offers an intuitive API for game development. Here's a quick look:
+
+```swift
+let stadium = createEntity()
+setEntityMesh(entityId: stadium, filename: "stadium", withExtension: "usdc")
+translateBy(entityId: stadium, position: simd_float3(0.0, 0.0, 0.0))
+
+let player = createEntity()
+setEntityMesh(entityId: player, filename: "redplayer", withExtension: "usdc", flip: false)
+setEntityAnimations(entityId: player, filename: "running", withExtension: "usdc", name: "running")
+changeAnimation(entityId: player, name: "running") // Start animation
+setEntityKinetics(entityId: player) // Enable Physics System
+```
 ---
 
 ## Visuals

Sources/DemoGame/main.swift

@@ -13,6 +13,8 @@ class GameScene {
         if let desktopURL = FileManager.default.urls(for: .desktopDirectory, in: .userDomainMask).first {
             assetBasePath = desktopURL.appendingPathComponent("DemoGameAssets")
         }
+        
+        //Take a look at the DribblingSystem and BallSystem (inside `Sources/DemoGame`) to see how the game is structured and get familiar with the Untold Engine API.
 
         // The Untold Engine uses an ECS (Entity–Component–System) architecture.
         // This means you can extend the engine by adding your own custom

Sources/StarterGame/main.swift

@@ -13,6 +13,22 @@ class GameScene {
             assetBasePath = desktopURL.appendingPathComponent("DemoGameAssets")
         }
 
+        // Note: You’re not limited to the editor for setting up entities.
+        // The editor provides a visual workflow, but you can also create and
+        // configure everything directly in code if that’s your preference.
+        // Here is an example. For more details, see:
+        // https://github.com/untoldengine/UntoldEngine?tab=readme-ov-file#systems
+        
+        let stadium = createEntity()
+        setEntityMesh(entityId: stadium, filename: "stadium", withExtension: "usdc")
+        translateBy(entityId: stadium, position: simd_float3(0.0, 0.0, 0.0))
+        
+        let player = createEntity()
+        setEntityMesh(entityId: player, filename: "redplayer", withExtension: "usdc", flip: false)
+        rotateTo(entityId: player, angle: 0, axis: simd_float3(0.0,1.0,0.0))
+        setEntityAnimations(entityId: player, filename: "running", withExtension: "usdc", name: "running")
+        changeAnimation(entityId: player, name: "running") // Start animation
+        
     }
 
     func update(deltaTime _: Float) {