# Směnárna

> Itemy za itemy v pevném kurzu, v obchodním okně samotné hry – třeba banka mincí – otevřená příkazem nebo postavou, na kterou hráč klikne. Novinka v 0.3, ve výchozím stavu vypnuto.

Source: https://stygion.eu/cs/docs/keystone/exchange
Updated: 2026-10-25

Novinka v 0.3, modul `exchange`, ve výchozím stavu vypnutý. Směnárna mění itemy za itemy v pevném kurzu, v obchodním okně samotné hry, které každý hráč zná. Typicky banka mincí, která mění malé mince za velké a zpátky.

## Nastavení (`exchange.toml`)

- `items`: vlastní itemy serveru, stejné řádky jako `crates.items`: `obol minecraft:debug_stick model=74001 look=stygion:coin_obol colour=#e8dcc0 Obol | Převozníkovo mýtné.` Item s `look` nese značku Keystone a **přijímají se jen označené itemy**, takže přejmenovaná kopie nemá žádnou cenu.
- `trades`: co která směnárna mění, řádek na obchod: `<směnárna> | <počet> <item> -> <počet> <item>`, s id z `items` nebo jakýmkoli id itemu ze hry. `bank | 8 obol -> 1 ember`, `bank | 1 ember -> 8 obol`.
- `titles`: titulek okna pro každou směnárnu (`bank | &#ffca36&lBanka`), `[en]…[cs]…` funguje.
- `command`: příkaz, který ji otevře, výchozí `/exchange [jméno]`; napiš `bank` a bude to `/bank`. Nové jméno platí po restartu.
- `figures`: postavy, které po kliknutí otevřou směnárnu; Keystone je drží na místě (vrátí je, když zmizí, posune zpět, když je někdo odstrčí, nedají se zranit ani sebrat): `bank | minecraft:overworld | 209.5 131.0625 43.5 | 69 | Bankéř` (směnárna, svět, pozice, natočení, jméno).
- `range`: jak blízko postavy téže směnárny příkaz funguje, v blocích; 0 funguje všude.

Každé otevření je samostatné okno, hráči nic nesdílejí. Oprávnění `keystone.exchange` (ve výchozím stavu má každý). `GET /v1/exchange` (scope `status.read`) vypíše směnárny a jejich obchody.