GooseSync

# 🦢 GooseSync - Advanced Latency Compensation Plugin > **The Ultimate Solution for High-Ping Players on Minecraft Servers** (https://img.shields.io/badge/Minecraft-1.16%20--%201.21.x-brightgreen.svg)](https://www.minecraft.net/) (https://img.shields.io/badge/Java-8+-orange.svg)](https://adoptium.net/) (https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) ## 🌟 Overview GooseSync is a revolutionary Minecraft plugin designed to eliminate the frustration of high latency gameplay. Whether you're playing on servers across the globe or experiencing network issues, GooseSync intelligently compensates for ping-related delays, providing a smooth and fair gaming experience for all players. ## ✨ Key Features ### 🥊 **Combat Compensation System** - **Smart Knockback Adjustment**: Automatically adjusts knockback based on player ping - **Damage Timing Optimization**: Compensates for latency in combat scenarios - **Velocity Stabilization**: Prevents unfair knockback for high-ping players - **Real-time Ping Monitoring**: Continuously tracks player connection quality ### 🍎 **Consumption Speed Enhancement** - **Golden Apple Optimization**: Reduces consumption delays for high-ping players - **Food Consumption Boost**: Faster eating mechanics for better gameplay flow - **Smart Delay Reduction**: Automatically adjusts based on ping thresholds ### 🔮 **Ender Pearl Optimization** - **Cooldown Reduction**: Reduces ender pearl cooldown for high-ping players - **Teleportation Compensation**: Smoother pearl usage experience - **Fair Play Balancing**: Maintains game balance while improving accessibility ### 🧪 **Potion Throw Enhancement** - **Throw Speed Optimization**: Faster potion throwing for high-ping players - **Splash Potion Support**: Enhanced mechanics for all potion types - **Timing Compensation**: Reduces delay in potion usage ### 📊 **Advanced Ping Monitoring** - **Real-time Tracking**: Monitors player ping every second - **Automatic Compensation**: Applies optimizations based on ping levels - **Performance Metrics**: Detailed logging for server administrators ## 🚀 Installation ### Prerequisites - **Minecraft Server**: 1.16.x - 1.21.x (Spigot, Paper, Purpur, or any Bukkit-based server) - **Java**: Version 8 or higher (Java 17+ recommended for optimal performance) - **Permissions**: Server restart capability ### Quick Installation Guide 1. **Download the Plugin** ```bash # Download goosesync-1.0.0.jar from the releases ``` 2. **Install on Your Server** ```bash # Place the JAR file in your plugins folder cp goosesync-1.0.0.jar /path/to/your/server/plugins/ ``` 3. **Start Your Server** ```bash # Restart your server to load the plugin ./start.sh ``` 4. **Verify Installation** ``` GooseSync has been enabled successfully! Compatible with Minecraft versions 1.16 - 1.21.x ``` ## ⚙️ Configuration ### Default Configuration The plugin automatically creates a `plugins/GooseSync/config.yml` file: ```yaml # Main plugin settings enabled: true ping-threshold: 100 knockback-multiplier: 0.8 # Consumption settings consumption: enabled: true delay-reduction: 0.2 # Ender pearl settings pearl: enabled: true cooldown-reduction: 0.2 # Potion settings potions: enabled: true throw-delay-reduction: 0.2 ``` ### Configuration Options | Setting | Default | Description | |---------|---------|-------------| | `enabled` | `true` | Master toggle for the plugin | | `ping-threshold` | `100` | Minimum ping (ms) to trigger compensation | | `knockback-multiplier` | `0.8` | Knockback reduction multiplier | | `consumption.delay-reduction` | `0.2` | Food consumption speed boost (20%) | | `pearl.cooldown-reduction` | `0.2` | Ender pearl cooldown reduction (20%) | | `potions.throw-delay-reduction` | `0.2` | Potion throw speed boost (20%) | ## 🎮 Commands ### Player Commands | Command | Description | Permission | |---------|-------------|------------| | `/gs` or `/goosesync` | Show plugin information | `goosesync.use` | | `/gs help` | Display help menu | `goosesync.use` | | `/gs version` | Show version details | `goosesync.use` | ### Admin Commands | Command | Description | Permission | |---------|-------------|------------| | `/gs reload` | Reload configuration | `goosesync.reload` | ### Example Usage ``` /gs ╔══════════════════════════════════════════╗ ║ GooseSync ║ ╠══════════════════════════════════════════╣ ║ A Plugin to fix all the latency issues! ║ ║ Version: 1.0.0 ║ ║ Made by Kyssta! ║ ║ Kyssta Network: kyssta.xyz ║ ║ Server Version: 1_21_R0 ║ ╚══════════════════════════════════════════╝ ``` ## 🔧 Permissions ### Permission Nodes | Permission | Default | Description | |------------|---------|-------------| | `goosesync.use` | `true` | Allows use of basic commands | | `goosesync.reload` | `op` | Allows configurat