KCode

KCode-Formatierung

KCode ist das Markup-System für Nachrichten auf Knuddels. Damit kannst du Texte formatieren, klickbare Links erstellen, Bilder manipulieren und interaktive Elemente einbetten.

Hinweis: Einige erweiterte KCode-Features (Buttons, Countdown, Textausrichtung) funktionieren nur in der PC-App. In anderen Clients wird stattdessen ein einfacher Link oder gar nichts angezeigt.

---

Grundlegende Formatierung

var bot = KnuddelsServer.getDefaultBotUser();

// Fett
bot.sendPublicMessage('_Das ist fett_');

// Kursiv
bot.sendPublicMessage('Das ist °#°kursiv°#°');

// Fett und kursiv
bot.sendPublicMessage('_°#°Fett und kursiv°#°_');

Farben

// Vordefinierte Farbkürzel
°R°Rot°#°     °G°Grün°#°     °B°Blau°#°
°E°Rot2°#°    °W°Weiß°#°     °K°Schwarz°#°
°Y°Gelb°#°    °C°Cyan°#°     °M°Magenta°#°

// RGB-Farbcode
°#FF0000°Roter Text°#°
°#00FF00°Grüner Text°#°

Schriftgröße

// Größe 0–9 (Standard ist normal)
°1°Kleine Schrift°#°
°5°Größere Schrift°#°
°9°Sehr große Schrift°#°

Textausrichtung (nur PC-App)

°>LEFT<°Linksbündig
°>CENTER<°Zentriert
°>RIGHT<°Rechtsbündig
°>JUSTIFY<°Blocksatz

// Prozentuale Einrückung
°%20°20% eingerückt
°%50°50% eingerückt

---

Klickbare Links / Befehle

Die wichtigste KCode-Funktion: Text, der beim Klick einen Befehl ausführt.

// Syntax: °>BEFEHL|ANZEIGETEXT<°

// Chat-Befehl ausführen
bot.sendPublicMessage('Klicke °>/start|hier<° um zu starten!');

// Profil öffnen
bot.sendPublicMessage('Besuche ' + user.getProfileLink() + ' im Profil!');

// Eigener Anzeigetext für Profillink
bot.sendPublicMessage('Besuche ' + user.getProfileLink('diesen Nutzer') + '!');

Beispiel: Menü mit klickbaren Optionen

user.sendPrivateMessage(
    'Was möchtest du tun?\n' +
    '°>/spielen|Spielen<°\n' +
    '°>/highscore|Highscore anzeigen<°\n' +
    '°>/hilfe|Hilfe<°'
);

---

Buttons (nur PC-App)

Im Chat können grafische Buttons dargestellt werden:

// Syntax: °>{button}TEXT|ID<°
°>{button}Klick mich|btn1<°

// Button mit Befehl
°>{button}Spielen||call|/start<°

// Deaktivierter Button
°>{button}Gesperrt||enabled|0<°

// Button mit Icon
°>{button}Hallo||icon|sm_00.gif<°

// Größe anpassen
°>{button}Großer Button||width|200|height|30<°

// Textschatten
°>{button}Schatten||textshadow|1<°

Button-Farben

Buttons können mit Farbverläufen gestaltet werden. Der Gradient definiert drei Farben (oben, mitte, unten) als RGB-Werte, getrennt durch ~:

// Komplett roter Button
°>{button}Rot||color|255,0,0~255,0,0~255,0,0<°

// Regenbogen-Gradient
°>{button}Bunt||color|255,0,0~0,255,0~0,0,255<°

Vordefinierte Stile sind ebenfalls verfügbar (z.B. |color|green, |color|blue).

---

Bilder

Bilder werden mit °>BILDPFAD<° eingebettet. Den Pfad erhältst du über KnuddelsServer.getFullImagePath():

var imgPath = KnuddelsServer.getFullImagePath('mein-bild.png');
bot.sendPublicMessage('°>' + imgPath + '<°');

MouseOver-Effekt

°>bild_normal.gif|bild_hover.gif<°

Bild als klickbare Schaltfläche

°>bild_normal.gif|bild_hover.gif<>|/mein-befehl<°

Tabellen

°>{table}BREITE<°
  °>{tr}<°
    °>{tc}BREITE<°Zelle 1
    °>{tc}BREITE<°Zelle 2
  °>{tr}<°
    °>{tc}BREITE<°Zelle 3
    °>{tc}BREITE<°Zelle 4

---

Tipps & Troubleshooting

• KCode funktioniert in allen Nachrichtentypen: öffentlich, privat und Post-Nachrichten
• Encoding: Dateien müssen als UTF-8 ohne BOM gespeichert sein, sonst werden Sonderzeichen (ä, ö, ü) falsch dargestellt
• Client-Kompatibilität: Nicht alle KCode-Features funktionieren in allen Clients. Teste immer in PC-App, Web-Client und mobilen Apps
• Verschachtelte Formatierungen sind möglich, aber halte es einfach

---

← Zurück zur Übersicht