Get Current Song

Этот простой мод для FabricMC предоставляет возможность узнать, какая музыкальная композиция сейчас играет в Minecraft, используя специальные команды.

Доступные команды

Мод добавляет в игру две полезные команды:

• /getsong — отображает детальную информацию о текущей мелодии, включая её название и автора
• /getsongid — показывает идентификатор играющей композиции

Стоит отметить, что аналогичные сведения можно посмотреть на экране отладки (F3).

Для разработчиков ресурс-паков

Если ваш ресурс-пак содержит пользовательскую музыку, рекомендуется добавить информацию о композициях в файл getcurrentsong/song_names.json. Структура JSON-объекта выглядит следующим образом:

{
    "name": "название композиции (обязательный строковый параметр)",
    "composer": "имя композитора (обязательный строковый параметр)",
    "soundtrack": "название альбома (необязательный строковый параметр)",
    "trackNumber": "номер трека в альбоме (необязательный числовой параметр)"
}

Важно: если указано название альбома, необходимо также указать номер трека, и наоборот.

Для разработчиков модов

Чтобы подключить API этого мода через Gradle, добавьте следующие строки в ваш build.gradle:

repositories {
    // Другие Maven-репозитории могут располагаться выше или ниже репозитория Modrinth
    maven {
        name = "Modrinth"
        url = "https://api.modrinth.com/maven"
        content {
            includeGroup "maven.modrinth"
        }
    }
}

dependencies {
    modApi "maven.modrinth:getcurrentsong:1.0.1"
}

После подключения API вы сможете получать информацию о музыкальных композициях из ресурс-паков, используя следующие методы класса SongNameDatabase (пакет io.github.gaming32.getcurrentsong):

• SongNameDatabase#isInitialized — возвращает true, если информация о композициях загружена. Попытка чтения из базы данных при значении false может привести к некорректным результатам
• SongNameDatabase#getSong — получает данные о композиции по названию или идентификатору net.minecraft.util.Identifier, возвращая объект SongNameDatabase.SongInfo или null, если композиция не найдена в базе данных