Skip to main content

​
Modded Server Support

Gate provides excellent compatibility with modded Minecraft servers including Fabric and NeoForge. This guide will help you set up Gate to work seamlessly with your modded servers using Velocity modern forwarding.

​
Overview

Gate implements the same forwarding protocols as Velocity, providing comprehensive support for modded servers:

​
Forwarding Modes Supported

  • Velocity modern forwarding - Secure binary format with MAC authentication (Minecraft 1.13+)
  • Legacy BungeeCord forwarding - Compatible with older versions and servers
  • BungeeGuard forwarding - Enhanced security over legacy forwarding
  • No forwarding - Basic proxy functionality without player data forwarding
For complete details on player information forwarding, see the Velocity documentation.

​
Fabric Server Setup

Gate works with Fabric out of the box, but you should add support for player info forwarding and modded content compatibility.

​
Required Mods

​
FabricProxy-Lite (For Velocity Forwarding)

Always download the mod version that matches your Minecraft server version. Check the compatibility table on the mod page.

​
CrossStitch (Recommended for Modded Content)

  • Purpose: Improves support for Minecraft features extended by mods (custom argument types, etc.)
  • Download: CrossStitch on Modrinth
  • Maintained by: Velocity project (official)

​
Configuration

1

Configure Fabric server

Edit server.properties:
server-port=25566
online-mode=false
motd=Fabric Server with Gate Proxy
2

Configure FabricProxy-Lite

Create or edit config/FabricProxy-Lite.toml:
hackOnlineMode = false
hackEarlySend = false
hackMessageChain = false
disconnectMessage = "This server requires you to connect with Gate."
secret = "your-secret-key-here"
If the config file doesn’t appear after restart, you can use environment variables:
export FABRIC_PROXY_SECRET="your-secret-key-here"
export FABRIC_PROXY_HACK_ONLINE_MODE=false
export FABRIC_PROXY_HACK_EARLY_SEND=false
export FABRIC_PROXY_HACK_MESSAGE_CHAIN=false
3

Configure Gate

Edit your Gate config.yml:
config:
  bind: 0.0.0.0:25565
  servers:
    fabric-server: localhost:25566
  try:
    - fabric-server
  forwarding:
    mode: velocity
    velocitySecret: 'your-secret-key-here'
  status:
    motd: |
      §bGate Proxy with Fabric
      §eVelocity Forwarding Enabled
4

Install mods and start

  1. Install FabricProxy-Lite and CrossStitch in the server’s mods/ folder
  2. Ensure Fabric API is installed (required dependency)
  3. Start Gate, then start your Fabric server
The secret in FabricProxy-Lite.toml must match the velocitySecret in Gate’s config.yml.

​
NeoForge Server Setup

Gate works with NeoForge servers using the Proxy-Compatible-Forge mod for Velocity modern forwarding.

​
Required Mods

​
Proxy-Compatible-Forge (For Velocity Forwarding)

Ensure you download the correct mod version for your NeoForge server version. Check the releases page for compatibility.

​
Configuration

1

Configure NeoForge server

Edit server.properties:
server-port=25567
online-mode=false
motd=NeoForge Server with Gate Proxy
2

Configure Proxy-Compatible-Forge

Create or edit config/pcf-common.toml:
#Modern Forwarding Settings
[modernForwarding]
    forwardingSecret = "your-secret-key-here"

[commandWrapping]
    #List of argument types that are not vanilla but are integrated into the server
    moddedArgumentTypes = ["livingthings:sampler_types"]
3

Configure Gate

Edit your Gate config.yml:
config:
  bind: 0.0.0.0:25565
  servers:
    neoforge-server: localhost:25567
  try:
    - neoforge-server
  forwarding:
    mode: velocity
    velocitySecret: 'your-secret-key-here'
  status:
    motd: |
      §bGate Proxy with NeoForge
      §eVelocity Forwarding Enabled
4

Install mod and start

  1. Install Proxy-Compatible-Forge in the server’s mods/ folder
  2. Start Gate, then start your NeoForge server

​
Multi-Server Setup

You can run both Fabric and NeoForge servers behind the same Gate proxy: 
config:
  bind: 0.0.0.0:25565
  servers:
    fabric-server: localhost:25566 # Fabric server
    neoforge-server: localhost:25567 # NeoForge server
    vanilla-server: localhost:25568 # Vanilla server
  try:
    - fabric-server
    - neoforge-server
    - vanilla-server
  forwarding:
    mode: velocity
    velocitySecret: 'shared-secret-key'
  status:
    motd: |
      §bGate Multi-Server Network
      §eFabric • NeoForge • Vanilla
All servers in a network should use the same velocitySecret for consistency.

​
Comparison Table

FeatureFabricNeoForge
Forwarding ModFabricProxy-LiteProxy-Compatible-Forge
Required DependencyFabric APINone
Recommended AddonCrossStitch-
Velocity Forwarding✅ Yes✅ Yes
Configuration FormatTOMLTOML
Environment Variables✅ Supported❌ Not supported

​
Troubleshooting

Possible causes:
  • Server not running on configured port
  • Firewall blocking connections
  • Server startup errors
Solutions:
  1. Check server ports with netstat -tlnp | grep java
  2. Verify firewall allows connections: sudo ufw status
  3. Check server logs for startup errors
Symptoms:
  • “Failed to verify username” errors
  • Players kicked during login
  • UUID conflicts
Solutions:
  1. Secret mismatch - Ensure velocitySecret matches in both Gate and mod configs
  2. Online mode - Must be false on backend servers when using forwarding
  3. Mod compatibility - Verify the forwarding mod supports your server version
Incompatible Mods:
  • NeoVelocity 1.2.4 - Incompatible with NeoForge 21.8.x
  • NeoForwarding 1.3.0 - Only supports older NeoForge versions
Solution: Use Proxy-Compatible-Forge instead for modern NeoForge versions.

​
Security Considerations

When running modded servers:
  • Use Velocity forwarding when possible for better security than legacy forwarding
  • Configure firewalls to block direct access to backend servers (only allow from Gate IP)
  • Keep secrets private - Never commit velocitySecret to version control
  • Regular updates - Keep Gate and mods updated for security patches
Never use the same velocitySecret across different networks or environments (dev/prod).

​
Getting Help

If you encounter issues:
  1. Check the logs - Both Gate and server logs often contain helpful error messages
  2. Verify versions - Ensure compatibility between Gate, server version, and mods
  3. Community support - Join the Gate Discord for general questions
  4. Report bugs - For reproducible bugs with logs and steps, use Gate GitHub Issues
This guide covers the most common modded server setups. For specific mod compatibility questions, consult the mod’s documentation or community.

Build docs developers (and LLMs) love

Get started for freeTalk to us