EterniaMusic

EterniaMusic
EterniaMusic is an EULA-friendly, MIDI-powered music engine for Paper Minecraft servers. It comes with 100+ songs included — ready to play out of the box. Want to play Lord of the Rings music in a bossfight? Gangnam Style in spawn? Now you can!



Music is played privately to each player — only the listener hears it. Each player has their own independent playback session with personal volume control, queue, and crossfading. Drop additional .mid files into the songs/ folder to expand your library.



Features

• MIDI playback engine — parses .mid files and maps 128 MIDI instruments to 16 noteblock sounds with full percussion support
• Per-player playback — independent volume, queue, pause/resume, and loop per player
• Crossfading — smooth linear volume transitions between songs
• WorldGuard region music — auto-play on enter, stop on exit, per-region volume and loop settings
• Ambient blocks — invisible sound emitters with distance-based volume falloff
• Jukebox support — custom music discs that play MIDI songs from jukebox blocks
• GUI song browser — paginated inventory GUI (requires EterniaCore)
• PlaceholderAPI expansion — now_playing, volume, queue_size, song_count, is_playing
• Player preferences — per-player volume and toggle saved to YAML, MySQL, or MongoDB
• Config migration — new config options are auto-merged on updates
• Multi-language support with language file migration
• bStats metrics
• Public MusicAPI for other plugins

Dependencies
Optional
Plugin Purpose
EterniaCore GUI song browser and module system
WorldGuard Region-based music
PlaceholderAPI Placeholder support
EterniaMusic has no required dependencies beyond the Paper API.

Commands
Base command: /music (alias: /song)

Can be configured in config.yml.

Command Description Permission
/music help [page] Show paginated help —
/music play <song> Play a song eternia.music.use
/music stop Stop current playback and clear queue eternia.music.use
/music pause Pause playback eternia.music.use
/music resume Resume playback eternia.music.use
/music skip Skip to the next song in queue eternia.music.use
/music queue [song] Show queue or add a song eternia.music.use
/music list [page] List available songs eternia.music.use
/music nowplaying Show currently playing song eternia.music.use
/music volume <0-100> Set your volume eternia.music.use
/music toggle Toggle music on/off eternia.music.use
/music gui Open the song browser GUI eternia.music.use
/music disc <song> Get a custom music disc item eternia.music.disc
/music reload [all|config|language|songs] Reload configuration (defaults to config) eternia.music.reload
/music addambient <song> <radius> Add ambient block at target eternia.music.manage
/music removeambient Remove ambient block at target eternia.music.manage



Permissions
Permission Default Description
eternia.music.admin op Full access to all admin commands (parent of all below)
eternia.music.use true Use music playback commands
eternia.music.disc op Get music disc items via command or GUI
eternia.music.reload op Reload plugin configuration
eternia.music.manage op Manage ambient blocks
For extensive configuration options, please see the Wiki.

How It Works
MIDI Playback

1. Place .mid or .midi files in the songs/ folder
2. The plugin parses MIDI sequences, mapping instruments and converting tempo to server ticks
3. Each player gets an independent playback session with personal volume and queue
4. Notes are played as noteblock sounds via player.playSound() every tick

Region Music

1. Configure WorldGuard regions in config.yml with a song, loop, and volume
2. A background task checks player regions every second
3. Songs play and crossfade automatically as players move between regions

Support
Please visit our Discord for extensive plugin support.

Wiki
For a full list of commands, permissions, and extensive configuration options, please see the Wiki.

You can also create your own songs at: https://noteblock.studio/ (not affiliated, but great tool)