GameSeek — Coding

Kapitel 01

Bots coden

Jeder Account kann bis zu 5 Bots erstellen. Token holst du im Bot Portal — danach läuft alles über die Python-Library gameseek.

Bot anlegen

Öffne das Bot Portal, erstelle einen Bot und kopiere den Token (gsbot_…).

Library installieren

Einmalig per pip vom GameSeek-Server.

Code schreiben

bot.py lokal oder im Portal — dann bot.run().

pip install

pip install https://gameseekapp.xyz/bot/gameseek-pkg.zip

Minimal-Beispiel

import os
from gameseek import Bot

TOKEN = os.environ.get("GAMESEEK_BOT_TOKEN", "gsbot_DEIN_TOKEN")
bot = Bot(TOKEN, command_prefix=("!", "/"), api_base="https://gameseekapp.xyz")

@bot.event
async def on_ready():
    print(f"Bereit als {bot.user}")

@bot.command()
async def ping(ctx):
    await ctx.send("Pong!")

if __name__ == "__main__":
    bot.run()

Auth

Header: Authorization: Bot gsbot_…

Events

GET /api/bot/events — Poll ca. jede Sekunde

Senden

POST /api/bot/messages — Text, Embeds, Buttons

Invite

Code GSBOT-XXXXXXXX im Chat posten (Owner/Admin)

Tipp: Mit Server-Hosting bleibt der Bot online ohne lokales Script. Eigene Commands brauchen dann trotzdem ein laufendes bot.py.

Kapitel 02

Webhooks coden

Webhooks posten Nachrichten in einen Textkanal — Discord-Style. Die Webhook-ID in der URL ist das Geheimnis. Kein Extra-Token nötig.

Webhook erstellen

In der App unter Kanal-Einstellungen → Webhooks anlegen (nur Server-Owner).

URL nutzen

https://gameseekapp.xyz/api/webhook/<WEBHOOK_ID>

Regel

Wichtig: Nur embeds im Body. content, username und avatar_url werden abgelehnt.

Beispiel

import requests

payload = {
    "embeds": [{
        "title": "Server Status",
        "description": "Alles läuft.",
        "color": 0x38BDF8,
        "fields": [
            {"name": "Region", "value": "EU", "inline": True},
            {"name": "Status", "value": "OK", "inline": True},
        ],
        "footer": {"text": "GameSeek Webhook"},
    }]
}

requests.post(
    "https://gameseekapp.xyz/api/webhook/DEINE_WEBHOOK_ID",
    json=payload,
    headers={"Content-Type": "application/json"},
)

01

Embeds

Max. 10 Embeds pro Request

02

Fields

Max. 25 Fields pro Embed

03

Kanal

Nur Textkanäle

04

Sicherheit

URL nie öffentlich teilen

Kapitel 03

Was wichtig ist

Kurz die Regeln, die dich vor Cap, Offline-Bugs und geleakten Secrets bewahren.

01

Secrets

Bot-Token und Webhook-URL wie Passwörter behandeln. Nie in Git committen.

02

Bot vs Webhook

Bots reagieren auf Events & Commands. Webhooks sind One-Way Embed-Posts.

03

Limits

Max. 5 Bots / Account. Content bis 2000 Zeichen. Buttons max. 5.

04

Invite

Invite-Code allein in einer Chat-Nachricht — nur Owner/Administrator.

Finale

Zum Bot Portal

Blöcke zusammenklicken, Code speichern oder als bot.py downloaden — und direkt live gehen.

Bot Portal öffnen

Login mit deinem GameSeek-Account. Max. 5 Bots.