GameCP Logo
FeaturesFeaturesPricingPricingSelf-HostedSelf-HostedGames & AppsGames & AppsIntegrationsIntegrationsDocsDocs
Launch Your Panel
GameCP Logo
GameCP

The next-generation game server management platform. Built for performance, security, and ease of use.

Product

  • Features
  • Integrations
  • App Store
  • Pricing
  • Self-Hosted
  • Custom Development
  • Compare Panels

Resources

  • Documentation
  • API Reference
  • Referral Program
  • Support
  • System Status

Company

  • About
  • Contact

Β© 2026 GameCP. All rights reserved.

Privacy PolicyTerms of ServiceSelf-Hosted License
Back to Templates
Minecraft - Velocity
Minecraft - Velocity
GameCP OfficialProxy
Verified

Minecraft - Velocity

Dedicated Server Template

Velocity is a high-performance Minecraft proxy server designed to connect multiple backend servers into a seamless network. Known for its modern architecture, strong security features, and excellent scalability. Supports modern player forwarding, plugin API, and automatic version resolution via the PaperMC API.

v12
8/7/2026

Minecraft - Velocity Game Server Hosting

Deploy and manage your own Minecraft - Velocity dedicated server with GameCP's free game server control panel. This template provides a production-ready server configuration with one-click installation, automatic updates via SteamCMD, and full environment variable management. Whether you're hosting for a small group of friends or running a large community server, GameCP makes Minecraft - Velocity server administration simple and reliable.

Free Control PanelOne-Click DeployAuto UpdatesDocker Containerized
Full Hosting Guide

Ready to host Minecraft - Velocity?

Read our complete step-by-step guide covering installation, configuration, performance tuning, and getting your server online in minutes.

Read Hosting GuideGet Started Free

Resource Requirements

CPU Cores
1
Memory
0.5 GB(max 2 GB)
Storage
1 GB

+5 MiB per player

Recommended Players

100
Recommended
Min: 1Max: 1000

Performance Tiers

Economy

Small proxy, 1-100 players

RAM1 GB
CPU Shares1024
Recommended

Standard

Large proxy, 100-1000 players

RAM1 GB
CPU Shares2048

Startup Command

CommandDirect command execution

Default

Standard Velocity proxy startup with optimized G1GC flags.

Default

Environment Variables

SERVER_NAME

Read Only

Proxy Name

Internal proxy name, used as default MOTD seed

Default
(empty)

VELOCITY_VERSION

Read Only

Install Version

Version to use when installing or reinstalling the proxy. Use 'latest' for the newest stable release, or specify a version like '3.4.0'. Admin only.

Default
latest

PLAYER_INFO_FORWARDING

Player Forwarding Mode

How player information is forwarded to backend servers.

Default
modern

MAX_PLAYERS

RequiredRead Only

Show Max Players

Maximum number of players shown in the server list. Velocity does not enforce this limit.

Default
500

MOTD

Message of the Day

Message of the Day shown in the server list. Supports MiniMessage formatting.

Default
${SERVER_NAME}

ONLINE_MODE

Online Mode

Verify players with Mojang servers. Enable for security (recommended). Backend servers behind Velocity must always have online-mode disabled.

Default
true

FORCE_KEY_AUTH

Force Key Authentication

Enforce public key security standard for player authentication.

Default
true

PREVENT_PROXY_CONNECTIONS

Prevent Proxy Connections

Block players whose ISP differs from the authentication server. Can break VPN users.

Default
false

ANNOUNCE_FORGE

Announce Forge

Tell clients this proxy supports Forge/FML modding framework.

Default
false

KICK_EXISTING_PLAYERS

Kick Existing Players

Kick an existing session when the same player connects again.

Default
false

PING_PASSTHROUGH

Ping Passthrough

Pass server list pings to a backend server.

Default
DISABLED

COMPRESSION_THRESHOLD

Compression Threshold

Minimum packet size (bytes) before compression is applied. Set to 0 to compress all, -1 to disable.

Default
256

