MusicAura-1.0.0-SNAPSHOT

MusicAura
Custom Music • Personal Music Library • Particle Aura • Music Rooms • Economy Integration

MusicAura is a Minecraft music system designed for modern Paper servers that want to bring custom music, visual particle effects, player-owned music, and an in-game music economy into one unified experience.

Players can collect, purchase, play, and gift music while each track can have its own playback settings, hearing radius, particle effect, loop behavior, and visual timeline.

MusicAura uses a server-generated resource pack to deliver custom audio directly inside Minecraft without requiring players to install a separate client-side mod.

Features
Custom Music Playback
Add your own music to the server and make it available to players through MusicAura.

Supported audio formats include:

• .ogg
  
  
• .mp3
  
  
• .wav
  

MP3 and WAV files can be processed through FFmpeg, while OGG files can be used directly.

Each music track can have its own:

• Display name
  
  
• Author
  
  
• Description
  
  
• Category
  
  
• Volume
  
  
• Hearing radius
  
  
• Loop setting
  
  
• Playback category
  
  
• Availability
  
  
• Particle effect
  
  
• Effect timeline
  
  
• Shop price
  

This allows every song to behave differently instead of using one global configuration for every track.

Personal Music Ownership
MusicAura introduces a persistent ownership system for server music.

Players can build their own personal music library and play tracks they own.

Ownership can be:

• Purchased from the music shop
  
  
• Given by an administrator
  
  
• Received from another player
  
  
• Managed through the plugin's ownership system
  

This makes music a collectible feature rather than simply a server-wide command.

Music Shop & Economy
Music can be sold through the server economy.

MusicAura supports economy integration through Vault, allowing administrators to assign individual prices to tracks.

Example:

Ocean Dream
Price: $75,000

Night Love
Price: $100,000

Players can purchase music and permanently add it to their personal library.

The shop can also be integrated with DeluxeMenus for a fully customized GUI experience.

Gift Music to Other Players
Players can share music they own with other players.

/tangnhac <player> <music-id>

The gifting system supports configurable behavior such as:

• Copy ownership
  
  
• Ownership transfer
  
  
• Flat tax
  
  
• Percentage tax
  
  
• Gift cooldown
  

This allows server owners to turn music into a collectible social feature.

Particle Aura System
MusicAura synchronizes visual particle effects with music playback.

Different songs can have completely different visual identities.

Available effect styles include:

• Ring
  
  
• Wave
  
  
• Orbit
  
  
• Aura
  
  
• Helix
  
  
• Expanding effects
  

Example effects include:

• Note particles
  
  
• Hearts
  
  
• Splash particles
  
  
• End Rod
  
  
• Flame
  
  
• Soul
  
  
• Enchant particles
  
  
• Firework particles
  

Effects can be configured per track with parameters such as:

• Radius
  
  
• Height
  
  
• Density
  
  
• Points
  
  
• Speed
  
  
• Particle type
  

Timeline Effects
A song can also change its visual effect during playback.

Example:

timeline:
- start: 0
end: 60
effect: heart_orbit

- start: 60
end: 200
effect: note_ring

This allows a single song to have multiple visual phases instead of displaying the same particle effect from beginning to end.

Music Rooms
MusicAura includes a music room system designed for multiplayer listening.

Players can access the music room interface to:

• Create rooms
  
  
• Join rooms
  
  
• Leave rooms
  
  
• Invite other players
  
  
• Manage room participants
  

This provides a foundation for social music experiences where players can listen together.

Resource Pack System
MusicAura automatically builds the resource pack required for custom audio.

The plugin includes resource pack management and distribution functionality, allowing server administrators to configure how the generated pack is provided to players.

Supported deployment modes include:

• External URL
  
  
• Built-in HTTP server
  
  
• Disabled
  

The resource pack can also be automatically sent to players when they join the server.

Automatic Audio Import
Adding new music does not require manually building resource-pack files.

Place your audio files inside:

plugins/MusicAura/inbox/

Then use:

/nhac zip

MusicAura can import the available audio files and rebuild the resource pack.

For servers using MP3 or WAV files, FFmpeg can automatically process the audio into the required format.

Music Request System
Players can request new music directly from the server.

/yeucau <song name>

Administrators can then review and manage submitted requests.

The request system includes:

• Request limits
  
  
• Cooldowns
  
  
• Pending request management
  
  
• Approve
  
  
• Deny
  
  
• Complete
  

This gives server staff a controlled way to manage community music requests.

GUI Support
MusicAura includes GUI support for the player music library and music rooms.

The music library can display:

• Owned music
  
  
• Music name
  
  
• Category
  
  
• Author
  
  
• Current playback
  
  
• Play button
  
  
• Stop button
  
  
• Pagination
  

MusicAura can also work alongside DeluxeMenus for completely customized server interfaces.

PlaceholderAPI Support
MusicAura provides PlaceholderAPI integration for use with other plugins and custom GUIs.

Available placeholders include information such as:

%musicaura_owns_<id>%
%musicaura_price_<id>%
%musicaura_name_<id>%
%musicaura_author_<id>%
%musicaura_category_<id>%
%musicaura_shop_<id>%
%musicaura_ready_<id>%
%musicaura_playing%
%musicaura_is_playing%
%musicaura_owned_count%
%musicaura_balance%
%musicaura_has_economy%
%musicaura_pack_ready%

