SyncChats

SyncChats is a professional Minecraft plugin that enables bidirectional synchronization between Minecraft chat and Discord. Designed for production servers, it offers advanced filtering, rate limiting, and statistics tracking features.

Features

Chat Synchronization

• Bidirectional: Minecraft ↔ Discord messages
• Flexible modes: Webhook and Discord Bot
• Rich embeds: Formatted messages with avatars
• Mentions: Discord @mentions support

Security & Performance

• Advanced filtering: Blocked words, custom regex
• Rate limiting: Anti-spam protection
• Smart caching: Performance optimization
• Console logging: Full server console capture to Discord

Discord Integration

• Slash commands: Native Discord commands
• Rich embeds: Beautiful formatted messages
• Event logging: Player join/leave, deaths, achievements
• Bot presence: Dynamic status updates

Statistics & Monitoring

• Real-time stats: Message counts, active users
• Performance metrics: Response times, cache hits
• Event tracking: Server events and player actions
• Discord logs: Complete server monitoring

Installation

1. Download the latest release
2. Place the .jar file in your server's plugins folder
3. Configure the plugin in config.yml
4. Set up your Discord bot and obtain a token
5. Configure Discord channel IDs and permissions
6. Restart your server

Configuration

discord:
  token: ""
  channel_id: ""
  webhook_url: ""
  
  # Communication mode: "bot", "webhook", or "both"
  mode: "both"
  
  # Slash Commands
  commands:
    enabled: true
    admin_users:
      - ""
  
  # Console Logging
  logs:
    enabled: false
    channel_id: ""
    console:
      enabled: false
      min_level: "INFO"

# Message filtering system
filter:
  enabled: true
  words: []
  allowed_users: []
  action: "block"

# Rate limiting
rate_limiting:
  enabled: true
  max_messages_per_minute: 10
  cooldown_seconds: 60

and more..

Commands

Discord Slash Commands

• /reload - Reload plugin configuration
• /status - Show plugin status
• /stats - Display plugin statistics
• /serverstatus - Show server status and player count

Minecraft Commands

• /syncchatsreload - Reload plugin configuration
• /syncchatsstatus - Show plugin status
• /syncchatsstats - Display statistics
• /syncchatsserverstatus - Show server status

Permissions

Configure permissions in the config.yml file using Discord user IDs and role IDs.

Requirements

• Minecraft Server (Spigot/Paper 1.20+)
• Java 17 or higher
• Discord Bot Token
• Discord Server with appropriate permissions

Build Information

• Build System: Gradle 8.10
• Language: Kotlin 2.1.10
• Target: Java 17
• Framework: Spigot API 1.20.1
• Discord Library: JDA 5.0.0-beta.12
• Output: Fat JAR (6.4MB) with all dependencies included

Support

For support, please open an issue on the GitHub repository.

License

This project is licensed under the MIT License.

SyncChats v1.0.3 Release

I'm very excited to announce the release of SyncChats v1.0.3! This update brings several important improvements and optimizations to enhance performance, compatibility, and overall user experience.

What's New

• Multi-Version Support Enhancements
  Improved compatibility across Minecraft versions from 1.8.8 to 1.21.4.

• Optimized Build
  Reduced plugin JAR size.

• Bug Fixes

  • Fixed configuration file parsing issues on older server versions (e.g., Spigot 1.8.8) by removing unsupported emojis from the config file.
  • Resolved various minor bugs to ensure smoother operation and better stability.

• Performance Improvements
  Enhanced code readability and efficiency, resulting in a more responsive plugin during runtime.

• Updated Dependencies
  Updated and forced resolution strategies for certain dependencies to ensure a stable and consistent build.

Changes

• JDK Downgrade:
  Compilation target downgraded from JDK 17 to JDK 8 for improved compatibility with older Minecraft servers.

• API Version:
  The plugin now compiles against Spigot 1.13.2 API as the primary version, while still supporting newer versions up to 1.21.

How to Update

1. Download the SyncChats v1.0.3 JAR.
2. Replace your existing SyncChats JAR in your plugins folder.
3. Restart or reload your Minecraft server.
4. Enjoy the improvements and enhanced multi-version support!

For issues, feature requests, or further assistance, please visit GitHub repository.

Happy gaming and coding!

SyncChats is a Minecraft plugin that synchronizes in-game chat with a Discord channel in real-time.

🔹 New features:

• ✅ Custom bot status
• ✅ Supports join/left events
• ✅ Update check

Enjoy seamless chat synchronization! 🎮💬
📌 Note: Ensure your bot has MESSAGE_CONTENT and GUILD_MESSAGES intents enabled.

SyncChats is a Minecraft plugin that synchronizes in-game chat with a Discord channel in real-time.

🔹 Features:

• ✅ Two-way chat sync between Minecraft and Discord
• ✅ Customizable message formats (config.yml)
• ✅ Discord bot & webhook support
• ✅ Automatic player avatars in Discord messages
• ✅ /syncchatsreload command to reload configuration

🔹 Setup Instructions:

• Add your Discord bot token, channel ID, and webhook URL in config.yml
• Restart your Minecraft server

Enjoy seamless chat synchronization! 🎮💬
📌 Note: Ensure your bot has MESSAGE_CONTENT and GUILD_MESSAGES intents enabled.