🌟 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:
- Download
bedrock-combat-compat-1.0.0.jar - Place in your server's
plugins/folder - Restart your server
- 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
