Écouter de la musique en vocal avec HurixBot

Une soirée jeux, un salon de révisions, un live entre potes : la musique, ça rassemble ! 🎶 Le module Musique permet à HurixBot de rejoindre ton salon vocal pour jouer des titres YouTube, SoundCloud et bien d'autres, avec une file d'attente, des boutons de contrôle, des filtres audio et des playlists partagées créées depuis le dashboard.

1. Activer le module

Sur le dashboard, choisis ton serveur puis ouvre Musique dans la rubrique Modules du menu de gauche. Active le module avec l'interrupteur en haut de la page.

2. Régler la lecture

Dans la section Lecture :

• Volume par défaut (%) : le volume au lancement d'une lecture, de 0 à 200 (80 par défaut).
• Taille max de la file : le nombre maximum de pistes en attente (200 par défaut).
• Durée max par piste (sec) : refuse les pistes plus longues. 0 = aucune limite.
• Déconnexion si salon vide (sec) : le délai avant que HurixBot quitte un salon vocal où il n'y a plus personne (60 secondes par défaut).

Dans Annonces, l'option Annoncer la piste en cours envoie un message avec les boutons de contrôle à chaque nouvelle piste, dans le salon où la musique a été lancée.

3. Choisir qui contrôle la musique

• Permissions DJ : ajoute des Rôles DJ pour réserver le contrôle du lecteur (pause, passer, volume, boucle…) à certains membres. Laisse vide pour que tout le monde puisse contrôler. Tout le monde peut toujours ajouter des titres avec /play.
• Salons vocaux autorisés : limite la musique à certains salons vocaux. Laisse vide pour autoriser tous les salons.

4. Lancer une lecture

Rejoins un salon vocal, puis tape :

/play query:daft punk one more time

• query accepte une recherche par titre ou un lien. Les liens YouTube, SoundCloud, Spotify, Deezer, Apple Music, Twitch, Bandcamp et Vimeo sont acceptés.
• L'option plateforme choisit où chercher (YouTube par défaut, ou SoundCloud). Pour Spotify ou Apple Music, colle plutôt directement le lien.
• Un lien de playlist ajoute toutes ses pistes d'un coup, dans la limite de la taille de la file.

Si HurixBot joue déjà dans un autre salon vocal, rejoins ce salon pour ajouter des titres.

5. Contrôler le lecteur

Sous chaque annonce de piste, cinq boutons : ⏯️ pause / reprise, ⏭️ piste suivante, ⏹️ arrêt, 🔁 boucle (désactivée, piste actuelle, file complète) et 🔀 mélange.

Pour utiliser les boutons et les commandes de contrôle, tu dois être dans le même salon vocal que HurixBot (et avoir un rôle DJ s'il y en a).

6. Créer des playlists du serveur

Dans Playlists du serveur, clique sur Nouvelle playlist :

1. Donne-lui un Nom et, si tu veux, une Description.
2. Choisis la Source par défaut pour la recherche (YouTube ou SoundCloud), puis Créer.
3. Clique sur Gérer : recherche un titre ou colle une URL pour ajouter des pistes, puis réorganise-les avec Monter et Descendre, ou enlève-les avec Retirer.

Les playlists sont partagées par tout le serveur. Pour en lancer une : /playlist play nom:<playlist>, ou commence à taper son nom dans /play, elle apparaît dans les suggestions avec l'icône 📋.

Commandes

Pour tout le monde :

• /play query:<titre ou lien> : ajoute un titre ou une playlist à la file. Option plateforme.
• /playlist play nom:<playlist> : lance une playlist du serveur.
• /playlist list : liste les playlists du serveur.
• /playlist info nom:<playlist> : affiche le détail d'une playlist.
• /music queue : affiche la file d'attente.
• /music nowplaying : affiche la piste en cours.

Pour contrôler (même salon vocal que le bot, et rôle DJ s'il y en a) :

• /music pause / /music resume : met en pause ou reprend.
• /music skip : passe à la piste suivante.
• /music stop : vide la file et quitte le salon vocal.
• /music volume level:<0-200> : règle le volume.
• /music seek seconds:<secondes> : saute à une position dans la piste.
• /music jump position:<n> : saute directement à une piste de la file (1 = la prochaine).
• /music remove position:<n> : retire une piste de la file.
• /music shuffle : mélange la file.
• /music clear : vide la file sans couper la piste en cours.
• /music loop mode:<off, track ou queue> : désactive la boucle, répète la piste ou toute la file.
• /music filter mode:<filtre> : applique un filtre audio : bassboost, nightcore, vaporwave, lofi, karaoke, tremolo ou vibrato. off (reset) retire tous les filtres.

Erreurs fréquentes

• « Tu dois être dans un salon vocal » : rejoins un salon vocal avant de lancer /play.
• « Ce salon vocal n'est pas autorisé pour la musique » : le salon ne fait pas partie des Salons vocaux autorisés.
• « Action réservée aux DJ » : il te manque un des rôles DJ.
• « La file d'attente est pleine » : attends que des pistes passent ou augmente la Taille max de la file.
• Une piste est refusée : elle dépasse la Durée max par piste.

Pour aller plus loin : laisse tes membres créer leur propre salon vocal avec le tutoriel Salons vocaux temporaires.