Server-Branding — Detail-Guide
Server-Branding — Detail-Guide
Pro / Beta / Lifetime — leichtgewichtige Whitelabel-Alternative ohne eigenen Bot-Token
Was passiert technisch?
Discord erlaubt Bots, ihr Profil pro Server zu überschreiben über den Endpoint:
PATCH /guilds/{guild.id}/members/@me
{ "nick": "...", "avatar": "data:image/png;base64,...", "banner": "..." }
Der Bot bleibt derselbe (selbe Application-ID, selber Token), aber auf diesem einen Server sieht er anders aus.
Wann statt Whitelabel?
| Eigenschaft | Server-Branding | Whitelabel |
|---|---|---|
| Eigener Bot-User | ❌ Quantix bleibt | ✅ Eigener Bot |
| Eigener Token nötig | ❌ Nein | ✅ Ja |
| Quantix muss kicken | ❌ Nein | ✅ Ja |
| Setup-Zeit | ~30 Sek | ~5 Min |
| Pro-Tier | ✅ | ✅ |
Beide gleichzeitig sind möglich — pro Server entscheidest du.
Konfiguration
Felder
Nickname (max. 32 Zeichen)
- Display-Name des Bots auf diesem Server
- Discord-Member-Liste zeigt diesen Namen
- @-Mention nutzt weiterhin den globalen Bot-Namen
Avatar-URL (PNG / JPG / GIF, ≤ 8 MB)
- Profilbild speziell für diesen Server
- Discord lädt das Bild beim Anwenden, nicht beim Speichern
- URL muss öffentlich erreichbar sein
Anwenden vs Speichern
Zwei Schritte:
- Auto-Save speichert deine Eingaben in der DB (alle paar Sekunden)
- "Anwenden"-Button sendet die Daten an Discord — erst dann ändert sich das Profil
Falls die Bilder zu groß sind oder URLs ungültig: Discord-Fehler erscheint im Panel mit Details.
Zurücksetzen
"Zurücksetzen"-Button entfernt das Server-Override:
PATCH /guilds/{guild.id}/members/@me
{ "nick": null, "avatar": null, "banner": null }
Bot fällt aufs globale Quantix-Profil zurück. Praktisch wenn du:
- Whitelabel umstellen willst
- Branding testest und schnell zurück willst
- Premium läuft ab (passiert automatisch)
Premium-Auto-Cleanup
- Branding-Config wird eingefroren (Bot zeigt letztes Profil weiter)
- Nach Premium-Ende kannst du es nicht mehr ändern, nur zurücksetzen
- Renewal aktiviert es automatisch wieder
Häufige Fehler
"Image larger than 8 MB"
- Bild zu groß. Komprimiere lokal (TinyPNG, Squoosh)
"Image must be png, jpg, gif, or webp"
- Falsches Format. Konvertiere zu PNG/JPG
"Image fetch failed (404)"
- URL nicht erreichbar — meistens Authentifizierung nötig
- Discord-CDN-URLs (cdn.discordapp.com) funktionieren oft nicht (Auth-required)
- Empfehlung: eigenes CDN nutzen (imgur.com, cloudinary, eigene Domain)
"Pro tier required"