Ga naar inhoud

Serverwidget voor je eigen website

Een klein blokje dat op jouw site laat zien of je Minecraft server online is, hoeveel spelers er nu spelen en hoeveel stemmen je deze maand hebt. Met een knop waarmee je bezoekers direct kunnen stemmen. Kies hieronder je server, kopieer de regel code en plak hem in je pagina.

1. Kies je server

Staat je server er niet bij? Dan is hij nog niet goedgekeurd of nog niet toegevoegd.

Gekozen: SuCraft.

2. Kies de maat en de kleur

De voorvertoning is de echte widget, live uit onze database.

Maat
Kleur van de widget
Achtergrond van de voorvertoning

Alleen om te kijken hoe het staat — dit komt niet in je code.

Voorvertoning van SuCraft.

3. Plak deze code op je site

Plak hem op de plek waar de widget moet staan. In WordPress is dat het blok Aangepaste HTML, in de meeste andere bouwers een blok dat “HTML” of “Embed” heet.

Iframe — werkt overal

aanbevolen
<iframe src="https://mineservers.nl/widget.php?slug=sucraft" width="300" height="210" style="border:none;border-radius:12px;" title="SuCraft op MineSERVERS.nl" loading="lazy" scrolling="no"></iframe>

Scripttag — past zich aan de breedte aan

alleen als je site <script> toestaat
<a href="https://mineservers.nl/server/sucraft" rel="noopener">SuCraft op MineSERVERS.nl</a>
<script src="https://mineservers.nl/widget.js" data-server="sucraft"></script>

Deze variant zet het iframe zelf neer en plaatst er een gewone tekstlink onder. Veel bouwers (Wix, Weebly, WordPress zonder de juiste rechten) verwijderen <script> uit je pagina; het iframe hierboven blijft daar wel staan. Werkt de scripttag niet, neem dan het iframe.

Liever een banner?

Een afbeelding van 468×60 die zichzelf bijwerkt. Handig voor forums, Discord en elke plek waar je geen HTML mag plaatsen maar wel een plaatje mag posten.

Banner van SuCraft met de actuele serverstatus

468 × 60 pixels, ververst elke 5 minuten.

HTML

<a href="https://mineservers.nl/server/sucraft" rel="noopener"><img src="https://mineservers.nl/banner.php?slug=sucraft" alt="SuCraft op MineSERVERS.nl" width="468" height="60"></a>

BBCode (forum)

[url=https://mineservers.nl/server/sucraft][img]https://mineservers.nl/banner.php?slug=sucraft[/img][/url]

Directe link naar de afbeelding

https://mineservers.nl/banner.php?slug=sucraft

Alle parameters

Je kunt de widget-URL ook met de hand samenstellen. Alles achter het vraagteken is optioneel, behalve slug. Een waarde die wij niet kennen wordt genegeerd; de widget valt dan terug op de standaard en blijft gewoon werken.

Parameters van de widget-URL
Parameter Waarden Standaard Wat het doet
slug je serverslug verplicht Het laatste stuk van je serverpagina-URL. Bij mineservers.nl/server/mijn-server is de slug mijn-server.
size normal, compact normal normal toont drie vakjes (status, spelers, stemmen) — neem 300×210. compact zet alles op één regel met alleen de stemknop eronder — neem 300×110.
theme dark, light, auto dark Donkere of lichte kaart. Met auto volgt de widget de systeeminstelling van je bezoeker, net als een site die zelf een donkere modus heeft.

Breedte en hoogte. De widget vult precies het vak dat je hem geeft. Wil je hem breder dan 300 pixels, zet dan gewoon een grotere width; de vakjes rekken mee. Maak je hem hoger, dan blijft de stemknop onderaan staan. Onder de 290 pixels breed worden de cijfers iets kleiner zodat er niets afgekapt wordt.

Verversen. De gegevens komen uit onze eigen metingen: wij pingen elke server elke vijf minuten. De widget zelf mag vijf minuten in de cache van je bezoeker blijven staan.

Meegroeien in de hoogte. De widget stuurt zijn hoogte naar de pagina waarin hij staat. Wil je het iframe automatisch laten meegroeien, geef het dan id="ms-widget" en zet dit erbij. Dit werkt met het iframe-fragment; de scripttag zet zijn iframe in een sandbox zonder scripts, dus daar stuurt de widget geen hoogte (nodig is het ook niet: die variant vult de breedte al vanzelf).

<script>
window.addEventListener('message', function (e) {
  if (e.origin !== 'https://mineservers.nl') return;
  if (e.data && e.data.type === 'mineservers:widget-height') {
    document.getElementById('ms-widget').style.height = e.data.height + 'px';
  }
});
</script>

Waarom zou je dit plaatsen?

Je bezoeker ziet meteen of je server draait. Dat is het eerste wat iemand wil weten die op je site belandt: kan ik nu inloggen, en is er iemand? De widget haalt dat uit onze meting van een paar minuten geleden, dus je hoeft er zelf niets voor bij te houden en er staat nooit een verouderd getal.

Je spelers kunnen stemmen zonder te zoeken. De knop gaat rechtstreeks naar het stemformulier van jouw server. Wie dagelijks stemt, hoeft niet eerst onze lijst door.

Alleen: die knop is pas iets waard als er een beloning tegenover staat. Van onze 225 goedgekeurde servers hebben er 14 Votifier ingesteld. Die 14 kregen deze maand samen 2.032 stemmen. De andere 211 samen 20. Zonder in-game beloning stemt bijna niemand, met stemknop of zonder. Zet Votifier dus eerst goed, dan pas deze widget.

Wat het níét doet

Deze widget stuurt je geen bezoekers, en we gaan niet doen alsof van wel. Gemeten van 25 mei tot en met 24 augustus 2026 haalden 184 serverpagina's op MineSERVERS.nl samen 85 klikken uit Google — ongeveer een halve klik per server per kwartaal. Wie je widget ziet, staat al op jóuw site. Het verkeer loopt van jou naar ons, niet andersom. Wat je ervoor terugkrijgt is de live status op je eigen pagina en een kortere weg naar de stemknop. Vindt je dat de moeite niet waard, plaats hem dan niet — dat is een prima uitkomst.

Werkt het niet?

Er staat “Server niet gevonden”
De slug in je code klopt niet, of je server is (nog) niet goedgekeurd. Haal de code hierboven opnieuw op; dan staat de juiste slug er gegarandeerd in.
Het blokje blijft leeg of ik zie alleen een rand
Waarschijnlijk stript je site het <script>-fragment. Gebruik dan de iframe-variant; die overleeft vrijwel elke editor.
De widget is afgeknipt
Controleer de height in je code: 210 voor normal, 110 voor compact. Geef je hem meer hoogte, dan wordt er niets afgeknipt — alleen minder hoogte kan wringen.
Mijn server staat op offline terwijl hij draait
Dan zit het probleem niet in de widget maar in onze ping. In de FAQ staat wat dat meestal is (verkeerde poort, firewall, of enable-query=false).
Ik wil hem weghalen
Verwijder de regel uit je pagina. Verder hoef je niets te doen en er verandert niets aan je vermelding bij ons.