Skapa en Discord-bot med .NET Core och distribuera den på en VPS-server

Hej, Habr-anhängare!

Idag kommer du att bekanta dig med en artikel som förklarar hur man skapar en bot med C# på .NET Core och hur man får den att fungera på en fjärrserver.

Artikeln kommer att bestå av en bakgrund, förberedelser, skrivande av logik och överföring av boten till en fjärrserver.

Jag hoppas att denna artikel kommer att hjälpa många nybörjare.

Bakgrund

Allt började en sömnlös höstnatt som jag tillbringade på en Discord-server. Eftersom jag ganska nyligen anslöt mig till den, började jag utforska den grundligt. Jag upptäckte textkanalen "Jobbannonser" och blev intresserad, så jag öppnade den och hittade bland de erbjudanden som inte intresserade mig detta:

"Programmerare (botutvecklare)
Krav:

• kunskaper i programmeringsspråk;
• förmåga att lära sig själv.

Önskemål:

• förmåga att förstå andras kod;
• kunskap om DISCORD:s funktionalitet.

Uppgifter:

• utveckling av boten;
• underhåll och support av botens funktion.

Din fördel:

• Möjlighet att stödja och påverka ett intressant projekt;
• Erfarenhet av att arbeta i team;
• Möjlighet att visa och förbättra befintliga färdigheter."

Det här fascinerade mig omedelbart. Ja, för detta arbete betalades det inte, men inga förpliktelser krävdes av dig, och dessutom kommer det att vara en bra tillägg till portföljen. Så jag skrev till serveradministratören, och han bad mig att skriva en bot som skulle visa spelarens statistik i World of Tanks.

Förberedelsefasen

Discord
Innan vi påbörjar skrivandet av vår bot måste vi skapa en för Discord. Du behöver:

1. Logga in på Discord-kontot via länken
2. Klicka på knappen "New Application" i fliken "Applications" och namnge boten
3. Hämta botens token genom att logga in på din bot och hitta "Bot"-fliken under "Settings" i listan
4. Spara token någonstans

Wargaming

Dessutom behöver du skapa en applikation i Wargaming för att få tillgång till Wargamings API. Det är också enkelt:

1. Logga in på Wargaming-kontot via denna länk
2. Gå till "Mina applikationer" och klicka på knappen "Lägg till ny applikation", ge applikationen ett namn och välj dess typ
3. Spara applikationens ID

Programvara

Här finns det redan frihet att välja. Vissa använder Visual Studio, andra Rider, och vissa skriver kod i Vim (verkliga programmerare använder ju bara tangentbord, eller hur?). Men för att slippa implementera Discord API kan man använda det inofficiella biblioteket för C# "DSharpPlus". Det kan installeras antingen från NuGet eller genom att bygga källkoden från repositoryt själv.

För dem som inte vet, eller har glömt, hur man installerar applikationer från NuGet.Instruktion för Visual Studio

1. Vi går till fliken Projekt – Hantera NuGet-paket;
2. Klicka på Bläddra och skriv "DSharpPlus" i sökfältet;
3. Välj och installera ramverket;
4. VINST!

Förberedelsefasen är avslutad, nu kan vi börja skriva boten.

Skriva logik

Vi kommer inte att gå igenom all logik i applikationen, jag ska bara visa hur man arbetar med meddelandefångst av boten och hur man jobbar med Wargaming API.

Arbetet med Discord-boten sker genom funktionen static async Task MainTask(string[] args);
För att anropa denna funktion måste du ange i Main

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

Därefter måste du initiera din bot:

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

Där token är din bots token.
Sedan, genom en lambda, anger vi de nödvändiga kommandona som boten ska utföra:

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

Där e.Author.Username är hämtningen av användarnamnet.

Så när du skickar ett meddelande som börjar med &, kommer boten att hälsa dig.

I slutet av denna funktion måste du ange await discord.ConnectAsync(); och await Task.Delay(-1);

Detta gör att kommandon kan köras i bakgrunden utan att blockera huvudtråden.

Nu måste vi förstå Wargaming API. Här är allt enkelt – du skriver CURL-förfrågningar, får svar i form av JSON-strängar, extraherar de nödvändiga uppgifterna och manipulerar med dem.

Exempel på arbete med 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("Spelaren hittades inte");
                }
            }
            else
            {
                string error = parsed.error.message;
                if (error == "NOT_ENOUGH_SEARCH_LENGTH")
                {
                    throw new PlayerNotFound("Minst tre tecken krävs");
                }
                else if (error == "INVALID_SEARCH")
                {
                    throw new PlayerNotFound("Ogiltig sökning");
                }
                else if (error == "SEARCH_NOT_SPECIFIED")
                {
                    throw new PlayerNotFound("Tomt smeknamn");
                }
                else
                {
                    throw new Exception("Något gick fel.");
                }
            }

            return player;
        }

Observera! Det rekommenderas starkt att inte lagra tokens och app-ID:n i öppen form! Minst av allt – Discord blockerar sådana tokens när de kommer ut på nätet, och i värsta fall – kan botten börja användas av illasinnade.

Distribuera på VPS – server

När du har avslutat botten, måste den placeras på en server som alltid är igång 24/7. Detta beror på att när din applikation körs, körs också botten. Så snart du stänger av applikationen, går även din bot i vila.

Det finns många VPS-servrar i världen, både på Windows och Linux, men i de flesta fall är det betydligt billigare att hosta på Linux.

På Discord-servern rekommenderade de vscale.io, och jag skapade omedelbart en virtuell server där på Ubuntu och laddade upp botten. Jag kommer inte att gå in på hur den här webbplatsen fungerar, utan gå direkt till inställningarna för botten.

Först och främst behöver du installera nödvändig programvara som kommer att köra vår bot skriven på .NET Core. Så här gör du, beskrivs här.

Därefter behöver du ladda upp botten till en Git-tjänst, som GitHub eller liknande, och klona den på VPS-servern, eller på andra sätt ladda ner din bot. Observera att du endast kommer att ha en konsol, GUI kommer inte att finnas. Överhuvudtaget.

När du har laddat ner din bot, behöver du starta den. För att göra detta behöver du:

• Återställa alla beroenden: dotnet restore
• Bygga applikationen: dotnet build name_project.sln -c Release
• Gå till den byggda DLL-filen;
• dotnet name_of_file.dll

Grattis! Din bot är igång. Tyvärr upptar boten konsolen, och det är inte så enkelt att lämna VPS-servern. Om servern startas om, måste boten startas igen. Det finns några lösningar på detta. Alla är relaterade till att starta vid serverstart:

• Lägg till skriptstart i /etc/init.d
• Skapa en tjänst som startas vid uppstart.

Jag ser ingen mening i att gå in på detaljer, allt är tillräckligt väl beskrivet på internet.

Slutsatser

Jag är glad att jag tog mig an den här uppgiften. Det var min första erfarenhet av att utveckla en bot, och jag är glad att jag fick nya kunskaper om C# och att arbeta med Linux.

Länk till Discord-servern. För dem som spelar Wargaming-spel.
Länk till repositoriet där Discord-boten finns.
Länk till repositoriet DSharpPlus.
Tack för uppmärksamheten!

Källa: habr.com