# Banka: účty v mincích serveru

> Účet pro každého hráče v mincích serveru: vklad, výběr, /pay komukoli, kniha všech změn, bankéř, na kterého hráči kliknou - a pozemky, odemykání v zónách a Create shopy platí i z něj. Novinka 0.5.0, ve výchozím stavu vypnutá.

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

Modul `bank` (**ve výchozím stavu vypnutý** - drží peníze lidí, takže ho server zapíná vědomě) dá každému hráči účet v mincích, které server už používá. Mince zůstávají skutečnými předměty: banka je místo, kde čekají, když je nikdo nechce nosit. Nic tu nezávisí na STYGIONu.

## Mince

`bank.coins` je vypíše, jeden řádek na minci - stejné řádky jako `crates.items` a mince pozemků: hodnota v nejmenší jednotce, krátké jméno, předmět, jeho vzhled a jméno.

```toml
coins = [
  "1 obol mymod:coin_obol look=mymod:coin_obol Obol",
  "8 ember mymod:coin_ember look=mymod:coin_ember Ember Hex",
  "64 seal mymod:coin_seal look=mymod:coin_seal Styx Seal",
  "512 sovereign mymod:coin_sovereign look=mymod:coin_sovereign glint Sovereign"
]
```

Zůstatek se drží v nejmenší jednotce a vypisuje zpátky v mincích (`3 seal 2 obol`). Částka se dá napsat obojím způsobem: `200` nebo `3seal`. Počítá se jen předmět, který nese značku mince (`look=`): stejný předmět bez ní nebo s jinou značkou se nikdy nevezme.

## Pro hráče

- `/bank` - tvůj zůstatek.
- `/bank deposit` - všechny mince, které neseš, jdou na účet.
- `/bank withdraw <částka>` - vyplatí se v mincích; `/bank withdraw 2seal` chce tu minci (tak se mění peníze), samotné číslo největší mince, které to složí. Najednou nejvýš inventář mincí (2304); co se nevejde, se vrátí na účet.
- `/bank history` - poslední změny na účtu.
- `/pay <hráč> <částka>` - peníze někomu jinému, online i pryč. Jméno, které nosily dva účty, se odmítne, nehádá se; příjemce se to dozví hned, nebo si to přečte v `/bank history`. `bank.transfer-fee` vezme z každé platby procento (zaokrouhlené nahoru) z ekonomiky: příjemce dostane částku bez poplatku a poplatek nedostane nikdo.

`/bank` chce `keystone.bank` a `/pay` chce `keystone.bank.pay`; skupina `default` má obě, takže server, který chce účty bez převodů mezi hráči, druhé oprávnění odebere.

## Bankéř, na kterého hráči kliknou

`bank.banker.place` postaví do světa jednu postavu, kterou pravý klik změní v banku - K → Banka pro hráče s Keystone ve hře, zůstatek a příkazy v chatu pro hráče bez něj.

```toml
[banker]
place = "minecraft:overworld 209.5 131 43.5 69"   # world, x, y, z, where it looks (degrees)
entity = "minecraft:villager"                     # any entity: a wandering trader, an armour stand, a mod's
name = "Banker"                                   # over its head; empty = no name
data = "{VillagerData:{profession:\"minecraft:librarian\",level:5,type:\"minecraft:plains\"}}"
```

Bankéř nedělá nic jiného: žádné obchody, žádná AI, žádné poškození, nedá se odvést, přejmenovat ani - modem, který sbírá vesničany kliknutím - odnést; každý klik na něj se zruší dřív, než ho entita uslyší. Dokud je jeho chunk načtený, Keystone ho každých pět sekund hlídá: chybějící bankéř se vrátí, druhá kopie zmizí, posunutý se vrátí na místo. Kvůli němu se nic nenačítá. Prázdné `place` ho odebere. Server se `spawn-npcs=false` v `server.properties` odstraní všechny vesničany a potulné obchodníky sám, tedy i bankéře - dej mu tam jinou entitu.

## Placení z účtu

Pozemky, odemykání v zónách a Create shopy berou peníze z kapsy i z účtu dohromady. `bank.pay-order` říká, odkud nejdřív: `pocket-first` (výchozí), `bank-first` nebo `bank-only`. Na vrácení dá největší mince, které to složí.

