# Přechod z jiného serveru: importy z EssentialsX, LuckPerms, FTB Ranks, seznamů hry a CoreProtect

> /keystone import přečte soubory pluginu nebo modu, který jste používali dřív, ukáže, co se převede, a přenese homes, warpy, přezdívky, kity, skupiny, oprávnění, ranky a bany do Keystone - jednou, ať ho spustíte kolikrát chcete. Novinka 0.4.

Source: https://stygion.eu/cs/docs/keystone/import
Updated: 2026-11-16

## Proč

Server, který běží rok, drží domovy lidí, strom oprávnění a seznam banů. Zadávat to znovu je důvod, proč nikdo nepřechází. `/keystone import` přečte soubory, které starý plugin nebo mod nechal, přeloží je, **nejdřív vám výsledek ukáže** a teprve potom ho zapíše.

Je pro každý server: kde jsou stará data, jak se jmenovaly staré světy, které staré oprávnění znamená které tady, do jaké skupiny přejde úroveň operátora a jaký příkaz vyplácí zůstatek, je všechno nastavení. Nic se nikam neposílá.

## Příkaz

Všechny potřebují `keystone.import` (majitel a operátoři ho mají přes `keystone.*`).

| Příkaz | Co dělá |
|---|---|
| `/keystone import` | vypíše zdroje |
| `/keystone import <zdroj> --dry-run` | **náhled**: přečte, přeloží, zeptá se modulů, co by udělaly, a vypíše to. Nic nezmění |
| `/keystone import <zdroj>` | provede to |
| `... --from <složka>` | přečte jinou složku, která musí být **uvnitř složky serveru** |

Zdroje: `essentialsx`, `luckperms`, `ftbranks`, `vanilla`, `coreprotect` (také `essentials`, `lp`, `ops`, `cp`).

Starou složku dejte tam, kde ji Keystone hledá, nebo ji nechte tam, kde ji měl starý plugin:

| Zdroj | Hledá se v (v tomto pořadí) |
|---|---|
| `essentialsx` | `import/essentialsx`, `plugins/Essentials` |
| `luckperms` | `import/luckperms`, `plugins/LuckPerms` |
| `ftbranks` | `import/ftbranks`, `config/ftbranks` (a pro hráče `serverconfig/ftbranks` ve světě) |
| `vanilla` | `import/vanilla`, jinak samotná složka serveru |
| `coreprotect` | `import/coreprotect`, `plugins/CoreProtect` |

## Dvakrát spustit, jednou převést

Každá věc se porovná s tím, co už tu je: skupina existuje, hráč ji už má, home už je nastavený. Druhé spuštění najde všechno *už tu je* a nic nezmění. **Nic, co už máte, se nepřepíše ani nesmaže** - skupina stejného jména si nechá váhu, prefix a rodiče (importované řádky oprávnění se do ní přidají); řádek, kterému vaše skupina říká opak, zůstane váš; existující kit, home, warp, přezdívka nebo ban zůstanou, jak jsou. Smažete-li něco importovaného a spustíte import znovu, vrátí se to.

## Co se převede

| Zdroj | Převede se | Nepřevede se |
|---|---|---|
| **EssentialsX** | homes (se jmény světů přeloženými), warpy, přezdívky (bez barevných kódů, pak platí pravidla pro přezdívky), kity (itemy podle ID tohoto serveru, `/příkazy` jako příkazy kitu, delay jako četnost kitu, `-1` jako jednou), zůstatky | pošta (Keystone ji nemá), enchanty, jména a popisy itemů v kitech (item přijde obyčejný), kdo smí kit vzít |
| **LuckPerms** (souborové úložiště: `yaml-storage` nebo `json-storage`) | skupiny s váhou, prefixem, suffixem a rodiči; řádky oprávnění (povoleno i zakázáno, po světech); členství hráčů, u dočasného s koncem | databázové úložiště (H2, SQL) a HOCON - ve starém pluginu nastavte `storage-method` na `yaml` nebo `json`, jednou ho restartujte a importujte složku, kterou zapíše; tracky; oprávnění daná přímo hráči; cokoli omezené na jiný server nebo na jiný kontext než svět |
| **FTB Ranks** (`ranks.snbt` / `ranks.json5`, `players.snbt` / `players.json5`) | ranky jako skupiny (power je váha, text okolo `{name}` v `ftbranks.name_format` je prefix a suffix), řádky povolit/zakázat, ranky hráčů | hodnoty, které nejsou povolit/zakázat (limity claimů a podobně patří jiným modům); rank, který byl automatický (op, odehraný čas...), se stane skupinou bez lidí |
| **Seznamy hry** (`vanilla`) | `banned-players.json` do záznamu banů (důvod, autor, konec), `ops.json` do skupiny, kterou pro danou úroveň jmenuje `import.operators` | `whitelist.json` a `banned-ips.json` zůstávají, kde jsou: hra je vynucuje sama |
| **CoreProtect** (SQLite `database.db`) | změny bloků a truhel, do [auditu bloků](/docs/keystone/audit) Keystone | kliknutí a zabití; CoreProtect na MySQL. Když je modul `audit` vypnutý, import řádky spočítá, řekne to a nic neztratí - spusťte ho znovu, až audit zapnete |

