?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
CommandBridge

CommandBridge

Bridge commands between Velocity and Paper servers using scripts. This helps to execute commands global across all your servers.

2,920
23

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x

Platforms

Links

Report issues View source Visit wiki Join Discord server

Creators

objz
objzOwner

Details

Licensed Apache-2.0
Published 2 years ago
Updated 4 weeks ago

CommandBridge

overview

Working on a rewrite, expect less or none uploads for the next 2-3 months. The latest version is stable. (2025.10.10)

This plugin connects Velocity and Paper servers seamlessly, enabling cross-server command execution. Here's what it does exactly:

  • Custom Scripts: Define commands in scripts for both server types.
  • Two-Way Communication:
    • Run a command on Velocity โ†’ Matching commands execute on Paper.
    • Run a command on Paper โ†’ Matching commands execute on Velocity.
  • WebSocket-Powered: Ensures fast, reliable and realtime communication between servers.
  • Placeholders Supported: Use placeholders for dynamic command execution.

With this plugin, you can create global gameplay experiences that feel smooth and connected!

Requirements

CommandBridge v2.0.0 introduces new requirements and updates:

  • Java 21 Required: The server must run on Java 21.
  • Minecraft Compatibility: Fully compatible with Minecraft 1.21.x and 1.20.x.
  • Single JAR File: Only download CommandBridge-XXX-all.jar.
  • Dual Placement: The JAR must be placed in both the target Paper server and the Velocity server to function.
  • Plugin Compatibility: Built for Paper servers, though it may work on other software (not tested).

Important: These requirements apply only to versions 2.0.0 and above.

News

The 2.0.0 release brings major updates and improvements:

  • Rewritten Code: Cleaner, faster, and more reliable.
  • WebSocket Technology: Replaces plugin messaging to fix issues where messages could not be sent if no players were online.
  • Alpha Release: Still in early stages, so expect some rough edges.

Installation (Short Version)

For detailed instructions, visit the website.

  1. Add the JAR: Place the plugin JAR in the plugins folder of both the Paper and Velocity servers.
  2. Restart Servers: Restart both servers. After the restart, a secret.key file will be generated in the Velocity server's plugins/CommandBridge folder.
  3. Secure the Key:
    • Open secret.key on the Velocity server.
    • Copy the key and paste it into the secret field in the config.yml of all Paper servers.
    • Do not share this key.
  4. Open a Port:
    • Choose an unused port for the Velocity server.
    • Configure this port in the config.yml of both Velocity and Paper servers.
  5. Set Server IP:
    • Find your Velocity server's IP address (plain IP, no domain).
    • Update the host field in Velocity's config.yml and the remote field in all Paper servers with this IP.
  6. Set Identifiers:
    • In Velocity: Set a server-id (any name you prefer).
    • In Paper: Set a matching client-id.
  7. Restart Order: Restart the Velocity server before the Paper servers.

After setup, you should see logs like this in the Velocity console:

[21:10:10 INFO] [CommandBridge]: Client authenticated successfully: /127.0.0.1:42918
[21:10:10 INFO] [CommandBridge]: Added connected client: lobby

Now you're ready to create scripts!

What Comes in the Future

Exciting features and improvements are planned for CommandBridge:

  • Multiple Velocity Server Support: Connect additional Velocity servers to act as clients.
  • GUI Menu for Scripts: Create and manage scripts with an easy-to-use graphical interface.
  • Bug Fixes: Continuous improvements to ensure stability and performance.
  • Dump Command & Tools: Integration with a website and Discord bot for troubleshooting and support.
  • And More!

Stay tuned for updates and new features! ๐ŸŽ‰

Help or Issues

Metrics Collection

This plugin collects anonymous server statistics via bStats, an open-source statistics service for Minecraft plugins. You can disable this in plugins/bStats/config.yml.

bStats

Contributing

Join the Discord server or visit the GitHub for more information on contributing to the project.