Feature/mat system

AGENTS.md

@@ -3,3 +3,16 @@
 ## C++ naming
 
 - Never use `b` as a prefix or suffix to denote a `bool`. Prefer concise names that are clear from their context, such as `Cancelled` or `Completed`; use predicates such as `IsVisible`, `HasFocus`, `CanRender`, or `ShouldUpdate` when needed for clarity.
+
+## C++ documentation
+
+- Write Doxygen documentation in English for public types, public members, and public functions.
+- Follow ISO 24495-1 plain-language principles: state the purpose first, use short direct sentences, and use familiar terms.
+- Use `@param`, `@return`, `@tparam`, and `@pre` only when they add information needed to use the API correctly.
+- Document public data members when their purpose, unit, ownership, valid range, or relationship to another member is not immediately clear.
+- Use a short single-sentence comment for private methods. Document private data only when it is necessary to explain an invariant or a non-obvious relationship.
+
+## Validation
+
+- This project targets macOS and Windows. Validate changes for Windows compilation and linking implications even when only macOS is available locally; the CI runs tests on Windows.
+- When a public API crosses a shared-library boundary, verify that its out-of-line symbols use `ELIXIR_API` where Windows DLL export and import require it.

Assets/.gitignore

@@ -0,0 +1,3 @@
+/Meshes
+
+*.hdr

Assets/VFX/FireAndFireworks.json

@@ -110,7 +110,7 @@
     {
       "name": "FlameCore",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$flame_start", "emissive": [1.25, 0.15, 0.01, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 2200,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -138,7 +138,7 @@
     {
       "name": "EmberSparks",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$ember_start", "emissive": [0.90, 0.08, 0.01, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 1200,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -166,7 +166,7 @@
     {
       "name": "SmokePlume",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$smoke_start", "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 1000,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -193,7 +193,7 @@
     {
       "name": "VortexSprites",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": [0.88, 0.54, 1.00, 0.78], "emissive": [0.40, 0.10, 0.60, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 1800,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -223,7 +223,7 @@
     {
       "name": "RocketOrange",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$trail_start", "emissive": [0.80, 0.15, 0.02, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 220,
       "spawnRate": "$spawn_rate",
       "burst": { "count": 14, "interval": 1.25 },
@@ -252,7 +252,7 @@
     {
       "name": "RocketBlue",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$trail_start", "emissive": [0.05, 0.25, 1.00, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 220,
       "spawnRate": "$spawn_rate",
       "burst": { "count": 14, "interval": 1.55 },
@@ -281,7 +281,7 @@
     {
       "name": "RocketGold",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$trail_start", "emissive": [0.80, 0.45, 0.05, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 240,
       "spawnRate": "$spawn_rate",
       "burst": { "count": 16, "interval": 1.85 },
@@ -310,7 +310,7 @@
     {
       "name": "BurstOrange",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$burst_a_start", "emissive": [0.80, 0.05, 0.01, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 1800,
       "spawnRate": "$spawn_rate",
       "trigger": { "source": "RocketOrange", "delay": 1.18 },
@@ -340,7 +340,7 @@
     {
       "name": "BurstBlue",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$burst_b_start", "emissive": [0.05, 0.30, 1.00, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 1800,
       "spawnRate": "$spawn_rate",
       "trigger": { "source": "RocketBlue", "delay": 1.12 },
@@ -370,7 +370,7 @@
     {
       "name": "BurstGold",
       "renderMode": "Sprite",
-      "spriteTexture": "Assets/Textures/SoftGlow.png",
+      "material": { "color": "$burst_c_start", "emissive": [1.00, 0.50, 0.05, 0.0], "texture": "Assets/Textures/SoftGlow.png" },
       "maxParticles": 2000,
       "spawnRate": "$spawn_rate",
       "trigger": { "source": "RocketGold", "delay": 1.18 },

Assets/VFX/RainStorm.json

@@ -37,7 +37,7 @@
     {
       "name": "RainDrops",
       "renderMode": "Sprite",
-      "spriteTexture": "./Assets/Textures/RainDrop.png",
+      "material": { "color": "$rain_drop_start", "texture": "./Assets/Textures/RainDrop.png" },
       "maxParticles": 5600,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -67,7 +67,7 @@
     {
       "name": "GroundMist",
       "renderMode": "Sprite",
-      "spriteTexture": "./Assets/Textures/RainDrop.png",
+      "material": { "color": "$mist_start", "texture": "./Assets/Textures/RainDrop.png" },
       "maxParticles": 640,
       "spawnRate": "$spawn_rate",
       "parameters": {

Assets/VFX/RibbonGarden.json

@@ -38,6 +38,7 @@
     {
       "name": "PathRibbon",
       "renderMode": "Ribbon",
+      "material": { "color": "$canopy_color_start", "emissive": [0.10, 0.25, 0.50, 0.0] },
       "maxParticles": 256,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -66,6 +67,7 @@
     {
       "name": "PurpleFountain",
       "renderMode": "Sprite",
+      "material": { "color": "$spark_color_start", "emissive": [0.40, 0.05, 0.60, 0.0] },
       "maxParticles": 1600,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -96,6 +98,7 @@
     {
       "name": "CrystalShards",
       "renderMode": "Mesh",
+      "material": { "color": [0.86, 0.94, 1.0, 0.62] },
       "maxParticles": 220,
       "spawnRate": "$spawn_rate",
       "parameters": {

Assets/VFX/RibbonVortex.json

@@ -38,6 +38,7 @@
     {
       "name": "PathRibbon",
       "renderMode": "Ribbon",
+      "material": { "color": "$canopy_color_start", "emissive": [0.10, 0.25, 0.50, 0.0] },
       "maxParticles": 256,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -108,6 +109,7 @@
     {
       "name": "PurpleFountain",
       "renderMode": "Sprite",
+      "material": { "color": "$spark_color_start", "emissive": [0.40, 0.05, 0.60, 0.0] },
       "maxParticles": 1600,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -189,6 +191,7 @@
     {
       "name": "CrystalShards",
       "renderMode": "Mesh",
+      "material": { "color": [0.86, 0.94, 1.0, 0.62] },
       "maxParticles": 220,
       "spawnRate": "$spawn_rate",
       "parameters": {
@@ -274,4 +277,4 @@
       ]
     }
   ]
-}
+}