COMPRESSION_LEVEL

Compression Level

Compression intensity (0-9). -1 uses the system default.

Default
-1

LOGIN_RATELIMIT

Login Rate Limit (ms)

Delay in milliseconds between connections from the same IP address.

Default
3000

CONNECTION_TIMEOUT

Connection Timeout (ms)

How long to wait (ms) when connecting to a backend server.

Default
5000

READ_TIMEOUT

Read Timeout (ms)

How long a connection can stay idle (ms) before being closed.

Default
30000

HAPROXY_PROTOCOL

HAProxy Protocol

Enable PROXY protocol support for load balancers like HAProxy or Nginx.

Default
false

TCP_FAST_OPEN

TCP Fast Open

Speed up TCP handshakes. Linux only.

Default
false

BUNGEE_PLUGIN_CHANNEL

BungeeCord Plugin Channel

Enable compatibility with BungeeCord-style plugin messaging.

Default
true

ANNOUNCE_PROXY_COMMANDS

Announce Proxy Commands

Declare proxy commands to 1.13+ clients for tab completion.

Default
true

SHOW_PING_REQUESTS

Show Ping Requests

Log individual ping requests from clients.

Default
false

FAILOVER_ON_DISCONNECT

Failover on Disconnect

Move players to fallback server if a backend unexpectedly disconnects.

Default
true

LOG_COMMAND_EXECUTIONS

Log Command Executions

Log every command players execute.

Default
false

LOG_PLAYER_CONNECTIONS

Log Player Connections

Log player joins, server switches, and disconnects.

Default
true

ENABLE_PLAYER_ADDRESS_LOGGING

Log Player IPs

Show player IP addresses in log output.

Default
true

QUERY_ENABLED

Enable Query (GS4)

Respond to GameSpy 4 query protocol requests.

Default
false

QUERY_PORT

Query Port

Port for the GS4 query protocol.

Default
25565

QUERY_MAP

Query Map Name

Map name shown in query responses.

Default
Velocity

QUERY_SHOW_PLUGINS

Show Plugins in Query

Include plugins in GS4 query responses.

Default
false

JAVA_XMX

RequiredRead Only

Max Memory (Xmx)

Maximum memory allocation for the Java process. Velocity is lightweight and typically needs 512M-1G.

Default
512M

JAVA_XMS

RequiredRead Only

Initial Memory (Xms)

Initial memory allocation for Java.

Default
256M

Lifecycle Scripts

Installation Script

Downloads the Velocity proxy JAR from the PaperMC API and generates a forwarding secret.

before installghcr.io/ptero-eggs/installers:debian

Configuration Files

Velocity Configuration

Main Velocity proxy configuration file. Uses Rules Mode to update settings in the velocity.toml file.

//velocity.tomltoml
0 fields

Container Configuration

Docker Image

eclipse-temurin:21-jre-alpine

Technical Profile

Template ID

minecraft-java-velocity

Author

GameCP Team

Last Updated

August 7, 2026

Status

Active

Configuration Metadata

Information about the origin and version of this game configuration.

Author

GameCP Team

Version

1

Source

gamecp

Hosting Guide

Host Your Own Minecraft - Velocity Server

Step-by-step setup guide, performance tips, and everything you need to get your server running.

Read Full GuideGet Started Free
Template Info
Versionv12
CategoryProxy
SourceGameCP Official
Download Configuration

Export this template as a native GameCP Template

Quick Import

Copy this link to import in your GameCP panel

Pterodactyl Export

Export this template as a Pterodactyl egg for use in other panels

TCAdmin Export

Export this template as a TCAdmin game config XML

CDN Image Assets
minecraft-java Icon
IconSquare game icon
minecraft-java Banner
Banner16:9 card thumbnail
minecraft-java Hero
HeroUltra-wide background
minecraft-java Logo
LogoTransparent game logo

Tags

#minecraft#java#velocity#proxy#network#multiplayer#lightweight

Ready to deploy?

Join GameCP today and deploy your favorite games and applications instantly.

Get Started Free