.VARIABLES

RAGAI.VARIABLES ist ein leeres Objekt, das dir zur Verfügung steht, um eigene Variablen zu speichern. Damit kannst du Daten zwischen verschiedenen Bot-Bausteinen, Skills oder Code-Blöcken teilen – ohne globale Variablen oder window-Eigenschaften.

Unterschied zu KEYVAL

RAGAI.VARIABLES speichert Daten nur im Arbeitsspeicher für die aktuelle Sitzung. Wenn du Daten dauerhaft (über Sitzungen hinweg) speichern möchtest, verwende stattdessen RAGAI.KEYVAL.

---

Verwendung

Du kannst beliebige Werte auf RAGAI.VARIABLES setzen und in jedem anderen Baustein wieder auslesen.

// In Baustein A: Variablen setzen
RAGAI.VARIABLES.spielerName = "Max";
RAGAI.VARIABLES.aktuelleRunde = 3;
RAGAI.VARIABLES.punkte = [10, 20, 15];

// In Baustein B: Variablen auslesen
console.log(RAGAI.VARIABLES.spielerName);    // "Max"
console.log(RAGAI.VARIABLES.aktuelleRunde);  // 3
console.log(RAGAI.VARIABLES.punkte);         // [10, 20, 15]

---

Beispiel: Spielzustand verwalten

// Spielzustand initialisieren
RAGAI.VARIABLES.spielZustand = {
  runde: 1,
  leben: 3,
  gesammelt: [],
  gestartet: new Date()
};

// Später im Spielverlauf aktualisieren
RAGAI.VARIABLES.spielZustand.runde++;
RAGAI.VARIABLES.spielZustand.gesammelt.push("Schlüssel");
RAGAI.VARIABLES.spielZustand.leben--;

// Zusammenfassung ausgeben
const z = RAGAI.VARIABLES.spielZustand;
await RAGAI.MSG.botMessage(
  `Runde ${z.runde} | Leben: ${z.leben} | Gesammelt: ${z.gesammelt.join(", ")}`
);

---

Hinweise

• RAGAI.VARIABLES ist ein einfaches JavaScript-Objekt – du kannst Werte jederzeit setzen, ändern oder löschen.
• Die gespeicherten Werte bleiben nur für die aktuelle Bot-Sitzung erhalten. Nach einem Reload gehen sie verloren.
• Für persistente Speicherung verwende RAGAI.KEYVAL oder RAGAI.PROJECTKEYVAL.