Instalace · Keystone · Dokumentace

Keystone je jeden soubor. Tentýž jar patří do mods/ na serveru i do mods/ v klientovi hráče — není serverová a klientská edice a nejsou dvě čísla verzí, která by se rozcházela. Server nerozhoduje o tom, co mod obsahuje, ale co vyžaduje po lidech, kteří se připojují.

Všechno, co Keystone dneska dělá, dělá server, takže soubor patří na server a nikdo, kdo se připojuje, nepotřebuje nic. Části, které musí někomu něco nakreslit na obrazovku — chat v plné barvě, mapa, obrazovky, co vypadají navržené a ne jako truhla — jsou ta půlka, co běží v klientovi, a až přijdou, budou v tomhle stejném souboru.

Který soubor

Každé vydání jich nese čtyři a jméno říká, který je který:

Kód

keystone-fabric-1.21.1-<verze>+1.21.1-fabric.jar
keystone-neoforge-1.21.1-<verze>+1.21.1-neoforge.jar
keystone-fabric-26.2-<verze>+26.2-fabric.jar
keystone-neoforge-26.2-<verze>+26.2-neoforge.jar

Vezmi ten, který odpovídá tvému loaderu a verzi Minecraftu. Špatný nefunguje napůl — odmítne se načíst a napíše to do konzole, což je odpověď, kterou chceš, místo serveru, co nastartuje a chová se divně.

Fabric k tomu potřebuje Fabric API. NeoForge nepotřebuje nic navíc.

Jak ho tam dát

Zastav server.
Dej soubor do mods/.
Nastartuj znovu.

To je celé. Při prvním startu si Keystone vedle světa vytvoří dvě věci:

config/keystone/ — jeden soubor s nastavením pro každou část modu, každý okomentovaný. Všechno v nich jde měnit i ze hry, z konzole a z editoru, takže sem už nikdy nemusíš, pokud sám nechceš.
keystone/ — jeho databáze. Ranky, tickety, tresty, hlasy, všechno, co kdo drží. Zálohuj ji se světem; je to jeden soubor.

Co jde ven a kdy

Žádná IP adresa se nikdy nikam nezapisuje. Adresa existuje jen po dobu, co se někdo připojuje, a do databáze jde místo ní místo: jednosměrný otisk pod klíčem, který si tvůj server vyrobil sám a drží ho ve své složce. Stejný stroj se pořád pozná jako stejný stroj — což je jediné, na co se kdy kdo ptá — a zpátky na adresu to nepřevede nikdo, nás nevyjímaje.

Ven jde tohle, a nic jiného:

Kam	Co	Kdy
Mojang	Jméno hráče, nebo jeho id	Jen na serveru v offline režimu, aby dostal svůj skin a aby koupené jméno nenosil někdo cizí. Server, který se Mojangu ptá sám, se neptá nic.
Discord	Chat a jméno hráče v odkazu na avatar	Až mu dáš token bota.
MineSkin	Obrázek, který někdo přilinkoval přes `/skin <odkaz>` — jen ten obrázek, žádné jméno, žádné id	Jen když ten příkaz někdo použije. Prázdné nastavení to vypne.
Poskytovatel asistenta	Otázka, ze které jsou předtím vyškrtnutá tajemství	Až vyplníš adresu a klíč. Může to být kdokoliv, nebo nikdo.
Sledování chyb (Sentry nebo GlitchTip)	Chyba, v jejímž zásobníku je kód Keystone: typ výjimky, rámce, verze a loader; text výjimky až po vymazání tajemství, adres, e-mailů, URL, cest, UUID a všeho v uvozovkách — žádná jména hráčů, adresy ani chat	Jen když v `keystone.toml` vyplníš `errors.dsn`. Ve výchozím stavu vypnuto a jar žádnou adresu nenese. Stejná chyba nejvýš jednou za deset minut.
stygion.eu	Jednou denně pět minut časů ticku, seznam tvých modů a co je to za stroj — žádné jméno serveru, žádná adresa, žádný hráč a žádné id, ani náhodné	Zapnuté od začátku. Z toho se staví veřejná čísla a není v tom nic, co by se dalo vystopovat zpátky k tvému serveru.

Jak to poslední vypnout:

Kód

/keystone set bench.share-live false

Vyprázdnění bench.send-to zastaví všechno, co tahle část modu kdy může poslat, včetně běhu, který zveřejníš ručně.

Kromě toho žádná kontrola aktualizací a žádné volání domů: server v online režimu bez tokenu bota, bez klíče k asistentovi, bez errors.dsn a s vypnutým bench.share-live se nespojí s nikým.

Jakou Javu

Takovou, jakou chce hra: Java 21 pro Minecraft 1.21.1 a Java 25 pro 26.2. Když ti server startuje, máš tu správnou.

Jak poznáš, že to vyšlo

Konzole to při startu řekne:

Kód

[Keystone] Keystone is running. <n> modules, 1.21.1 on neoforge.
[Keystone] [api] local API on http://127.0.0.1:25586

<n> je počet modulů, které běží; vypnutý modul se nepočítá. Když se ta první řádka neobjeví, je soubor pro jiný loader nebo jinou verzi hry — viz Když něco nehraje.

Aktualizace

Vyměň soubor a restartuj. Nastavení i databáze zůstávají a všechno nové přijde s hotovou výchozí hodnotou, takže aktualizace nikdy nechce, abys něco vyplnil dřív, než server nastartuje.

Jedna věc, kterou aktualizace neudělá: nesáhne na nastavení, které už máš. Když se v nové verzi zlepší výchozí hodnota, platí to jen pro servery, které se jí nikdy nedotkly — tvůj si nechá tu svoji. Když poznámky k vydání říkají, že se výchozí hodnota posunula, a chceš tu novou, nastav si ji sám.

Odinstalace

Vyndej soubor a restartuj. Svět zůstane nedotčený — Keystone do něj nikdy nezapisuje. Složky config/keystone/ a keystone/ zůstanou, takže když ho vrátíš, najde všechno tak, jak to bylo; smaž je, když ho chceš pryč pořádně.