Discord-boti loomine .NET Core'is ja selle paigaldamine VPS-serverisse

Tere, Habrashanid!

Täna tutvute artikliga, milles räägitakse, kuidas luua boti, kasutades C#-s .NET Core'i, ja kuidas see käivitada eemaldatud serveris.

Artikkel koosneb eelhistooriast, ettevalmistusest, loogika kirjutamisest ja boti üleviimisest eemaldatud serverisse.

Loodan, et see artikkel aitab paljusid algajaid.

Eellugu

Kõik algas ühel unetul sügisöösel, mille veetsin Discordi serveris. Kuna ma liitusin sellega suhteliselt hiljuti, hakkasin seda süvitsi uurima. Leidsin tekstikanali "Tööpakkumised" ja huvi pärast avasin selle. Otsides kõrvalisi pakkumisi, leidsin sealt järgmise:

„Programmeerija (boti arendaja)
Nõuded:

• programmeerimiskeelte tundmine;
• võime enesearenguks.

Soovitused:

• oskus mõista teiste koodi;
• teadlikkus DISCORDi funktsionaalsusest.

Ülesanded:

• boti arendamine;
• boti tõhususe toetamine ja hooldamine.

Teie kasu:

• Võimalus toetada ja mõju avaldada meelepärasele projektile;
• Kogemus meeskonnas töötamisest;
• Võimalus demonstreerida ja täiendada olemasolevaid oskusi.»

See köitis mu tähelepanu kohe. Jah, selle töö eest ei makstud, kuid sinult ei nõutud mingeid kohustusi, ja portfooliosse ei ole see üleliigne. Seetõttu kirjutasin serveri administraatorile ja ta palus mul luua boti, mis kuvab World of Tanks'i mängija statistikat.

Ettevalmistusetapp

Discord
Enne kui hakkame meie boti kirjutama, tuleb see kõigepealt Discordis luua. Teil on vaja:

1. Siseneda Discordi kontole linki pidi
2. Vahekaartide "Rakendused" all klikkige nupule "Uus rakendus" ja nimetage bot
3. Saada boti token, sisenedes oma boti ja leides loendist "Seaded" vahekaart "Bot"
4. Salvesta token kuskil

Wargaming

Samuti peate looma rakenduse Wargamingus, et saada juurdepääs Wargaming API-le. See on samuti lihtne:

1. Siseneda Wargamingu kontole sellel linkil
2. Minge "Minu rakendused" ja klõpsake nuppu "Lisa uus rakendus", andes rakendusele nime ja valides selle tüübi
3. Salvesta rakenduse ID

Tarkvara

Siin on juba valikuvabadus. Mõni kasutab Visual Studio't, mõni Riderit, mõni kirjutab isegi võimsas Vimis (päris programmeerijad kasutavad ju vaid klaviatuuri, eks?). Kuid et mitte rakendada Discord API-d, võib kasutada C# mittetäielikku teeki 'DSharpPlus'. Selle saab installida kas NuGet'ist või ise allalaadides lähtekoodi hoidlast.

Neil, kes ei tea või on unustanud, kuidas installida rakendusi NuGet'ist.Juhised Visual Studio jaoks

1. Liigume vahekaardile Projekt – NuGet pakettide haldamine;
2. Klikkige ülevaates ja otsinguvälja sisestage 'DSharpPlus';
3. Valige ja installige framework;
4. PROFIT!

Ettevalmistav etapp on lõppenud, nüüd võib minna boti kirjutamise juurde.

Logika kirjutamine

Kogu rakenduse loogikat me ei käsitle, näitan vaid, kuidas töötada sõnumite katkestamisega botiga ja kuidas töötada Wargaming API-ga.

Töötamine Discord boti kaudu toimub funktsiooni static async Task MainTask(string[] args); kaudu.
Selle funktsiooni kutsumiseks tuleb Main'is kirjutada

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

Edasi peate initsialiseerima oma boti:

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

Kus token on teie boti token.
Siis, läbi lambda, kirjutame vajalikud käsklused, mida bot peab täitma:

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

Kus e.Author.Username on kasutaja hüüdnimede saamine.

Nii et kui saadate mis tahes sõnumi, mis algab &-ga, tervitab bot teid.

Selle funktsiooni lõpus tuleb kirjutada await discord.ConnectAsync(); ja await Task.Delay(-1);

