# Peek - 神奇的旁观者插件 ✨
一个神奇的 Minecraft 插件，允许玩家通过旁观者模式查看其他玩家的视角。
## 🌟 神奇的功能
- 🎯 旁观模式偷看
- 🔮 隐私模式和请求系统
- ⏳ 魔法冷却
- 📊 详细的使用统计
- 🌍 跨维度传送
- 🎵 自定义音效
- 💫 状态保存与恢复
- 📈 PlaceholderAPI 支持
## 📌 重要提示
1. 需要 Paper/Folia 服务器
2. 支持 Minecraft 1.20+
3. 推荐使用 PlaceholderAPI
4. 隐私模式需要玩家在线
5. 跨维度传送可能受服务器设置影响
6. 统计数据会定期自动保存
7. 冷却时间可配置
8. 所有消息均可自定义
9. 所有音效均可自定义
10. 统计变量需要 PlaceholderAPI
## 🎮 快速上手
1. 下载 Peek 的最新版本
2. 将其放置在服务器的 plugins 文件夹中
3. 重启服务器
4. (可选) 安装 PlaceholderAPI 以获得高级变量
## 📜 指令
- `/peek <玩家>` - 开始偷看某位玩家
- `/peek exit` - 停止偷看
- `/peek stats` - 查看统计数据
- `/peek privacy` - 切换隐私模式
- `/peek accept` - 接受偷看请求
- `/peek deny` - 拒绝偷看请求
## 🔑 权限
- `peek.use` - 允许使用基本的偷看功能
- `peek.bypass` - 允许绕过隐私模式
- `peek.nocooldown` - 允许绕过冷却
- `peek.stats` - 允许查看统计数据
## ⚙️ 配置文件
### 基本设置
```yaml
Debug 模式
debug: false
限制设置
limits:
max-peek-distance: 50.0 # 最大偷看距离
cooldown:
enabled: true # 启用冷却
duration: 90 # 冷却持续时间（秒）
隐私设置
privacy:
request-timeout: 30 # 请求超时（秒）
cooldown:
enabled: true # 启用请求冷却
duration: 90 # 冷却持续时间（秒）
音效设置
sounds:
start-peek: ENTITY_ENDERMAN_TELEPORT # 开始偷看音效
end-peek: ENTITY_ENDERMAN_TELEPORT # 结束偷看音效
```
## 📊 PlaceholderAPI 变量
- `%peek_peek_count%` - 玩家使用偷看功能的次数
- `%peek_peeked_count%` - 玩家被偷看的次数
- `%peek_total_duration%` - 总偷看时长（分钟）
- `%peek_is_peeking%` - 玩家当前是否正在偷看
- `%peek_is_private%` - 玩家是否启用了隐私模式
## 🎯 特性细节
1. **旁观模式**
- 自动切换到旁观者模式
- 自动追踪目标
- 超出范围时自动结束
2. **隐私模式**
- 启用时需要请求
- 超时自动取消
- 可配置请求冷却
3. **状态保留**
- 自动保存状态
- 断线后自动恢复
- 支持跨服务器重启
4. **距离限制**
- 可配置最大偷看距离
- 超出时自动结束
- 跨维度传送
## 🎯 技术特性
1. **Folia 支持**
- 完全支持 Folia 多线程
- 优化区域调度器使用
- 安全跨线程操作
2. **状态管理**
- 自动保存玩家状态
- 安全的状态恢复机制
- 跨服务器重启保护
3. **性能优化**
- 异步数据处理
- 优化内存管理
- 自动清理系统
## 🛠️ 开发要求
- Java 21+
- Paper/Folia 1.20+
- PlaceholderAPI (可选)
## 📦 构建工具
- Maven
- Adventure API
- Folia API
- PlaceholderAPI
## 🔄 更新日志
### v2.7
- ✨ 改进了 Folia 支持
- 🔒 增强了状态保存机制
- 🎯 优化了距离检查逻辑
- 🎵 添加了更多音效选项
## 🐛 问题报告
如果您在使用此插件时遇到任何问题，请报告它们：
1. 在 [GitHub Issues](https://github.com/MineSunshineOne/Peek/issues) 上创建一个问题
## 📄 许可证
本项目采用 [MIT](LICENSE) 许可证。
## 🙏 致谢
- [Paper](https://papermc.io/) - 高性能 Minecraft 服务器
- [Folia](https://github.com/PaperMC/Folia) - 多线程服务器
- [MiniMessage](https://docs.adventure.kyori.net/minimessage.html) - 文本格式化库