De Lobby is het centrale startpunt van het Tulpencraft-netwerk.

Wanneer een speler via de Velocity Proxy verbinding maakt met Tulpencraft, komt de speler in de Lobby terecht. Vanuit de Lobby kan de speler naar de beschikbare spelservers en andere onderdelen van het netwerk.

De Lobby is daarmee de centrale gebruikersinterface van Tulpencraft.

De Lobby is niet zelfstandig vanaf het internet bereikbaar.

De gewenste netwerkroute is:

Speler
  ↓
tulpencraft.nl
  ↓
Velocity Proxy
  ↓
Lobby

Vanuit de Lobby worden spelers vervolgens naar de beschikbare spelservers gestuurd.

                         INTERNET
                             │
                             ▼
                    ┌─────────────────┐
                    │ Velocity Proxy  │
                    │   mc-proxy001   │
                    └────────┬────────┘
                             │
                             ▼
                    ┌─────────────────┐
                    │      LOBBY      │
                    │   mc-lobby001   │
                    │      Paper      │
                    └────────┬────────┘
                             │
                 ┌───────────┼───────────┐
                 ▼           ▼           ▼
              Survival     Events      SkyBlock

Belangrijk: de backendservers zijn niet bedoeld om rechtstreeks door spelers te worden benaderd. De Lobby vormt de centrale toegang tot de spelomgeving.

De belangrijkste functies van de Lobby zijn:

• centrale spawn;
• spelers ontvangen na het verbinden;
• serverselectie;
• NPC's;
• hologrammen;
• servermenu;
• profielmenu;
• scoreboard;
• tablist;
• lobby-interactie;
• voorbereiding op toekomstige spelservers.

De Lobby is geen Survival-wereld, maar een centrale en beveiligde omgeving.

De Lobby draait op:

Paper

De serverbestanden bevinden zich onder:

/srv/minecraft/lobby/

Plugins:

/srv/minecraft/lobby/plugins/

De Lobby wordt beheerd als systemd-service:

minecraft-lobby

Plugins controleren:

ls /srv/minecraft/lobby/plugins/

Citizens wordt gebruikt voor de NPC's in de Lobby.

De NPC's vormen een belangrijk onderdeel van de visuele navigatie.

Momenteel worden NPC's gebruikt voor onder andere:

• Survival;
• Events;
• toekomstige spelmodi;
• toekomstige SkyBlock-server.

De NPC's worden gecombineerd met hologrammen om duidelijk te maken waarvoor iedere NPC dient.

Citizens
2.0.43-SNAPSHOT (build 4237)

Citizens wordt tijdens het starten van de Lobby voorzien van de benodigde libraries.

DecentHolograms wordt gebruikt voor zwevende teksten in de Lobby.

Hologrammen worden onder andere gebruikt bij NPC's.

Een voorbeeld van de huidige presentatie:

SURVIVAL
 
Bouw, overleef en ontdek!
 
Rechtermuisknop om te spelen

De hologrammen zijn onafhankelijk van Citizens en kunnen afzonderlijk worden beheerd.

LobbyPlugin verzorgt een groot deel van de algemene Lobby-functionaliteit.

De plugin verzorgt onder andere:

• lobby-spawn;
• lobby-items;
• servermenu;
• scoreboard;
• double jump;
• launch pads;
• profiel;
• join-title;
• lobby-interactie.

Configuratie:

/srv/minecraft/lobby/plugins/LobbyPlugin/config.yml

Bij het betreden van de Lobby ontvangt een speler een aantal speciale items.

De huidige primaire Lobby-items zijn:

Deze items vormen de belangrijkste interactieve elementen van de Lobby.

De Nether Star is het centrale navigatie-item van Tulpencraft.

Naam:

Servermenu (Rechtermuisknop)

Slot:

0

Materiaal:

NETHER_STAR

Configuratie:

navigator-slot: 0
navigator-name: '&b&lServermenu &7(Rechtermuisknop)'
navigator-material: NETHER_STAR

Door met de rechtermuisknop te klikken wordt het servermenu geopend.

Vanuit dit menu kunnen beschikbare servers worden geselecteerd.

De Player Head wordt gebruikt voor het persoonlijke profiel.

Naam:

Profiel (Rechtermuisknop)

Slot:

8

Materiaal:

PLAYER_HEAD

Configuratie:

profile-slot: 8
profile-name: '&e&lProfiel &7(Rechtermuisknop)'
profile-material: PLAYER_HEAD

Een Compass wordt momenteel niet gebruikt als Lobby-navigatie.

Een eerdere configuratie gebruikte:

COMPASS

als Navigator-item.

Dit bleek problemen te geven met de navigatie/teleportfunctionaliteit. Daarom is de Compass vervangen door de Nether Star.

De Compass moet daarom niet opnieuw als standaard Lobby-item worden ingesteld zonder eerst te controleren welke plugin de interactie afhandelt.

Het servermenu van de LobbyPlugin bevat momenteel onder andere:

Het menu is bedoeld als visuele serverselectie.

Let op: de COMPASS hierboven is alleen het materiaal van het Lobby-menu-item waarmee terug naar de Lobby kan worden genavigeerd. Dit staat los van het speciale Lobby-item dat de speler in zijn hotbar krijgt.

De hotbar gebruikt dus de Nether Star als servermenu.

Naast het servermenu worden NPC's gebruikt voor belangrijke servers.

De globale navigatiestructuur is:

                 LOBBY
                   │
          ┌────────┴────────┐
          │                 │
     Servermenu            NPC's
          │                 │
     ┌────┼────┐       ┌────┼────┐
     ▼    ▼    ▼       ▼    ▼    ▼
 Survival Events ... Survival Events SkyBlock

