🌑 2D Darkness and Light System

GameCrom includes a complete 2D lighting system based on masking layers, fully compatible with the Canvas engine and without relying on WebGL. This system allows you to create dynamic darkness effects such as caves, flashlights, torches, or realistic night scenes, all with perfect performance even on mobile browsers.

🧱 General Concept

The system works with two types of objects:

💡 Light: an individual, configurable light source with a radius.
🌑 Darkness: a global darkness layer that covers the entire scene and reveals only the areas “cut” by active lights.

🔹 Lights and darkness are regular objects in the editor (not components).
🔹 They are automatically drawn in the correct render order.
🔹 No scripts or physics required — everything is handled visually.

💡 Light Object

Lights are used to illuminate specific areas of the scene.

Available Properties:

color → Light color (default: #ffffaa).
radius → Illumination radius in pixels.
intensity → Light intensity (0.0 to 1.0).
layer → Render layer (combines with object order).
active / visible → Allows turning the light ON/OFF.

// Example: warm torch light
{
  type: "light",
  x: 320,
  y: 240,
  radius: 250,
  intensity: 0.8,
  color: "#ffb84d",
  layer: 20,
  active: true,
  visible: true
}

🌑 Darkness Object

This object creates the global darkness layer. Only one can exist per scene, and it covers the entire camera view during gameplay. Lighted areas are cut out dynamically.

Properties:

color → Darkness color (typically black #000000).
opacity → Overall darkness level (0 = no effect, 1 = fully dark).
playerLightRadius → Light radius emitted around the player.
active / visible → Controls whether darkness is active.

⚠️ In the editor, the darkness is not drawn visually to avoid blocking your view,
but it always appears in the hierarchy and renders automatically in the game.

📌 Recommendations

Place the darkness object on a very high layer (e.g., layer = 999).
Do not use transparent images for darkness — use solid colors.
Use opacity to adjust ambience (day/night cycles).
You can animate playerLightRadius or opacity via script for dynamic effects.

✅ This system delivers realistic lighting effects without shaders, is lightweight, scalable, and works on any modern device.