Erstellung eines Discord-Bots in .NET Core mit Deployment auf einem VPS-Server

Hallo, Habr-Bewohner!

Heute werden Sie mit einem Artikel vertraut gemacht, in dem erklärt wird, wie man einen Bot mit C# auf .NET Core erstellt und wie man ihn auf einem entfernten Server einrichtet.

Der Artikel wird aus einer Vorgeschichte, einem Vorbereitungsabschnitt, der Logikprogrammierung und dem Transfer des Bots auf den entfernten Server bestehen.

Ich hoffe, dieser Artikel hilft vielen Anfängern.

Vorgeschichte

Alles begann an einer schlaflosen Herbstnacht, die ich auf dem Discord-Server verbrachte. Da ich relativ neu dabei war, begann ich, ihn gründlich zu erkunden. Als ich den Textkanal „Stellenangebote“ entdeckte, wurde ich neugierig, öffnete ihn und fand unter den uninteressanten Angeboten dieses:

„Programmierer (Bot-Entwickler)
Anforderungen:

• Kenntnisse in Programmiersprachen;
• Fähigkeit zum autodidaktischen Lernen.

Wünsche:

• Fähigkeit, sich in fremden Code hineinzudenken;
• Kenntnisse über die Funktionalität von DISCORD.

Aufgaben:

• Entwicklung des Bots;
• Unterstützung und Wartung des Bots.

Ihr Vorteil:

• Die Möglichkeit, ein interessantes Projekt zu unterstützen und zu beeinflussen;
• Erwerb von Teamerfahrung;
• Die Möglichkeit, vorhandene Fähigkeiten zu demonstrieren und zu verbessern.“

Das hat sofort mein Interesse geweckt. Ja, für diese Arbeit wurde nicht bezahlt, aber es wurden keine Verpflichtungen von mir gefordert, und es wird nicht schaden, es im Portfolio zu haben. Also schrieb ich dem Admin des Servers, und er bat mich, einen Bot zu erstellen, der die Statistiken eines Spielers in World of Tanks anzeigt.

Vorbereitungsphase

Discord
Bevor wir mit dem Schreiben unseres Bots beginnen können, müssen wir ihn für Discord erstellen. Sie müssen:

1. In Ihr Discord-Konto einloggen unter diesem Link
2. Im Tab „Anwendungen“ auf die Schaltfläche „Neue Anwendung“ klicken und den Bot benennen
3. Das Bot-Token erhalten, indem Sie sich in Ihren Bot einloggen und den Tab „Bot“ in der Liste „Einstellungen“ finden
4. Das Token irgendwo speichern

Wargaming

Außerdem müssen Sie eine Anwendung bei Wargaming erstellen, um Zugang zur Wargaming API zu erhalten. Auch hier ist alles einfach:

1. Loggen Sie sich in Ihr Wargaming-Konto ein über diesen Link
2. Gehen Sie zu „Meine Anwendungen“ und klicken Sie auf die Schaltfläche „Neue Anwendung hinzufügen“, benennen Sie die Anwendung und wählen Sie den Typ aus
3. Speichern Sie die Anwendungs-ID

Software

Hier gibt es bereits Freiheit der Wahl. Einige verwenden Visual Studio, andere Rider, manche nutzen sogar leistungsstarke Anwendungen und schreiben Code in Vim (wahre Programmierer benutzen schließlich nur die Tastatur, oder?). Um jedoch die Discord API nicht selbst zu implementieren, kann man die inoffizielle Bibliothek für C# "DSharpPlus" verwenden. Diese kann entweder aus NuGet installiert oder selbst aus dem Repository kompiliert werden.

Für diejenigen, die nicht wissen oder vergessen haben, wie man Anwendungen aus NuGet installiert.Anleitung für Visual Studio

1. Wir gehen zum Reiter Projekt – NuGet-Pakete verwalten;
2. Wir klicken auf Durchsuchen und geben im Suchfeld "DSharpPlus" ein;
3. Wir wählen aus und installieren das Framework;
4. PROFIT!

Der Vorbereitungsschritt ist abgeschlossen, wir können mit dem Schreiben des Bots fortfahren.

Schreiben der Logik

Wir werden die gesamte Logik der Anwendung nicht betrachten, ich zeige lediglich, wie man mit dem Abfangen von Nachrichten durch den Bot arbeitet und wie man mit der Wargaming API umgeht.

Die Arbeit mit dem Discord-Bot erfolgt über die Funktion static async Task MainTask(string[] args);
Um diese Funktion aufzurufen, muss in Main geschrieben werden

MainTask(args).ConfigureAwait(false).GetAwaiter().GetResult();

Als nächstes müssen Sie Ihren Bot initialisieren:

discord = new DiscordClient(new DiscordConfiguration
{
    Token = token,
    TokenType = TokenType.Bot,
    UseInternalLogHandler = true,
    LogLevel = LogLevel.Debug
});

Wo token der Token Ihres Bots ist.
Dann schreiben wir über eine Lambda die erforderlichen Befehle, die der Bot ausführen soll:

discord.MessageCreated += async e =>
{
    string message = e.Message.Content;
    if (message.StartsWith("&"))
    {
        await e.Message.RespondAsync("Hallo, " + e.Author.Username);
    }
};

Wo e.Author.Username – der Benutzername des Nutzers abgerufen wird.