NPC's zijn vooral bedoeld als visuele en directe toegang tot belangrijke spelmodi.

De Lobby gebruikt een scoreboard.

Titel:

▸ TULPENCRAFT ◂

Het scoreboard toont onder andere:

• spelernaam;
• rang;
• aantal online spelers;
• speeltijd;
• servernaam.

Voorbeeld:

--------------------
Speler: <speler>
Rang: <rang>
 
Online: <online>/<max>
Speeltijd: <speeltijd>
 
Server: tulpencraft.nl
--------------------

Configuratie:

/srv/minecraft/lobby/plugins/LobbyPlugin/config.yml

TAB verzorgt de tablist en spelersinformatie.

Configuratie:

/srv/minecraft/lobby/plugins/TAB/

Belangrijke configuratiebestanden zijn:

config.yml
groups.yml
users.yml
messages.yml
animations.yml

LuckPerms verzorgt het rechtenbeheer.

Configuratie:

/srv/minecraft/lobby/plugins/LuckPerms/

LuckPerms bepaalt welke groepen en permissies spelers binnen de Lobby hebben.

WorldEdit wordt gebruikt voor het bouwen en onderhouden van de Lobby.

Voorbeelden:

• grote bouwbewerkingen;
• selecties;
• kopiëren en plakken;
• terreinbewerking;
• onderhoud.

WorldEdit is primair een beheertool.

WorldGuard wordt gebruikt om de Lobby te beschermen.

De Lobby is geen bouwserver. Normale spelers mogen de omgeving daarom niet vrij aanpassen.

WorldGuard kan onder andere worden gebruikt voor:

• spawnbeveiliging;
• bouwbeperkingen;
• PvP-beheer;
• interactiebeperkingen;
• bescherming van belangrijke gebieden.

De huidige Lobby-spawn:

Wereld: world
 
X: 2.8635867604118044
Y: 77.0
Z: -85.07011597788045
 
Yaw: 2.2503967
Pitch: -4.6499844

De spawn wordt gebruikt als centrale aankomstlocatie.

Configuratie:

/srv/minecraft/lobby/plugins/LobbyPlugin/config.yml

De actieve Lobbywereld is:

world

Configuratie:

lobby-world: world

Deze wereld is specifiek bedoeld voor de centrale Lobby.

De Lobby ondersteunt double jump.

Configuratie:

double-jump:
  enabled: true
  height: 0.9
  forward-multiplier: 1.2

Hierdoor kunnen spelers in de Lobby een extra sprong maken.

Dit is uitsluitend een Lobby-functionaliteit.

De Lobby ondersteunt launch pads.

Een launch pad wordt geactiveerd via een pressure plate boven een geschikt blok.

Huidige configuratie:

launch-pad:
  enabled: true
  trigger-block: SPONGE
  pressure-plate: LIGHT_WEIGHTED_PRESSURE_PLATE
  height: 1.2
  forward-multiplier: 2.5

Hiermee kunnen spelers zich snel door bepaalde delen van de Lobby verplaatsen.

De Lobby moet worden beschouwd als een controlled environment.

Spelers mogen niet:

• bouwen;
• blokken vernietigen;
• belangrijke Lobby-objecten aanpassen;
• NPC's verwijderen;
• hologrammen aanpassen;
• configuraties wijzigen.

Beheer gebeurt via de serverconsole en de daarvoor bedoelde plugins.

sudo systemctl status minecraft-lobby

sudo systemctl start minecraft-lobby

sudo systemctl stop minecraft-lobby

sudo systemctl restart minecraft-lobby

Live logs:

sudo journalctl -u minecraft-lobby -f

Recente logs:

sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager

Fouten zoeken:

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

Citizens controleren:

sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager | \
grep -Ei 'Citizens|error|exception'

DecentHolograms controleren:

sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager | \
grep -Ei 'DecentHolograms|hologram|error|exception'

De Lobby gebruikt drie belangrijke navigatiemethoden:

                    LOBBY
                      │
          ┌───────────┼───────────┐
          │           │           │
          ▼           ▼           ▼
     ⭐ Nether Star  NPC's    Hologrammen
          │           │
          ▼           ▼
      Servermenu   Spelserver
          │
     ┌────┼────┐
     ▼    ▼    ▼
 Survival Events SkyBlock

De Nether Star is de primaire navigatie vanuit de hotbar.

De NPC's vormen de belangrijkste visuele navigatie in de Lobby.

De hologrammen geven aanvullende informatie bij deze NPC's.

De Lobby is voorbereid op uitbreiding van Tulpencraft.

Mogelijke toekomstige spelservers:

• Survival;
• Events;
• SkyBlock;
• nieuwe tijdelijke spelmodi.

Een toekomstige SkyBlock-server kan bijvoorbeeld worden toegevoegd met:

Lobby
  │
  └── SkyBlock NPC
        │
        └── SkyBlock

De netwerkarchitectuur blijft daarbij hetzelfde:

Speler
  ↓
Velocity
  ↓
Lobby
  ↓
Spelserver

• Serverinfrastructuur — Overzicht
• Proxy
• Survival
• Events
• NPC's
• Hologrammen
• Servermenu
• Spawn
• Plugins

Laatste update: augustus 2026

De Lobby is het centrale startpunt van Tulpencraft. Wijzigingen aan de Lobby, plugins, spawn, NPC's of navigatiestructuur moeten ook in deze documentatie worden bijgewerkt.