Описание
# SoundPoints
**SoundPoints** is a unique plugin for Minecraft servers running on Paper, designed to enhance your world with customizable sound points and mob spawning. It supports both vanilla Minecraft mobs and custom mobs from the **MythicMobs** plugin, allowing you to create immersive atmospheres with eerie sounds or dynamic mob spawns. Perfect for adding surprises or ambiance to your server!
---
## 🚀 Features
- **Customizable Sounds**: Configure Minecraft sounds with adjustable volume, pitch, and hearing radius.
- **Mob Spawning**: Spawn vanilla Minecraft mobs or custom MythicMobs, either a single type or a random selection from a list.
- **Flexible Activation**: Set fixed or random delays between point activations.
- **Mob Behavior Control**: Enable or disable AI and configure mobs to float to the surface with customizable speed.
- **User-Friendly Management**: Intuitive commands with clickable coordinates in chat for easy teleportation.
---
## 📥 Installation
1. Download the `SoundPoints.jar` file from [GitHub Releases](https://github.com/GettSweet/soundpoints/releases) or Modrinth.
2. Place the `.jar` file in your server’s `plugins` folder.
3. Restart your server to generate the `config.yml` file in the `plugins/SoundPoints` directory.
4. Edit `config.yml` to customize sounds, mobs, and points (see example below).
5. (Optional) Install the **MythicMobs** plugin to enable spawning custom mobs.
---
## 🛠️ Requirements
- **Minecraft Version**: 1.21 (or compatible).
- **Server Software**: Paper.
- **Optional Dependency**: MythicMobs (for custom mob spawning).
---
## 🎮 Usage
### Commands
| Command | Description | Permission |
|-----------------------------|------------------------------------------|---------------------|
| `/setsoundpoint` | Creates a point at your current location | `soundpoints.admin` |
| `/pointslist` | Lists all configured points | `soundpoints.admin` |
| `/pointslist ` | Shows details for a specific point | `soundpoints.admin` |
| `/pointslist teleport ` | Teleports to a specific point | `soundpoints.admin` |
| `/reloadsoundpoints` | Reloads the plugin configuration | `soundpoints.admin` |
| `/forceactivate ` | Force-activates a specific point | `soundpoints.admin` |
| `/delpoint ` | Deletes a specific point | `soundpoints.admin` |
### Permissions
- **`soundpoints.admin`**: Grants access to all commands (default for operators only).
Assign permissions using a plugin like LuckPerms:
```
/lp user permission set soundpoints.admin true
```
### Example Configuration
```yaml
points:
'01':
cords: 0.0, 0.0, 0.0, world
type: scream
cooldown: 60
random: true
min_timeing: 30
spawn_mob: true
type_mob:
- salmon
- cod
- SkeletonKing # Custom MythicMobs mob
updraft_to_air: true
speed_updraft: 1.0
ai: true
type_sounds:
scream:
sounds:
- sound: ENTITY_GHAST_SCREAM
tonality: 1.0
volume: 100
hear_blocks: 100
- sound: ENTITY_ALLAY_DEATH
tonality: 0.4
volume: 100
hear_blocks: 100
```
**Explanation**:
- This point triggers every 30–60 seconds.
- Plays a combination of `ENTITY_GHAST_SCREAM` and `ENTITY_ALLAY_DEATH` sounds.
- Spawns a random mob (`salmon`, `cod`, or the custom MythicMobs mob `SkeletonKing`).
- Mobs float to the surface with a speed of `1.0` and have AI enabled.
---
## 🌟 Why Use SoundPoints?
- **Enhance Atmosphere**: Add eerie sounds to caves, oceans, or custom biomes.
- **Dynamic Events**: Create engaging events with vanilla or custom MythicMobs spawns.
- **Player Surprises**: Delight or spook players with unexpected mob spawns and sounds.
---
## 📚 Documentation
For detailed configuration and advanced usage, check the full documentation on the [GitHub Wiki](https://github.com/GettSweet/soundpoints/wiki/%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F-SoundPoints).
---
## 💬 Support
Encounter an issue or have a suggestion?
- Create an issue on [GitHub](https://github.com/GettSweet/soundpoints/).
- Leave a comment on [Modrinth](https://modrinth.com/plugin/soundpoints).
- Contact the developer on [Discord](https://discord.gg/BqUYJ3KGFd).
---
## 📜 License
All rights reserved by the author.