Spiel bearbeiten

Spiel-Dateien hochladen (ZIP) & URL automatisch setzen

Lädt die Spieldateien hoch und setzt die „Spiel-URL" oben automatisch auf die erkannte HTML. So musst du die URL nicht selbst kennen. (Alternativ die URL oben von Hand eintragen.)

Ziel-Einstellung (optional)

Events / Actions Event Code generieren

Der Key muss zur runAction() im Spiel-HTML passen. Zeilen mit „tr-Key" nutzen die eingebauten TikEasy-Übersetzungen – eigene Labels (DE/EN) überschreiben das.

Key	Icon	Label DE	Label EN	👤	Win	Farbe	🎁 Standard

„Übernehmen" ändert nur die Liste – erst „Katalog speichern" schreibt auf den Server.

Anleitung: Neues Spiel anbinden

Ablauf in 5 Schritten

1. Spiel bauen: Eine einzelne HTML-Datei (Design für 1080×1920 hochkant, three.js vom CDN ist ok). Sounds in einen sounds/-Unterordner daneben.
2. Anbindungs-Code einbauen (Vorlage unten kopieren): WebSocket-Empfänger + runAction() + Win-Melder.
3. Hochladen: Ordner nach stream_games_display/<SpielName>/ auf den Server.
4. Hier anlegen: „Neues Spiel" → Key, URL, Events (Keys exakt wie im Code!), Cover. Sichtbarkeit erst auf „🔒 Nur Admins" → „Katalog speichern".
5. Testen & live schalten: TikEasy (Admin) neu starten → Spielseite öffnen → mit den ▶-Test-Buttons jedes Event prüfen (feuert exakt wie ein echtes Gift). Läuft alles → Sichtbarkeit auf „🟢 Live".

Die 4 Regeln

• Der Spiel-Key und die Event-Keys im Code müssen exakt den Einträgen im Katalog entsprechen – nur Kleinbuchstaben, Zahlen, _.
• count beachten: 5× dasselbe Gift = eine Nachricht mit count: 5 → Aktion entsprechend oft (mit Deckel!) ausführen.
• Spendername: data.name/data.pfp_url sind dabei, wenn der Server sie kennt – nutzen, wenn das Spiel Namen anzeigen soll (wie Smash-Burger-Vordrängler).
• Win-Tracker: Events mit Win ±1 müssen reportWin(+1/-1) aufrufen (Konsolen-Markierung, siehe Vorlage) – TikEasy fängt das ab.

Copy-Paste-Vorlage (ans Ende des Spiel-Scripts) Kopieren

/* ==== StreamUp-Anbindung (Gift → Spiel-Aktion) ==== */
const GAME_KEY = 'meinspiel';   // = Key aus dem Spiele-Katalog (Kleinbuchstaben!)

// Event-Key → Funktion. Die Keys MÜSSEN exakt den Katalog-Events entsprechen.
const GIFT_ACTIONS = {
  boost:      (name, pfp) => { /* ... Spiel-Logik ... */ },
  bomb:       (name, pfp) => { /* ... Spiel-Logik ... */ },
  win_add:    () => reportWin(+1),
  win_remove: () => reportWin(-1),
};

function runAction(action, count, name, pfp) {
  const fn = GIFT_ACTIONS[action];
  if (!fn) return;
  const n = Math.max(1, Math.min(20, count | 0 || 1));   // Spam-Deckel
  for (let i = 0; i < n; i++) fn(name, pfp);
}

// Win-Tracker: ±1 an TikEasy melden (das Spielfenster liest die Konsole).
// full=true NUR für selbst erspielte Siege (füllt bis zum Ziel, ohne Bonus).
function reportWin(delta, full) {
  try { console.log((full ? '__APSWINFULL__:' : '__APSWIN__:') + (delta > 0 ? 1 : -1)); } catch (e) {}
}

// WebSocket: empfängt { type: GAME_KEY+'_action', data: { action, count, name, pfp_url } }
(function setupGiftSocket() {
  const readKey = new URLSearchParams(location.search).get('key');
  if (!readKey) return;                    // ohne ?key= (lokaler Test) kein Server
  const scheme = location.protocol === 'https:' ? 'wss' : 'ws';
  const url = scheme + '://' + location.host + '/ws/updates/' + readKey;
  let delay = 1000;
  function connect() {
    let ws; try { ws = new WebSocket(url); } catch (e) { retry(); return; }
    ws.onopen = () => { delay = 1000; };
    ws.onmessage = (ev) => {
      let m; try { m = JSON.parse(ev.data); } catch (e) { return; }
      if (m && m.data && m.type === GAME_KEY + '_action')
        runAction(m.data.action, m.data.count, m.data.name, m.data.pfp_url);
    };
    ws.onclose = () => retry();
    ws.onerror = () => { try { ws.close(); } catch (e) {} };
  }
  function retry() { setTimeout(() => { delay = Math.min(delay * 1.6, 15000); connect(); }, delay); }
  connect();
})();

Checkliste vor „Live"

• ☑ Jeder ▶-Test-Button auf der TikEasy-Spielseite löst die richtige Aktion aus
• ☑ Mehrfach-Gifts (count > 1) übertreiben nicht (Deckel testen)
• ☑ Win-Events erhöhen/senken den Win-Tracker in TikEasy
• ☑ Spiel läuft flüssig im TikEasy-Spielfenster (nicht nur im Browser)
• ☑ Menü/Einstellungen passen sich der Fenstergröße an (auch 1080×1200)

Anbindungs-Code

Ans Ende des <script>-Blocks im Spiel-HTML einfügen und die TODO-Funktionen mit der Spiel-Logik füllen. Die Event-Keys sind exakt die aus diesem Editor – nicht umbenennen!

Spiel-Dateien

Neue Version hochladen (ZIP) → in Test-Version

ZIP mit dem kompletten Spiel-Inhalt (HTML + sounds/ …). Ein einzelner Top-Ordner im ZIP wird automatisch entfernt. Der aktuelle Stand wird vorher automatisch als Version gesichert.

Versionen Aktuellen Stand herunterladen

Log

Papierkorb & Katalog-Log

Aus dem Katalog gelöschte Spiele landen hier (die letzten 25) und können mit einem Klick wiederhergestellt werden – inklusive aller Events und Einstellungen. Die Spiel-Dateien auf dem Server werden beim Löschen ohnehin nie angefasst.

Änderungs-Log