Tebex komplett einrichten: Der vollständige Guide für FiveM-Serverbetreiber

Tebex: Mehr als ein Zahlungsanbieter

Tebex — früher bekannt als Buycraft — ist die Standard-Monetarisierungsplattform für FiveM-Server. Die Plattform ist direkt in FiveM integriert, verarbeitet Zahlungen über alle gängigen Methoden und kann nach einem Kauf automatisch Befehle auf deinem Gameserver ausführen. Das macht es zur idealen Lösung für Server-VIP, In-Game-Währung, Fahrzeuge und andere Vorteile.

Aber Tebex ist mehr als ein Shop. Richtig eingerichtet, ist es ein vollständiges Ökosystem: Analytics, Coupon-Systeme, Subscription-Management, Discord-Integration und — für fortgeschrittene Setups — eine Headless API für vollständig custom Webstores.

Dieser Guide führt dich Schritt für Schritt durch den kompletten Setup-Prozess.

Account-Erstellung und Store-Konfiguration

Tebex bietet verschiedene Pläne an. Der kostenlose Plan reicht für den Start, aber die kostenpflichtigen Pläne bieten wichtige Features wie Subscription-Management, erweiterte Analytics und niedrigere Transaktionsgebühren.

Schritt 1: Account und Store erstellen

1. Registriere dich auf creator.tebex.io
2. Erstelle einen neuen Webstore und wähle FiveM als Spielplattform
3. Gib deinen Store-Namen und die Basis-URL an
4. Vervollständige die Account-Verifikation (wichtig für Auszahlungen)

Schritt 2: FiveM-Server verbinden

Die Verbindung zwischen Tebex und deinem Server erfolgt über einen geheimen API-Key:

1. Gehe im Tebex-Dashboard zu Settings → Webstore → Game Server
2. Kopiere deinen Secret Key
3. Installiere die tebex-fivem Ressource auf deinem Server (aus dem CFX-Repository)
4. Trage den Key in deine server.cfg ein:

# server.cfg
set sv_tebexSecret "DEIN_GEHEIMER_KEY_HIER"

5. Starte deinen Server neu — Tebex sollte jetzt "Server verbunden" anzeigen

Behandle deinen Secret Key wie ein Passwort. Commit ihn niemals in Git-Repositories und teile ihn nicht öffentlich. Mit diesem Key kann jeder Befehle auf deinem Server ausführen.

Schritt 3: Auszahlungskonto einrichten

Bevor du Zahlungen empfangen kannst, musst du ein Auszahlungskonto einrichten. Tebex zahlt entweder per Überweisung oder PayPal aus. Die Verifizierung kann 2-5 Werktage dauern — mach das früh, nicht erst wenn du bereits Verkäufe hast.

Kategorien und Pakete strategisch strukturieren

Die Struktur deines Stores beeinflusst direkt die Conversion-Rate. Spieler kaufen eher wenn sie schnell verstehen was angeboten wird und wie viel es kostet.

Kategorien-Strategie

Empfohlene Kategorien für einen typischen RP-Server:

• VIP / Mitgliedschaft: Monatliche Subscriptions mit server-weiten Vorteilen. Das ist oft der größte Umsatztreiber.
• Starter-Pakete: Einmalige Käufe für neue Spieler. Startkapital, Grundausstattung, schnellerer Einstieg.
• Fahrzeuge: Permanente Custom-Vehicles die nur durch Kauf erhältlich sind.
• Charakter: Kleidung, Tattoos, Custom-Nummernchilder, Charakter-Slots.
• Server-Unterstützung: Freiwillige Spenden ohne In-Game-Vorteile (für Community-fokussierte Server).

Vermeide mehr als 5-6 Hauptkategorien. Ein überfüllter Store verwirrt Käufer.

Pakete korrekt konfigurieren

Jedes Paket in Tebex führt nach dem Kauf automatisch Befehle auf deinem Server aus. Die Befehle werden im "Commands"-Tab des Pakets eingetragen:

-- Beispiel-Befehle für ein VIP-Paket (im Tebex-Backend eingetragen)
-- {username} wird durch den Spieler-Identifier ersetzt

-- ESX-basierter Server:
add.vip {username} vip_gold 30
esx_addonaccount:addMoney {username} bank 100000

-- QBCore-basierter Server:
qbcore:addmoney {username} cash 50000
qbcore:additem {username} vip_card 1

Wichtige Befehls-Konfigurationsoptionen:

• Required: Spieler muss online sein wenn der Befehl ausgeführt wird
• Delay: Warte X Sekunden nach Zahlung vor Ausführung (Betrugs-Schutz)
• Repeat: Für Subscriptions — führe Befehl monatlich neu aus
• Expiry: Führe Ablauf-Befehl aus wenn Subscription endet

Teste jeden Befehl manuell in der Server-Konsole bevor du ein Paket live schaltest. Ein nicht funktionierender Kauf-Befehl führt zu Support-Tickets und Chargebacks.

