serverinfrastructuur:lobby

Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

Link naar deze vergelijking

Beide kanten vorige revisie Vorige revisie
Volgende revisie		 Vorige revisie
serverinfrastructuur:lobby [2026/08/25 07:00] – rroethofserverinfrastructuur:lobby [2026/08/25 07:09] (huidige) – [🏗️ Positie binnen het netwerk] rroethof
Regel 3: Regel 3:
 De **Lobby** is het centrale startpunt van het Tulpencraft-netwerk. De **Lobby** is het centrale startpunt van het Tulpencraft-netwerk.
  
-Wanneer een speler via de [[serverinfrastructuur:proxy|Velocity Proxy]] verbinding maakt +Wanneer een speler via de [[serverinfrastructuur:proxy|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.
-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 daarmee de centrale gebruikersinterface van Tulpencraft.
Regel 20: Regel 18:
 | Wereld             | `world`        | | Wereld             | `world`        |
 | Toegang            | Via Velocity   | | Toegang            | Via Velocity   |
-| Publiek bereikbaar | ❌ Nee          |+| Publiek bereikbaar | ❌ Nee         |
 | Minecraft-netwerk  | Tulpencraft    | | Minecraft-netwerk  | Tulpencraft    |
  
-De Lobby en Velocity draaien op dezelfde server: **mc-proxy001**. +De Lobby is **niet zelfstandig vanaf het internet bereikbaar**.
- +
-De Lobby is niet rechtstreeks vanaf het internet bereikbaar.+
  
 De gewenste netwerkroute is: De gewenste netwerkroute is:
Regel 37: Regel 33:
   ↓   ↓
 Lobby Lobby
 +```
 +
 +Vanuit de Lobby worden spelers vervolgens naar de beschikbare spelservers gestuurd.
 +
 +---
 +
 +# 🏗️ Positie binnen het netwerk
 +
 +```text
 +                         INTERNET
 +                             │
 +                             ▼
 +                    ┌─────────────────┐
 +                    │ Velocity Proxy  │
 +                    │   mc-proxy001   │
 +                    └────────┬────────┘
 +                             │
 +                             ▼
 +                    ┌─────────────────┐
 +                    │      LOBBY      │
 +                    │   mc-proxy001   │
 +                    │      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.
 +
 +---
 +
 +# 🎮 Functie van de Lobby
 +
 +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.
 +
 +---
 +
 +# 📦 Platform
 +
 +De Lobby draait op:
 +
 +```text
 +Paper
 +```
 +
 +De serverbestanden bevinden zich onder:
 +
 +```text
 +/srv/minecraft/lobby/
 +```
 +
 +Plugins:
 +
 +```text
 +/srv/minecraft/lobby/plugins/
 +```
 +
 +De Lobby wordt beheerd als systemd-service:
 +
 +```text
 +minecraft-lobby
 +```
 +
 +---
 +
 +# 🔌 Geïnstalleerde plugins
 +
 +| Plugin          |                       Versie | Functie                       |
 +| --------------- | ---------------------------: | ----------------------------- |
 +| Citizens        | 2.0.43-SNAPSHOT (build 4237) | NPC's                         |
 +| DecentHolograms |                       2.10.1 | Hologrammen                   |
 +| LobbyPlugin     |                          2.0 | Algemene lobbyfunctionaliteit |
 +| LuckPerms       |                       5.5.77 | Rechten en groepen            |
 +| TAB             |                        6.1.2 | Tablist en spelersinformatie  |
 +| WorldEdit       |           7.4.5+7590-b8dc4c1 | Wereldbewerking               |
 +| WorldGuard      |          7.0.18+2392-fa605e6 | Wereldbeveiliging             |
 +| bStats          |                            — | Pluginstatistieken            |
 +
 +Plugins controleren:
 +
 +```bash
 +ls /srv/minecraft/lobby/plugins/
 +```
 +
 +---
 +
 +# 🧍 Citizens
 +
 +[[plugins:citizens|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.
 +
 +### Huidige status
 +
 +```text
 +Citizens
 +2.0.43-SNAPSHOT (build 4237)
 +```
 +
 +Citizens wordt tijdens het starten van de Lobby voorzien van de benodigde libraries.
 +
 +---
 +
 +# ✨ DecentHolograms
 +
 +[[plugins:decentholograms|DecentHolograms]] wordt gebruikt voor zwevende teksten in de Lobby.
 +
 +Hologrammen worden onder andere gebruikt bij NPC's.
 +
 +Een voorbeeld van de huidige presentatie:
 +
 +```text
 +SURVIVAL
 +
 +Bouw, overleef en ontdek!
 +
 +Rechtermuisknop om te spelen
 +```
 +
 +De hologrammen zijn onafhankelijk van Citizens en kunnen afzonderlijk worden beheerd.
 +
 +---
 +
 +# 🏠 LobbyPlugin
 +
 +[[plugins:lobbyplugin|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:
 +
 +```text
 +/srv/minecraft/lobby/plugins/LobbyPlugin/config.yml
 +```
 +
 +---
 +
 +# 🎒 Lobby-items
 +
 +Bij het betreden van de Lobby ontvangt een speler een aantal speciale items.
 +
 +De huidige primaire Lobby-items zijn:
 +
 +| Slot | Item           | Functie    |
 +| ---: | -------------- | ---------- |
 +|    0 | ⭐ Nether Star  | Servermenu |
 +|    8 | 🧑 Player Head | Profiel    |
 +
 +Deze items vormen de belangrijkste interactieve elementen van de Lobby.
 +
 +---
 +
 +## ⭐ Nether Star — Servermenu
 +
 +De **Nether Star** is het centrale navigatie-item van Tulpencraft.
 +
 +Naam:
 +
 +```text
 +Servermenu (Rechtermuisknop)
 +```
 +
 +Slot:
 +
 +```text
 +0
 +```
 +
 +Materiaal:
 +
 +```text
 +NETHER_STAR
 +```
 +
 +Configuratie:
 +
 +```yaml
 +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.
 +
 +---
 +
 +## 🧑 Player Head — Profiel
 +
 +De **Player Head** wordt gebruikt voor het persoonlijke profiel.
 +
 +Naam:
 +
 +```text
 +Profiel (Rechtermuisknop)
 +```
 +
 +Slot:
 +
 +```text
 +8
 +```
 +
 +Materiaal:
 +
 +```text
 +PLAYER_HEAD
 +```
 +
 +Configuratie:
 +
 +```yaml
 +profile-slot: 8
 +profile-name: '&e&lProfiel &7(Rechtermuisknop)'
 +profile-material: PLAYER_HEAD
 +```
 +
 +---
 +
 +## ❌ Compass
 +
 +Een **Compass** wordt momenteel **niet gebruikt** als Lobby-navigatie.
 +
 +Een eerdere configuratie gebruikte:
 +
 +```text
 +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.
 +
 +---
 +
 +# 🧭 Servermenu
 +
 +Het servermenu van de LobbyPlugin bevat momenteel onder andere:
 +
 +| Slot | Server   | Materiaal     |
 +| ---: | -------- | ------------- |
 +|   11 | Survival | `GRASS_BLOCK` |
 +|   13 | Events   | `NETHER_STAR` |
 +|   15 | Lobby    | `COMPASS`     |
 +
 +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.
 +
 +---
 +
 +# 🧍 NPC-navigatie
 +
 +Naast het servermenu worden NPC's gebruikt voor belangrijke servers.
 +
 +De globale navigatiestructuur is:
 +
 +```text
 +                 LOBBY
 +                   │
 +          ┌────────┴────────┐
 +          │                 │
 +     Servermenu            NPC's
 +          │                 │
 +     ┌────┼────┐       ┌────┼────┐
 +     ▼    ▼    ▼       ▼    ▼    ▼
 + Survival Events ... Survival Events SkyBlock
 +```
 +
 +NPC's zijn vooral bedoeld als **visuele en directe toegang** tot belangrijke spelmodi.
 +
 +---
 +
 +# 📊 Scoreboard
 +
 +De Lobby gebruikt een scoreboard.
 +
 +Titel:
 +
 +```text
 +▸ TULPENCRAFT ◂
 +```
 +
 +Het scoreboard toont onder andere:
 +
 +* spelernaam;
 +* rang;
 +* aantal online spelers;
 +* speeltijd;
 +* servernaam.
 +
 +Voorbeeld:
 +
 +```text
 +--------------------
 +Speler: <speler>
 +Rang: <rang>
 +
 +Online: <online>/<max>
 +Speeltijd: <speeltijd>
 +
 +Server: tulpencraft.nl
 +--------------------
 +```
 +
 +Configuratie:
 +
 +```text
 +/srv/minecraft/lobby/plugins/LobbyPlugin/config.yml
 +```
 +
 +---
 +
 +# 👥 TAB
 +
 +[[plugins:tab|TAB]] verzorgt de tablist en spelersinformatie.
 +
 +Configuratie:
 +
 +```text
 +/srv/minecraft/lobby/plugins/TAB/
 +```
 +
 +Belangrijke configuratiebestanden zijn:
 +
 +```text
 +config.yml
 +groups.yml
 +users.yml
 +messages.yml
 +animations.yml
 +```
 +
 +---
 +
 +# 🔐 LuckPerms
 +
 +[[plugins:luckperms|LuckPerms]] verzorgt het rechtenbeheer.
 +
 +Configuratie:
 +
 +```text
 +/srv/minecraft/lobby/plugins/LuckPerms/
 +```
 +
 +LuckPerms bepaalt welke groepen en permissies spelers binnen de Lobby hebben.
 +
 +---
 +
 +# 🧱 WorldEdit
 +
 +[[plugins:worldedit|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
 +
 +[[plugins:worldguard|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.
 +
 +---
 +
 +# 📍 Lobby-spawn
 +
 +De huidige Lobby-spawn:
 +
 +```text
 +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:
 +
 +```text
 +/srv/minecraft/lobby/plugins/LobbyPlugin/config.yml
 +```
 +
 +---
 +
 +# 🌍 Lobbywereld
 +
 +De actieve Lobbywereld is:
 +
 +```text
 +world
 +```
 +
 +Configuratie:
 +
 +```yaml
 +lobby-world: world
 +```
 +
 +Deze wereld is specifiek bedoeld voor de centrale Lobby.
 +
 +---
 +
 +# 🚀 Double Jump
 +
 +De Lobby ondersteunt double jump.
 +
 +Configuratie:
 +
 +```yaml
 +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.
 +
 +---
 +
 +# 🚀 Launch Pads
 +
 +De Lobby ondersteunt launch pads.
 +
 +Een launch pad wordt geactiveerd via een pressure plate boven een geschikt blok.
 +
 +Huidige configuratie:
 +
 +```yaml
 +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.
 +
 +---
 +
 +# 🚫 Beveiliging
 +
 +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.
 +
 +---
 +
 +# 🧑‍💻 Beheer
 +
 +### Status
 +
 +```bash
 +sudo systemctl status minecraft-lobby
 +```
 +
 +### Starten
 +
 +```bash
 +sudo systemctl start minecraft-lobby
 +```
 +
 +### Stoppen
 +
 +```bash
 +sudo systemctl stop minecraft-lobby
 +```
 +
 +### Herstarten
 +
 +```bash
 +sudo systemctl restart minecraft-lobby
 +```
 +
 +---
 +
 +# 📜 Logs
 +
 +Live logs:
 +
 +```bash
 +sudo journalctl -u minecraft-lobby -f
 +```
 +
 +Recente logs:
 +
 +```bash
 +sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager
 +```
 +
 +Fouten zoeken:
 +
 +```bash
 +sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager | \
 +grep -Ei 'error|exception|warn'
 +```
 +
 +Citizens controleren:
 +
 +```bash
 +sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager | \
 +grep -Ei 'Citizens|error|exception'
 +```
 +
 +DecentHolograms controleren:
 +
 +```bash
 +sudo journalctl -u minecraft-lobby --since "10 minutes ago" --no-pager | \
 +grep -Ei 'DecentHolograms|hologram|error|exception'
 +```
 +
 +---
 +
 +# 📁 Belangrijke directories
 +
 +| Directory                                       | Functie         |
 +| ----------------------------------------------- | --------------- |
 +| `/srv/minecraft/lobby/`                         | Volledige Lobby |
 +| `/srv/minecraft/lobby/plugins/`                 | Plugins         |
 +| `/srv/minecraft/lobby/plugins/LobbyPlugin/`     | LobbyPlugin     |
 +| `/srv/minecraft/lobby/plugins/Citizens/`        | Citizens        |
 +| `/srv/minecraft/lobby/plugins/DecentHolograms/` | Hologrammen     |
 +| `/srv/minecraft/lobby/plugins/LuckPerms/`       | Rechtenbeheer   |
 +| `/srv/minecraft/lobby/plugins/TAB/`             | Tablist         |
 +| `/srv/minecraft/lobby/plugins/WorldEdit/`       | WorldEdit       |
 +| `/srv/minecraft/lobby/plugins/WorldGuard/`      | WorldGuard      |
 +
 +---
 +
 +# 🧭 Navigatiestructuur
 +
 +De Lobby gebruikt drie belangrijke navigatiemethoden:
 +
 +```text
 +                    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.
 +
 +---
 +
 +# 🚀 Toekomstige uitbreiding
 +
 +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:
 +
 +```text
 +Lobby
 +  │
 +  └── SkyBlock NPC
 +        │
 +        └── SkyBlock
 +```
 +
 +De netwerkarchitectuur blijft daarbij hetzelfde:
 +
 +```text
 +Speler
 +  ↓
 +Velocity
 +  ↓
 +Lobby
 +  ↓
 +Spelserver
 +```
 +
 +---
 +
 +# 📋 Huidige status
 +
 +| Onderdeel              | Status             |
 +| ---------------------- | ------------------ |
 +| Paper Lobby            | 🟢 Actief          |
 +| Lobby-spawn            | 🟢 Actief          |
 +| Nether Star servermenu | 🟢 Actief          |
 +| Player Head profiel    | 🟢 Actief          |
 +| Citizens NPC's         | 🟢 Actief          |
 +| DecentHolograms        | 🟢 Actief          |
 +| Scoreboard             | 🟢 Actief          |
 +| TAB                    | 🟢 Actief          |
 +| LuckPerms              | 🟢 Actief          |
 +| WorldEdit              | 🟢 Actief          |
 +| WorldGuard             | 🟢 Actief          |
 +| Survival               | 🟡 In ontwikkeling |
 +| Events                 | 🟡 In ontwikkeling |
 +| SkyBlock               | ⚪ Toekomstig       |
 +
 +---
 +
 +# 📚 Gerelateerde pagina's
 +
 +* [[serverinfrastructuur:overzicht|Serverinfrastructuur — Overzicht]]
 +* [[serverinfrastructuur:proxy|Proxy]]
 +* [[serverinfrastructuur:survival|Survival]]
 +* [[serverinfrastructuur:events|Events]]
 +* [[lobby:npcs|NPC's]]
 +* [[lobby:hologrammen|Hologrammen]]
 +* [[lobby:servermenu|Servermenu]]
 +* [[lobby:spawn|Spawn]]
 +* [[plugins:start|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.
 +
  • serverinfrastructuur/lobby.1787634040.txt.gz
  • Laatst gewijzigd: 2026/08/25 07:00
  • door rroethof