diff --git a/test-modes.sh b/test-modes.sh
new file mode 100755
index 0000000..6baf049
--- /dev/null
+++ b/test-modes.sh
@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Testa o ciclo de modos do wallpaper: recarrega o plugin e alterna
+# retrowave -> chuva -> balada -> chuva -> retrowave com pausas para observar.
+set -e
+
+PLUGIN_ID="com.vini.dancingcharacter"
+PAUSE="${1:-5}"   # segundos entre cada transição (padrão 5)
+
+plasma_script() {
+  local js="for (let i of desktops()) { i.wallpaperPlugin = \"$1\"; }"
+  qdbus6 org.kde.plasmashell /PlasmaShell org.kde.PlasmaShell.evaluateScript "$js" 2>/dev/null \
+    || qdbus org.kde.plasmashell /PlasmaShell org.kde.PlasmaShell.evaluateScript "$js"
+}
+
+set_modes() {  # set_modes <chuva> <balada>
+  echo "$1" > /tmp/skeledance-chuva
+  echo "$2" > /tmp/skeledance-balada
+}
+
+echo "==> Recarregando wallpaper (troca para org.kde.image e volta)..."
+plasma_script "org.kde.image"
+sleep 1
+plasma_script "$PLUGIN_ID"
+sleep 2
+
+echo "==> chuva ON"
+set_modes 1 0; sleep "$PAUSE"
+
+echo "==> balada ON (transição chuva -> balada)"
+set_modes 0 1; sleep "$PAUSE"
+
+echo "==> chuva ON (transição balada -> chuva)"
+set_modes 1 0; sleep "$PAUSE"
+
+echo "==> ambos OFF (volta ao retrowave)"
+set_modes 0 0
+
+echo "==> Ciclo completo. Confira: só um de lua/globo visível por vez."