Subscriptions: Wiederkehrende Einnahmen aufbauen

Subscriptions sind für die meisten Server der stabilste Einnahme-Kanal. Einmalige Käufe schwanken stark, monatliche Subscriptions geben dir planbare Einnahmen für Server-Kosten.

Tebex-Subscriptions erfordern den Professional-Plan oder höher. So richtest du sie ein:

1. Erstelle ein Paket und wähle unter "Type" → Subscription
2. Wähle den Abrechnungszeitraum (monatlich empfohlen)
3. Konfiguriere Initial-Befehl (beim Start der Subscription) und Renewal-Befehl (bei monatlicher Verlängerung)
4. Optional: Expiry-Befehl wenn die Subscription endet (z.B. VIP-Rechte entfernen)

-- Initial Command (beim Abonnieren):
addVip {username} gold_vip

-- Renewal Command (bei Verlängerung, falls unterschiedlich):
renewVip {username} gold_vip

-- Expiry Command (beim Ablauf):
removeVip {username} gold_vip

Coupon-Strategie: Mehr als Rabatte

Gutschein-Codes sind ein unterschätztes Marketing-Tool. Richtig eingesetzt können sie Wachstum beschleunigen, Spieler zurückgewinnen und Community-Events aufwerten.

Typen von Coupons und ihre Anwendungsfälle

• Launch-Coupons: Einmalig nutzbarer 30-50% Rabattcode der beim Server-Start kommuniziert wird. Erzeugt ersten Cashflow und zeigt Early-Adoptern Wertschätzung.
• Streamer-Codes: Individuelle Codes pro Content Creator ("STREAMER-XYZ"). Ermöglicht dir zu tracken welcher Creator die meisten Käufe generiert.
• Event-Codes: Zeitlich begrenzte Codes für Server-Events. "SILVESTER2025" für 24 Stunden mit 20% Rabatt während eines Silvester-Events.
• Wiederkehr-Codes: Für Spieler die länger inaktiv waren. Personalisierte Nachricht + Code per Discord-DM kann Spieler reaktivieren.
• Freunde-werben-Codes: Spieler teilen ihren persönlichen Code, und wenn jemand darüber kauft, bekommt der Werber einen Bonus. Erfordert Custom-Implementierung.

Coupons in Tebex erstellen

1. Dashboard → Coupons → Create Coupon
2. Code festlegen (oder auto-generieren)
3. Rabatttyp: Prozentsatz oder fixer Euro-Betrag
4. Nutzungslimit: Pro-User-Limit (verhindert Mehrfachnutzung), Gesamt-Limit
5. Gültigkeitsdauer: Start- und Enddatum setzen
6. Kategorie-Einschränkung: Optional auf bestimmte Kategorien begrenzen

Discord-Webhook-Integration

Öffentliche Kaufbenachrichtigungen in Discord sind ein starkes Social-Proof-Signal. Spieler sehen dass andere kaufen — das senkt die Hemmschwelle.

// Discord-Webhook-URL generieren:
// Dein Discord-Server → Kanal-Einstellungen → Integrationen → Webhooks → Neuer Webhook

// Tebex-Dashboard: Settings → Integrations → Discord
// Füge die Webhook-URL ein und konfiguriere das Nachrichten-Format

// Beispiel Webhook-Nachricht (Tebex sendet POST-Request):
{
  "username": "FusionDev Store",
  "avatar_url": "https://dein-logo.png",
  "content": "🎉 **{player}** hat **{package}** erworben! Danke für die Unterstützung!",
  "embeds": [{
    "color": 3066993,
    "fields": [
      { "name": "Paket", "value": "{package}", "inline": true },
      { "name": "Betrag", "value": "€{price}", "inline": true }
    ]
  }]
}

Die Headless API: Für custom Webstore-Frontends

Tebex bietet eine vollständige Headless API an, die es ermöglicht, einen komplett eigenen Webstore zu bauen — mit eigenem Design, eigener Domain, eigener UX. Unser Store hier ist ein Beispiel dafür.

Die API erlaubt:

• Alle Pakete und Kategorien abrufen
• Warenkörbe erstellen und Pakete hinzufügen
• Checkout-Links generieren (Weiterleitung zu Tebex-Checkout)
• Coupons und Gutscheine anwenden
• Spieler-Lookup für Username-Verknüpfung

// Pakete über API abrufen (Next.js API Route Beispiel)
const response = await fetch(
  'https://headless.tebex.io/api/webstores/{YOUR_WEBSTORE_ID}/packages',
  {
    headers: {
      'Content-Type': 'application/json',
    }
  }
);
const data = await response.json();

// Warenkorb erstellen
const basketResponse = await fetch(
  'https://headless.tebex.io/api/baskets',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Tebex-Secret': process.env.TEBEX_SECRET_KEY,
    },
    body: JSON.stringify({
      complete_url: 'https://meinserver.de/checkout/complete',
      cancel_url: 'https://meinserver.de/checkout/cancel',
      custom: {
        username: spielerUsername
      }
    })
  }
);
const basket = await basketResponse.json();

