בוטי Discord מגיעים בכל הצורות והגדלים וניתן להשתמש בהם למגוון רחב של מטרות, החל מניהול התנהגות משתמשים בשרת שלך, חלוקה אוטומטית של עונשים כמו השתקה או איסור על גיימרים שיוצאים מהקו ועד משחק מוזיקה להנאת כולם.
ההוראות למטה מניחות שכבר יש לך חשבון Discord ושרת במקום. אם לא, עליך להגדיר זאת ב- discordapp.com לפני שתמשיך.
בעוד שבוטים של Discord כתובים בשפת JavaScript, אינך צריך להיות קודן מנוסה כדי ליצור אותם. למעשה, התהליך הרבה פחות מאיים ממה שאתה יכול לדמיין. המשך לקרוא כדי ללמוד כיצד ליצור Discord Bot שעושה את ההצעה שלך.
מדריך זה מיועד למשתמשים המריצים מערכות הפעלה macOS או Windows.
הורד והתקן את Node.js
לפני שמתחילים עם יצירת בוטים של Discord, תחילה תרצו להתקין את Node.js, סביבת זמן ריצה של JavaScript הבנויה על מנוע V8 של Google Chrome.
-
פתח דפדפן אינטרנט ונווט לדף ההורדה הרשמי של Node.js.
- בחר את חבילת ההתקנה המתאימה לפלטפורמה הספציפית שלך (macOS או Windows) ולחץ על קישור ההורדה שלה.
- פתח את הקובץ שהורד ופעל לפי ההנחיות שעל המסך כדי להתקין את Node.js.
-
לאחר השלמת, הפעל את היישום שורת הפקודה (Windows) או Terminal (macOS).
-
הקלד את הטקסט הבא בהנחיה והקש Enter במקלדת שלך: node -v
- אם מספר גרסה מוחזר, אז Node.js מותקן כהלכה. אם לא, עיין שוב בשלבים שלעיל וודא שההתקנה הושלמה.
Create a Discord Application
עכשיו, לאחר שהורדת את התנאים המוקדמים, הגיע הזמן ליצור אפליקציה חדשה שאפשר להוסיף אליה את הבוט שלך מאוחר יותר.
- פתח דפדפן ונווט אל פורטל המפתחים של Discord עבור השרת שלך, התחבר במידת הצורך.
-
לחץ יישום חדש.
-
הזן שם לאפליקציה החדשה שלך בשדה העריכה שסופק ולחץ על Create כשתהיה מוכן.
-
מסך המידע הכללי עבור האפליקציה החדשה שלך אמור להיות מוצג כעת, כפי שמוצג בצילום המסך המצורף. בחר Bot, נמצא בחלונית התפריט השמאלית.
-
לחץ הוסף בוט.
-
כעת תופיע הודעה, שתשאל אם אתה בטוח שאתה רוצה להוסיף בוט ליישום שלך. לחץ על כן, עשה זאת!
-
יש ליצור כעת את הבוט החדש שלך, עם המידע והאפשרויות שלו מוצגים בקטע BUILD-A-BOT. בחר Click to Reveal Token.
-
יש להציג כעת מחרוזת תווים ארוכה במקום הקישור הנ ל. לחץ על Copy כדי לשלוח אסימון זה ללוח שלך.
-
הדבק את האסימון הזה בקובץ טקסט לעת עתה באמצעות Notepad, TextEdit או יישום דומה.
עליך למחוק את הקובץ הזה ולהסיר אותו מסל המיחזור או מהאשפה לאחר השלמת המדריך הזה.
Coding Your Bot
יצרת בוט והוספת אותו לשרת שלך. לאחר מכן מגיע החלק המהנה, למעשה קידוד הבוט שלך לעשות מה שאתה רוצה שהוא יעשה.
- הפעל את היישום שורת הפקודה (Windows) או Terminal (macOS).
-
הקלד את הטקסט הבא בהנחיה והקש Enter או Return במקלדת שלך: mkdir discord-test -bot
אתה יכול להחליף את discord-test-bot בשם לבחירתך.
-
לאחר מכן, הקלד את הפקודה הבאה כדי לעבור לספרייה החדשה שלך: cd discord-test-bot
-
שורת הפקודה אמורה להתעדכן כעת, ומציגה את שם תיקיית פרויקט התיקייה של הבוט שלך. הקלד את הדברים הבאים והקש Enter או Return: npm init -y
-
כעת יש ליצור קובץ בשם package.json בתיקיית הפרויקט שלך, כפי שמוצג בצילום המסך שלמעלה. הקלד את הדברים הבאים בשורת הפקודה שלך והקש Enter או Return: npm install --save discord.js
-
רשימה של הודעות WARN עשויה להופיע כעת, שניתן להתעלם ממנה כל עוד לא מוצגות שגיאות (ERR) וההודעה בתחתית שורת הפקודה או חלון המסוף שלך כתובה "נוספו 7 חבילות" או "נוספו 8 חבילות".הקלד את הדברים הבאים והקש Enter או Return כדי ליצור את קובץ auth.json: touch auth.json
אם אתה מקבל הודעת שגיאה בעת ניסיון להשתמש בפקודה touch, ייתכן שתצטרך להתקין אותה תחילה על ידי הזנת התחביר הבא בשורת הפקודה שלך: npm install touch-cli -g
-
תופיע הודעת אישור שתציין שהקובץ הזה נוצר, אבל אתה יכול להקליד ls -al (macOS) או dir (Windows) כדי לראות את התוכן של ספריית הפרויקט שלך ולאשר בעצמך ש-auth.json אכן מופיע ברשימה.
- הפעל את הקוד או עורך הטקסט המועדף עליך כגון Atom, Notepad או TextEdit, ונווט אל תיקיית הפרויקט החדשה שלך.
-
פתח את הקובץ auth.json והזן את הטקסט המוצג בצילום המסך המצורף, תוך החלפת AUTH-TOKEN במחרוזת אסימון האימות שאחסנת קודם לכן במדריך. שמור את הקובץ בסיום.
אתה חייב להעתיק ולהדביק את כל מחרוזת האימות בתוך המירכאות המוצגות. אם חסר לך אפילו תו אחד, הבוט שלך לא יפעל כמצופה.
- חזור לעורך וצור קובץ חדש בתיקיית הפרויקט שלך בשם bot.js.
-
קובץ bot.js יכיל את הקוד שמכתיב את ההתנהגות של הבוט שלך, וזה לגמרי תלוי בך. עם זאת, למטרות מדריך זה, אנו ממליצים להשתמש בקוד הבא ולבדוק את הבוט שלך מקצה לקצה כדי לוודא שהכל עובד כמצופה. לאחר מכן תוכל לחזור אחורה ולערוך את התוכן של bot.js כראות עיניך.
const Discord=require('discord.js');
const client=new Discord. Client();
const auth=require('./auth.json');
client.on('ready', ()=> {
console.log(`מחובר בתור ${client.user.tag}!`);
});
client.on('message', msg=> {
if (msg.content==='שלום') {
msg.reply('hi!');
}
});
client.login(auth.token);
קוד לדוגמה זה יכתוב הודעה למסוף שורת הפקודה כאשר הבוט ייקרא, אשר יאשר כניסה מוצלחת ויכיל את תג המשתמש שלך.
- שמור את הקובץ bot.js המעודכן שלך.
- חזור לשורת הפקודה או למסוף והקלד את הדברים הבאים כדי להפעיל את סקריפט הבוט שלך: node bot.js
- אם עשית הכל נכון עד לנקודה זו, הטקסט הבא אמור להופיע בשורת הפקודה או בחלון המסוף שלך: מחובר כ-discord-test-bot
שלב את קוד הבוט עם השרת שלך
כמעט הגעתם…
- פתח דפדפן ונווט אל פורטל המפתחים של Discord עבור השרת שלך, התחבר במידת הצורך.
-
בחר את האפליקציה שיצרנו קודם לכן מהמסך MY APPLICATIONS, אם תתבקש.
-
לחץ על OAuth2, ממוקם בחלונית התפריט השמאלית.
-
גלול לתחתית המסך עד שתאתר את הקטע SCOPES. הצב סימן ביקורת ליד האפשרות bot על ידי לחיצה עליו פעם אחת.
-
גלול מטה שוב לקטע BOT PERMISSIONS, הצב סימני ביקורת ליד כל סוג הרשאה שאולי הבוט הבודד שלך צריך כדי לתפקד כמצופה.למטרות של בוט לדוגמה זה, אנו זקוקים להרשאות הבאות: שלח הודעות, קרא היסטוריית הודעות
סביר להניח שהבוט הספציפי שלך יזדקק לקבוצת הרשאות שונה משמעותית. חשוב להבין מה כוללת כל הרשאה לפני הפעלתה, כדי שמשתמשי הבוט לא יוכלו לנצל אותה למטרות מרושעות.
-
לחץ על Copy, ממוקם בין הקטעים SCOPES ו-BOT PERMISSIONS ומלווה בכתובת URL ארוכה.
- פתח כרטיסיית דפדפן חדשה והדבק את כתובת האתר הזו בשורת הכתובות, הקש Enter או Return כדי לטעון את הדף.
-
ממשק CONNECT TO DISCORD אמור להיות מוצג כעת, כפי שמוצג בצילום המסך המצורף. לחץ על בחר שרת ובחר את שם השרת שלך מהרשימה המסופקת.
-
לחץ Authorize.
-
הצב סימן ביקורת ליד I'm not a robot על ידי לחיצה על תיבת הסימון שלו פעם אחת.
-
כעת אמורה להופיע הודעת אישור, ולציין שהבוט שלך מורשה והוא נוסף לשרת שלך.
איך לבדוק את הבוט שלך בשרת
אתה יכול לבדוק את הבוט שלך על ידי הפעלת לקוח Discord ושליחת פקודות או הודעות המתאימות לקוד הספציפי שלך. בדוגמה זו, שלח את המילה hello לבוט שלך והוא אמור להגיב ב- hi!