Discord-bots kommer i alle former og størrelser og kan bruges til en bred vifte af formål, der spænder fra moderering af brugeradfærd på din server, automatisk uddeling af straffe såsom muting eller forbud mod spillere, der træder ud af linjen, til at spille musik, som alle kan nyde.
Instruktionerne nedenfor antager, at du allerede har en Discord-konto og -server på plads. Hvis ikke, skal du konfigurere dette på discordapp.com, før du fortsætter.
Mens Discord-bots er skrevet på JavaScript-sproget, behøver du ikke at være en erfaren koder for at oprette dem. Faktisk er processen meget mindre skræmmende, end du måske forestiller dig. Fortsæt med at læse for at lære, hvordan du laver en Discord-bot, der gør dit bud.
Denne selvstudie er beregnet til brugere, der kører macOS eller Windows-operativsystemer.
Download og installer Node.js
Før du går i gang med oprettelse af Discord-bot, skal du først installere Node.js, et JavaScript-runtime-miljø bygget på Google Chromes V8-motor.
-
Åbn en webbrowser, og naviger til den officielle Node.js-downloadside.
-
Vælg den passende installationspakke til din specifikke platform (macOS eller Windows), og klik på dens downloadlink.
- Åbn den downloadede fil, og følg vejledningen på skærmen for at installere Node.js.
- Når du er færdig, skal du starte applikationen Kommandoprompt (Windows) eller Terminal (macOS).
-
Skriv følgende tekst ved prompten, og tryk på Enter på dit tastatur: node -v
- Hvis et versionsnummer returneres, er Node.js installeret korrekt. Hvis ikke, skal du gense ovenstående trin og sikre dig, at installationen er fuldført.
Create a Discord Application
Nu hvor du har fået forudsætningerne af vejen, er det tid til at oprette en ny applikation, som din bot senere kan føjes til.
- Åbn en browser, og naviger til Discord Developer Portal for din server, log ind om nødvendigt.
-
Klik New Application.
-
Indtast et navn til din nye applikation i det angivne redigeringsfelt, og klik på Create, når du er klar.
-
Skærmbilledet med generelle oplysninger for din nye applikation skulle nu blive vist, som vist på det medfølgende skærmbillede. Vælg Bot, som findes i venstre menurude.
-
Klik Add Bot.
-
Der vises nu en meddelelse, der spørger, om du er sikker på, at du vil tilføje en bot til din applikation. Klik på Ja, gør det!
-
Din nye bot skulle nu være oprettet med dens oplysninger og muligheder vist i BUILD-A-BOT sektionen. Vælg Click to Reveal Token.
-
En lang række af tegn skal nu vises i stedet for det førnævnte link. Klik på Copy for at sende dette token til din udklipsholder.
-
Indsæt dette token i en tekstfil for nu ved hjælp af Notesblok, TextEdit eller et lignende program.
Du bør slette denne fil og fjerne den fra din papirkurv eller papirkurv, når du har gennemført dette selvstudie.
Coding Your Bot
Du har oprettet en bot og tilføjet den til din server. Dernæst kommer den sjove del, faktisk at kode din bot til at gøre, hvad du vil have den til.
- Start applikationen Kommandoprompt (Windows) eller Terminal (macOS).
-
Skriv følgende tekst ved prompten, og tryk på Enter eller Return på dit tastatur: mkdir discord-test -bot
Du kan erstatte discord-test-bot med et navn efter eget valg.
-
Næste, skriv følgende kommando for at gå ind i din nyoprettede mappe: cd discord-test-bot
-
Kommandoprompten skulle nu være opdateret og viser navnet på din bots mappeprojektmappe. Indtast følgende, og tryk på Enter eller Retur: npm init -y
-
En fil ved navn package.json skulle nu oprettes i din projektmappe, som vist på ovenstående skærmbillede. Skriv følgende ved din kommandoprompt, og tryk på Enter eller Retur: npm install --save discord.js
-
En liste over WARN-meddelelser kan nu blive vist, som kan ignoreres, så længe der ikke vises nogen fejl (ERR), og meddelelsen nederst i din kommandoprompt eller terminalvindue lyder "tilføjet 7 pakker" eller "tilsat 8 pakker". Skriv følgende, og tryk på Enter eller Retur for at oprette auth.json-filen: touch auth.json
Hvis du modtager en fejlmeddelelse, når du prøver at bruge touch-kommandoen, skal du muligvis først installere den ved at indtaste følgende syntaks ved din kommandoprompt: npm install touch-cli -g
-
Der vil være en bekræftelsesmeddelelse, der bemærker, at denne fil blev oprettet, men du kan skrive ls -al (macOS) eller dir (Windows) for at se indholdet af dit projektbibliotek og selv bekræfte, at auth.json faktisk er opført.
- Start din foretrukne kode eller teksteditor såsom Atom, Notepad eller TextEdit, og naviger til din nye projektmappe.
-
Åbn auth.json-filen, og indtast teksten vist på det medfølgende skærmbillede, og erstat AUTH-TOKEN med den autentificeringstokenstreng, som du gemte tidligere i selvstudiet. Gem filen, når du er færdig.
Du skal kopiere og indsætte hele godkendelsesstrengen inden for de viste anførselstegn. Hvis du mangler blot ét tegn, vil din bot ikke fungere som forventet.
- Vend tilbage til editoren, og opret en ny fil i din projektmappe med navnet bot.js.
-
Bot.js-filen vil indeholde koden, der dikterer din bots adfærd, hvilket er helt op til dig. Til formålet med denne vejledning anbefaler vi dog at bruge følgende kode og teste din bot ende-til-ende for at sikre, at alt fungerer som forventet. Du kan derefter gå tilbage og redigere indholdet af bot.js, som det passer dig.
const Discord=require('discord.js');
const client=new Discord. Client();
const auth=require('./auth.json');
client.on('ready', ()=> {
console.log(`Logget ind som ${client.user.tag}!`);
});
client.on('message', msg=> {
if (msg.content===‘hej’) {
msg.reply(‘hej!’);
}
});
client.login(auth.token);
Denne eksempelkode vil skrive en besked til kommandolinjekonsollen, når botten kaldes, bekræfter et vellykket login og indeholder dit brugertag.
- Gem din opdaterede bot.js fil.
- Vend tilbage til kommandoprompt eller terminal, og skriv følgende for at køre dit bot-script: node bot.js
- Hvis du har gjort alt korrekt indtil dette tidspunkt, bør følgende tekst vises i din kommandoprompt eller terminalvindue: Logget ind som discord-test-bot
Integrer botkoden med din server
Du er næsten der…
- Åbn en browser, og naviger til Discord Developer Portal for din server, log ind om nødvendigt.
-
Vælg den applikation, vi oprettede tidligere fra MINE APPLICATIONS-skærmen, hvis du bliver bedt om det.
-
Klik på OAuth2, placeret i venstre menurude.
-
Rul til bunden af skærmen, indtil du finder SCOPES sektionen. Sæt et flueben ud for muligheden bot ved at klikke på den én gang.
-
Rul ned igen til BOT TILLADELSER sektionen, og sæt flueben ud for hver tilladelsestype, som din individuelle bot muligvis skal bruge for at fungere som forventet. Til formålet med dette eksempel-bot har vi brug for følgende tilladelser: Send meddelelser, Læs meddelelseshistorik
Din specifikke bot vil sandsynligvis have brug for et væsentligt andet sæt tilladelser. Det er vigtigt at forstå, hvad hver enkelt tilladelse indebærer, før du aktiverer den, så botbrugere ikke kan udnytte den til ondsindede formål.
-
Klik Copy, placeret mellem sektionerne SCOPES og BOT REMISSIONS og ledsaget af en lang URL.
- Åbn en ny browserfane, og indsæt denne URL i adresselinjen ved at trykke på Enter eller Return for at indlæse siden.
-
CONNECT TO DISCORD-grænsefladen skulle nu blive vist, som vist på det medfølgende skærmbillede. Klik på Vælg en server, og vælg navnet på din server fra den angivne liste.
-
Klik Authorize.
-
Sæt et flueben ud for I'm not a robot ved at klikke på dets afkrydsningsfelt én gang.
-
Der skulle nu vises en bekræftelsesmeddelelse, som bemærker, at din bot er autoriseret og er blevet tilføjet til din server.
Sådan tester du din bot på serveren
Du kan teste din bot ved at starte Discord-klienten og sende den kommandoer eller beskeder, der svarer til din specifikke kode. I dette eksempel skal du sende ordet hello til din bot, og den skal svare med hi!