# Instalace

> Jeden soubor pro obě půlky. Vyber správný ze čtyř, dej ho do mods, nastartuj server.

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

**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ý:

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

1. Zastav server.
2. Dej soubor do `mods/`.
3. 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](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] [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](/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.

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