// Paket zum Warenkorb hinzufügen
await fetch(
  `https://headless.tebex.io/api/baskets/${basket.data.ident}/packages`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      package_id: paketId,
      quantity: 1
    })
  }
);

Rechtliche Anforderungen: Was du beachten musst

Das wird gerne vergessen — mit fatalen Konsequenzen. Als Betreiber eines europäischen Webstores hast du gesetzliche Pflichten:

Impressumspflicht (Deutschland)

Wenn du in Deutschland Waren oder Dienstleistungen verkaufst (auch digital), ist ein Impressum mit vollständiger Anschrift, Kontaktdaten und bei bestimmten Umsätzen einer USt-IdNr. Pflicht. Tebex selbst kann dir ein Basis-Impressum nicht ersetzen — du bist der Betreiber.

Datenschutz (DSGVO)

Tebex verarbeitet personenbezogene Daten deiner Käufer. Du musst in deiner Datenschutzerklärung erwähnen:

• Welche Daten gesammelt werden (Name, E-Mail, Zahlungsdaten über Tebex)
• Wer die Daten verarbeitet (Tebex als Auftragsverarbeiter)
• Wie lange Daten gespeichert werden
• Rechte der Betroffenen (Auskunft, Löschung, Berichtigung)

Rockstar-Monetarisierungsrichtlinien

Rockstar Games hat spezifische Regeln was FiveM-Server monetarisieren dürfen. Zusammengefasst:

• Erlaubt: Kosmetische Items, Rang-Vorteile, Startkapital (in vernünftigem Rahmen), VIP-Labels
• Nicht erlaubt: Pay-to-Win-Mechaniken die das Spielerlebnis unfair verschieben, Verkauf von in-game Items die direkte Spielvorteile gegenüber zahlenden Spielern geben
• Graubereich: Viele übliche Praktiken liegen in einem nicht klar definierten Graubereich — halte dich auf der sicheren Seite

Häufige Fehler — und wie du sie vermeidest

Fehler 1: Befehle nicht getestet

Der klassische erste Fehler. Du konfigurierst ein Paket, jemand kauft es, der Befehl schlägt fehl weil ein Syntaxfehler vorliegt oder die Ressource nicht geladen ist. Teste jeden Befehl manuell in der Server-Konsole: add.vip testplayer vip_gold 30. Wenn es dort funktioniert, funktioniert es auch via Tebex.

Fehler 2: Keine Testphase

Schalte deinen Store niemals ohne Testphase live. Tebex bietet Test-Transaktionen an. Kaufe jedes Paket einmal testweise durch, prüfe ob alle Befehle korrekt ausgeführt wurden und ob die Bestätigungs-E-Mails korrekt aussehen.

Fehler 3: Unklare Paketbeschreibungen

"VIP Gold" als Paketname mit keiner weiteren Beschreibung. Was ist enthalten? Wie lange gilt es? Auf welchem Server? Fehlende Informationen führen zu Kaufreue und Chargebacks. Beschreibe exakt was ein Käufer bekommt.

Fehler 4: Zu viele Pakete ohne Struktur

40 unstrukturierte Pakete auf einer Seite überfordern Käufer. Weniger ist mehr — starte mit 8-12 Paketen in 3-4 Kategorien und erweitere basierend auf echtem Spieler-Feedback.

Fehler 5: Fehlendes Chargeback-Management

Chargebacks (Rückbuchungen) sind die größte Gefahr für Tebex-Stores. Klare Beschreibungen reduzieren sie. Aber wenn sie kommen: Reagiere schnell, dokumentiere alles (Kauf-Log, erbrachte Leistung) und antworte über den Tebex-Dispute-Prozess.

Analytics nutzen: Daten-basiert optimieren

Tebex bietet eingebaute Analytics. Nutze sie aktiv:

• Conversion Rate: Welche Pakete werden angeschaut aber nicht gekauft? Das sind Optimierungs-Kandidaten.
• Top-Seller: Deine beliebtesten Pakete verdienen prominenten Platz im Store.
• Zeitliche Trends: Wann kaufen Spieler? Nach Events? Am Wochenende? Plane Promotionen entsprechend.
• Coupon-Performance: Welche Codes führen zu tatsächlichen Käufen? Welche werden nie eingelöst?

Fazit: Ein Store ist eine Investition in deinen Server

Ein professionell konfigurierter Tebex-Store macht deinen Server ernster. Er zeigt Spielern dass du in den Server investierst, dass du planst langfristig zu betreiben und dass du die Unterstützung der Community ernst nimmst. Ein guter Store läuft im Hintergrund und generiert kontinuierlich Einnahmen die du in bessere Scripts, bessere Hardware und eine bessere Community investieren kannst. Starte sauber, teste gründlich und baue von dort aus weiter.