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/.