# Instalace

> Jeden soubor pro obě půlky a od 0.3.4 ještě STYGION Library. Vyber Keystone pro svou verzi Minecraftu, dej oba do mods, nastartuj server.

Source: https://stygion.eu/cs/docs/keystone/install
Updated: 2026-10-30

**Keystone je jeden soubor a od 0.3.4 k němu patří druhý, malý: [STYGION Library](https://www.curseforge.com/minecraft/mc-mods/stygion-library).** Tytéž jary patří do `mods/` na serveru i do `mods/` v klientovi hráče — není serverová a klientská edice. 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

Keystone běží na **NeoForge**. Od 0.3 nese každé vydání dva soubory Keystone, jeden pro každou verzi Minecraftu, a jméno říká, který je který:

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

Vezmi ten, který odpovídá tvé 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ě.

**Od 0.3.4 Keystone potřebuje vedle sebe [STYGION Library](https://www.curseforge.com/minecraft/mc-mods/stygion-library)** — jeden soubor, `stygion-library-<verze>.jar`, stejný pro 1.21.1 i 26.2. Nese cizí knihovny, se kterými Keystone drží svá data a záloha mimo server (SQLite a SFTP), beze změn a s jejich licencemi; jar samotného Keystone je pak jen náš vlastní kód. Bez ní se NeoForge zastaví na načítací obrazovce a pojmenuje chybějící mod. Na CurseForge se nainstaluje spolu s Keystone jako závislost a STYGION Launcher ji nainstaluje za tebe. Keystone 0.3.3 a starší ty knihovny nesou v sobě a Library nepotřebují.

**Fabric** byl podporovaný do 0.2.x. Poslední build pro Fabric zůstává na CurseForge a dál funguje, jen už nedostane další aktualizace; server na Fabricu, který chce novinky, přejde na NeoForge a složky `config/keystone/` a `keystone/` si vezme s sebou beze změny.

## Jak ho tam dát

1. Zastav server.
2. Dej oba soubory do `mods/`: Keystone a STYGION Library.
3. Nastartuj znovu.

Hráč, který chce klientskou půlku Keystone (nebo hraje singleplayer s ním), dá ty samé dva soubory do svého `mods/`.

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](https://stygion.eu/performance) a není v tom nic, co by se dalo vystopovat zpátky k tvému serveru. |

**Jak to poslední vypnout:**

```
/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:

```
[Keystone] Keystone is running. <n> modules, 1.21.1 on neoforge.
[Keystone] running on STYGION Library 1.0.0
[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, nebo chybí STYGION Library — viz [Když něco nehraje](/docs/keystone/troubleshooting).

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

**Aktualizace na 0.3.4 a novější z 0.3.3 nebo starší:** přidej zároveň STYGION Library. Library samotná se mění zřídka; vydání Keystone řekne, kdy potřebuje novější, a NeoForge pojmenuje verzi, kterou chce, když je ta tvoje stará.

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