🌟 What's New

✨ Cross-Platform Combat Optimization

• Automatic Player Detection: Seamlessly identifies Bedrock Edition players using Geyser/Floodgate
• Dual Combat Systems: Maintains traditional Java combat for Java players while optimizing for Bedrock players
• Controller-Friendly Combat: Removes attack cooldowns and spam-click penalties for Bedrock players
• Fair PvP Balance: Ensures competitive balance between Java and Bedrock players

🎯 Smart PvP Detection

• Real-Time PvP Monitoring: Automatically detects when players enter PvP combat
• Timeout System: Configurable PvP timeout periods (default: 10 seconds)
• Clean Status Messages: Informative in-game notifications for combat status

⚡ Performance Features

• Attack Speed Optimization: Removes attack speed limitations for Bedrock players
• Attack Indicator Management: Hides Java-specific attack indicators for Bedrock players
• Lightweight Design: Minimal server performance impact

🛠️ Administrative Tools

• In-Game Commands: Easy-to-use commands for server administrators
• Tab Completion: Full tab completion support for all commands
• Real-Time Configuration: Toggle features without server restarts

📋 Features Overview

Feature	Java Players	Bedrock Players
Attack Cooldown	✅ Traditional	❌ Removed
Attack Speed	⚖️ Standard	⚡ Optimized
Attack Indicator	✅ Visible	❌ Hidden
PvP Detection	✅ Monitored	✅ Monitored
Combat Messages	✅ Clean UI	✅ Clean UI

🎮 Commands

Primary Command: /bedrockcombat

• Aliases: /bc, /bcc
• Permission: bedrockcombat.use

Available Subcommands:

• /bedrockcombat help - Show help menu
• /bedrockcombat reload - Reload plugin configuration
• /bedrockcombat status - Check your combat status
• /bedrockcombat version - Display plugin version

🔧 Installation

Requirements:

• Minecraft Server: Spigot/Paper 1.21+
• Java Version: Java 17 or higher
• Dependencies: Geyser + Floodgate (for cross-platform support)

Quick Install:

1. Download bedrock-combat-compat-1.0.0.jar
2. Place in your server's plugins/ folder
3. Restart your server
4. Configure as needed (optional)

🌐 Server Compatibility

✅ Supported Platforms

• Spigot 1.21+
• Paper 1.21+ (Recommended)
• Purpur 1.21+
• Pufferfish 1.21+

🔗 Required for Cross-Platform

• Geyser: Enables Bedrock players to join Java servers
• Floodgate: Allows Bedrock players without Java accounts

🎯 Perfect For

🏰 Server Types

• Survival Servers with mixed player bases
• PvP Servers requiring fair combat balance
• Mini-Game Servers with combat elements
• Cross-Platform Communities

👥 Player Benefits

• Bedrock Players: Smooth, controller-friendly combat experience
• Java Players: Unchanged traditional combat mechanics
• Server Owners: Happy players from both platforms

🔒 Security & Performance

• Zero Security Risks: No external connections or data collection
• Lightweight: Minimal memory footprint (~2MB)
• Efficient: Optimized event handling and player detection
• Stable: Thoroughly tested on production servers

📊 Technical Details

Plugin Information

• Version: 1.0.0
• API Version: 1.21
• Main Class: io.github.chiefboyardee.bedrockcombat.BedrockCombatPlugin
• Dependencies: Soft-depend on Geyser/Floodgate

Permissions

• bedrockcombat.use - Access to basic commands (default: true)
• bedrockcombat.admin - Access to admin commands (default: op)

🐛 Known Issues

Currently, there are no known issues! This is a stable release ready for cross-platform servers!

🔮 Roadmap

Planned Features

• Configuration file for customizable settings
• Per-world combat mode settings
• Advanced PvP statistics tracking
• Integration with popular PvP plugins
• Custom combat animations for Bedrock players

💬 Community & Support

Get Help

• 🐛 Bug Reports: GitHub Issues
• 💭 Discussions: GitHub Discussions
• 📚 Documentation: Wiki