See võimaldab täita komande taustal, blokeerimata peamist lõime.

Nüüd tuleb tutvuda Wargaming API-ga. Siin on kõik lihtne – kirjutage CURL-päringud, saage vastus JSON-stringina, tõmmake sealt vajalikud andmed välja ja tehke nendega manipulatsioone.

Näide WargamingAPI kasutamisest

aval Player FindPlayer(string otsitavNickname)
        {
            //https://api.worldoftanks.ru/wot/account/list/?application_id=y0ur_a@@_id_h3r3search=nickname
            urlRequest = resourceMan.GetString("url_find_player") + appID + "&search=" + otsitavNickname;
            Player mängija = 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)
                {
                    mängija = new Player
                    {
                        Nickname = parsed.data[0].nickname,
                        Id = parsed.data[0].account_id
                    };
                }
                else
                {
                    throw new PlayerNotFound("Mängijat ei leitud");
                }
            }
            else
            {
                string error = parsed.error.message;
                if (error == "NOT_ENOUGH_SEARCH_LENGTH")
                {
                    throw new PlayerNotFound("Vähemalt kolm sümbolit on vajalikud");
                }
                else if (error == "INVALID_SEARCH")
                {
                    throw new PlayerNotFound("Vale otsing");
                }
                else if (error == "SEARCH_NOT_SPECIFIED")
                {
                    throw new PlayerNotFound("Tühi nickname");
                }
                else
                {
                    throw new Exception("Midagi läks valesti.");
                }
            }

            return mängija;
        }

Tähelepanu! Kõiki tokene ja rakenduste ID-sid ei soovitata hoida avalikult! Vähemalt – Discord blokeerib sellised tokenid, kui need satuvad ülemaailmsesse võrku, maksimaalselt – bot hakkab kurjategijate käes tööle.

VPS – serverisse juurutamine

Pärast seda, kui olete botiga lõpetanud, tuleb see paigutada serverisse, mis töötab pidevalt 24/7. See on seotud sellega, et kui teie rakendus töötab, töötab ka bot. Kui lõpetate rakenduse, magab ka teie bot.

Maailmas on palju VPS servereid, nii Windowsi kui ka Linuxi peal, ent enamikul juhtudel on Linuxis hostimine kordades odavam.

Discordi serveris soovitati mulle vscale.io, ning ma lõin seal kohe virtuaalse serveri Ubuntu peal ja laadisin boti üles. Ma ei hakka selgitama, kuidas see sait töötab, vaid lähen kohe boti seadistamise juurde.

Esmalt peate installima vajaliku tarkvara, mis käivitab meie boti, mis on kirjutatud .NET Core'is. Kuidas seda teha, on siin kirjeldatud.

Seejärel peate boti üles laadima Git – teenusesse, nagu GitHub ja sarnased, ning kloonima selle VPS – serverisse või muul moel alla laadima oma boti. Pange tähele, et teil on vaid käsurea liides, GUI-d ei ole.

Pärast seda, kui olete oma boti alla laadinud, peate selle käivitama. Selleks peate:

• Taastama kõik sõltuvused: dotnet restore
• Koguma rakenduse: dotnet build name_project.sln -c Release
• Minema loodud DLL-faili juurde;
• dotnet name_of_file.dll

Palju õnne! Teie bot on käivitunud. Kahjuks aga blokeerib bot konsooli ja VPS-serverist väljumine ei ole nii lihtne. Samuti, kui server taaskäivitub, tuleb bot uuesti käivitada. Siin on mõned lahendused. Kõik need on seotud serveri käivitamisel bot'i käivitamisega:

• Lisada skripti käitamine /etc/init.d kausta
• Luua teenus, mis käivitub alguses.

Ei näe mõtet neist põhjalikult rääkida, kõik on piisavalt detailselt internetis kirjeldatud.

Järeldused

Olen rõõmus, et asusin seda ülesannet tegema. See oli minu esimene kogemus boti arendamisel ning olen rõõmus, et sain uusi teadmisi C#-st ja Linuxi kasutamisest.

Link Discord-serverile. Need, kes mängivad Wargamingi mänge.
Link repole, kus asub Discord bot.
Link DSharpPlus repole.
Aitäh tähelepanu eest!

Allikas: habr.com