Wie du Claude AI mit Roblox Studio verbindest – Schritt-für-Schritt-Anleitung

Melden

Die Integration von Claude AI in Roblox Studio ermöglicht es dir, intelligente NPCs, dynamische Storylines oder interaktive Chatbots zu erstellen. In diesem Tutorial erfährst du, wie du mithilfe von Luau und dem HttpService Anfragen an die Anthropic-API (Claude) sendest und die Antworten im Spiel nutzt.


Voraussetzungen

  1. Ein verifizierter Account bei Anthropic (um Zugriff auf die API zu erhalten).
  2. Ein Roblox-Konto und installiertes Roblox Studio.
  3. Grundlegende Kenntnisse in Luau-Scripting.

Schritt 1: API-Schlüssel bei Anthropic erstellen

Um Claude anzusprechen, benötigst du einen persönlichen API-Schlüssel:

  1. Gehe auf die offizielle Entwickler-Konsole von Anthropic (console.anthropic.com).
  2. Navigiere zu den API Keys und klicke auf Create Key.
  3. Gib dem Schlüssel einen Namen (z. B. „RobloxIntegration“) und kopiere den generierten Code.
  4. Wichtig: Speichere den Schlüssel an einem sicheren Ort. Du kannst ihn später nicht noch einmal ansehen.

Schritt 2: HTTP-Anfragen in Roblox Studio aktivieren

Standardmäßig blockiert Roblox ausgehende Internetanfragen aus Sicherheitsgründen. Du musst den Zugriff zuerst erlauben:

  1. Öffne dein Spiel in Roblox Studio.
  2. Klicke im Menüband (oben) auf Home und dann auf Game Settings. (Hinweis: Falls dein Spiel noch nicht veröffentlicht ist, musst du es zuerst auf Roblox speichern).
  3. Gehe im Menü links auf Security.
  4. Aktiviere den Schalter bei Allow HTTP Requests.
  5. Klicke auf Save.

Schritt 3: Das Skript erstellen

Verbinde dich jetzt über ein Server-Skript mit der API. Wichtig: Verwende dafür immer ein normales Script (Server-seitig), niemals ein LocalScript, da Spieler sonst deinen API-Key auslesen könnten.

  1. Gehe im Explorer-Fenster zu ServerScriptService.
  2. Klicke auf das Plus-Symbol (+) und wähle Script.
  3. Benenne das Skript z. B. in ClaudeService um.
  4. Ersetze den Inhalt durch folgenden Code:
local HttpService = game:GetService("HttpService")

-- KONFIGURATION
local API_KEY = "DEIN_API_SCHLÜSSEL_HIER_EINTRAGEN"
local API_URL = "https://api.anthropic.com/v1/messages"

-- Funktion, um eine Nachricht an Claude zu senden
local function askClaude(promptText)
    -- Die von Anthropic benötigten Header
    local headers = {
        ["Content-Type"] = "application/json",
        ["x-api-key"] = API_KEY,
        ["anthropic-version"] = "2023-06-01" -- Erforderliche API-Version
    }

    -- Der Inhalt der Anfrage (Payload)
    local payload = {
        model = "claude-3-haiku-20240307", -- Schnell und kostengünstig für Spiele
        max_tokens = 250, -- Maximale Länge der Antwort
        messages = {
            {
                role = "user",
                content = promptText
            }
        }
    }

    -- Umwandlung der Lua-Tabelle in JSON
    local jsonBody = HttpService:JSONEncode(payload)

    -- Senden der HTTP-POST-Anfrage (abgesichert via pcall)
    local success, response = pcall(function()
        return HttpService:RequestAsync({
            Url = API_URL,
            Method = "POST",
            Headers = headers,
            Body = jsonBody
        })
    end)

    -- Auswertung der Antwort
    if success then
        if response.Success then
            local data = HttpService:JSONDecode(response.Body)
            -- Die generierte Textantwort extrahieren
            local aiResponse = data.content[1].text
            return aiResponse
        else
            warn("API-Fehler (" .. response.StatusCode .. "): " .. response.StatusMessage)
            warn("Details: " .. response.Body)
            return nil
        end
    else
        warn("Netzwerkfehler: HTTP-Anfrage fehlgeschlagen.")
        return nil
    end
end

-- TESTAUFRUF:
task.wait(2) -- Kurze Pause beim Spielstart
local testPrompt = "Du bist ein weiser Zauberer in einem Roblox-Spiel. Begrüße einen neuen Abenteurer mit einem kurzen Satz!"
print("Sende Anfrage an Claude...")

local antwort = askClaude(testPrompt)

if antwort then
    print("-----------------------------------")
    print("Claude antwortet: " .. antwort)
    print("-----------------------------------")
else
    print("Keine Antwort erhalten.")
end

Schritt 4: Testen

  1. Öffne das Output-Fenster in Roblox Studio (View -> Output).
  2. Klicke auf Play (Testen).
  3. Nach etwa 2–3 Sekunden sollte im Output-Fenster die Antwort von Claude erscheinen.

Wichtige Hinweise für den produktiven Einsatz

  • Roblox Textfilter: Wenn der von Claude generierte Text für andere Spieler im Chat oder auf UI-Elementen sichtbar gemacht wird, bist du laut Roblox-Regeln verpflichtet, ihn durch das interne Textfiltersystem von Roblox (TextService:FilterStringAsync) laufen zu lassen.
  • Rate Limits & Kosten: Jede Anfrage verbraucht API-Tokens. Begrenze Anfragen (z. B. durch Cooldowns/Debounce), damit Spieler die API nicht spammen.
  • Sicherheit: Für größere Live-Spiele empfiehlt es sich, einen eigenen Zwischenserver (Proxy z. B. auf Node.js/Python) zu nutzen, anstatt den API-Key direkt im Roblox-Server zu hinterlegen.
0