# 🦢 GooseSync - 高延迟补偿插件
> **Minecraft 服务器上高延迟玩家的终极解决方案**
[](https://www.minecraft.net/)
[](https://adoptium.net/)
[](LICENSE)
## 🌟 概述
GooseSync 是一款革命性的Minecraft插件，旨在消除高延迟游戏带来的挫败感。无论您是在全球范围内的服务器上游戏，还是遇到网络问题，GooseSync 都能够智能地补偿与延迟相关的问题，为所有玩家提供流畅且公平的游戏体验。
## ✨ 主要特性
### 🥊 **战斗补偿系统**
- **智能后坐力调整**: 自动调整玩家的后坐力，基于 Ping 值
- **伤害时间优化**: 在战斗场景中补偿延迟
- **速度稳定**: 防止高 Ping 玩家遭受不公平的后坐力
- **实时 Ping 值监控**: 持续跟踪玩家的网络连接质量
### 🍎 **消耗速度增强**
- **金苹果优化**: 为高 Ping 玩家减少金苹果的消耗延迟
- **食物消耗加速**: 改善进食机制，提升游戏流畅度
- **智能延迟减少**: 自动调整基于 Ping 值阈值
### 🔮 **末影珠优化**
- **冷却时间减少**: 为高 Ping 玩家减少末影珠的冷却时间
- **传送补偿**: 更流畅的末影珠使用体验
- **公平游戏平衡**: 在提升可访问性的同时，保持游戏平衡
### 🧪 **药水投掷增强**
- **投掷速度优化**: 为高 Ping 玩家提供更快的药水投掷速度
- **溅射药水支持**: 增强所有药水类型的机制
- **时间补偿**: 减少药水使用时的延迟
### 📊 **高级 Ping 值监控**
- **实时跟踪**: 每秒监控玩家的 Ping 值
- **自动补偿**: 根据 Ping 值等级应用优化
- **性能指标**: 为服务器管理员提供详细的日志记录
## 🚀 安装
### 前置条件
- **Minecraft 服务器**: 1.16.x - 1.21.x (Spigot, Paper, Purpur 或任何 Bukkit 驱动的服务器)
- **Java**: 8 及更高版本 (推荐使用 Java 17+ 以获得最佳性能)
- **权限**: 服务器重启能力
### 快速安装指南
1. **下载插件**
```bash
# 从发布版下载 goosesync-1.0.0.jar
```
2. **安装到您的服务器**
```bash
# 将 JAR 文件放入您的插件文件夹
cp goosesync-1.0.0.jar /path/to/your/server/plugins/
```
3. **启动您的服务器**
```bash
# 重启您的服务器以加载插件
./start.sh
```
4. **验证安装**
```
[INFO] GooseSync 已成功启用！
[INFO] 兼容 Minecraft 版本 1.16 - 1.21.x
```
## ⚙️ 配置
### 默认配置
插件会自动创建一个 `plugins/GooseSync/config.yml` 文件：
```yaml
# 主要插件设置
enabled: true
ping-threshold: 100
knockback-multiplier: 0.8
# 消耗设置
consumption:
enabled: true
delay-reduction: 0.2
# 末影珠设置
pearl:
enabled: true
cooldown-reduction: 0.2
# 药水设置
potions:
enabled: true
throw-delay-reduction: 0.2
```
### 配置选项
| 设置 | 默认 | 描述 |
|---------|---------|-------------|
| `enabled` | `true` | 插件的主开关 |
| `ping-threshold` | `100` | 触发补偿的最小 Ping 值 (毫秒) |
| `knockback-multiplier` | `0.8` | 后坐力减少倍数 |
| `consumption.delay-reduction` | `0.2` | 食物消耗速度提升 (20%) |
| `pearl.cooldown-reduction` | `0.2` | 末影珠冷却时间减少 (20%) |
| `potions.throw-delay-reduction` | `0.2` | 药水投掷速度提升 (20%) |
## 🎮 指令
### 玩家指令
| 指令 | 描述 | 权限 |
|---------|-------------|------------|
| `/gs` 或 `/goosesync` | 显示插件信息 | `goosesync.use` |
| `/gs help` | 显示帮助菜单 | `goosesync.use` |
| `/gs version` | 显示版本详情 | `goosesync.use` |
### 管理员指令
| 指令 | 描述 | 权限 |
|---------|-------------|------------|
| `/gs reload` | 重新加载配置 | `goosesync.reload` |
### 示例用法
```
/gs
╔══════════════════════════════════════════╗
║ GooseSync ║
╠══════════════════════════════════════════╣
║ 一款修复所有延迟问题的插件！ ║
║ 版本: 1.0.0 ║
║ 由 Kyssta 制作！ ║
║ Kyssta 网络: kyssta.xyz ║
║ 服务器版本: 1_21_R0 ║
╚══════════════════════════════════════════╝
```
## 🔧 权限
### 权限节点
| 权限 | 默认 | 描述 |
|------------|---------|-------------|
| `goosesync.use` | `true` | 允许使用基本指令 |
| `goosesync.reload` | `op` | 允许重新加载配置 |
### 权限示例
```yaml
# 给予所有玩家使用基本指令的权限
permissions:
goosesync.use:
default: true
# 仅给予管理员重新加载的权限
permissions:
goosesync.reload:
default: op
```
## 📈 性能影响
### 最小开销
- **CPU 使用率**: 额外的服务器负载 < 1%
- **内存**: 约 2MB RAM 使用
- **网络**: 最小的包开销
- **兼容性**: 与所有主要服务器软件兼容
### 优化功能
- **高效的 Ping 值监控**: 每秒更新，影响最小
- **智能补偿**: 仅当需要时应用 (Ping > 阈值)
- **特定版本的优化**: 为每个 Minecraft 版本定制
## 🌍 服务器兼容性
### 支持的服务器软件
- ✅ **Spigot** - 完全兼容
- ✅ **Paper** - 增强的性能
- ✅ **Purpur** - 完全功能支持
- ✅ **任何 Bukkit 驱动的服务器** - 普遍兼容
### Minecraft 版本支持
| 版本 | 状态 | 功能 |
|---------|--------|----------|
| 1.16.x | ✅ 完全支持 | 基本补偿 |
| 1.17.x | ✅ 完全支持 | 增强的冷却 API |
| 1.18.x | ✅ 完全支持 | 性能优化 |
| 1.19.x | ✅ 完全支持 | 所有功能 |
| 1.20.x | ✅ 完全支持 | 新的战斗系统 |
| 1.21.x | ✅ 完全支持 | 最新优化 |
## 🛠️ 故障排除
### 常见问题
**插件无法启动:**
```
[ERROR] 在启用 GooseSync 时发生错误
```
**解决方案**: 确保您使用的是 Java 8+ 并且支持的 Minecraft 版本 (1.16+)
**指令无法使用:**
```
未知指令。输入 /help 获取帮助。
```
**解决方案**: 安装后重启您的服务器
**没有补偿效果:**
```
[INFO] 检测到服务器版本: 1_21_R0
```
**解决方案**: 检查玩家 Ping 值是否高于阈值 (默认: 100 毫秒)
### 调试信息
通过在 config.yml 中设置 `debug: true` 来启用调试日志记录：
```yaml
debug: true
```
## 📊 指标与监控
### 服务器日志
插件提供详细的日志记录：
```
[INFO] GooseSync 已成功启用！
[INFO] 兼容 Minecraft 版本 1.16 - 1.21.x
[INFO] 检测到服务器版本: 1_21_R0
```
### 性能监控
通过以下方式监控插件性能：
- 服务器控制台日志
- 插件命令输出
- 内置指标
## 🔄 更新与维护
### 自动功能
- **版本检测**: 自动检测服务器版本
- **兼容性检查**: 确保插件与您的设置兼容
- **优雅降级**: 回退到兼容方法
### 手动更新
1. 下载最新版本
2. 停止您的服务器
3. 替换旧的 JAR 文件
4. 启动您的服务器
## 💡 最佳实践
### 服务器配置
- **Java 版本**: 使用 Java 17+ 以获得最佳性能
- **服务器软件**: 推荐使用 Paper 或 Purpur
- **内存**: 确保有足够的 RAM 分配
### 插件设置
- **Ping 阈值**: 根据您的玩家群调整
- **补偿级别**: 从默认设置开始，根据需要进行调整
- **监控**: 启用调试模式以进行故障排除
## 🆘 支持
### 获取帮助
- **文档**: 首先查看此 README
- **问题**: 通过服务器日志报告错误
- **问题**: 提供详细信息联系支持
- **Discord**: [https://discord.gg/5USMkzcuxH](https://discord.gg/5USMkzcuxH)
### 需要的信息
在寻求支持时，请提供：
- Minecraft 版本
- 服务器软件 (Spigot/Paper/Purpur)
- Java 版本
- 插件版本
- 错误日志
- 配置文件
## 📄 许可证
本项目采用 MIT 许可证 - 请参阅 [LICENSE](LICENSE) 文件以了解详细信息。
## 🙏 鸣谢
**由：** Kyssta
**MC 服务器：** [kyssta.xyz](https://kyssta.xyz)
**网站：** [goose.kyssta.xyz](https://goose.kyssta.xyz)
**版本：** 1.0.0
---
**感谢您选择 GooseSync！** 🦢
*今天就改变您的高延迟游戏体验吧。*