🥇יצירת בוט Discord ב-.NET Core עם פריסה לשרת VPS

שלום חברוביטים!

היום תראו מאמר שיראה לכם כיצד ליצור בוט באמצעות C# ב-.NET Core וכיצד להפעיל אותו על שרת מרוחק.

המאמר יורכב מרקע, שלב הכנה, כתיבת לוגיקה והעברת הבוט לשרת מרוחק.

אני מקווה שמאמר זה יעזור למתחילים רבים.

פרהיסטוריה

הכל התחיל בליל סתיו אחד ללא שינה שביליתי בשרת הדיסקורד. מאז שהצטרפתי אליו לאחרונה, התחלתי ללמוד אותו מעלה ומטה. לאחר שמצאתי את ערוץ הטקסט "מקומות פנויים", התעניינתי, פתחתי אותו ומצאתי בין ההצעות שלא עניינו אותי, אלו:

"מתכנת (מפתח רובוט)
דרישות:

ידע בשפות תכנות;

יכולת למידה עצמית.

Пожелания:

יכולת להבין קוד של אנשים אחרים;

ידע בפונקציונליות DISCORD.

מטרות:

פיתוח בוטים;

תמיכה ותחזוקה של הבוט.

היתרון שלך:

הזדמנות לתמוך ולהשפיע על הפרויקט שאתה אוהב;

צבירת ניסיון בעבודה בצוות;

הזדמנות להפגין ולשפר מיומנויות קיימות.

זה עניין אותי מיד. כן, הם לא שילמו על העבודה הזו, אבל לא דרשו ממך שום התחייבות, וזה לא יהיה מיותר בתיק. לכן, כתבתי למנהל השרת, והוא ביקש ממני לכתוב בוט שיציג את הסטטיסטיקה של השחקן ב-World of Tanks.

שלב ההכנה

Discrod
לפני שנתחיל לכתוב את הבוט שלנו, עלינו ליצור אותו עבור Discord. אתה צריך:

היכנס לחשבון דיסקורד по ссылке
בלשונית "יישומים", לחץ על כפתור "יישום חדש" ושם לבוט
קבל אסימון בוט על ידי כניסה לבוט שלך ומציאת הכרטיסייה "בוט" ברשימת "הגדרות"
שמור את האסימון איפשהו

Wargaming

כמו כן, עליך ליצור אפליקציה ב-Wargaming כדי לקבל גישה ל-Wargaming API. גם כאן הכל פשוט:

היכנס לחשבון Wargaming שלך על ידי קישור זה
נעבור ל"האפליקציות שלי" ונלחץ על כפתור "הוסף אפליקציה חדשה", נותן את שם האפליקציה ובחר את סוגה
שמירת מזהה האפליקציה

תוכנה

יש כבר חופש בחירה. מישהו משתמש ב-Visual Studio, מישהו ב-Rider, מישהו הוא בדרך כלל חזק, וכותב קוד ב-Vim (אחרי הכל, מתכנתים אמיתיים משתמשים רק במקלדת, נכון?). עם זאת, כדי לא ליישם את Discord API, אתה יכול להשתמש בספריית C# הלא רשמית "DSharpPlus". אתה יכול להתקין אותו מ-NuGet, או על ידי בניית המקורות בעצמך מהמאגר.

למי שלא יודע או שכח איך להתקין אפליקציות מ-NuGet.הוראות עבור Visual Studio

עבור ללשונית פרויקט - ניהול חבילות NuGet;
לחץ על הביקורת ובשדה החיפוש הזן "DSharpPlus";
בחר והתקן את המסגרת;
רווח!

שלב ההכנה הסתיים, אתה יכול להמשיך לכתיבת הבוט.

היגיון כתיבה

לא נשקול את כל ההיגיון של האפליקציה, אני רק אראה איך עובדים עם יירוט הודעות על ידי הבוט, ואיך עובדים עם Wargaming API.

העבודה עם הבוט של Discord מתרחשת דרך המשימה אסינכרון סטטי MainTask(string[] args);
כדי לקרוא לפונקציה זו, ב-Main יש להירשם

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

לאחר מכן, עליך לאתחל את הבוט שלך:

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

איפה האסימון הוא האסימון של הבוט שלך.
לאחר מכן, דרך הלמבדה, אנו כותבים את הפקודות הדרושות שהבוט צריך לבצע:

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

איפה e.Author.Username מקבל את הכינוי של המשתמש.

