document. Closes DRE-794. Closes DRE-996.

Author: Jaxkr

combined-ingredients.md

@@ -1525,6 +1525,44 @@ if (hit) {
 }
 ```
 
+## Drawing with Pixi
+```ts
+import { Behavior, RawPixi } from "@dreamlab/engine";
+import * as PIXI from "@dreamlab/vendor/pixi.ts";
+
+export default class GraphicsDemo extends Behavior {
+  rawPixi!: RawPixi;
+  g!: PIXI.Graphics;
+
+  onInitialize() {
+    if (!this.game.isClient()) return;
+    this.rawPixi = this.game.local.spawn({
+      type: RawPixi,
+      name: "GraphicsTest",
+      transform: { position: this.entity.pos, z: 5 },
+    });
+
+    // Create a PIXI.Graphics and add it to the RawPixi container
+    this.g = new PIXI.Graphics();
+    this.rawPixi!.container!.addChild(this.g);
+
+    // 3) Draw something simple
+    this.g
+      .rect(0, 0, 5, 5)
+      .fill("#00ffb7");
+  }
+
+  onPostTick() {
+    if (!this.game.isClient()) return;
+    // Keep your graphics positioned relative to your entity
+    this.rawPixi.globalTransform.position.x = this.entity.pos.x;
+    this.rawPixi.globalTransform.position.y = this.entity.pos.y;
+  }
+}
+```
+
+You can also attach it to a RawPixi entity itself.
+
 ---
 
 

docs/guide/preloading.mdx

@@ -0,0 +1,14 @@
+# Preloading Assets
+
+
+Textures, sounds, and other assets can be preloaded by defining a `preload.ts` file in the root of your project
+
+```ts
+export default definePreload({
+  textures: ["res://assets/a.png"],
+  // ... sounds, etc
+  custom: async () => {
+    // custom preloading goes here
+  }
+});
+```