De Velocity Proxy is het centrale toegangspunt van het Tulpencraft-netwerk.

Alle spelers die verbinding maken met Tulpencraft komen binnen via de Velocity-proxy. De proxy stuurt spelers door naar de centrale Lobby.

De achterliggende Minecraft-servers zijn niet zelfstandig vanaf het internet bereikbaar.

Tulpencraft gebruikt een centrale netwerkarchitectuur.

De verbinding van een speler verloopt altijd via de proxy en vervolgens naar de Lobby:

                     Minecraft-client
                            │
                            │ tulpencraft.nl:25565
                            ▼
                  ┌────────────────────┐
                  │   Velocity Proxy   │
                  │     mc-proxy001    │
                  └─────────┬──────────┘
                            │
                            │
                            ▼
                  ┌────────────────────┐
                  │       Lobby        │
                  │     mc-lobby001    │
                  └─────────┬──────────┘
                            │
                 ┌──────────┼──────────┐
                 │          │          │
                 ▼          ▼          ▼
              Survival    Events    SkyBlock

De Velocity-proxy maakt voor spelers uitsluitend de Lobby tot eerste backend.

De spelservers bevinden zich achter de Lobby.

De gewenste verkeersstroom is:

Speler
  ↓
Velocity
  ↓
Lobby
  ↓
Spelserver

Niet:

Speler
  ├──→ Survival
  ├──→ Events
  └──→ SkyBlock

De achterliggende servers zijn dus geen zelfstandige publieke Minecraft-servers.

Velocity verzorgt de centrale netwerklaag van Tulpencraft.

De proxy handelt onder andere af:

• inkomende Minecraft-verbindingen;
• doorsturen naar de Lobby;
• netwerkcommando's;
• serverroutering;
• versiecompatibiliteit;
• proxyplugins;
• centrale netwerkfunctionaliteit.

De hoofdconfiguratie staat in:

/srv/minecraft/velocity/velocity.toml

De huidige pluginset op mc-proxy001 bestaat uit:

De pluginbestanden bevinden zich in:

/srv/minecraft/velocity/plugins/

De huidige directorystructuur is:

/srv/minecraft/velocity/plugins/
├── bStats/
├── MCKotlinVelocity-1.5.1-k2.4.0.jar
├── viabackwards/
├── ViaBackwards-5.11.0.jar
├── viaversion/
├── ViaVersion-5.11.0.jar
├── vlobby/
└── VLobby-2.1.1.jar

De mappen bevatten de configuratie en plugin-data van de betreffende plugins.

VLobby verzorgt de lobbycommando's op de Velocity-proxy.

De huidige pluginversie is:

VLobby 2.1.1

Configuratie:

/srv/minecraft/velocity/plugins/vlobby/configuration.conf

De configuratie gebruikt momenteel de handler:

command-handler="COMMAND_TO_SERVER"

De beschikbare routeringscommando's zijn onder andere:

/survival
/events
/lobby
/hub

De configuratie koppelt deze commando's aan de betreffende servers.

Voorbeeld:

survival=survival
events=events
lobby=lobby
hub=lobby

VLobby gebruikt momenteel een cooldown van 5 seconden voor de geconfigureerde commando's.

De Nederlandse melding hiervoor is:

Je kunt dit commando niet zo snel opnieuw gebruiken. Wacht <time> seconden.

ViaVersion verzorgt de Minecraft-versiecompatibiliteit op de proxy.

Versie:

5.11.0

Pluginbestand:

/srv/minecraft/velocity/plugins/ViaVersion-5.11.0.jar

Configuratie:

/srv/minecraft/velocity/plugins/viaversion/

ViaVersion maakt het mogelijk om verschillende ondersteunde Minecraft-clientversies met het netwerk te laten communiceren.

ViaBackwards werkt samen met ViaVersion.

Versie:

5.11.0

Pluginbestand:

/srv/minecraft/velocity/plugins/ViaBackwards-5.11.0.jar

Configuratie:

/srv/minecraft/velocity/plugins/viabackwards/

ViaBackwards breidt ViaVersion uit met ondersteuning voor oudere Minecraft-clientversies.

De combinatie is:

ViaVersion
     +
ViaBackwards
     ↓
Versiecompatibiliteit

MCKotlinVelocity levert Kotlin-runtimefunctionaliteit voor Velocity-plugins die hiervan afhankelijk zijn.

Versie:

1.5.1-k2.4.0

Pluginbestand:

/srv/minecraft/velocity/plugins/MCKotlinVelocity-1.5.1-k2.4.0.jar

MCKotlinVelocity is geen gameplayplugin. Het is een technische runtime/dependency voor plugins die Kotlin gebruiken.

