OpenBotsDocs
03 Dashboard04 Fonctionnalites

Musique

Lecture audio en vocal — recherche multi-source, filtres et file d'attente.

🎵 Musique

Le module Musique permet au bot de rejoindre un salon vocal et d'y jouer de la musique, via un serveur audio Lavalink dédié.


🔎 Sources de recherche

/play accepte une recherche libre ou un lien direct, avec plusieurs sources possibles :

  • SoundCloud (par défaut)
  • YouTube
  • YouTube Music
  • Lien direct (URL)

🎚️ Filtres audio

La commande /filtre applique un effet à la lecture en cours :

  • Aucun (normal)
  • Bass boost
  • Nightcore
  • Vaporwave (ralenti)

🔔 Annonces et options avancées

Des blocs optionnels, configurables via le Flows Builder, pour habiller l'expérience musique :

  • XP à l'écoute — donne de l'XP Niveaux aux membres présents en vocal pendant qu'une piste joue.
  • Panneau « en lecture » — annonce/embed affiché quand une nouvelle piste démarre.
  • Fin de file / déconnexion — message envoyé quand la file d'attente se termine et que le bot quitte le vocal par inactivité.
  • Annonce de connexion — message quand le bot rejoint un salon vocal.
  • Vote-skip atteint — annonce quand assez de votes ont été réunis pour passer la piste.
  • Radio en veille relancée — log quand une radio en pause reprend automatiquement.

Alertes destinées au staff ou aux utilisateurs concernés :

  • Alerte erreur de lecture — prévient quand une piste ne peut pas être jouée (source indisponible, erreur Lavalink...).
  • Log d'accès refusé — trace les tentatives d'utiliser la musique sans les permissions requises (salon vocal restreint, rôle manquant...).
  • Alerte recherche bloquée — trace les recherches bloquées par un filtre (mot-clé interdit, source désactivée...).
  • Alerte file pleine — prévient quand la file d'attente a atteint sa taille maximum.

🎮 Commandes

CommandeEffet
/playRecherche et joue (ou ajoute à la file) une musique.
/pause / /resumeMet en pause / reprend la lecture.
/skipPasse à la piste suivante (déclenche un vote si plusieurs personnes sont en vocal).
/filtreApplique un filtre audio à la lecture en cours.
/volumeRègle le volume (0–200).
/npAffiche la piste en cours de lecture.
/playlistAffiche la file d'attente.
/stop_musicStoppe la lecture et vide la file.
/leaveDéconnecte le bot du salon vocal.

[!NOTE] Le module Musique nécessite un serveur Lavalink actif à côté du bot (déjà inclus dans le déploiement standard d'OpenBots).

On this page