Tlačítko Hrát na tvůj web

Když provozuješ Minecraft server, to nejtěžší na přivedení hráče je všechno, co se děje před hrou: najít modpack, najít správnou verzi, nainstalovat ho, přidat adresu, připojit se. Tlačítko Hrát tohle všechno udělá jedním kliknutím na tvojí vlastní stránce.

Co uvidí hráč

Klikne na Hrát na tvém webu.
Otevře se launcher a zeptá se na jednu jedinou věc: Připojit se na tvůj server? Nainstaluje se tvůj pack.
Řekne ano — a nic dalšího po něm nikdo nechce. Pack se stáhne, tvoje adresa se mu uloží do seznamu serverů, hra naběhne a on stojí na tvém serveru.

Dvě věci to pořád přeruší a obě mají. Při úplně první instalaci se přihlašuje do Minecraftu — to je Mojang, ne my. A modpack, jehož autor na CurseForge zakázal distribuci, ho pošle přes stahovací stránku CurseForge, protože si to autor tak přál.

Kdo launcher ještě nemá, přistane na stránce, která mu vysvětlí, co to je, a nabídne stažení. Chybu neuvidí nikdy.

Jak si ho vyrobit

Přihlas se a otevři svůj účet → Vývojáři. Potřebuješ tři věci:

Pole	Co do něj patří
Adresa serveru	Přesně to, co hráč píše do Minecraftu — `play.priklad.cz`, klidně s portem. Ne webová adresa.
ID modpacku	ID projektu na Modrinthu nebo CurseForge. Vlož adresu packu a pole se vyplní samo; výjimka je CurseForge, jehož API neumí slug — použij Project ID z pravého sloupce na stránce packu.
Verze	Nepovinná. Nevyplněná znamená, že každý hráč dostane nejnovější verzi ve chvíli, kdy klikne. Vyplněná znamená, že dostane vždycky tuhle.

Vypadne z toho obrázek, odkaz a hotový kód:

<a href="https://stygion.eu/play?t=TVUJTOKEN"><img
   src="https://stygion.eu/b/TVUJTOKEN.svg?l=cs" alt="Hrát na Tvůj server"
   height="40" style="height:40px;width:auto"></a>

Vlož ho na stránku a je hotovo.

Verzi připíchni, když se tvůj server nehýbe, a nech ji prázdnou, když s packem držíš krok. Připíchnutý odkaz je způsob, jak zabránit tomu, aby hráč dorazil s verzí, kterou tvůj server nepřijme.

Když se něco změní

Kód vkládáš jednou. Tlačítko na tvojí stránce je obrázek, který jede od nás — takže všechno na něm: název, adresa, na kterou se hráč připojí, který pack se instaluje i jaká verze, se mění v účtu → Vývojáři, a každá stránka, kde tlačítko je, se do pár minut srovná. Nikdy se nemusíš vracet a přepisovat web — a nemusí ani nikdo jiný, kdo si tvoje tlačítko dal k sobě.

Proto je to obrázek, a ne kus HTML s natvrdo vepsaným názvem serveru. Ten starý tvar zastaral v den, kdy se cokoliv změnilo — potichu, na stránkách, jejichž majitelé o tom neměli šanci vědět.

Nápis na tlačítku je česky nebo anglicky: kód, který si zkopíruješ, se vyrobí v jazyce, ve kterém účet čteš, a přepínáš to přidáním nebo odebráním ?l=cs v adrese obrázku.

Jak ho stáhnout

Na stejné stránce máš seznam všech svých tlačítek, u každého kolikrát bylo otevřeno, a tlačítko Stáhnout. Stažený odkaz okamžitě přestane fungovat a obrázek i stránka řeknou, že byl stažen — takže staré tlačítko pod příspěvkem na fóru říká pravdu, místo aby vypadalo rozbitě. Stažení je konečné; místo vracení se vyrobí nové.

Co počítáme a co ne

Číslo u každého tlačítka je kolikrát bylo otevřeno — tedy kliknuto a rozklíčováno launcherem. Načtení obrázku se nepočítá, takže je to počet lidí, kteří vyrazili, ne těch, kteří kolem projeli. Kdo klikl, nikde nedržíme: máme číslo, ne seznam toho, kdo kde hraje.

Proč to chce účet

Odkaz, který někomu cizímu instaluje software, musí mít majitele. Přihlášení je to, co dělá tlačítko dohledatelným — a hlavně to, co umožňuje ho stáhnout. Ze stejného důvodu je odkaz řádek u nás, a ne balík parametrů v adrese: launcher se nás ptá, co odkaz znamená, takže se to může změnit a může to přestat platit.