# SoundPoints
**SoundPoints** 是一个专为运行在 Paper 版本的 Minecraft 服务器上的独特插件，旨在通过自定义声音点和生物生成来增强您的世界。 它支持原版 Minecraft 生物和 **MythicMobs** 插件的自定义生物，让您可以使用怪异的声音或动态生物生成来创建沉浸式氛围。 非常适合为您的服务器添加惊喜或氛围！
---
## 🚀 特性
- **可自定义的声音**: 配置 Minecraft 声音，可调节音量、音调和聆听半径。
- **生物生成**: 生成原版 Minecraft 生物或 MythicMobs 自定义生物，可以是单一类型或从列表中随机选择。
- **灵活的激活**: 设置点激活之间固定或随机延迟。
- **生物行为控制**: 启用或禁用 AI，并配置生物以可自定义速度浮到地表。
- **用户友好的管理**: 具有聊天中可点击坐标的直观命令，便于传送。
---
## 📥 安装
1. 从 [GitHub Releases](https://github.com/GettSweet/soundpoints/releases) 或 Modrinth 下载 `SoundPoints.jar` 文件。
2. 将 `.jar` 文件放入服务器的 `plugins` 文件夹中。
3. 重启服务器以在 `plugins/SoundPoints` 目录中生成 `config.yml` 文件。
4. 编辑 `config.yml` 以自定义声音、生物和点（请参阅以下示例）。
5. (可选) 安装 **MythicMobs** 插件以启用自定义生物生成。
---
## 🛠️ 要求
- **Minecraft 版本**: 1.21 (或兼容)。
- **服务器软件**: Paper。
- **可选依赖**: MythicMobs (用于自定义生物生成)。
---
## 🎮 使用方法
### 命令
| 命令 | 描述 | 权限 |
|-----------------------------|------------------------------------------|---------------------|
| `/setsoundpoint` | 在您的当前位置创建点 | `soundpoints.admin` |
| `/pointslist` | 列出所有已配置的点 | `soundpoints.admin` |
| `/pointslist ` | 显示特定点的详细信息 | `soundpoints.admin` |
| `/pointslist teleport ` | 传送至特定点 | `soundpoints.admin` |
| `/reloadsoundpoints` | 重新加载插件配置 | `soundpoints.admin` |
| `/forceactivate ` | 强制激活特定点 | `soundpoints.admin` |
| `/delpoint ` | 删除特定点 | `soundpoints.admin` |
### 权限
- **`soundpoints.admin`**: 授予访问所有命令的权限（默认仅适用于操作员）。
使用 LuckPerms 等插件分配权限：
```
/lp user permission set soundpoints.admin true
```
### 示例配置
```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
```
**说明**:
- 此点每 30–60 秒触发一次。
- 播放 `ENTITY_GHAST_SCREAM` 和 `ENTITY_ALLAY_DEATH` 组合的声音。
- 生成随机生物 (`salmon`、`cod` 或自定义 MythicMobs 生物 `SkeletonKing`)。
- 生物以速度 `1.0` 浮到地表，并启用了 AI。
---
## 🌟 为什么使用 SoundPoints？
- **增强氛围**: 为洞穴、海洋或自定义生物群系添加怪异的声音。
- **动态事件**: 使用原版或自定义 MythicMobs 生成创建引人入胜的事件。
- **玩家惊喜**: 使用意外的生物生成和声音来让或惊吓玩家。
---
## 📚 文档
有关详细配置和高级用法的说明，请查看 [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) 。
---
## 💬 支持
遇到问题或有建议？
- 在 [GitHub](https://github.com/GettSweet/soundpoints/) 上创建问题。
- 在 [Modrinth](https://modrinth.com/plugin/soundpoints) 上留下评论。
- 在 [Discord](https://discord.gg/BqUYJ3KGFd) 上联系开发者。
---
## 📜 许可
所有权利均由作者保留。