# Lobby

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

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.

De Lobby is daarmee de centrale gebruikersinterface van Tulpencraft.

---

## 🌐 Basisinformatie

| Eigenschap         | Waarde         |
| ------------------ | -------------- |
| Hostname           | `mc-proxy001`  |
| Platform           | Paper          |
| Rol                | Centrale Lobby |
| Wereld             | `world`        |
| Toegang            | Via Velocity   |
| Publiek bereikbaar | ❌ Nee         |
| Minecraft-netwerk  | Tulpencraft    |

De Lobby is **niet zelfstandig vanaf het internet bereikbaar**.

De gewenste netwerkroute is:

```text
Speler
  ↓
tulpencraft.nl
  ↓
Velocity Proxy
  ↓
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.