Back to Templates
Minecraft - Java Edition (Velocity)
Minecraft - Java Edition (Velocity)
GameCP OfficialProxy
Verified

Minecraft - Java Edition (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.

v6
2/25/2026

Minecraft - Java Edition (Velocity) Game Server Hosting

Deploy and manage your own Minecraft - Java Edition (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 - Java Edition (Velocity) server administration simple and reliable.

Free Control PanelOne-Click DeployAuto UpdatesDocker Containerized
Full Hosting Guide

Ready to host Minecraft - Java Edition (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

Standard

Small network, up to 100 players

RAM1 GB
CPU Shares512
Recommended

Pro

Large network, 100-1000 players

RAM1 GB
CPU Shares1024

Startup Command

CommandDirect command execution

Default

Standard Velocity proxy startup with optimized G1GC flags.

Default

Environment Variables

SERVER_NAME

Required

Proxy Name

Name for this proxy instance

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

Read Only

Message of the Day

Message of the Day shown in the server list.

Default
${SERVER_NAME}

ONLINE_MODE

Online Mode

Verify players with Mojang servers. Should match the online-mode setting of your backend servers.

Default
true

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

February 25, 2026

Status

Active

Configuration Metadata

Information about the origin and version of this game configuration.

Author

GameCP Team

Version

1

Source

gamecp