Řádek oprávnění **omezený něčím, co Keystone udržet neumí, se vynechá, nerozšíří**: řádek LuckPerms pro jiný server by se jinak stal řádkem pro tenhle. Dočasný řádek se také neudělá trvalým. Obojí se počítá v reportu.

### Oprávnění se překládají

Řádky z LuckPerms a FTB Ranks procházejí přes `import.permissions`, tabulku `staré=nové`. Výchozí zná uzly EssentialsX, které tu něco znamenají (`essentials.home` se stane `keystone.home`, `essentials.kits.*` se stane `keystone.kit.*`, `essentials.warp` se stane `keystone.warp` a tak dál); řádek bez pravidla zůstane přesně, jak byl, protože oprávnění Keystone čtou i jiné mody.

## Report

Náhled i import vypíšou report do chatu a uloží ho: **Import** v editoru ukáže tabulku (nových, už tu je, odmítnutých podle druhu), poznámky a každé odmítnutí s důvodem. Uchovává se posledních třicet reportů. Reporty jmenují hráče a homes, takže je čte jen klíč majitele.

## Nastavení

`import.toml`, nebo **Settings** v editoru.

| Nastavení | Výchozí | Co dělá |
|---|---|---|
| `worlds` | `world=minecraft:overworld`, `world_nether=minecraft:the_nether`, `world_the_end=minecraft:the_end` | jak starý server nazýval světy. Home ve světě, který nikdo nepřiřadil, se odmítne, nehádá se |
| `permissions` | tabulka EssentialsX výše | pravidla `staré=nové` pro řádky oprávnění; koncová `*` přenese zbytek; prázdná pravá strana řádek zahodí |
| `operators` | `4=admin` | do jaké skupiny přejde úroveň operátora při importu `ops.json`. Úroveň 4 tu smí všechno tak jako tak; skupina je na den, kdy jim operátora sebereš. Úroveň bez řádku se nechá být |
| `economy.command` | prázdné | konzolový příkaz, který vyplatí zůstatek, s `{player}`, `{uuid}` a `{amount}`. Keystone žádné zůstatky nevede, vede je váš měnový mod. Prázdné: zůstatky se vypíšou a nevyplatí. **Každý zůstatek se vyplatí jednou**, ať import spustíte kolikrát (jen majitel) |

## API

Obě cesty jsou majitelovy: report jmenuje hráče a homes a import zapisuje skupiny a bany.

| Cesta | Scope | |
|---|---|---|
| `GET /v1/import` | `import.read` | zdroje, zda se našly jejich soubory, a poslední reporty |
| `POST /v1/import/run` | `import.run` | `source`, `dryRun` (výchozí `true`), `from`; odpoví reportem |

## Co čte a co ne

Čte soubory uvnitř složky serveru a zapisuje do vlastní databáze a nastavení Keystone, plus - jen u zůstatků - ten jeden konzolový příkaz, který nastavíte. Soubory starého pluginu nikdy nemění, nic nemaže a nic neposílá ven. Soubor, který nejde přečíst, je v reportu jmenovaný s řádkem; zbytek se importuje dál. Poznámky a důvody odmítnutí v reportu jsou anglicky, ať hráči mluví jakkoli.
