# A Play button for your server

> Put a one-click Play button on your own website: it installs your modpack, saves your address and drops the player onto your server.

Source: https://stygion.eu/docs/launcher/play-tlacitko
Updated: 2026-10-09

If you run a Minecraft server, the hardest part of getting somebody in is everything before the game starts: find the modpack, find the right version, install it, add the address, connect. A Play button does all of it from one click on your own page.

## What the player sees

1. They click **Play** on your website (or on your link on Discord or a forum). They land on the button's page, `stygion.eu/play/<token>`, which shows your server and pack.
2. The launcher opens and asks one question: *Join **your server**? It will install **your pack**.*
3. They say yes, and nothing else is asked of them. The pack downloads, your address is saved in their server list, the game starts and they arrive on your server.

Two things still interrupt, and both are meant to. On a first-ever install they sign in to Minecraft — that is Mojang's, not ours. And a modpack whose author disabled distribution on CurseForge sends them through that file's CurseForge page, because the author asked for that.

Somebody who does not have the launcher yet lands on a page that explains what this is and offers the download. They never see an error.

## Making one

Open **[stygion.eu/launcher/play-button](https://stygion.eu/launcher/play-button)** and sign in with a STYGION ID (Discord, Microsoft, GitHub or Google). A button belongs to your account — it cannot be made without one. You need:

| Field | What goes in it |
|---|---|
| **Server address** | Exactly what a player types into Minecraft — `play.example.com`, or with a port. Not a web address. |
| **Server name** | Optional, up to 32 characters. Left out, the pack's own name. |
| **A sentence about the server** | Optional, up to 200 characters, plain words, no links, e-mails or Discord invites. |
| **Modpack** | Optional; empty means vanilla. Paste the pack's Modrinth address and it fills itself in; for CurseForge, use the Project ID from the right-hand column of the pack's page. |
| **Pin one release** | Optional: the CurseForge file id or the Modrinth version id. Empty means every player gets the newest version whenever they click. |
| **Show in the public list** | Optional, see below. |

Out come a picture and code to copy in four shapes: **HTML**, **Markdown**, **BBCode** (forums) and **just the link**. For example:

```html
<a href="https://stygion.eu/play/YOURTOKEN"><img
   src="https://stygion.eu/b/YOURTOKEN.svg" alt="Play Your Server"
   height="40" style="height:40px;width:auto"></a>
```

Paste it on your page and you are done. One person can have at most fifty live buttons.

**Pin a version when your server does not move**, and leave it empty when you keep up with the pack. A pinned link is how you stop a player arriving on a version your server cannot accept.

## Changing it later

**You paste the snippet once.** The button on your page is a picture served from us, so everything about it — the name on it, the address it connects to, which pack it installs, which version — is edited in **your account → Developers** ([stygion.eu/account/developers](https://stygion.eu/account/developers)), and every page carrying that button follows within a few minutes. You never have to go back and edit your website, and neither does anybody else who put your button on theirs.

That is also why it is a picture rather than a piece of HTML with your server's name written into it. The old shape went stale the day anything changed, silently, on pages whose owners had no way of knowing.

The words on the button come in Czech or English — you choose when you make it, and adding or removing `?l=cs` on the picture's address switches it.

## The public list of servers

Tick **show in the public list** and your server appears at [stygion.eu/servers](https://stygion.eu/servers) with its address, pack, whether it is online and how many are playing. The order is by what is alive: servers that answer come first, then by players and by how often their button was pressed lately — **never by who paid**.

A few things worth knowing:

- **The list is "listed", not "verified".** Nobody checks that the server is yours. That is why it is made hard to profit from rather than hard to enter.
- The text you write about a server **is cleaned before it is shown** (limited length and characters, no links), and the player counts of somebody else's server come from asking the server, not from what it says about itself.
- One account can have at most five servers in the list.
- **Anybody signed in can report a button or a server** (spam, scam, offensive, broken, other; once per button). The team can hide it from the list, block its link or delete it, and the owner reads the reason.

## Taking one down

In **your account → Developers** you have the list of every button you have made, with how many times each has been opened, and a **Take down** button. A link you take down stops working immediately, and both the picture and the page say it was taken down — so an old button on a forum post says something true rather than looking broken. Taking one down is final; make a new one rather than expecting it back. A button can also be **deleted with its numbers**; the old address then says nothing about it.

## What we count, and what we do not

For each button you see, for the last thirty days, **how many times its page was opened, how many times Play was pressed and how many times the launcher started**, per day. Loading the picture is not counted, so it is a count of people who set off, not of people who scrolled past. One person counts once a day. There is no record of who clicked: we hold a number, not a list of where individual people play.

## Why it needs an account

A link that installs software on somebody else's machine has to belong to somebody. Signing in is what makes a button answerable for and, more importantly, what makes it possible to take down. That is also why a link is a row we hold rather than a bundle of parameters in an address: the launcher asks us what a link means, so what it means can change and can stop. The launcher installs only from CurseForge and Modrinth, never from an address in a link.
