OmniPort is a powerful Minecraft plugin that allows your server to listen on multiple ports simultaneously, all connecting to the same server instance. Perfect for servers with players behind restrictive firewalls or network configurations.
OmniPort forwards incoming connections from additional ports to your main server port, creating a seamless experience for all players.
- 🔌 Multi-Port Support: Listen on multiple ports (25565, 25566, 25567, etc.)
- 🔄 Real-Time Port Management: Block/unblock ports on the fly without server restart
- 📊 Connection Monitoring: Track all active connections with detailed statistics
- 🛡️ Geyser/Floodgate Integration: Full support for Bedrock players across all ports
- 🎨 Modern UI: Beautiful gradient colors and intuitive command interface
- 🚀 Performance Optimized: Low overhead proxy implementation
- Download the latest version of OmniPort from GitHub Releases
- Place the jar file in your server's
pluginsfolder - Restart your server
- Edit the
config.ymlfile in theplugins/OmniPortfolder (if needed) - Use
/omniport statusto verify the plugin is working correctly
OmniPort is designed to work out of the box with sensible defaults. To customize it, edit the config.yml file:
# List of ports to listen on (in addition to the main server port)
# These ports will forward traffic to the main Minecraft server port
# The main server port (usually 25565) will be automatically excluded
ports:
- 25566
- 25567
- 25568
- 25569
- 19132 # Also listen on the default Bedrock port when using Geyser
# Connection settings
connection:
# Maximum time (in milliseconds) to wait for client data before timing out
timeout: 30000
# Maximum number of concurrent connections across all ports
max-connections: 100
# Floodgate integration
floodgate:
# Welcome message for Bedrock players (set to "" to disable)
welcome-message: "§aWelcome to the server! You connected via Bedrock Edition using OmniPort."
# Whether to show platform icons next to player names (requires a compatible chat plugin)
show-platform-icons: trueOmniPort comes with a set of intuitive commands to manage your multi-port setup:
| Command | Description | Permission |
|---|---|---|
/omniport status |
Display server status with port info | omniport.use |
/omniport connections |
List all active connections | omniport.use |
/omniport block <port> |
Block a port temporarily | omniport.admin |
/omniport unblock <port> |
Unblock a port | omniport.admin |
/omniport reload |
Reload configuration | omniport.admin |
OmniPort works seamlessly with Geyser and Floodgate to provide a unified experience for both Java and Bedrock players:
- Geyser: Allows Bedrock players to connect to your Java server
- Floodgate: Allows Bedrock players to connect without a Java account
- Port Flexibility: Bedrock players can connect through any of your configured ports
When both Geyser and Floodgate are installed, OmniPort will automatically detect and integrate with them, no additional configuration needed!
| Issue | Solution |
|---|---|
| Port already in use | Make sure no other service is using your configured ports |
| Connection refused | Check your firewall settings and ensure ports are forwarded |
| Empty port list | Configure ports in config.yml or use the default ports |
| Bedrock players can't connect | Make sure Geyser and Floodgate are properly set up |
OmniPort provides a simple API for other plugins to interact with:
// Get the OmniPort instance
OmniPort omniPort = (OmniPort) Bukkit.getPluginManager().getPlugin("OmniPort");
// Get active ports
List<Integer> activePorts = omniPort.getActivePorts();
// Get current connections
int connectionCount = omniPort.getCurrentConnections();
// Block a port
omniPort.setPortBlocked(25566, true);OmniPort is licensed under the MIT License - see the LICENSE file for details.
- Developer: Amineos
- Contributors: Amineos
- Special Thanks:
- The Paper team for their amazing server software
- The Geyser and Floodgate teams for their incredible cross-platform support
Made with ❤️ for the Minecraft community