**Create shopy** (`bank.create-shops`, zapnuto): u obchodu s ubrusem (Table Cloth) dostane kupující, kterému chybí mince ceny, ty chybějící z účtu těsně předtím, než Stock Keeper spočítá platbu - až poté, co Create zkontroloval sklad, takže se nic nevezme za nákup, který nemůže proběhnout. Bez Create z toho nic neběží.

Prodávající pozemku dostane peníze na účet, i když je pryč. `bank.crates-to-bank` dá mince z beden a hlasů na účet místo do inventáře. Questy a kapitoly mohou vyplácet mince rovnou na účet (`coins 2seal` jako odměna).

## Nic se neztratí, nic nevznikne

Obě strany `/pay` jsou jedna změna a jedna databázová transakce. Vklad vezme jen to, co účet může přijmout; výběr se spočítá v mincích dřív, než se sáhne na účet, a mince, které nejdou předat, se vrátí. Zápis, který databáze odmítne, se podrží, zkusí se znovu a při zastavení se v logu pojmenuje, pokud nikdy neprošel.

**Po pádu** se svět vrátí k poslednímu uložení a účty se s ním nevrátí. Každá výměna mincí mezi inventářem a bankou je očíslovaná v uložených datech hráče; při jeho dalším připojení se výměny, které ta data nezaznamenala, jednou napraví:

- vklad, jehož mince se vrátily, se z účtu odečte (`bank.crash-revert.take-back`, `on` nebo `log-only`);
- výběr, jehož mince se mohly ztratit, **čeká na vlastníka** (`bank.crash-revert.give-back`, výchozí `log-only`): mince předané před pádem dál existují a banka to nepozná, takže kdyby je vrátila na vlastní slovo, hráč, který umí server shodit, by mohl kopírovat peníze. Vypíšou se pod `/bank waiting` a na obrazovce Bank v editoru, kde je vlastník vrátí, nebo zamítne.

## Kniha

Každá změna je jeden řádek: kdy, čí, kolik, jaký druh (`deposit`, `withdraw`, `pay`, `paid`, `plot`, `plot-sold`, `refund`, `unlock`, `shop`, `crate`, `quest`, `staff`, `crash-revert`, `crash-waiting`), s kým, poznámka a zůstatek potom.

## Editor a API

Obrazovka **Bank** v editoru ukáže všechny účty a všechny peníze na účtech, historii hráče, celou knihu a co čeká po pádu, a týmu dovolí připsat nebo strhnout částku s důvodem, který hráč přečte.

| Cesta | Scope | Co |
|---|---|---|
| `GET /v1/bank` | `bank.read` | účty od největšího; součet; mince, poplatek, pořadí placení; co čeká po pádu |
| `GET /v1/bank/history?player=<uuid>&most=50` | `bank.read` | kniha jednoho hráče, nejnovější první |
| `GET /v1/bank/ledger?most=100` | `bank.read` | kniha celého serveru |
| `POST /v1/bank/adjust` | `bank.write` | `player` (uuid nebo jméno), `amount` (minus = strhnout), `reason` |
| `POST /v1/bank/waiting` | `bank.write` | `id`, `action` = `give` nebo `dismiss` |

Oba scope jsou jen pro **majitele** a nastavení banky (`bank.*`, ceny odemykání, `plots.player-sales.fee`, `crates.items`) smí ve hře zapisovat jen majitel - ne skupina, která má `keystone.settings.write`.

Pro doplňky: `Player.savedNumber` / `saveNumber` drží číslo v uložených datech hráče, `Player.save()` je zapíše hned.

## Nastavení

`bank.coins`, `bank.pay-order` (`pocket-first`), `bank.transfer-fee` (0), `bank.create-shops` (zapnuto), `bank.crates-to-bank` (vypnuto), `bank.crash-revert.take-back` (`on`), `bank.crash-revert.give-back` (`log-only`), `bank.banker.place` (prázdné), `bank.banker.entity` (`minecraft:villager`), `bank.banker.name` (`Banker`), `bank.banker.data` (prázdné). Banka nahrazuje modul exchange z 0.3.