This makes MusicAura easy to integrate into existing server menus and systems.

Performance Controls
MusicAura includes configurable limits designed for multiplayer servers.

Administrators can control:

• Maximum active music sessions
  
  
• Particle update interval
  
  
• Maximum particles per session
  
  
• Global particle limits
  
  
• Music hearing radius
  
  
• Playback behavior
  

For example, the plugin can automatically stop playback when:

• A player quits
  
  
• A player dies
  
  
• A player changes to a configured disabled world
  
  
• Playback is manually stopped
  

These controls help server owners balance visual effects and network performance.

Database
MusicAura uses persistent storage for player music ownership and related data.

SQLite is available as the default database option.

MySQL and MariaDB configurations are also supported.

Automatic database backups can be configured with:

• Backup interval
  
  
• Retention count
  
  
• Backup storage
  

Admin Tools
MusicAura provides administrative commands for managing the entire music system.

Administrators can:

• Create music
  
  
• Edit music
  
  
• Delete music
  
  
• Import audio
  
  
• Import multiple audio files
  
  
• Rebuild the resource pack
  
  
• Set music prices
  
  
• Enable or disable shop listings
  
  
• Give music to players
  
  
• Remove music from players
  
  
• Manage music requests
  
  
• Check plugin status
  
  
• Create database backups
  
  
• Reload configuration
  

Example:

/nhac list
/nhac info <id>
/nhac create <id>
/nhac edit <id>
/nhac delete <id>
/nhac import <file>
/nhac zip
/nhac rebuildpack
/nhac give <player> <id>
/nhac remove <player> <id>
/nhac status
/nhac backup

Integrations
MusicAura is designed to work with popular Paper server plugins.

Supported Integrations

• Vault — Economy
  
  
• PlaceholderAPI — Placeholders and external GUI integration
  
  
• DeluxeMenus — Custom music shop and library interfaces
  
  
• FFmpeg — MP3/WAV audio processing
  

Integrations are optional where possible, allowing the core music system to remain lightweight.

Example Music Configuration
A music track can be configured like this:

ocean_dream:
id: ocean_dream
display_name: "<blue>Ocean Dream"
author: "Server Music"
category: Chill

shop:
enabled: true
price: 75000
currency: money

playback:
volume: 1.0
radius: 30
loop: true
category: MUSIC

particle:
enabled: true
preset: ocean_wave
particle: SPLASH
radius: 2.0
height: 1.0
density: 10
speed: 0.05

access:
type: OWNERSHIP

This makes MusicAura highly configurable without requiring server owners to modify plugin code.

Commands
Player Commands
Command Description
/phatnhac Open your music library / play owned music
/stopnhac Stop current music and effects
/muanhac <id> Purchase a music track
/yeucau <song> Submit a music request
/tangnhac <player> <id> Gift owned music
/nhacphong Open the music room interface
/phong Open the music room interface
Administration
/nhac list
/nhac info <id>
/nhac create <id>
/nhac edit <id>
/nhac delete <id>
/nhac import <file>
/nhac zip
/nhac rebuildpack
/nhac give <player> <id>
/nhac remove <player> <id>
/nhac requests
/nhac status
/nhac backup
/nhac reload

Permissions
musicaura.use
musicaura.play
musicaura.request
musicaura.gift

musicaura.admin
musicaura.admin.music
musicaura.admin.import
musicaura.admin.give
musicaura.admin.requests
musicaura.admin.resourcepack

musicaura.bypass
musicaura.bypass.limit

Requirements
Server

• Paper
  
  
• Java 25
  
  
• Minecraft version matching the plugin build
  

Optional Dependencies

• Vault
  
  
• PlaceholderAPI
  
  
• DeluxeMenus
  
  
• FFmpeg
  

A resource pack is required for players to hear custom MusicAura audio.

Installation
1. Install MusicAura
Place:

MusicAura.jar

inside:

plugins/

Start the server once.

2. Add your music
Place .ogg, .mp3, or .wav files into:

plugins/MusicAura/inbox/

3. Import the music
Run:

/nhac zip

MusicAura will process the audio and rebuild the required resource pack.

4. Configure resource pack delivery
Set your resource pack URL in:

resource-pack:
mode: EXTERNAL_URL
url: " https://your-domain.com/resourcepack.zip"

5. Reload MusicAura
/nhac reload

Your server is now ready to use custom music.

Why MusicAura?
MusicAura is built around the idea that music should be more than background audio.

Instead of simply playing a sound to a player, MusicAura connects:

Music → Ownership → Economy → Visual Effects → Social Rooms → Resource Pack

This allows server owners to build a complete music ecosystem around their server's gameplay and community.

Whether you are running an SMP, RPG, survival, chill, social, or custom server, MusicAura provides the foundation for turning custom music into an interactive part of the Minecraft experience.

Compatibility
Platform: Paper
Java: 25
Database: SQLite / MySQL / MariaDB
Economy: Vault
Placeholders: PlaceholderAPI
GUI: DeluxeMenus
Audio Processing: FFmpeg

MusicAura is currently in active development. Features, configuration formats, and APIs may change between releases.