SocialsBridge

Social bridge is a Minecraft plugin that adds to the game the ability to transfer commands from Telegram and/or Discord directly into the game.

Features

• Connect Minecraft with Discord and Telegram
• Execute Minecraft commands from Discord and Telegram
• Command cooldown system with auto-deletion of cooldown messages
• Multi-language support (English, Russian, Italian, French, Japanese, Chinese)
• Command blocking system
• Admin-only commands
• In-game titles when commands are executed

Requirements

• Minecraft 1.21.4
• Paper server
• Java 17 or higher
• Discord bot token
• Telegram bot token

Installation

1. Download the latest release from the releases page
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/SocialsBridge/config.yml

Configuration

The configuration file (config.yml) contains the following sections:

# Main settings
enable: true              # Enable/disable the plugin
lang: 'en'               # Language setting (en, ru, it, fr, ja, zh)
command-cooldown: 5000    # Command cooldown in milliseconds


# Discord settings
discord:
  token: 'YOUR_DISCORD_BOT_TOKEN'
  channel-id: 'CHANNEL_ID'

# Telegram settings
telegram:
  token: 'YOUR_TELEGRAM_BOT_TOKEN'

Commands

Minecraft Commands

• /bridge reload - Reload configuration
• /bridge on/off - Enable/disable the plugin
• /bridge telegram on/off - Enable/disable Telegram integration
• /bridge discord on/off - Enable/disable Discord integration
• /bridge lang en/ru/zh/it/fr/ja - Changes the language of the plugin

Discord & Telegram Commands

• /execute <command> - Execute a Minecraft command
• /help - Show available commands
• /info - Show plugin information
• /block <command> - Block a command from being executed (admin only)
• /unblock <command> - Unblock a command (admin only)

Discord-specific Commands

• /set <channel> - Set the channel for command execution (admin only)

Permissions

• socialsbridge.admin - Access to all Minecraft commands

Discord Bot Setup

1. Go to the Discord Developer Portal
2. Create a new application
3. Go to the "Bot" section and create a bot
4. Copy the bot token and paste it in the config.yml
5. Enable the "Message Content Intent" in the bot settings
6. Use the OAuth2 URL Generator to invite the bot to your server
   • Required permissions: Send Messages, View Channels
   • Required scope: bot, applications.commands

Telegram Bot Setup

1. Talk to @BotFather on Telegram
2. Create a new bot using the /newbot command
3. Copy the bot token and paste it in the config.yml
4. Add the bot to your group
5. Make the bot an admin in the group to use admin-only commands

Support

If you encounter any issues or need help, please create an issue on the GitHub repository. (unavailable)

License

© 2025 RATcraft. All rights reserved.