Skip to main content
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. De code valt onder de GPL-3.0-licentie.
Het overzicht van het portaal met saldo, aantal plots, baan, level en fitheid van de speler, en links het menuHet overzicht van het portaal met saldo, aantal plots, baan, level en fitheid van de speler, en links het menu

​
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. 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.
De pagina Mijn bankrekeningen met het aantal rekeningen, het totale saldo en een tabel met een privérekening en een overheidsrekeningDe pagina Mijn bankrekeningen met het aantal rekeningen, het totale saldo en een tabel met een privérekening en een overheidsrekening

Mijn bankrekeningen

De pagina Mijn plots met drie plots, of je eigenaar of lid bent en de locatie van elke plotDe pagina Mijn plots met drie plots, of je eigenaar of lid bent en de locatie van elke plot

Mijn plots

De makelaar met een plot te koop: prijs, verkoper, beschrijving, coördinaten en een knop om de plot te kopenDe makelaar met een plot te koop: prijs, verkoper, beschrijving, coördinaten en een knop om de plot te kopen

Makelaar

De pagina Vergunningen met drie vergunningen om aan te vragen, elk met prijs en vereiste informatie, en daaronder je eigen aanvragenDe pagina Vergunningen met drie vergunningen om aan te vragen, elk met prijs en vereiste informatie, en daaronder je eigen aanvragen

Mijn vergunningen

Het bedrijvenregister met zoeken op naam, KvK-nummer of beschrijving, filters op status en type, en een bedrijf met zijn KvK-nummerHet bedrijvenregister met zoeken op naam, KvK-nummer of beschrijving, filters op status en type, en een bedrijf met zijn KvK-nummer

Bedrijvenregister

​
Wat beheerders kunnen

Beheerders en spelers met een rol die extra rechten geeft, zien extra onderdelen in het menu. Deze functies staan in een nieuw portaal uit. Een beheerder zet ze aan bij Instellingen:
  • Bedrijven
  • Vergunningen
  • Makelaar
  • Banktransacties
De instellingen voor beheerders met vinkjes voor Bedrijven, Vergunningen, Makelaar en Banktransacties, en de status van de verbinding met de pluginDe instellingen voor beheerders met vinkjes voor Bedrijven, Vergunningen, Makelaar en Banktransacties, en de status van de verbinding met de plugin

Instellingen

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. 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.

​
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 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.

​
Gehost of zelf hosten

Je kunt het portaal op twee manieren draaien.

Gehost via openminetopia.nl

Gratis. Je krijgt een portaal op een eigen adres op mtportal.nl. Wij regelen de server.

Zelf hosten

Draai het portaal op je eigen server, met Docker, Pterodactyl of een eigen webserver.
Host je het zelf, dan kies je een van deze manieren:
  • Installatiescript: één commando dat het portaal met Docker installeert.
  • Docker: het portaal zelf met Docker Compose draaien.
  • Pterodactyl: het portaal als server in je Pterodactyl-panel.
  • Handmatig: met PHP, Composer en Node.js op je eigen webserver.
Draait je portaal al? Lees dan hoe je het bijwerkt en wat je doet bij problemen.