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

Sound Formats

• Minecraft sound Example: entity.player.levelup
• Minecraft Sound List: Minecraft Sound List
• Custom Sound Example: iamusic:music_disc.mozart (This is an example of a custom sound made in Items Adder)

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 &6Welcome 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! 🎵