So wird Ihr Bot Sie begrüßen, wenn Sie eine Nachricht senden, die mit & beginnt.

Am Ende dieser Funktion muss await discord.ConnectAsync(); und await Task.Delay(-1); geschrieben werden;

Dies ermöglicht die Ausführung von Befehlen im Hintergrund, ohne den Hauptthread zu blockieren.

Jetzt müssen wir uns mit der Wargaming API befassen. Hier ist alles einfach – Sie schreiben CURL-Anfragen, erhalten eine Antwort in Form einer JSON-Zeichenkette, extrahieren die benötigten Daten und führen Manipulationen damit durch.

Beispielarbeit mit WargamingAPI

public Player FindPlayer(string searchNickname)
        {
            //https://api.worldoftanks.ru/wot/account/list/?application_id=y0ur_a@@_id_h3r3search=nickname
            urlRequest = resourceMan.GetString("url_find_player") + appID + "&search=" + searchNickname;
            Player player = null;
            string resultResponse = GetResponse(urlRequest);
            dynamic parsed = JsonConvert.DeserializeObject(resultResponse);

            string status = parsed.status;
            if (status == "ok")
            {
                int count = parsed.meta.count;
                if (count > 0)
                {
                    player = new Player
                    {
                        Nickname = parsed.data[0].nickname,
                        Id = parsed.data[0].account_id
                    };
                }
                else
                {
                    throw new PlayerNotFound("Spieler nicht gefunden");
                }
            }
            else
            {
                string error = parsed.error.message;
                if (error == "NOT_ENOUGH_SEARCH_LENGTH")
                {
                    throw new PlayerNotFound("Mindestens drei Zeichen erforderlich");
                }
                else if (error == "INVALID_SEARCH")
                {
                    throw new PlayerNotFound("Ungültige Suche");
                }
                else if (error == "SEARCH_NOT_SPECIFIED")
                {
                    throw new PlayerNotFound("Leerer Nickname");
                }
                else
                {
                    throw new Exception("Etwas ist schiefgegangen.");
                }
            }

            return player;
        }

Achtung! Es wird dringend davon abgeraten, alle Tokens und App-IDs im Klartext zu speichern! Mindestens – Discord sperrt solche Tokens, wenn sie im weltweiten Netz erscheinen, schlimmstenfalls – könnte der Bot von Angreifern missbraucht werden.

Deployment auf VPS – Server

Sobald Sie mit dem Bot fertig sind, muss er auf einem Server gehostet werden, der rund um die Uhr, 24/7, läuft. Dies hängt damit zusammen, dass der Bot nur dann aktiv ist, wenn Ihre Anwendung läuft. Wenn Sie die Anwendung schließen, schläft auch Ihr Bot.

Es gibt viele VPS-Server auf dieser Welt, sowohl unter Windows als auch unter Linux, jedoch ist der Betrieb auf Linux in den meisten Fällen deutlich günstiger.

Auf dem Discord-Server wurde mir vscale.io empfohlen, und ich habe dort sofort einen virtuellen Server mit Ubuntu erstellt und den Bot hochgeladen. Ich werde nicht erklären, wie diese Seite funktioniert, sondern direkt mit den Bot-Einstellungen fortfahren.

Zuerst müssen Sie die notwendige Software installieren, die unseren Bot, geschrieben in .NET Core, ausführt. Wie das geht, ist hier beschrieben..

Als Nächstes müssen Sie den Bot auf einen Git-Dienst wie GitHub hochladen und auf dem VPS-Server klonen oder auf anderem Wege herunterladen. Beachten Sie, dass Sie nur eine Konsole haben werden, GUI gibt es nicht. Überhaupt.

Nachdem Sie Ihren Bot heruntergeladen haben, müssen Sie ihn starten. Dazu müssen Sie:

• Alle Abhängigkeiten wiederherstellen: dotnet restore
• Die Anwendung erstellen: dotnet build name_project.sln -c Release
• Zum erstellten DLL wechseln;
• dotnet name_of_file.dll

Herzlichen Glückwunsch! Ihr Bot läuft. Allerdings benötigt der Bot leider die Konsole, und es ist nicht so einfach, aus dem VPS-Server auszusteigen. Außerdem müssen Sie den Bot im Falle eines Serverneustarts erneut starten. Es gibt ein paar Lösungsansätze. Alle hängen mit dem Start beim Serverstart zusammen:

• Fügen Sie den Skriptstart zu /etc/init.d hinzu
• Erstellen Sie einen Dienst, der beim Start gestartet wird.

Ich sehe keinen Sinn darin, ausführlich darauf einzugehen, da im Internet alles ausreichend detailliert beschrieben ist.

Das DBMS Tarantool ist ein attraktives, zukunftsträchtiges Produkt zur Erstellung von hochbelasteten Anwendungen.

Ich freue mich, dass ich mich dieser Aufgabe angenommen habe. Es war meine erste Erfahrung bei der Entwicklung eines Bots, und ich bin froh, neue Kenntnisse in C# und der Arbeit mit Linux gewonnen zu haben.

Link zum Discord-Server. Für diejenigen, die Wargaming-Spiele spielen.
Link zum Repository, in dem der Discord-Bot liegt.
Link zum DSharpPlus-Repository.
Vielen Dank für Ihre Aufmerksamkeit!

Quelle: habr.com