# Technische infrastructuur

Deze pagina beschrijft de technische basis waarop het Tulpencraft-netwerk momenteel draait en hoe deze infrastructuur in de toekomst kan worden uitgebreid.

---

## Huidige infrastructuur

Tulpencraft draait momenteel als virtuele infrastructuur binnen een **Proxmox VE-omgeving**.

De primaire fysieke host waarop de Tulpencraft-VM's momenteel draaien is:

```text
hv002
```

Deze host wordt beschikbaar gesteld door **FastWebHosting.nl** en **Override.nl**. Naast Tulpencraft draait op deze fysieke host ook andere infrastructuur.

Tulpencraft maakt gebruik van de beschikbare overcapaciteit van deze host.

```text
                    hv002
              Proxmox VE 9.2
                     │
        ┌────────────┴────────────┐
        │                         │
        ▼                         ▼
   Tulpencraft VM's        Overige infrastructuur
```

De huidige situatie is daarmee een gedeelde virtualisatieomgeving. Tulpencraft beschikt over eigen VM's, maar niet over de volledige fysieke host.

---

# Proxmox-host `hv002`

| Eigenschap     | Waarde                            |
| -------------- | --------------------------------- |
| Hostname       | `hv002`                           |
| Hypervisor     | Proxmox VE                        |
| Proxmox-versie | 9.2.10                            |
| Kernel         | Linux 7.0.14-4-pve                |
| Boot           | EFI                               |
| CPU            | 32 logische CPU's                 |
| CPU-sockets    | 2                                 |
| CPU-model      | Intel Xeon Silver 4208 @ 2.10 GHz |
| RAM            | ± 1,01 TiB                        |
| Opslag         | ± 1,80 TiB                        |
| Swap           | 8 GiB                             |

De host beschikt over aanzienlijke capaciteit. Hierdoor is er momenteel voldoende ruimte om de Tulpencraft-infrastructuur verder uit te bouwen.

De beschikbare capaciteit wordt echter gedeeld met andere infrastructuur. Resourcegebruik wordt daarom actief meegewogen bij verdere uitbreiding.

---

# Virtuele machines

De Tulpencraft-componenten worden waar mogelijk als afzonderlijke VM's uitgevoerd.

Een vereenvoudigd overzicht:

```text
hv002
└── Proxmox VE
    │
    ├── mc-proxy001
    │   ├── Velocity
    │   ├── Lobby
    │   └── Database
    │
    ├── mc-survival001
    │   └── Paper Survival
    │
    ├── mc-events001
    │   └── Paper Events
    │
    └── toekomstige game-VM's
```

De exacte VM-indeling kan veranderen wanneer Tulpencraft groeit of wanneer een verdere scheiding van diensten technisch of organisatorisch wenselijk wordt.

---

# `mc-proxy001`

De VM `mc-proxy001` vormt momenteel het centrale onderdeel van de netwerk-infrastructuur.

Op deze VM draaien momenteel meerdere diensten:

* Velocity Proxy;
* de centrale Lobby;
* de database.

Dit is een bewuste keuze voor de huidige ontwikkel- en groeifase.

De Lobby is hierdoor momenteel niet ondergebracht in een afzonderlijke VM. Wanneer de schaal of belasting dit noodzakelijk maakt, kan de Lobby worden verplaatst naar een eigen VM.

---

# Game-servers

Game-servers worden zoveel mogelijk als afzonderlijke VM's uitgevoerd.

Hierdoor kunnen game-servers onafhankelijk van de netwerkdiensten worden beheerd en krijgen zij hun eigen resources.

Bijvoorbeeld:

```text
mc-survival001
└── Rocky Linux 10
    └── Paper
        └── Survival
```

Dit maakt het mogelijk om een game-server afzonderlijk te:

* starten;
* stoppen;
* herstarten;
* onderhouden;
* upgraden;
* migreren;
* voorzien van extra resources.

---

# Netwerkarchitectuur

Spelers verbinden niet rechtstreeks met de afzonderlijke backendservers.

De publieke toegang verloopt via Velocity:

```text
Speler
   │
   ▼
tulpencraft.nl
   │
   ▼
Velocity
   │
   ▼
Lobby
   │
   ├── Survival
   ├── Events
   └── toekomstige servers
```

