---
title: "Konfiguracja proxy Velocity na serwerze Minecraft - Wiki"
description: "Utwórz proxy Velocity, ustaw modern forwarding, wpisz adres backendu Paper, skopiuj wartość forwarding.secret, a graczom podaj wyłącznie adres IP proxy."
url: "https://eternyx.pl/wiki/nastaveni-serveru/konfiguracja-proxy-velocity-na-serwerze-minecraft"
lastmod: "2026-08-22T22:27:00.000Z"
---

# Konfiguracja proxy Velocity na serwerze Minecraft

Utwórz proxy Velocity, ustaw modern forwarding, wpisz adres backendu Paper, skopiuj wartość forwarding.secret, a graczom podaj wyłącznie adres IP proxy.

[![Skin autora Tomáš Navrátil](https://visage.surgeplay.com/bust/256/012486e303614e7d8327d890d5cef004) Tomáš Navrátil](https://eternyx.pl/autor/tomas) 22 sierpnia 2026

[Velocity](https://eternyx.pl/slovnik/velocity) to nowoczesne proxy. Gracz łączy się na jeden adres. Proxy wysyła go do lobby albo na backend. Często używa się go zamiast BungeeCord.

Backend zostaje pełnym serwerem Minecraft ([Paper](https://eternyx.pl/slovnik/paper), Purpur, Fabric) z własnym światem i pluginami. Velocity nie uruchamia świata. Tylko przekazuje graczy. Świat działa na backendzie. Bez co najmniej jednej instancji za proxy gracz nie ma dokąd iść.

## Konfiguracja Velocity (szybki przegląd)

1. W Eternyx Dashboard utwórz serwer typu **Velocity**, jeśli nie masz jeszcze proxy.
2. W pliku `velocity.toml` ustaw: `player-info-forwarding-mode = "modern"`, a w `[servers]` wpisz adres backendu Paper.
3. Z pliku `forwarding.secret` skopiuj secret. Wartości nie wpisuj do tego artykułu.
4. Na Paper ustaw `online-mode=false` i w `config/paper-global.yml` włącz blok `proxies.velocity`.
5. Gracze wpisują **tylko IP proxy**. Adresu backendu graczom nie wysyłaj.

## 1. Czy w ogóle potrzebujesz proxy

Velocity ma sens, gdy któreś z poniższych jest prawdą:

- kilka światów gry jako osobne serwery (lobby + survival + minigry)
- gracz ma mieć jedno IP, a wewnątrz przełącza tryby
- backendy działają na różnych wersjach Minecraft

Sam Paper z jednym światem proxy nie potrzebuje. Wtedy graczy łączysz bezpośrednio z tym serwerem.

Najpierw uruchom backend. Każdy ma własne pluginy, świat i port. Velocity to tylko wejście.

Jeśli kilka usług dzieli tę samą maszynę, drugi port rozwiążesz tu: [Dodawanie ekstra portu na serwerze Minecraft w Eternyx Dashboard](https://eternyx.pl/wiki/eternyx-dashboard/dodawanie-extra-portu-na-serwerze-minecraft-w-eternyx-dashboard).

## 2. Utworzenie serwera Velocity

Jeśli proxy już masz, pomiń kreator tworzenia i idź do `velocity.toml`.

Przy nowym proxy w kreatorze **Utwórz serwer** wybierz Minecraft, pakiet **PROXY**, a w **Oprogramowanie** **Velocity**. Zostaw stabilną wersję, nazwij (na przykład `proxy`) i potwierdź utworzenie. Potem kliknij **Start**. Przy pierwszym starcie Velocity tworzy pliki `velocity.toml` i `forwarding.secret`.

Na istniejącym serwerze typ możesz też przełączyć na Velocity na stronie **Oprogramowanie** (to nadpisuje obecny fork, więc najpierw zrób kopię zapasową):

![Strona Oprogramowanie do zmiany typu serwera](https://eternyx.pl/_etnx/c6890728-a03b-4256-af59-1a9de5b2db34_Z1hECvQ.webp)

![Karta Velocity na stronie Oprogramowanie](https://eternyx.pl/_etnx/fb53b901-0441-40e6-9ea2-75064b7ff099_ZPL6dJ.webp)

## 3. Ustawienie modern forwarding

Otwórz proxy i kartę **Przeglądarka plików**. W katalogu głównym otwórz `velocity.toml`.

![Przeglądarka plików z katalogiem głównym serwera](https://eternyx.pl/_etnx/9fc5cc29-5473-484f-946b-aa63bddb5d1c_F37d2.webp)

Znajdź wiersz `player-info-forwarding-mode` i ustaw:

```
player-info-forwarding-mode = "modern"
```

`modern` to oficjalne przekazywanie Velocity dla klientów Minecraft 1.13+. Zapisz plik.

W tym samym pliku jest sekcja `[servers]`. Każdy klucz to nazwa backendu, wartość to `host:port`:

```
[servers]
lobby = "game01.eternyx.cz:8040"
try = ["lobby"]
```

Lista `try` to kolejność pierwszej próby. Zapisz plik.

## 4. Forwarding secret i Paper

Otwórz `forwarding.secret` w katalogu głównym proxy i skopiuj wartość. Do tego artykułu jej nie wpisuj.

Na backendzie Paper:

1. Zatrzymaj serwer (**Zatrzymywać się**).
2. W `server.properties` ustaw: `online-mode=false`.
3. W `config/paper-global.yml` włącz blok `proxies.velocity` i wklej ten sam secret.

![Przycisk Zatrzymywać się w nagłówku działającego serwera](https://eternyx.pl/_etnx/f817fa94-d3fc-45ce-8b7e-adcbdd2ea371_aGouu.webp)

![Wiersz online-mode w edytorze server.properties](https://eternyx.pl/_etnx/b7fcfe41-43fd-490e-8e90-c23e6585c3ff_Zc8Eu0.webp)

Potem uruchom backend i proxy. Gracze dostają tylko adres proxy (skopiuj z karty **ADRES IP**):

![Pełny adres IP serwera w nagłówku dashboardu](https://eternyx.pl/_etnx/f695f41b-957d-4e46-ace1-77c2779cfff8_Zu8Jzi.webp)

Wersję Java na proxy sprawdź też w **Ustawieniach** → **Obrazy Dockera**. Velocity często potrzebuje Java 21: [Zmiana wersji Java serwera Minecraft w Eternyx Dashboard](https://eternyx.pl/wiki/eternyx-dashboard/zmiana-wersji-java-serwera-minecraft-w-eternyx-dashboard).

## Częste problemy

### Gracze idą na IP backendu

Podawaj tylko IP proxy. Portu backendu nie udostępniaj publicznie.

### Unable to verify player details / invalid forwarding

Secret się nie zgadza albo na Paper nie jest włączone `proxies.velocity`. Skopiuj ponownie wartość z `forwarding.secret`, zapisz i zrestartuj oba serwery.

### Proxy działa, ale nie ma dokąd iść

Backend nie działa albo zły adres w `[servers]`. Najpierw uruchom Paper, sprawdź parę host:port.

[Wróć do: Ustawienia serwera](https://eternyx.pl/wiki/nastaveni-serveru)
