Added

• Support for region sound playback modes:

  • ON_ENTER
  • LOOP
  • INTERVAL 'used for SoundEffects'

• New command to change a region’s playback mode without recreating it:

  /player setmode <region> <mode>
  

• Optional per-player sound toggle:

  /player toggle
  

• Volume and pitch configuration per region (region.yml)

• Loop delay configuration per region (in ticks)

• Tab completion for:

  • Region names
  • Sound modes
  • All valid Minecraft sound IDs, including music discs

Changed

• Region sounds can now replay on a configurable loop or interval instead of only playing once
• Region playback behavior is now configurable after creation
• Region data now persists playback mode and loop timing in regions.yml
• Command structure standardized under /player (aliases preserved)

Fixed

• Looping sounds no longer overlap or layer on top of each other
• Music discs and long-duration sounds now replay correctly
• Sound playback stops reliably when leaving a region or disconnecting
• Active region state now restores correctly after server restart

Notes

• Loop and interval timing is measured in ticks (20 ticks = 1 second)
• Existing regions remain compatible and do not need to be recreated
• If using a long sound in LOOP mode set delay a few seconds longer than the sound

Support for recent update versions.

Soundlooper

Version: 1.0
Author: XCaNiNeX

Overview

Soundlooper is a lightweight plugin that lets you create custom sound regions on your server. Play immersive sounds when players enter specific areas like hubs, spawn points, or mini-games. Configure regions, sounds, and messages easily using commands.

Commands

Set Region Corners

• /looper pos1
  Set the first corner of the region at your location.

  • Example: /looper pos1

• /looper pos2
  Set the second corner of the region at your location.

  • Example: /looper pos2

Create and Manage Regions

• /looper set <name> <sound> [message]
  Create a region with a name, sound, and optional enter message.

  • Example: /looper set spawn_area ENTITY_PLAYER_LEVELUP Welcome to spawn!

• /looper play <name>
  Activate the region.

  • Example: /looper play spawn_area

• /looper stop <name>
  Deactivate the region.

  • Example: /looper stop spawn_area

• /looper remove <name>
  Delete the region permanently.

  • Example: /looper remove spawn_area

Plugin Management

• /looper reload
  Reloads the plugin’s configuration and region data.
  • Example: /looper reload

How It Works

1. Define a region: Use /looper pos1 and /looper pos2 to set corners.
2. Create a region: Use /looper set <name> <sound> [message] to save it.
3. Activate: Use /looper play <name> to start the sound when players enter the region.
4. Manage: Use /looper stop to deactivate, /looper remove to delete.

Configuration

• regions.yml: Stores all defined regions, sounds, and messages.
• active_regions.yml: Tracks active regions across restarts.

Compatibility

• Minecraft Version: 1.21+
• Dependencies: None
  Enjoy creating immersive soundscapes on your server with Soundlooper! 🎵