Bienvenue sur Music Interface
Votre lecteur musical dans Minecraft : gérez vos morceaux, vos playlists et les musiques adaptées au jeu.
Ce mod ajoute un lecteur et un gestionnaire de bandes-son, pas des chansons. Pour afficher des pistes, activez un Music Pack, c'est-à-dire un resource pack Minecraft contenant vos propres fichiers audio OGG et des définitions JSON. Les musiques vanilla et celles des autres mods ne sont pas automatiquement importées dans la bibliothèque.
Commencer en cinq étapes
- Téléchargez la bonne version du mod selon Minecraft et votre loader.
- Installez ses dépendances.
- Ajoutez un Music Pack compatible dans
resourcepacks/puis activez-le. - Ouvrez le lecteur depuis le raccourci configuré dans les contrôles.
- Si la bibliothèque est vide, rechargez les ressources avec
F3+Tou lancez/musicinterface_diagnostics.
Lire le tutoriel complet de création d'un Music Pack →
Bibliothèque et organisation
Le lecteur permet de chercher des pistes, naviguer par artiste ou album, gérer les favoris et les playlists, afficher l'historique récent, changer de vue et contrôler la lecture.
- Playlists : création, ordre des pistes, lecture aléatoire et répétition.
- Partage : codes de partage et import de playlists. Le code transmet la liste de pistes, jamais les fichiers son.
- Queue : Play Next, Add to Queue, réorganisation et sauvegarde en playlist. La persistance de la file est activée par défaut.
- Radio : lecture continue de pistes proches d'un morceau de référence, tant que des titres compatibles sont disponibles.
Radio, Smart Mixes et statistiques
Track Radio utilise les genres, tags, moods, artiste, album, Music Pack et préférences locales. Made for You propose quatre sélections : For You, On Repeat, Rediscover et Current Context. Le profil d'écoute reste enregistré localement, sans envoi de télémétrie par le code du profil.
À quoi servent les moods ?
Les moods décrivent l'ambiance d'une chanson, par exemple calm ou energetic. Avec tags, genres et energy, ils améliorent les recommandations et la Radio. Ils ne déclenchent pas à eux seuls la musique d'un combat, d'un biome ou du menu. Pour cela, utilisez les règles contexts décrites dans le guide Music Pack.
Notifications de lecture
Les notifications Now Playing affichent la pochette, le titre et éventuellement l'artiste et l'album. Leur couleur de contour provient automatiquement de la pochette, avec une couleur de secours si aucune image n'est utilisable. Il n'existe pas de paramètre séparé pour choisir manuellement cette couleur. En revanche, la position, l'animation et les métadonnées affichées sont réglables.
Versions et documentation
Consultez les notes de version et la compatibilité avant de télécharger un fichier. Ce wiki concerne Music Interface v2.0.
Installation
Le bon JAR, les bonnes dépendances et un Music Pack activé.
Installation pas à pas
- Ouvrez la liste des fichiers CurseForge ou Modrinth.
- Choisissez exactement votre version Minecraft et votre loader : Fabric ou NeoForge.
- Installez les dépendances affichées pour ce fichier et placez les JAR dans
mods/. - Lancez Minecraft. Installez votre Music Pack dans
resourcepacks/puis activez-le. - Ouvrez le lecteur depuis les contrôles Minecraft. Consultez les diagnostics si aucune piste n'apparaît.
Le code source v2.0 possède neuf cibles Minecraft et deux loaders, soit 18 combinaisons configurées. Vérifiez toujours la page du téléchargement correspondant à votre version.
Un fichier CurseForge (identifiant 9004584) est nommé musicinterface-fabric-1.21.1-2.0.jar, mais sa fiche indique Minecraft 1.21.5. Cette incohérence ne prouve pas sa compatibilité avec l'une ou l'autre version. Vérifiez les métadonnées du JAR avant installation.
Versions ciblées par le code source
| Versions Minecraft | Loaders | Java pour compilation |
|---|---|---|
| 1.21.1, 1.21.4, 1.21.5, 1.21.8, 1.21.10, 1.21.11 | Fabric et NeoForge | Java 21 |
| 26.1, 26.2, 26.3 | Fabric et NeoForge | Java 25 |
Dépendances déclarées pour Minecraft 1.21.1
| Fabric | NeoForge |
|---|---|
| Fabric Loader ≥ 0.18.4, Fabric API, Architectury API ≥ 13.0.8 | NeoForge 21.1.x, Architectury API ≥ 13.0.8 |
| Cloth Config recommandé pour l'écran de réglages | Cloth Config facultatif pour l'écran de réglages |
Les dépendances peuvent varier selon la version. Consultez les informations du fichier que vous installez. Un mod compilé ne signifie pas qu'un test en jeu a été réussi.
Configuration
Configurez la lecture automatique, les contextes et les notifications.
Comment fonctionne la musique contextuelle ?
Métadonnées : tags, genres, moods et energy servent à classer les chansons et alimentent la Radio et les recommandations. Contextes : des règles dans music_data.json ou music_contexts.json déclenchent la sélection automatique selon dimension, biome, tags de biome, jour/nuit, météo ou combat Cobblemon.
Une règle correspond quand toutes ses conditions renseignées sont respectées. Le scheduler utilise la priorité numérique la plus élevée parmi les règles compatibles. Le mode de transition par défaut est Finish : une piste contextuelle déjà jouée n'est pas interrompue immédiatement. Choisissez Crossfade pour permettre la transition des pistes gérées par le contexte.
Modes de lecture
- Ambient : musique espacée de pauses, par défaut de 15 à 90 secondes entre les morceaux.
- Continuous : pas de délai volontaire entre les pistes.
- World join silence : délai initial de 10 secondes par défaut en entrant dans un monde.
- Queue prioritaire : les morceaux ajoutés manuellement passent avant les sélections automatiques.
Musique de l'écran titre
La musique personnalisée de menu est activée par défaut. Un champ titleScreenTrackId vide signifie une sélection possible dans la bibliothèque, pas une désactivation. Pour choisir une piste précise, renseignez son ID. Pour arrêter la musique personnalisée du menu, désactivez l'option correspondante. La musique vanilla du menu possède un réglage distinct.
Combats Cobblemon
Le mode par défaut cobblemonBattleMode = external laisse la priorité au système audio du combat. Pour une piste personnalisée, sélectionnez context, activez les contextes, puis définissez une règle "combat": true sur la piste. Un simple tag battle ne suffit pas.
Quelques valeurs par défaut importantes
| Paramètre | Valeur initiale | Fonction |
|---|---|---|
playbackMode | ambient | Lecture espacée |
contextMusicEnabled | true | Musique contextuelle active |
contextTransitionMode | finish | Attend la fin du morceau |
contextFallbackMode | library | Retour à la bibliothèque normale |
cobblemonBattleMode | external | Priorité au son de combat externe |
persistQueue | true | Conserve la file au redémarrage |
worldJoinSilenceSeconds | 10 | Silence initial après connexion |
toastPosition | TOP_RIGHT | Position de la notification |
toastAnimation | SLIDE | Animation d'apparition |
vanillaMusicEnabled | false | Musique vanilla en jeu |
L'écran de paramètres utilise l'intégration optionnelle de Cloth Config. Les configurations locales sont enregistrées dans config/musicinterface/.
Commandes
Distinguez bien les commandes du client de celles du serveur.
Commandes côté client
| Commande | Fonction |
|---|---|
/musicinterface_diagnostics | Diagnostic des Music Packs, conflits, pistes et avertissements |
/musicinterface_open_resourcepacks | Ouvre le dossier des resource packs |
/musicinterface_import_playlist <code> | Importe une playlist depuis son code |
/musicinterface_import_shared <token> | Importe un jeton de partage reçu |
/musicgui | Ouvre le lecteur sur Fabric |
/musicinterface | Ouvre le lecteur sur NeoForge |
/musicinterface diagnostics | Alias diagnostic local NeoForge |
Commandes serveur, niveau de permission 2
| Commande | Fonction |
|---|---|
/musicinterface list | Liste les identifiants de pistes connus du serveur |
/musicinterface search <text> | Recherche de pistes |
/musicinterface play <id> <targets> | Demande la lecture d'une piste à certains joueurs |
/musicinterface stop <targets> | Arrêt de la lecture |
/musicinterface stop <targets> fade | Arrêt en fondu |
Les commandes serveur nécessitent l'installation compatible côté serveur et peuvent nécessiter la présence du mod côté client. Elles n'envoient pas les fichiers OGG aux joueurs.
Music Packs
Créez une bibliothèque musicale complète sans écrire de code Java.
Le guide présente la structure des dossiers, les fichiers OGG, sounds.json, music_data.json, les pochettes, la musique de menu, les contextes et les combats Cobblemon.
Structure minimale
resourcepacks/
Mon Music Pack/
pack.mcmeta
assets/
musicinterface/
music_data.json
sounds.json
sounds/
custom/
ma_piste.oggUn modèle sans audio n'est pas une musique
Le bouton de génération de modèle crée l'arborescence, les fichiers JSON et une pochette d'exemple, mais aucun véritable fichier OGG. Ajoutez votre propre audio, déclarez-le dans sounds.json puis associez une piste dans music_data.json.
Plusieurs Music Packs à la fois
Les packs actifs, en dossier ou en ZIP, peuvent être combinés. Si deux packs réutilisent le même ID de piste, le pack ayant la priorité la plus élevée l'emporte. Les diagnostics signalent les doublons. Conservez donc des identifiants uniques par piste.
Créer des musiques contextuelles
Associez des règles contexts dans le JSON. Les moods et les tags décrivent l'ambiance mais n'établissent pas le déclencheur. Des exemples JSON complets sont fournis dans le guide français.
Résolution des problèmes
Les vérifications concrètes avant de demander de l'aide.
Pourquoi ma bibliothèque est vide ?
Music Interface n'installe aucune piste par défaut. Activez un Music Pack contenant un music_data.json valide et des sons OGG. Rechargez les ressources avec F3+T, puis lancez /musicinterface_diagnostics.
Une musique apparaît mais reste silencieuse
Contrôlez le chemin OGG, l'événement dans sounds.json et la valeur sound associée dans music_data.json. Une simple piste avec un titre ne garantit pas qu'un son existe.
Pourquoi une musique de combat ne démarre pas ?
Le mode Cobblemon est external par défaut. Sélectionnez context et définissez des règles avec combat: true. Le tag battle seul n'active rien.
Pourquoi les moods ne déclenchent-ils pas les événements ?
Ils alimentent la Radio et les recommandations. Pour déclencher une musique à un moment particulier, utilisez les règles de contexte et leurs priorités.
Comment changer la couleur du cadre des notifications ?
La couleur du contour est extraite automatiquement de la pochette. Il n'existe pas d'option manuelle de couleur. Vous pouvez modifier la pochette, la position ou l'animation de la notification.
Deux Music Packs définissent la même piste
Chaque piste doit idéalement avoir son ID unique. Si deux packs partagent un ID, la version du pack prioritaire remplace l'autre. Consultez les diagnostics pour repérer les doublons.
Le modèle est indiqué comme incompatible
La génération utilise pack_format: 34 comme base. Adaptez pack.mcmeta à votre version exacte de Minecraft.
Mes réglages ou playlists ont disparu
Les données sont locales dans config/musicinterface/. Sauvegardez ce dossier avant de changer d'instance ou de réinstaller le jeu. Les statistiques et la file persistante peuvent être stockées séparément des playlists.
Que transmettre pour obtenir du support ?
Votre version exacte de Minecraft, Fabric ou NeoForge, le nom du JAR Music Interface, les dépendances installées, le pack, les étapes de reproduction et les extraits utiles de latest.log après suppression des informations privées.
Rejoignez le Discord Our Story Network.