Version 1.4.0 Update Overview

ChristmasMelodies v1.4.0 - Auto-Play on Join & Region Shuffle

New Features:

1. Auto-Play Song on Join:

Automatically play a song when players join your server!

Configuration:

Song name to automatically play when player joins (leave empty to disable)

How It Works:

- When a player joins, the plugin automatically plays the configured song
- Works with all existing features (volume, particles, etc.)
- Leave the song field empty to disable auto-play
- Song plays 1 second after join to ensure player is fully loaded

2. Region Music Shuffle:

Regions can now shuffle through all available songs!

New Command Syntax:

- /xm region set <song> <radius> [loop] [shuffle] - Create a region with optional loop and shuffle

Examples:

/xm region set jinglebells 30 true false # Looping region (no shuffle)
/xm region set jinglebells 30 true true # Looping region with shuffle
/xm region set jinglebells 30 false true # Shuffle only (no loop)

How Region Shuffle Works:

- When shuffle is enabled, the region picks a random song from all available songs
- Each time a song ends (if loop is enabled), it picks another random song
- Creates a dynamic, ever-changing musical experience in your regions
- Perfect for areas where you want variety in the background music

Updated Commands

Region Creation:

- /xm region set <song> <radius> - Basic region (no loop, no shuffle)
- /xm region set <song> <radius> true - Looping region
- /xm region set <song> <radius> true true - Looping region with shuffle
- /xm region set <song> <radius> false true - Shuffle only

Region List:

- Now shows shuffle status with Shuffle indicator
- Shows both loop and shuffle status when enabled

Feature Details:

Auto-Play on Join:

- Configurable via config.yml
- Plays 1 second after player joins (ensures player is loaded)
- Respects player volume settings
- Can be disabled by leaving song field empty
- Works with all existing playback features

Region Shuffle:

- Shuffles through ALL available songs in your songs folder
- Each song plays completely before moving to the next
- Works with loop option - when loop is enabled, it continuously shuffles
- Random selection ensures variety every time
- Perfect for spawn areas, shops, or any region where you want musical variety

Download version 1.4.0 to get these new features!

Version 1.3.0 Update Overview

ChristmasMelodies v1.3.0 - Shuffle Feature

New Feature
Shuffle Mode - Shuffle and play all available songs in random order!

What's New?

- Shuffle Command - Play all your Christmas songs in a completely random order
- Automatic Progression - Songs automatically transition to the next one when finished
- Smart Completion - Shuffle automatically stops when all songs have been played once
- Easy Control - Can be stopped anytime with /xm stop or by playing a specific song

New Command
Usage:
- /xm shuffle - Start playing all songs in random order

Examples:
/xm shuffle # Start shuffle mode
/xm stop # Stop shuffle (or regular playback)
/xm play <song> # Stop shuffle and play specific song

How It Works:

1. When you use /xm shuffle, the plugin:
- Gets all available songs from your songs folder
- Shuffles them into a random order
- Starts playing the first song

2. As each song finishes:
- The plugin automatically starts the next song in the shuffle queue
- Each song plays completely before moving to the next

3. When all songs have been played:
- The shuffle automatically stops
- You can start a new shuffle anytime!

Features:
- Random Order - Every shuffle creates a unique random order
- Complete Playback - Each song plays fully from start to finish
- Volume Control - Uses your personal volume settings
- Particle Effects - Works with particle effects
- Easy Interruption - Stop anytime with `/xm stop`

Technical Details:
- Shuffle queue is checked every second for optimal performance
- Respects all existing volume and particle settings
- Compatible with region music (shuffle works independently)
- Fully integrated with existing playback system

Version 1.2.0 Update Overview

ChristmasMelodies v1.2.0 - Region Looping Feature

New Feature:
Region Music Looping - Region melodies can now loop continuously!

What's New?
- Loop Option for Regions - When creating a music region, you can now enable looping so the song plays continuously while players are in the region
- Automatic Restart - Looping songs automatically restart when they finish
- Persistent Setting - Loop preferences are saved and persist across server restarts
- Visual Indicators - Region list now shows which regions have looping enabled ( Loop)

Command Changes:
The `/xm region set` command now accepts an optional loop parameter:

Usage:
- `/xm region set <song> <radius>` - Create a region without looping (default)
- `/xm region set <song> <radius> true` - Create a region with looping enabled
- `/xm region set <song> <radius> false` - Create a region with looping disabled

Examples:
/xm region set jinglebells 30 true - Creates a looping region
/xm region set silentsnight 20 - Creates a non-looping region (default)

How It Works:
1. When you create a region with looping enabled, the song will play continuously
2. The plugin monitors looping songs and automatically restarts them when they finish
3. Looping only applies while players are within the region - when they leave, the song stops
4. The loop setting is saved to `regions.yml` and persists across restarts

Region List Updates:
The `/xm region list` command now displays loop status:
- Regions with looping enabled show " Loop" in the list
- Makes it easy to see which regions are set to loop

Technical Details:
- Looping is checked every second (20 ticks) for optimal performance
- Only applies to region music (not personal songs)
- Fully backward compatible - existing regions default to no looping
- Loop setting is stored in the region data file

Version 1.1.1 Update Overview

ChristmasMelodies v1.1.1 - Compatibility Fix

Bug Fix

Fixed: Plugin now loads correctly on Minecraft 1.20.1 and all Paper/Spigot versions from 1.8 to 1.21.x

What Was Wrong?
- The api-version: 1.8 field in plugin.yml was causing Paper 1.20.1 to reject the plugin with the error: "Unsupported API version 1.8"

What Changed?
- Removed the restrictive api-version field from plugin.yml
- Plugin now uses the server's default API version handling
- This allows the plugin to work across all supported versions (1.8 - 1.21.x)

ChristmasMelodies v1.1.0 - Volume Control Update!

User Request by Bearably

What's New?

• Volume Command - Players can now control their music volume with /xm volume
• Persistent Settings - Volume preferences are saved and persist across server restarts
• Immediate Updates - Volume changes apply instantly to currently playing songs
• Per-Player Customization - Each player can set their own preferred volume (0-100)
• Volume settings apply to regions as well

I am always open to suggestions, just use the discussion tab!

Tab complete was not working; fixed.

Errors when running the plugin in newer versions of the game would make the songs lag and flood the console; just fixed it.