Deze pagina beschrijft de technische basis waarop het Tulpencraft-netwerk draait.

Waar Serverinfrastructuur — Overzicht beschrijft welke servers binnen Tulpencraft aanwezig zijn en welke functie ze hebben, beschrijft deze sectie hoe de onderliggende systemen technisch zijn opgebouwd en beheerd.

Tulpencraft bestaat uit een centrale netwerklaag met daarachter de verschillende Minecraft-servers.

De huidige infrastructuur is bewust compact opgezet. De Velocity Proxy en de Lobby draaien momenteel op dezelfde node.

                         INTERNET
                             │
                             ▼
                  ┌─────────────────────┐
                  │     mc-proxy001     │
                  │                     │
                  │  Rocky Linux 10     │
                  │                     │
                  │  ┌───────────────┐  │
                  │  │    Velocity   │  │
                  │  │     Proxy     │  │
                  │  └───────┬───────┘  │
                  │          │          │
                  │  ┌───────▼───────┐  │
                  │  │     Lobby     │  │
                  │  │     Paper     │  │
                  │  └───────┬───────┘  │
                  └──────────┼──────────┘
                             │
                ┌────────────┼────────────┐
                ▼            ▼            ▼
           Survival       Events       SkyBlock

De volgende onderdelen draaien momenteel gezamenlijk op:

mc-proxy001

De huidige combinatie van Proxy en Lobby op mc-proxy001 is een bewuste ontwerpkeuze.

Tulpencraft bevindt zich momenteel in de opbouwfase. Een aparte fysieke of virtuele node voor de Lobby zou op dit moment extra infrastructuur- en beheerkosten veroorzaken, terwijl de belasting van de Lobby relatief beperkt is.

Daarom worden Proxy en Lobby voorlopig gecombineerd op één node.

De voordelen hiervan zijn:

• lagere infrastructuurkosten;
• minder nodes om te beheren;
• eenvoudiger onderhoud;
• minder netwerkcomplexiteit;
• efficiënter gebruik van beschikbare resources.

De architectuur blijft echter zo ingericht dat de Lobby in de toekomst naar een aparte node kan worden verplaatst.

Wanneer Tulpencraft groeit, kan de Lobby worden afgesplitst.

De huidige situatie:

mc-proxy001
├── Velocity
└── Lobby

Een toekomstige situatie kan bijvoorbeeld zijn:

mc-proxy001
└── Velocity
 
mc-lobby001
└── Lobby

Daarmee ontstaat:

Internet
   │
   ▼
mc-proxy001
Velocity
   │
   ▼
mc-lobby001
Paper Lobby
   │
   ├──► Survival
   ├──► Events
   └──► SkyBlock

Deze uitbreiding vereist geen fundamentele wijziging aan het netwerkconcept.

De huidige infrastructuur bestaat uit een beperkt aantal nodes.

Concrete hostnames van toekomstige backendservers worden pas aan de documentatie toegevoegd zodra deze daadwerkelijk zijn ingericht.

De gewenste verbindingsroute voor spelers is:

Speler
  │
  ▼
Internet
  │
  ▼
mc-proxy001
Velocity
  │
  ▼
Lobby
  │
  ├──────────► Survival
  │
  ├──────────► Events
  │
  └──────────► SkyBlock

De speler heeft uitsluitend een publieke verbinding met de netwerkentree.

Backendservers zijn niet zelfstandig vanaf het internet bereikbaar.

Velocity vormt de centrale netwerklaag.

De proxy draait momenteel op:

mc-proxy001

Velocity verzorgt onder andere:

• de eerste verbinding van spelers;
• doorsturen naar de Lobby;
• serverselectie;
• verbindingen met backendservers;
• moderne forwarding;
• netwerkbrede communicatie.

Zie:

• Proxy

De Lobby draait momenteel eveneens op:

mc-proxy001

De Lobby gebruikt:

Paper

en vormt de centrale gebruikersomgeving van Tulpencraft.

De Lobby bevat onder andere:

• NPC's;
• hologrammen;
• servermenu;
• scoreboard;
• tablist;
• spawn;
• lobby-items;
• navigatie naar spelservers.

Zie:

• Lobby

Backendservers bevatten de daadwerkelijke spelwerelden.

Voorbeelden zijn:

• Survival;
• Events;
• toekomstige SkyBlock;
• toekomstige andere spelmodi.

Deze servers zijn geen zelfstandige publieke Minecraft-servers.

De toegang verloopt via:

Client
  ↓
Velocity
  ↓
Lobby
  ↓
Backendserver

De Tulpencraft-nodes gebruiken als uitgangspunt:

Rocky Linux 10

Rocky Linux vormt de basis voor:

