> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.openminetopia.nl/llms.txt
> Use this file to discover all available pages before exploring further.

# Wat is het portaal

> Een open-source webapp waarin spelers hun rekeningen, plots, strafblad en meer zien, gekoppeld aan de OpenMinetopia-plugin.

Het portaal is een open-source webapp die met de OpenMinetopia-plugin praat. Spelers zien er in de browser hun bankrekeningen, plots, strafblad en meer. Het portaal is gebouwd met Laravel en staat op [GitHub](https://github.com/OpenMinetopia/portal). De code valt onder de GPL-3.0-licentie.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/dashboard-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=ad7f9692e171348659d7b69416051c5f" alt="Het overzicht van het portaal met saldo, aantal plots, baan, level en fitheid van de speler, en links het menu" width="1440" height="900" data-path="images/portaal/dashboard-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/dashboard-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=2d74603badafc2716e6607bc78ae6fec" alt="Het overzicht van het portaal met saldo, aantal plots, baan, level en fitheid van de speler, en links het menu" width="1440" height="900" data-path="images/portaal/dashboard-dark.webp" />
</Frame>

## Wat spelers kunnen

Een speler maakt een account aan op het portaal met zijn naam, e-mailadres, Minecraft-gebruikersnaam en een wachtwoord. Daarna koppelt hij zijn Minecraft-account in-game met `/koppel`. Pas na het koppelen kan hij de rest van het portaal gebruiken. Hoe dat werkt, lees je bij [Koppelen met de plugin](/portaal/koppelen).

| Onderdeel | Wat je ermee doet |
| - | - |
| **Overzicht** | Je saldo, het aantal plots, je baan (prefix), je level en je fitheid in één scherm. |
| **Mijn bankrekeningen** | Je rekeningen bekijken. Met de functie Banktransacties aan kun je geld overmaken naar je eigen rekeningen of naar een privérekening van een andere speler. |
| **Mijn plots** | Je plots bekijken. Ben je eigenaar van een plot, dan voeg je eigenaren en leden toe of haal je ze weg. |
| **Mijn strafblad** | Je eigen strafblad bekijken. |
| **Makelaar** | Plots te koop zetten en plots van anderen kopen. |
| **Mijn vergunningen** | Een vergunning aanvragen en je aanvragen volgen. |
| **Mijn bedrijven** en **Bedrijvenregister** | Een bedrijf aanvragen, de opheffing van je bedrijf aanvragen en het register doorzoeken. |

Kost een vergunning of bedrijf geld, dan betaal je met een van je bankrekeningen. Het geld gaat naar de uitbetalingsrekening die de beheerder heeft gekozen.

Het portaal heeft een licht en een donker thema. Je wisselt met de knop onderaan het menu.

<div className="grid grid-cols-1 sm:grid-cols-2 gap-4">
  <Frame caption="Mijn bankrekeningen">
    <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/bank-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=2c4a462fcec13fcb0fa5b86a3610e1ee" alt="De pagina Mijn bankrekeningen met het aantal rekeningen, het totale saldo en een tabel met een privérekening en een overheidsrekening" width="1440" height="900" data-path="images/portaal/bank-light.webp" />

    <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/bank-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=15f2207e04ffdd527977bfa559e8810b" alt="De pagina Mijn bankrekeningen met het aantal rekeningen, het totale saldo en een tabel met een privérekening en een overheidsrekening" width="1440" height="900" data-path="images/portaal/bank-dark.webp" />
  </Frame>

  <Frame caption="Mijn plots">
    <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/plots-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=0960fe92860795a0816d5b564620864a" alt="De pagina Mijn plots met drie plots, of je eigenaar of lid bent en de locatie van elke plot" width="1440" height="900" data-path="images/portaal/plots-light.webp" />

    <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/plots-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=ee5a36a936ee17bcee18ea62fadc9dd3" alt="De pagina Mijn plots met drie plots, of je eigenaar of lid bent en de locatie van elke plot" width="1440" height="900" data-path="images/portaal/plots-dark.webp" />
  </Frame>

  <Frame caption="Makelaar">
    <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/makelaar-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=35800a127c4fce945a2cb5b74c2bf132" alt="De makelaar met een plot te koop: prijs, verkoper, beschrijving, coördinaten en een knop om de plot te kopen" width="1440" height="900" data-path="images/portaal/makelaar-light.webp" />

    <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/makelaar-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=a636b71d11f1995f7112c9c4be965c19" alt="De makelaar met een plot te koop: prijs, verkoper, beschrijving, coördinaten en een knop om de plot te kopen" width="1440" height="900" data-path="images/portaal/makelaar-dark.webp" />
  </Frame>

  <Frame caption="Mijn vergunningen">
    <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/vergunningen-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=85cbde66886ece61abc115dcdbabeda3" alt="De pagina Vergunningen met drie vergunningen om aan te vragen, elk met prijs en vereiste informatie, en daaronder je eigen aanvragen" width="1440" height="900" data-path="images/portaal/vergunningen-light.webp" />

    <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/vergunningen-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=7b8c45a95f7dee2fabee3dfe83dfc3cf" alt="De pagina Vergunningen met drie vergunningen om aan te vragen, elk met prijs en vereiste informatie, en daaronder je eigen aanvragen" width="1440" height="900" data-path="images/portaal/vergunningen-dark.webp" />
  </Frame>

  <Frame caption="Bedrijvenregister">
    <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/bedrijven-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=f21b6d989ea3b9bff5effa88bfb9bbc2" alt="Het bedrijvenregister met zoeken op naam, KvK-nummer of beschrijving, filters op status en type, en een bedrijf met zijn KvK-nummer" width="1440" height="900" data-path="images/portaal/bedrijven-light.webp" />

    <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/bedrijven-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=d8ff6bc99464ec4b6289828ffd57efdd" alt="Het bedrijvenregister met zoeken op naam, KvK-nummer of beschrijving, filters op status en type, en een bedrijf met zijn KvK-nummer" width="1440" height="900" data-path="images/portaal/bedrijven-dark.webp" />
  </Frame>
</div>

## Wat beheerders kunnen

Beheerders en spelers met een rol die extra rechten geeft, zien extra onderdelen in het menu.

| Onderdeel | Voor wie | Wat je ermee doet |
| - | - | - |
| **Spelersdatabase** | Beheerders en rollen met het recht Agent | Spelers opzoeken en hun strafblad bekijken. |
| **Bedrijfsaanvragen** en **Opheffingsaanvragen** | Beheerders en rollen met het recht Bedrijven beheren | Aanvragen voor nieuwe bedrijven en opheffingen goedkeuren of afwijzen. |
| **Alle aanvragen** (vergunningen) | Beheerders en rollen met het recht Vergunningen beheren | Vergunningaanvragen afhandelen. |
| **Type bedrijven** en **Type vergunningen** | Beheerders | Bepalen welke bedrijven en vergunningen spelers kunnen aanvragen. |
| **Gebruikers** | Beheerders | Accounts bekijken en rollen toekennen. |
| **Plots** | Beheerders | Alle plots bekijken en eigenaren en leden aanpassen. |
| **Rollen** | Beheerders | Rollen maken en rechten toekennen. |
| **Instellingen** | Beheerders | Functies aan- of uitzetten en de uitbetalingsrekening voor vergunningen en bedrijven kiezen. |

Deze functies staan in een nieuw portaal uit. Een beheerder zet ze aan bij **Instellingen**:

* **Bedrijven**
* **Vergunningen**
* **Makelaar**
* **Banktransacties**

<Frame caption="Instellingen">
  <img className="block dark:hidden" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/beheer-light.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=61f7a9bd2d62df2a1f56eb101b74362b" alt="De instellingen voor beheerders met vinkjes voor Bedrijven, Vergunningen, Makelaar en Banktransacties, en de status van de verbinding met de plugin" width="1440" height="900" data-path="images/portaal/beheer-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/openminetopia/q-XaDoEyyVdD0Jh4/images/portaal/beheer-dark.webp?fit=max&auto=format&n=q-XaDoEyyVdD0Jh4&q=85&s=b20650dc3100366cc156563372167057" alt="De instellingen voor beheerders met vinkjes voor Bedrijven, Vergunningen, Makelaar en Banktransacties, en de status van de verbinding met de plugin" width="1440" height="900" data-path="images/portaal/beheer-dark.webp" />
</Frame>

<Note>
  Wie zich registreert, wordt gewone speler. Je wordt beheerder via een eenmalige link, of doordat een andere beheerder je een beheerdersrol geeft bij **Gebruikers**. Bij een gehost portaal krijg je de link via de knop **Inloggen als beheerder** op openminetopia.nl. Zie [Gehost portaal](/portaal/gehost#beheerder-worden). Host je het portaal zelf, dan maak je de link op de server met `php artisan portal:admin-link`, of met `openminetopia-portal admin-link` als je het installatiescript gebruikte.
</Note>

## Hoe het portaal met de plugin praat

Het portaal en de plugin praten in twee richtingen met elkaar.

* **Portaal naar plugin.** Het portaal haalt de gegevens uit de game op via de [REST API](/plugin/rest-api) van de plugin. Het stuurt bij elke aanvraag de `api-key` uit `rest-api` in de header `X-API-Key` mee. Zonder geldige key antwoordt de plugin met 401.
* **Plugin naar portaal.** Typt een speler `/koppel <code>`, dan roept de plugin `/api/minecraft/verify` op het portaal aan. De plugin stuurt daarbij de `token` uit `portal` mee als `X-API-Key`.

De plugin moet dus bereikbaar zijn voor het portaal, en het portaal voor de plugin. Welke instellingen daarvoor nodig zijn, staat bij [Koppelen met de plugin](/portaal/koppelen).

## Gehost of zelf hosten

Je kunt het portaal op twee manieren draaien.

<CardGroup cols={2}>
  <Card title="Gehost via openminetopia.nl" icon="cloud" href="/portaal/gehost">
    Gratis. Je krijgt een portaal op een eigen adres op `mtportal.nl`. Wij regelen de server.
  </Card>

  <Card title="Zelf hosten" icon="server" href="/portaal/zelf-hosten">
    Draai het portaal op je eigen server, met Docker, Pterodactyl of een eigen webserver.
  </Card>
</CardGroup>

Host je het zelf, dan kies je een van deze manieren:

* [Installatiescript](/portaal/zelf-hosten/installatiescript): één commando dat het portaal met Docker installeert.
* [Docker](/portaal/zelf-hosten/docker): het portaal zelf met Docker Compose draaien.
* [Pterodactyl](/portaal/zelf-hosten/pterodactyl): het portaal als server in je Pterodactyl-panel.
* [Handmatig](/portaal/zelf-hosten/handmatig): met PHP, Composer en Node.js op je eigen webserver.

Draait je portaal al? Lees dan hoe je het [bijwerkt](/portaal/updaten) en wat je doet bij [problemen](/portaal/problemen).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.