בדרך זו, כאשר אתה שולח כל הודעה שמתחילה ב-&, הבוט יקבל את פניך.

בסוף פונקציה זו, עליך לכתוב await discord.ConnectAsync(); ומחכים ל-Task.Delay(-1);

זה יאפשר לך לבצע פקודות ברקע מבלי לקחת את השרשור הראשי.

עכשיו אנחנו צריכים להתמודד עם Wargaming API. הכל פשוט כאן - כתבו בקשות CURL, קבלו תגובה בצורת מחרוזת JSON, שלפו משם את הנתונים הדרושים ובצעו עליהם מניפולציות.

דוגמה לעבודה עם 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("Игрок не найден");
                }
            }
            else
            {
                string error = parsed.error.message;
                if (error == "NOT_ENOUGH_SEARCH_LENGTH")
                {
                    throw new PlayerNotFound("Минимум три символа требуется");
                }
                else if (error == "INVALID_SEARCH")
                {
                    throw new PlayerNotFound("Неверный поиск");
                }
                else if (error == "SEARCH_NOT_SPECIFIED")
                {
                    throw new PlayerNotFound("Пустой никнейм");
                }
                else
                {
                    throw new Exception("Something went wrong.");
                }
            }

            return player;
        }

תשומת הלב! בהחלט לא מומלץ לאחסן את כל האסימונים ומזהי האפליקציה בטקסט ברור! לכל הפחות, דיסקורד אוסר על אסימונים כאלה כשהם נכנסים לרשת העולמית, ולכל היותר, הבוט מתחיל להיות בשימוש על ידי תוקפים.

פריסה ל-VPS - שרת

לאחר שתסיים עם הבוט, הוא צריך להתארח בשרת שפועל כל הזמן 24/7. זאת בשל העובדה שכאשר האפליקציה שלך פועלת, גם הבוט פועל. ברגע שאתה מכבה את האפליקציה, גם הבוט שלך נרדם.

שרתי VPS רבים קיימים בעולם הזה, גם ב-Windows וגם בלינוקס, עם זאת, ברוב המקרים, הרבה יותר זול לארח בלינוקס.

בשרת הדיסקורד יעצו לי על vscale.io ומיד יצרתי עליו שרת וירטואלי באובונטו והעליתי את הבוט. לא אתאר איך האתר הזה עובד, אלא אעבור ישר להגדרות הבוט.

קודם כל, עליך להתקין את התוכנה הדרושה שתפעיל את הבוט שלנו שנכתב ב-.NET Core. כיצד לעשות זאת מתואר כאן.

לאחר מכן, עליך להעלות את הבוט לשירות Git, כמו GitHub וכדומה, ולשכפל אותו לשרת VPS, או להוריד את הבוט שלך בדרכים אחרות. שים לב שתהיה לך רק קונסולה, ללא GUI. בכלל.

לאחר שהורדת את הבוט שלך, עליך להפעיל אותו. בשביל זה, אתה צריך:

שחזר את כל התלות: שחזור dotnet
בניית יישום: dotnet build name_project.sln -c שחרור
עבור אל DLL בנוי;
dotnet name_of_file.dll

מזל טוב! הבוט שלך פועל. עם זאת, הבוט, למרבה הצער, תופס את הקונסולה, ולא קל לצאת משרת ה-VPS. כמו כן, במקרה של הפעלה מחדש של השרת, תצטרך להפעיל את הבוט בצורה חדשה. ישנן כמה דרכים לצאת מהמצב. כולם קשורים להפעלה בעת הפעלת השרת:

הוסף סקריפט הפעלה ל-/etc/init.d
צור שירות שיפעל בעת ההפעלה.

אני לא רואה טעם להתעכב עליהם בפירוט, הכל מתואר בפירוט מספיק באינטרנט.

ממצאים

אני שמח שלקחתי על עצמי את המשימה הזו. זה היה הניסיון הראשון שלי בפיתוח בוטים, ואני שמח שקיבלתי ידע חדש ב-C# ועבודה עם לינוקס.

קישור לשרת דיסקורד. למי שמשחק משחקי Wargaming.
קישור למאגר שבו נמצא הבוט של Discord.
קישור למאגר DSharpPlus.
תודה לך!

מקור: www.habr.com

יצירת בוט Discord ב-.NET Core עם פריסה לשרת VPS

פרהיסטוריה

שלב ההכנה

היגיון כתיבה

פריסה ל-VPS - שרת

ממצאים

הוספת תגובה ביטול תגובה