• Minecraft;
• Velocity;
• Java;
• systemd;
• netwerkconfiguratie;
• firewalld;
• SELinux;
• logging;
• beheer.

Zie:

• OS-installatie
• Rocky Linux 10
• Server hardening

De Minecraft-infrastructuur gebruikt:

Java 25

Java wordt op de betreffende Minecraft-nodes geïnstalleerd en beheerd.

Zie:

• Java

De servers gebruiken:

firewalld

Het uitgangspunt is:

Alleen noodzakelijke netwerkverbindingen worden toegestaan.

De publieke Minecraft-poort wordt op de netwerkentree beschikbaar gesteld. Backendservers worden niet rechtstreeks aan het internet blootgesteld.

Zie:

• Firewall

SELinux wordt gebruikt als aanvullende beveiligingslaag.

Het uitgangspunt is:

SELinux = Enforcing

SELinux wordt niet uitgeschakeld om applicatieproblemen op te lossen. Problemen worden opgelost door de juiste contexten en policies te configureren.

Zie:

• SELinux

Minecraft-componenten worden als systemd-services beheerd.

De huidige node bevat bijvoorbeeld:

velocity
minecraft-lobby

Hierdoor kunnen services:

• automatisch starten;
• gecontroleerd worden gestopt;
• worden herstart;
• via journald worden gelogd;
• centraal worden beheerd.

Voorbeeld:

sudo systemctl status minecraft-lobby

De Minecraft-installaties bevinden zich onder:

/srv/minecraft/

De huidige structuur bevat onder andere:

/srv/minecraft/
├── velocity/
└── lobby/

Wanneer aanvullende servers worden toegevoegd, krijgen deze hun eigen directory.

Bijvoorbeeld:

/srv/minecraft/
├── velocity/
├── lobby/
├── survival/
└── events/

Systeem- en servicegegevens worden via systemd/journald beschikbaar gesteld.

Voorbeeld:

sudo journalctl -u minecraft-lobby -f

Voor Velocity:

sudo journalctl -u velocity -f

Fouten kunnen bijvoorbeeld worden gezocht met:

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

Zie:

• Monitoring & logging

Minecraft-data wordt lokaal op de betreffende node opgeslagen.

Belangrijke data bestaat onder andere uit:

• werelden;
• plugins;
• configuraties;
• logs;
• serverdata;
• gebruikersdata.

Storagegebruik moet worden gemonitord omdat Minecraft-werelden en logs in de loop van de tijd kunnen groeien.

Zie:

• Storage

Backups moeten in ieder geval de kritieke Minecraft-data beschermen.

Belangrijke backupdoelen zijn:

• Minecraft-werelden;
• configuraties;
• pluginconfiguraties;
• belangrijke scripts;
• serverdata.

GitHub kan worden gebruikt voor broncode, configuraties en scripts, maar is geen vervanging voor backups van Minecraft-werelden.

Zie:

• Backups

De Tulpencraft-infrastructuur volgt een aantal basisprincipes:

1. Backendservers zijn niet publiek bereikbaar.
2. Alleen noodzakelijke firewallpoorten worden geopend.
3. SELinux blijft ingeschakeld.
4. SSH wordt beveiligd.
5. Minecraft-services draaien niet onnodig met rootrechten.
6. Geheimen worden niet opgeslagen in Git of de wiki.
7. Configuraties worden zoveel mogelijk reproduceerbaar beheerd.
8. Wijzigingen worden gedocumenteerd.
9. Plugins worden bewust geselecteerd.
10. De Velocity Proxy vormt het centrale toegangspunt van het netwerk.

De infrastructuur wordt ingericht met reproduceerbaarheid als uitgangspunt.

Een nieuwe node moet zoveel mogelijk opnieuw kunnen worden opgebouwd aan de hand van:

• OS-installatiedocumentatie;
• hardeningdocumentatie;
• installatiecommando's;
• configuratiebestanden;
• systemd-units;
• scripts;
• GitHub-repositories.

De wiki beschrijft voornamelijk de architectuur, keuzes en procedures.

GitHub bevat waar mogelijk de daadwerkelijke configuratiebestanden en scripts.

• Serverinfrastructuur — Overzicht
• Proxy
• Lobby
• Survival
• Events

• OS-installatie
• Rocky Linux 10
• Server hardening
• Java
• Firewall
• SELinux
• systemd
• Storage
• Monitoring & logging
• Backups

Laatste update: augustus 2026

De huidige infrastructuur is bewust compact opgezet. De combinatie van Velocity en de Lobby op mc-proxy001 is een kosten- en efficiëntiekeuze en kan in de toekomst worden gescheiden wanneer schaal, belasting of beschikbaarheid daar aanleiding toe geeft.