bStats wordt gebruikt voor anonieme plugin-statistieken.

De gegevens worden door individuele plugins gebruikt om algemene gebruiksstatistieken te verzamelen.

De bStats-data bevindt zich onder:

/srv/minecraft/velocity/plugins/bStats/

De volledige Velocity-installatie bevindt zich onder:

/srv/minecraft/velocity/

Belangrijke onderdelen:

/srv/minecraft/velocity/
├── velocity.toml
├── plugins/
├── lang/
├── logs/
└── ...

/srv/minecraft/velocity/velocity.toml

/srv/minecraft/velocity/plugins/

/srv/minecraft/velocity/lang/

/srv/minecraft/velocity/logs/

Velocity bevat verschillende taalbestanden:

/srv/minecraft/velocity/lang/

Daaronder bevindt zich onder andere:

messages_nl_NL.properties

Dit bestand bevat de Nederlandse vertalingen van Velocity-meldingen.

Voorbeeld:

velocity.error.connecting-server-error=Kan je niet verbinden met <arg:0>. Probeer het later opnieuw.

De standaard messages.properties bevat de Engelse fallback-teksten.

Bij wijzigingen aan Velocity-teksten moet rekening worden gehouden met de taal die door de Minecraft-client wordt gebruikt.

Velocity wordt als systemd-service uitgevoerd.

sudo systemctl status velocity

sudo systemctl start velocity

sudo systemctl stop velocity

sudo systemctl restart velocity

De Velocity-logs kunnen via journalctl worden bekeken.

sudo journalctl -u velocity -f

sudo journalctl -u velocity --since "10 minutes ago" --no-pager

sudo journalctl -u velocity --since "10 minutes ago" --no-pager | \
grep -Ei 'error|exception|warn'

sudo journalctl -u velocity --since "10 minutes ago" --no-pager | \
grep -Ei 'vlobby|error|exception'

Pluginconfiguraties worden opgeslagen binnen:

/srv/minecraft/velocity/plugins/

Na wijzigingen moet een plugin worden herladen of, indien noodzakelijk, moet Velocity worden herstart.

Voor wijzigingen aan kritieke proxyconfiguratie wordt een volledige restart aanbevolen:

sudo systemctl restart velocity

Daarna controleren:

sudo journalctl -u velocity --since "1 minute ago" --no-pager

De Velocity-proxy is het enige publieke Minecraft-toegangspunt.

De gewenste netwerkstructuur is:

id="d7r3mh"

                       INTERNET
                           │
                           │ :25565
                           ▼
                  ┌─────────────────┐
                  │     Velocity    │
                  │   mc-proxy001   │
                  └────────┬────────┘
                           │
                           ▼
                         Lobby
                           │
                ┌──────────┼──────────┐
                ▼          ▼          ▼
             Survival    Events    SkyBlock

De backendservers mogen niet rechtstreeks vanaf het internet bereikbaar zijn.

De proxy gebruikt de Lobby als centrale ingang.

id="p4h8zq"

Minecraft-client
       ↓
tulpencraft.nl
       ↓
Velocity
       ↓
Lobby

id="r8m2kc"

Speler
  ↓
Lobby
  ↓
Survival

id="v3q7nx"

Speler
  ↓
Lobby
  ↓
Events

id="m9c5hd"

Speler
  ↓
Lobby
  ↓
SkyBlock

Controleer:

id="b5q1sv"

sudo systemctl status velocity

Controleer vervolgens de logs:

id="t8m4pz"

sudo journalctl -u velocity --since "10 minutes ago" --no-pager

Controleer eerst Velocity:

id="k7n2fx"

sudo systemctl status velocity

Controleer daarna de Lobby:

id="v4c8rm"

sudo systemctl status minecraft-lobby

Controleer vervolgens de proxylogs:

id="z6p3qw"

sudo journalctl -u velocity --since "5 minutes ago" --no-pager | \
grep -Ei 'lobby|error|exception'

Controleer of Survival actief is:

id="q9m5kx"

sudo systemctl status minecraft-survival

Controleer vervolgens de proxy:

id="f2r7vc"

sudo journalctl -u velocity --since "5 minutes ago" --no-pager | \
grep -Ei 'survival|vlobby|error|exception'

Controleer daarna de Lobby-server zelf.

• Serverinfrastructuur — Overzicht
• Lobby
• Survival
• Events
• VLobby
• ViaVersion
• ViaBackwards
• Beheer

Laatste update: augustus 2026

De Velocity-proxy is de centrale toegangspoort van Tulpencraft. Wijzigingen aan de proxyconfiguratie, netwerkarchitectuur of geïnstalleerde plugins moeten in deze documentatie worden bijgewerkt.