Discord robotët vijnë në të gjitha format dhe madhësitë dhe mund të përdoren për një gamë të gjerë qëllimesh që variojnë nga moderimi i sjelljes së përdoruesit në serverin tuaj, duke bërë automatikisht dënime si heqja e zërit ose ndalimi i lojtarëve që dalin jashtë linjës, deri te loja muzikë që të gjithë ta shijojnë.
Udhëzimet e mëposhtme supozojnë se ju tashmë keni një llogari dhe server Discord në vend. Nëse jo, duhet ta konfiguroni këtë në discordapp.com përpara se të vazhdoni.
Ndërsa robotët Discord janë shkruar në gjuhën JavaScript, nuk duhet të jeni një kodues me përvojë për t'i krijuar ato. Në fakt, procesi është shumë më pak frikësues sesa mund ta imagjinoni. Vazhdoni të lexoni për të mësuar se si të krijoni një Discord Bot që bën ofertën tuaj.
Ky tutorial është menduar për përdoruesit që përdorin sisteme operative macOS ose Windows.
Shkarko dhe Instalo Node.js
Para se të filloni me krijimin e robotëve Discord, së pari do të dëshironi të instaloni Node.js, një mjedis i kohës së funksionimit JavaScript i ndërtuar në motorin V8 të Google Chrome.
-
Hap një shfletues ueb dhe lundroni në faqen zyrtare të shkarkimit të Node.js.
- Zgjidhni paketën e duhur të instaluesit për platformën tuaj të veçantë (macOS ose Windows) dhe klikoni në lidhjen e shkarkimit të saj.
- Hapni skedarin e shkarkuar dhe ndiqni kërkesat në ekran për të instaluar Node.js.
- Pasi të keni përfunduar, hapni aplikacionin Command Prompt (Windows) ose Terminal (macOS).
-
Shkruani tekstin e mëposhtëm në kërkesë dhe shtypni Enter në tastierën tuaj: node -v
- Nëse kthehet një numër versioni, atëherë Node.js është instaluar saktë. Nëse jo, rishikoni hapat e mësipërm dhe sigurohuni që instalimi të ketë përfunduar.
Krijoni një aplikacion mosmarrëveshje
Tani që i keni hequr kushtet paraprake, është koha për të krijuar një aplikacion të ri ku roboti juaj mund të shtohet më vonë.
- Hapni një shfletues dhe lundroni te Portali i Zhvilluesve Discord për serverin tuaj, duke u identifikuar nëse është e nevojshme.
-
Klikoni Aplikacion i ri.
-
Fut një emër për aplikacionin tënd të ri në fushën e redaktimit të dhënë dhe kliko Krijo kur të jetë gati.
-
Tani duhet të shfaqet ekrani i Informacionit të Përgjithshëm për aplikacionin tuaj të ri, siç tregohet në pamjen e ekranit shoqërues. Zgjidh Bot, që gjendet në panelin e majtë të menysë.
-
Kliko Shto Bot.
-
Tani do të shfaqet një mesazh, duke pyetur nëse jeni i sigurt që dëshironi të shtoni një bot në aplikacionin tuaj. Klikoni Po, bëjeni!
-
Tani duhet të krijohet boti juaj i ri, me informacionin dhe opsionet e tij të shfaqura në seksionin BUILD-A-BOT. Zgjidh Kliko për të Reveal Token.
-
Një varg i gjatë karakteresh duhet të shfaqet tani në vend të lidhjes së lartpërmendur. Klikoni Copy për ta dërguar këtë shenjë në kujtesën tuaj.
-
Ngjisni këtë shenjë në një skedar teksti tani për tani duke përdorur Notepad, TextEdit ose një aplikacion të ngjashëm.
Duhet ta fshini këtë skedar dhe ta hiqni nga koshi juaj i riciklimit ose koshi pasi të keni përfunduar këtë tutorial.
Kodikimi i botit tuaj
Ke krijuar një bot dhe e ke shtuar në serverin tënd. Më pas vjen pjesa argëtuese, në fakt kodimi i robotit tuaj për të bërë atë që dëshironi.
- Hanise aplikacionin Rreshti i komandës (Windows) ose Terminal (macOS).
-
Shkruani tekstin e mëposhtëm në kërkesë dhe shtypni Enter ose Return në tastierën tuaj: mkdir discord-test -bot
Mund të zëvendësoni discord-test-bot me një emër që zgjidhni.
-
Më pas, shkruani komandën e mëposhtme për të kaluar në drejtorinë tuaj të sapokrijuar: cd discord-test-bot
-
Rruga e komandës tani duhet të përditësohet, duke shfaqur emrin e dosjes së projektit të dosjes së robotit tuaj. Shkruani sa vijon dhe shtypni Enter ose Return: npm init -y
-
Një skedar me emrin package.json duhet të krijohet tani në dosjen tuaj të projektit, siç tregohet në pamjen e mësipërme të ekranit. Shkruani sa vijon në vijën e komandës dhe shtypni Enter ose Return: npm install --save discord.js
-
Tani mund të shfaqet një listë e mesazheve WARN, të cilat mund të injorohen për sa kohë që nuk shfaqen gabime (ERR) dhe mesazhi në fund të dritares suaj të vijës së komandës ose terminalit lexon "shtuar 7 paketa" ose “U shtuan 8 paketa”. Shkruani sa vijon dhe shtypni Enter ose Return për të krijuar skedarin auth.json: touch auth.json
Nëse merrni një mesazh gabimi kur përpiqeni të përdorni komandën touch, fillimisht mund t'ju duhet ta instaloni duke futur sintaksën e mëposhtme në vijën e komandës: npm instalo touch-cli -g
-
Do të ketë një mesazh konfirmimi duke vënë në dukje se ky skedar është krijuar, por mund të shkruani ls -al (macOS) ose dir (Windows) për të parë përmbajtjen e drejtorisë së projektit tuaj dhe për të konfirmuar vetë se auth.json është në të vërtetë renditur.
- Nisni kodin tuaj të preferuar ose redaktuesin e tekstit si Atom, Notepad ose TextEdit dhe lundroni te dosja juaj e re e projektit.
-
Hapni skedarin auth.json dhe futni tekstin e treguar në pamjen shoqëruese të ekranit, duke zëvendësuar AUTH-TOKEN me vargun e tokenit të vërtetimit që keni ruajtur më parë në tutorial. Ruaje skedarin kur të mbarosh.
Ju duhet të kopjoni dhe ngjisni të gjithë vargun e vërtetimit brenda thonjëzave të treguara. Nëse ju mungon qoftë edhe një karakter, atëherë roboti juaj nuk do të funksionojë siç pritej.
- Kthehuni te redaktori dhe krijoni një skedar të ri në dosjen tuaj të projektit të quajtur bot.js.
-
Skedari bot.js do të përmbajë kodin që dikton sjelljen e robotit tuaj, i cili varet plotësisht nga ju. Megjithatë, për qëllimet e këtij tutoriali, ne rekomandojmë përdorimin e kodit të mëposhtëm dhe testimin e robotit tuaj nga fundi në fund për t'u siguruar që gjithçka po funksionon siç pritej. Më pas mund të ktheheni dhe të modifikoni përmbajtjen e bot.js siç e shihni të arsyeshme.
const Mosmarrëveshje=kërkoj('discord.js');
klient konst=i ri Discord. Client();
const auth=kerkoj('./auth.json');
client.on('gati', ()=> {
console.log('I regjistruar si ${client.user.tag}!');
});
client.on('message', msg=> {
if (msg.content==='përshëndetje') {
msg.reply('përshëndetje!');
}
});
klient.login(auth.token);
Ky kod mostër do t'i shkruajë një mesazh komandës së linjës së komandës kur të thirret roboti, duke konfirmuar një hyrje të suksesshme dhe duke përmbajtur etiketën tuaj të përdoruesit.
- Ruaj skedarin tuaj të përditësuar bot.js.
- Kthehuni te Command Prompt ose Terminal dhe shkruani sa vijon për të ekzekutuar skriptin tuaj të botit: node bot.js
- Nëse keni bërë gjithçka në mënyrë korrekte deri në këtë pikë, teksti i mëposhtëm duhet të shfaqet në vijën e komandës ose dritaren e terminalit: I identifikuar si discord-test-bot
Integroni kodin bot me serverin tuaj
Ti je pothuajse aty…
- Hapni një shfletues dhe lundroni te Portali i Zhvilluesve Discord për serverin tuaj, duke u identifikuar nëse është e nevojshme.
-
Zgjidhni aplikacionin që krijuam më parë nga ekrani APLIKACIONET MIA, nëse ju kërkohet.
-
Kliko OAuth2, që ndodhet në panelin e majtë të menysë.
-
Lëvizni në fund të ekranit derisa të gjeni seksionin SCOPES. Vendosni një shenjë pranë opsionit bot duke klikuar mbi të një herë.
-
Lëvizni përsëri poshtë te seksioni LEJET BOT, duke vendosur shenjat e kontrollit pranë secilit lloj leje që mund t'i duhet robotit tuaj individual për të funksionuar siç pritej. Për qëllimet e këtij roboti shembull, na duhen lejet e mëposhtme: Dërgoni Mesazhet, Lexoni Historinë e Mesazheve
Boti juaj i veçantë ka të ngjarë të ketë nevojë për një grup shumë të ndryshëm lejesh. Është e rëndësishme të kuptoni se çfarë përfshin çdo leje përpara se ta aktivizoni atë, në mënyrë që përdoruesit e robotëve të mos mund ta shfrytëzojnë atë për qëllime të liga.
-
Kliko Copy, i vendosur midis seksioneve SCOPES dhe BOT PERMISSIONS dhe i shoqëruar nga një URL e gjatë.
- Hap një skedë të re të shfletuesit dhe ngjit këtë URL në shiritin e adresave, duke shtypur Enter ose Kthehu për të ngarkuar faqen.
-
Ndërfaqja CONNECT TO DISCORD tani duhet të shfaqet, siç tregohet në pamjen e ekranit shoqërues. Klikoni Zgjidhni një server dhe zgjidhni emrin e serverit tuaj nga lista e ofruar.
-
Klikoni Autorize.
-
Vendos një shenjë pranë Unë nuk jam robot duke klikuar një herë në kutinë e tij të kontrollit.
-
Tani duhet të shfaqet një mesazh konfirmimi, duke vënë në dukje se roboti juaj është i autorizuar dhe është shtuar në serverin tuaj.
Si ta testoni botin tuaj në server
Mund ta testoni botin tuaj duke hapur klientin Discord dhe duke i dërguar komanda ose mesazhe që korrespondojnë me kodin tuaj të veçantë. Në këtë shembull, dërgoni fjalën përshëndetje te roboti juaj dhe ai duhet të përgjigjet me hi!