@needle-tools/engine 4.13.0-next.e86f701 → 4.13.1-beta

package/CHANGELOG.md

@@ -6,7 +6,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [4.13.0] - 2026-02-10
 - **NEW**: Needle Engine MaterialX loader added to core. No extra dependency to @needle-tools/materialx is required anymore
-- Fix: ContactShadows not correctly rendering anymore
+- Fix: ContactShadows rendering
+- Fix: Memory issue caused by ReflectionProbes component
 
 ## [4.12.5] - 2026-02-09
 - Update three.js dependency

package/README.md

@@ -50,6 +50,43 @@ npm install @needle-tools/engine
 
 **Explore Examples:** [Try our interactive samples](https://engine.needle.tools/samples) to see what's possible ⚡
 
+## Basic Usage
+
+### Creating a Custom Component
+
+```typescript
+import { Behaviour, serializable } from "@needle-tools/engine";
+
+export class MyComponent extends Behaviour {
+    @serializable()
+    speed: number = 1;
+
+    start() {
+        console.log("Component started on:", this.gameObject.name);
+    }
+
+    update() {
+        this.gameObject.rotateY(this.context.time.deltaTime * this.speed);
+    }
+}
+```
+
+### Using Lifecycle Hooks (without components)
+
+```typescript
+import { onStart, onUpdate } from "@needle-tools/engine";
+
+onStart((context) => {
+    console.log("Engine started!");
+});
+
+onUpdate((context) => {
+    // Called every frame
+});
+```
+
+[→ See API Documentation](https://engine.needle.tools/docs/api/latest)
+
 ---
 
 *Available under commercial and educational licenses*