From 40fd25e14bd7862bc3707a1553973292dc575766 Mon Sep 17 00:00:00 2001
From: jessikitty <jess.rogerson.29@outlook.com>
Date: Mon, 6 Apr 2026 16:38:44 +1000
Subject: [PATCH] docs: Add cycle effect examples and documentation

- Document "cycle" effect for revolving lights
- Add Police Lights and Ocean Wave cycle examples
- Add effect_notes section explaining each effect
- Add police_red and police_blue to preset colors
---
 tag_colors.json.example | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/tag_colors.json.example b/tag_colors.json.example
index 67be081..07c8a8d 100644
--- a/tag_colors.json.example
+++ b/tag_colors.json.example
@@ -2,7 +2,11 @@
     "_comment": "Tag color mappings for LEGO Dimensions Portal Client",
     "_instructions": [
         "Map legacy keys to colors and effects",
-        "Effects: 'solid', 'pulse', 'flash'",
+        "Effects: 'solid', 'pulse', 'flash', 'cycle'",
+        "  - solid: Constant color on the pad",
+        "  - pulse: Smooth breathing/fading effect",
+        "  - flash: Blinking on/off",
+        "  - cycle: Revolving lights across ALL pads (like police lights!)",
         "Colors: [R, G, B] values 0-255",
         "Speed: 0.2 (very fast) to 3.0 (slow), 1.0 = normal",
         "Run the portal client to discover tag legacy keys",
@@ -34,9 +38,29 @@
             "effect": "flash",
             "speed": 0.5,
             "name": "Fast Flash Example"
+        },
+        "9876543210": {
+            "color": [255, 0, 0],
+            "effect": "cycle",
+            "speed": 0.5,
+            "name": "Police Lights (Red Cycle)"
+        },
+        "1111111111": {
+            "color": [0, 100, 255],
+            "effect": "cycle",
+            "speed": 1.0,
+            "name": "Ocean Wave (Blue Cycle)"
         }
     },
     
+    "_effect_notes": {
+        "_comment": "Effect behavior details",
+        "solid": "Simple constant color - most power efficient",
+        "pulse": "Smooth fade in/out breathing effect",
+        "flash": "Sharp on/off blinking",
+        "cycle": "Rotates color through CENTER → LEFT → RIGHT pads. Great for special characters! Speed controls how fast it rotates."
+    },
+    
     "_preset_colors": {
         "_comment": "Reference colors you can copy/paste",
         "red": [255, 0, 0],
@@ -53,6 +77,8 @@
         "forest_green": [0, 255, 100],
         "ocean_blue": [0, 100, 255],
         "fire_red": [255, 50, 0],
-        "ice_blue": [150, 200, 255]
+        "ice_blue": [150, 200, 255],
+        "police_red": [255, 0, 0],
+        "police_blue": [0, 0, 255]
     }
 }