Login Music

A simple Minecraft mod that can play music when players join in the world.

This mod uses AI to assist in development.

Inspired by TartaricAcid's Net Music !

The logo comes from here, designed by juicy_fish.

Functions

• Play music
• Supported file types: mp3, wav
• Music Downloading screen
• Allow download switch
• Play different musics based on the player's name (uuid)
• Show lyrics while playing music

File Structure

All music files are stored in the /LoginMusic folder.

├── {your minecraft version}
    ├── config
    │   ├── login_music-client.toml     # Client config
    │   ├── login_music-server.toml 
    │   └── login_music
    │       └── music.json              # Configure specific music
    │
    ├── LoginMusic                      # Store music files
    │   ├── Lyrics
    │   │   ├── music_1.lrc
    │   │   ├── music_2.lrc
    │   │   └── ...
    │   └── MusicCache
    │       ├── music_1.mp3
    │       ├── music_2.wav
    │       └── ...
    └── ...

Configuration

Music Config

Since mod version 1.2.0, the music config has changed to JSON type, just as shown below.

If you enter a server with this mod, the config file on the server has higher priority, which will cover your custom settings.

{
    "musics": [
        {
            "id": "Default",
            "music": "Default.mp3",
            "musicUrl": "https://www.example.com/example.mp3",
            "lyric": "Default.lrc",
            "lyricUrl": "https://www.example.com/example.lrc" 
        }, {
            "id": "Steve",
            "music": "login_music.mp3",
            "musicUrl": "https://www.example.com/login_music.mp3",
            "lyric": "login_music.lrc",
            "lyricUrl": "https://www.example.com/login_music.lrc"
        }
    ]
}

The music will be downloaded if InternetAccess is set true (the default setting is false), otherwise, the music is played through network audio streams, which may cause a short pause when entering a world.

For example, When a player named Steve enters the world, the mod will try to find the music matched the name Steve (in this case it's login_music.mp3 ) in the folder /LoginMusic first.
Then try to download it from its related url if it has failed before.

Tips: If there is a file with the same name in the folder, it will skip the download even if the file does not match the URL.

If more entries need to be configured, please follow the JSON's rule.

Since mod version 1.2.4, you can open Login Music Config from the main menu if Cloth Config API has been installed.

Client Side

login_music-client.toml is effective only for the client:

[Lyrics]
    #Whether to show lyrics while playing music
    ShowLyrics = true
    #Defines the position of the lyrics
    #Allowed Values: UP, MIDDLE, DOWN
    LyricsPosition = "DOWN"
    #Defines the color of the lyrics you want to use
    LyricsColor = "#FFFFFF"

[Music]
    #Range of music play (a non negative integer)
    # Default: 3
    # Range: 0 ~ 100
    range = 3
    #Whether to allow downloading music from the internet
    InternetAccess = false
    #Whether to play musics from other players
    AllowOthersMusic = true

Server Side

login_music-server.toml:

[Selection]
    #Keywords for music selection (name/uuid)
    #Allowed Values: NAME, UUID
    type = "NAME"

Command

All the commands need permission level 2.