Discordi boti loomine .NET Core'is VPS-serverile rakendamisega

Tere, Habravlased!

Täna saate tutvuda artikliga, kus räägitakse, kuidas luua boti, kasutades C#-t .NET Core'is, ja kuidas see käivitada kaugarvutil.

Artikkel koosneb eelloost, ettevalmistusfaasist, loogika kirjutamisest ja boti üleviimisest kaugarvutile.

Loodan, et see artikkel aitab paljusid algajaid.

Eelalugu

Kõik algas ühel unetul sügisõhtul, mille veetsin Discordi serveris. Kuna ma olin seal suhteliselt uus, hakkasin seda kõikvõimalikult uurima. Leides tekstikanali „Tööpakkumised”, tekkis mul huvi, avasin selle ja leidsin, et üks mitte huvitav pakkumine on:

„Programmeerija (boti arendaja)
Nõuded:

• programmeerimiskeelte tundmine;
• võime eneseõppimiseks.

Soovitused:

• oskus mõista võõrast koodi;
• DISCORDi funktsionaalsuse tundmine.

Ülesanded:

• boti arendamine;
• boti töö toetamine ja jälgimine.

Teie kasu:

• Võimalus toetada ja mõjutada meeldivat projekti;
• Kogemuste omandamine meeskonnas töötamisel;
• Võimalus demonstreerida ja täiustada olemasolevaid oskusi."

See pani mind huvituma. Jah, selle töö eest ei makstud, kuid sinult ei nõutud mingeid kohustusi ning see ei oleks ka portfoolios liialt. Seetõttu kirjutasin serveriadministraatorile ning ta palus mul kirjutada boti, mis näitab mängija statistikat World of Tanks'is.

Eeltestimine

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

1. Logida sisse oma Discordi kontole lingi kaudu
2. Vahekaardil „Rakendused“ vajutage nuppu „Uus rakendus“ ja nimetage bot
3. Saada boti token, sisestades oma boti ja leidke sealt kaust „Seaded“ vahekaart „Bot“
4. Salvestage token kuskile

Wargaming

Samuti tuleb luua rakendus Wargamingus, et saada juurdepääs Wargaming API-le. Siin on kõik samuti lihtne:

1. Logige sisse Wargamingu kontole antud lingil
2. Minge jaotisse „Minu rakendused“ ja vajutage nuppu „Lisa uus rakendus“, andes rakendusele nime ja valides selle tüübi
3. Salvesta rakenduse ID

Tarkvara

Siin on juba vabadus valida. Keegi kasutab Visual Studio't, keegi Riderit, keegi aga tõsiselt voolab ja kirjutab koodi Vim'is (õiged programmeerijad kasutavad ju ainult klaviatuuri, eks?). Kuid Discord API kasutamiseks, ei pea seda ise rakendama, piisab, kui kasutada mitteformaalseid C# raamatukogusid nagu “DSharpPlus”. Selle saad installida kas NuGet'ist või koguda ise lähtekoodid repolt.

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

1. Liigume vahekaardile Projekt – NuGet pakettide haldamine;
2. Klõpsame ülevaate ja kirjutame otsinguväljale “DSharpPlus”;
3. Valime ja installime framework'i;
4. PROFIT!

Ettevalmistavad tööd on lõpetatud, nüüd võime liikuda boti kirjutamise juurde.

Sisu kirjutamine

Me ei vaata rakenduse kogu loogikat, näitan vaid, kuidas töötada boti sõnumite püüdmisega ja kuidas töötada Wargaming API'ga.

Discord boti töö toimub funktsiooni static async Task MainTask(string[] args); kaudu;
Selle funktsiooni väljakutsumiseks tuleb Main'is kirjutada

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

Edasi tuleb teil oma boti initsialiseerida:

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, määrame vajalikud käsud, 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 – kasutaja hüüdnime saamine.

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

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

See võimaldab käske täita taustal, mitte blokeerides põhivoogu.

Nüüd on vajalik mõista Wargaming API-d. Siin on kõik lihtne – kirjutage CURL-päringud, saate vastuse JSON-formaadis, tõstate sealt vajalikud andmed ja teete nendega manipuleerimisi.

Näide WargamingAPI kasutamisest

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("Mängija ei leitud");
                }
            }
            else
            {
                string error = parsed.error.message;
                if (error == "NOT_ENOUGH_SEARCH_LENGTH")
                {
                    throw new PlayerNotFound("Nõutav on vähemalt kolm tähte");
                }
                else if (error == "INVALID_SEARCH")
                {
                    throw new PlayerNotFound("Vale otsing");
                }
                else if (error == "SEARCH_NOT_SPECIFIED")
                {
                    throw new PlayerNotFound("Tühi hüüdnimi");
                }
                else
                {
                    throw new Exception("Midagi läks valesti.");
                }
            }

            return player;
        }

Tähtis! Kõiki tokeneid ja rakenduste ID-sid ei soovitata avatud kujul hoida! Kõige vähem – Discord keelab sellised tokenid, kui need satuvad ülemaailmsetesse võrkudesse, kõige hullem – bot hakkab kurjategijate kätes tegutsema.

VPS – serveri seadistamine

Pärast boti seadistamist 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 rakenduse välja lülitate, uinub ka teie bot.

Selliseid VPS-servereid on maailmas palju, nii Windowsi kui ka Linuxi jaoks, kuid enamikul juhtudel on Linuxis palju odavam paigutamine.

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

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

Seejärel peate oma boti Git-ile üles laadima – teenusele, nagu GitHub ja sarnased, ning selle VPS-serverisse kloonima või muude meetoditega oma boti alla laadima. Pange tähele, et teil on vaid konsool, GUI-d ei ole. Üldse.

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

• Taastama kõik sõltuvused: dotnet restore
• Rakenduse koostama: dotnet build name_project.sln -c Release
• Minema koostatud DLL-i;
• dotnet name_of_file.dll

Palju õnne! Teie bot on käivitunud. Kahjuks kasutab bot konsooli, nii et VPS-serverist väljuda ei ole nii lihtne. Samuti, kui server taaskäivitub, peate boti uuesti käivitama. Siin on paar lahendust. Need kõik on seotud käivitamisega serveri käivitamisel:

• Lisage skripti käivitamine /etc/init.d
• Looge teenus, mis käivitub serveri käivitamisel.

Ei näe mõtet nendeleetailselt peatuda, kõik on internetis piisavalt detailselt kirjeldatud.

Järeldused

Mul on hea meel, et võtsin selle ülesande ette. See oli minu esimene kogemus boti arendamisel, ja mul on hea meel, et sain uusi teadmisi C#-st ja Linuxiga töötamisest.

Link Discordi serverisse. Neile, kes mängivad Wargamingi mänge.
Link hoidlasse, kus asub Discord bot.
DSharpPlus'i hoidla link.
Aitäh tähelepanu eest!

Allikas: habr.com