De Lobby fungeert als centraal toegangspunt tot de rest van het netwerk.

Backendservers zijn niet bedoeld als zelfstandig publiek toegangspunt.

---

# Operating system

De Minecraft-VM's gebruiken als uitgangspunt **Rocky Linux 10**.

De technische lagen zijn daarmee:

```text
Fysieke hardware
       ↓
Proxmox VE
       ↓
Virtuele machine
       ↓
Rocky Linux 10
       ↓
Minecraft-server
```

De specifieke installatie en hardening van Rocky Linux worden afzonderlijk gedocumenteerd.

Zie:

* [[technische-infrastructuur:os-installatie|OS-installatie]]
* [[technische-infrastructuur:rocky-linux-10|Rocky Linux 10]]

---

# Schaalbaarheid

De huidige infrastructuur is bewust zo ingericht dat Tulpencraft later relatief eenvoudig kan worden opgeschaald.

Zolang `hv002` voldoende capaciteit beschikbaar heeft, kunnen extra VM's op deze host worden toegevoegd.

Wanneer de belasting verder toeneemt, zijn meerdere scenario's mogelijk.

### Scenario 1 — Uitbreiden binnen `hv002`

Extra VM's worden op de bestaande Proxmox-host geplaatst zolang daarvoor voldoende capaciteit beschikbaar is.

### Scenario 2 — Tweede Proxmox-node

Een tweede fysieke host kan worden toegevoegd.

```text
Proxmox hv002
├── netwerkdiensten
└── game-VM's

Proxmox hv003
└── aanvullende game-VM's
```

De game-servers kunnen dan over meerdere fysieke nodes worden verdeeld.

### Scenario 3 — Dedicated server

Wanneer de resourcebehoefte of belasting dit noodzakelijk maakt, kan Tulpencraft overstappen naar een eigen dedicated server.

Een dedicated omgeving geeft meer controle over:

* CPU;
* RAM;
* opslag;
* I/O;
* netwerk;
* resourceverdeling.

Daar staan echter ook aanzienlijk hogere structurele kosten tegenover.

---

# Resourcebeheer

Bij verdere groei wordt niet alleen gekeken naar de hoeveelheid beschikbare RAM of CPU.

Voor Minecraft zijn onder andere de volgende factoren belangrijk:

* CPU-performance per core;
* tick performance;
* RAM-gebruik;
* opslag-I/O;
* wereldgrootte;
* aantal spelers;
* pluginbelasting;
* view-distance;
* simulation-distance;
* netwerkbelasting.

Een uitbreiding wordt daarom gebaseerd op de daadwerkelijke belasting en niet uitsluitend op theoretisch beschikbare capaciteit.

---

# Migratie

Doordat Tulpencraft als VM's binnen Proxmox draait, is een toekomstige migratie naar andere hardware eenvoudiger dan wanneer de Minecraft-servers rechtstreeks op fysieke hardware zouden draaien.

De huidige infrastructuur kan daardoor worden beschouwd als een flexibele basis voor verdere groei.

Een toekomstige dedicated omgeving hoeft daarom niet te betekenen dat de volledige Tulpencraft-architectuur opnieuw moet worden opgebouwd.

---

# Hostingmodel

Tulpencraft maakt momenteel gebruik van **gastgebruik van beschikbare capaciteit** op `hv002`.

Dit is een belangrijke reden waarom het netwerk momenteel relatief kostenefficiënt kan worden ontwikkeld.

De huidige hostingvorm is geen garantie voor onbeperkte capaciteit. Wanneer de belasting van Tulpencraft of de belasting van de overige infrastructuur daartoe aanleiding geeft, kan in overleg worden gekeken naar uitbreiding, migratie of een eigen dedicated omgeving.

Voor meer informatie en onze dank aan de partijen die deze infrastructuur mogelijk maken, zie:

**[[technische-infrastructuur:dankwoord|Dankwoord]]**

---

> **Status:** Actieve infrastructuur

> **Primaire Proxmox-host:** `hv002`

> **Besturingssysteem Minecraft-VM's:** Rocky Linux 10

> **Virtualisatie:** Proxmox VE 9.2.10

> **Laatst bijgewerkt:** augustus 2026