Zum Hauptinhalt springen

Einführung

Um auf Square Cloud zu entwickeln und zu hosten, ist es wichtig, einer strukturierten Abfolge von Konfigurationen und Voraussetzungen zu folgen. Dieser technische Leitfaden deckt den gesamten Prozess ab, von der anfänglichen Einrichtung bis zum Produktions-Deployment.

Voraussetzungen

  • Square Cloud Konto: Registriere dich über die Registrierungsseite mit deiner E-Mail-Adresse.
  • Aktiver kostenpflichtiger Plan: Stellt dedizierte Ressourcen und optimierte Leistung für deine Anwendung sicher. Sieh dir unsere verfügbaren Pläne an und wähle den passendsten für deine Bedürfnisse.

Projekt erstellen

Um einen Discord-Bot zu erstellen, ist es grundlegend, ein Konto zu besitzen, um Bots auf der Plattform zu erstellen und zu verwalten. Falls du noch keins hast, besuche die offizielle Discord-Website, um dein Konto zu erstellen.

Bot-Anwendung auf Discord

Anwendung erstellen

Rufe das Developer Portal auf und klicke auf “New Application”. Lege einen Namen für deinen Bot fest und klicke auf “Create”, um die Anwendung zu erstellen.
Erstellen einer Discord-Anwendung im Developer Portal

Authentifizierungs-Token generieren

Navigiere nach dem Erstellen der Anwendung zum Tab “Bot” und klicke auf “Reset Token”, um den Authentifizierungs-Token zu generieren. Kopiere den generierten Token zur späteren Verwendung bei der Code-Implementierung.
Generieren des Authentifizierungs-Tokens für den Discord-Bot

Privileged Intents aktivieren

Nachdem der Token konfiguriert ist, aktiviere die notwendigen Intents. Bleibe im Tab “Bot”, scrolle nach unten und suche “Privileged Gateway Intents”. Aktiviere die Intents wie im Bild gezeigt:
Aktivieren der Privileged Gateway Intents von Discord
Kritische Sicherheit: Halte deinen Bot-Token absolut geheim. Dieser Token gewährt vollständige Kontrolle über den Bot und sollte als vertrauliche Information behandelt werden.

Projekt entwickeln

Jetzt, da wir den Bot-Token haben, können wir mit dem Programmieren beginnen. Du kannst dafür deine bevorzugte Sprache verwenden.
Node.js-Umgebung einrichten
  1. Stelle sicher, dass Node.js auf deinem System installiert ist. Falls nicht, lade es von der offiziellen Node.js-Website herunter.
  2. Initialisiere ein neues Node.js-Projekt:
Terminal
npm init -y
  1. Installiere die Discord.js-Bibliothek:
Terminal
npm install discord.js
  1. Erstelle eine JavaScript-Datei (z. B. index.js) und füge den folgenden Code hinzu, um einen grundlegenden Discord-Bot zu erstellen:
index.js
const { Client, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.on("ready", () => {
  console.log(`${client.user.tag}!`);
});

client.on("messageCreate", (message) => {
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

client.login("your token here");

Deploying

Nachdem du deine Projektdateien vorbereitet hast, kannst du sie nun zu Square Cloud hochladen und dein Projekt hosten. Erstelle dazu eine ZIP-Datei, die alle deine Projektdateien enthält.

Über das Dashboard

1

Upload-Seite aufrufen

Rufe die Upload-Seite auf und lade die ZIP-Datei deines Projekts hoch.
2

Umgebung konfigurieren

Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.
3

Projekt bereitstellen

Klicke abschließend auf die Schaltfläche “Deploy”, um dein Projekt auf Square Cloud zu hosten.
Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.
Anwendung wird auf Square Cloud hochgeladen

Über die CLI

Um diese Methode zu nutzen, musst du eine Konfigurationsdatei mit dem Namen squarecloud.app im Stammverzeichnis deines Projekts erstellen. Diese Datei enthält die notwendige Konfiguration für dein Projekt.

Mehr erfahren: So erstellst du die Konfigurationsdatei für Square Cloud.

Die Datei squarecloud.app ist eine Konfigurationsdatei, mit der deine Anwendung konfiguriert wird; sie dient dazu, deine Umgebung zu definieren.
1

CLI installieren

Zuerst musst du die CLI in deiner Umgebung installiert haben. Falls du sie noch nicht hast, führe den folgenden Befehl in deinem Terminal aus:
npm install -g @squarecloud/cli
Falls du sie bereits hast, empfehlen wir, sie zu aktualisieren. Führe dazu den folgenden Befehl in deinem Terminal aus:
squarecloud update
2

Authentifizieren

Um dich zu authentifizieren und weitere CLI-Befehle zu nutzen, findest du deinen Autorisierungsschlüssel hier, indem du auf “Request API Key” klickst. Nachdem du deinen Autorisierungsschlüssel erhalten hast, führe den folgenden Befehl aus:
squarecloud auth login
3

Projekt hochladen

Um deine Anwendung schließlich über die CLI auf Square Cloud bereitzustellen, musst du den folgenden Befehl ausführen:
squarecloud upload 
Oder falls du die ZIP-Datei manuell erstellt hast, kannst du Folgendes verwenden:
squarecloud upload --file <path/to/zip> 

Den Bot testen

Wenn du alle Schritte korrekt befolgt hast, besteht der nächste Schritt darin, deinen Bot zum Testen einzuladen. Gehe dazu wie folgt vor:
  1. Rufe das Developer Portal auf.
  2. Wähle deinen Bot aus.
  3. Navigiere zum Tab “OAuth2”.
  4. Gehe zu “OAuth2 URL Generator”.
  5. Aktiviere die Option “bot”.
  6. Wähle die Berechtigungen aus, die dein Bot beim Einladen über diese Einladung haben soll.
  7. Unterhalb der Berechtigungen wird ein Einladungslink für deinen Bot generiert. Er sollte etwa so aussehen:
https://discord.com/oauth2/authorize?client_id=00000000000000&permissions=8&scope=bot
Denke daran, dass die client_id in der URL durch die tatsächliche ID deines Bots ersetzt werden sollte. Der Wert von permissions muss möglicherweise ebenfalls an die Berechtigungen angepasst werden, die dein Bot haben soll. Um nun zu testen, ob alles funktioniert, führe den folgenden Befehl auf deinem Server aus: !hello.
Testen des Discord-Bots nach dem Deployment

Weitere Ressourcen

Weitere Informationen zum Erstellen von Bots mit discord.py und discord.js findest du in der offiziellen discord.py-Dokumentation und im offiziellen discord.js-Guide. Dort findest du detaillierte Anleitungen, Tutorials und API-Dokumentation, die dir helfen, das Beste aus diesen Bibliotheken herauszuholen.

Kontaktiere uns

Falls du weiterhin technische Schwierigkeiten hast, steht dir unser spezialisiertes Support-Team zur Verfügung. Kontaktiere uns und wir helfen dir gerne, jedes Problem zu lösen.