Een muziekbot voor Discord instellen

Voordat je begint

• Een online bot die aan je server is toegevoegd.
• Een spraakkanaal waarin de bot Verbinden en Spreken heeft, plus een tekstkanaal waarin hij berichten mag sturen en links mag insluiten. Je moet zelf in het spraakkanaal zitten.

1. Weet waar de muziek vandaan komt

   De bot stuurt afspeelverzoeken naar de Lavalink-audioserver van het platform. Zoekwoorden gaan standaard eerst naar SoundCloud. Zonder resultaat volgt een YouTube-zoekopdracht. /play accepteert een titel of een http- of https-link; een lokaal bestandspad is geen geschikte invoer.

   YouTube kan inloggen vereisen of materiaal beperken op leeftijd of regio. Bij een afspeelfout probeert de bot op artiest en titel een SoundCloud-alternatief te vinden. Dat kan een cover of andere opname zijn. De melding in het kanaal vertelt welk nummer gebruikt wordt. Is er geen alternatief, dan wordt het nummer overgeslagen. Niet elke YouTube-link kan gegarandeerd afspelen.

2. Open Muziek voor de juiste server

   Open je bot op het dashboard en ga naar ‘Modules’. Schakel de module in en wacht tot de bot na een eventuele herstart weer online is. Open de instellingen met het tandwiel en kies je ‘Server’. De bot moet online zijn en aan die server zijn toegevoegd om kanalen en rollen te laden. Instellingen worden per server opgeslagen.

   Een volumewijziging of wachtrijlimiet geldt voor de gekozen server. Controleer die keuze opnieuw als je bot meerdere servers bedient.

3. Stel volume, wachtrij en duplicaten in

   Open ‘Afspelen’. ‘Standaardvolume’ loopt van 0 tot 100 en begint op 80. Begin eventueel met 50 of 60. Leden kunnen het volume tijdens een sessie met /volume aanpassen.

   ‘Maximale wachtrijlengte’ begint op 100. Nieuwe en bijgewerkte bots ondersteunen bij Free en Pro maximaal 5.000 nummers in de wachtrij of bij een afspeellijstimport. Een lagere opgeslagen serverlimiet blijft gelden. Zet de waarde op 0 om het plafond van 5.000 te gebruiken. Oudere bots houden hun oude limieten tot ze worden bijgewerkt.

   ‘Duplicaten toestaan’ staat standaard aan. Zet dit uit als hetzelfde nummer maar één keer in de wachtrij mag staan. Ook bij een import worden duplicaten dan overgeslagen.

4. Bepaal wanneer de bot het spraakkanaal verlaat

   Onder ‘Automatisch verlaten’ staat ‘Verlaten wanneer leeg’ standaard aan. Als alle mensen het kanaal verlaten, wacht de bot de ‘Vertrekvertraging (seconden)’ af, stopt de muziek en wist de wachtrij. De vertraging loopt van 5 tot 300 seconden en begint op 30.

   ‘24/7-modus’ houdt de bot ook zonder muziek verbonden en negeert de timer voor een leeg kanaal. Die functie en audiofilters vereisen Pro. Opgeslagen afspeellijsten zijn ook Pro. Laat deze functies voor je eerste test uit. Klik op ‘Instellingen opslaan’ en wacht op ‘Opgeslagen ✓’. Verschijnt er een waarschuwing dat live synchronisatie is mislukt? Herstart de bot vanaf de botpagina en wacht tot die weer online is voordat je test.

5. Speel een nummer en controleer de wachtrij

   Ga zelf naar het spraakkanaal. Gebruik /play met een artiest en titel in het tekstkanaal. Controleer of de bot verbindt en muziek laat horen. Bij ontbrekende machtigingen herstel je Verbinden en Spreken voor het kanaal; geef niet zomaar Beheerder.

   Voeg een tweede nummer toe en bekijk /queue. Gebruik /nowplaying, /pause, /resume en /skip om het afspelen te controleren. /shuffle mengt de wachtende nummers; /loop accepteert off, track of queue. /stop stopt, wist de wachtrij en verbreekt de verbinding. Met de standaardprefix kun je ook !play gebruiken.

   Meldt de bot dat Lavalink niet beschikbaar is? Wacht even en probeer opnieuw voordat je instellingen wijzigt. Werkt een YouTube-link niet, probeer dan artiest en titel of een SoundCloud-link. Pro heft de bronbeperkingen niet op.