# Pozemky na prodej

> Tým dá chunky na prodej s cenou a výškovým stropem; hráč koupí na místě nebo v K → Plots, zaplatí mincemi serveru a claim FTB Chunks přejde napořád na jeho tým. Novinka 0.4, výchozí vypnuto.

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

Modul `plots`, nastavení v `config/keystone/plots.toml`. Výchozí vypnutý (`enabled = true` ho zapne): hýbe půdou a penězi.

## Co vidí hráč

- **Při vstupu do chunku na prodej** jednou uvidí cenu a výškový strop s tlačítkem **Koupit** v chatu. S klientskou částí Keystone mají chunky na prodej i jemný červený okraj na zemi (`border.enabled`, `border.colour`, `border.reach`).
- **`/plot buy`** tam, kde stojí, řekne cenu; **Potvrdit koupi** (nebo `/plot buy confirm`) do minuty koupí. Nabídka drží cenu: když ji tým mezitím změní, nic se nestrhne.
- **K → Plots** je mapa okolí - na prodej, prodané, moje, týmu - s cenou a stropem každého chunku; vybere a koupí odtud, s potvrzením. Záložka *Moje pozemky* ukáže, co vlastní.
- **`/plot info`**, **`/plot list`** - tenhle chunk a moje pozemky.

Pozemek je **jeho napořád** - žádný nájem, nic se nebere za nepřítomnost. Nad výškovým stropem nejde položit blok (tým smí).

## Placení

**Keystone nedrží zůstatky.** S `currency.kind = items` se cena vezme z inventáře kupujícího v mincích ze seznamu `coins` - každý řádek je hodnota mince v nejmenší jednotce a pak stejný řádek, jaký bere `crates.items`:

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

Berou se nejdřív největší mince a drobné se vrátí v největších mincích, které je dají. Mince s `look=` se pozná podle značky Keystone, nikdy podle jména, takže přejmenovaný item nezaplatí nic. Cena se píše v nejmenší jednotce (`512`) nebo jako počet a mince (`1sovereign`, `4seal`).

S `currency.kind = command` platí peníze jiného modu: `currency.take-command` a `currency.give-command` s `{player}`, `{uuid}` a `{amount}`, třeba `eco take {player} {amount}`.

## Prodej půdy (tým)

Tým potřebuje `keystone.plots.admin`.

| Příkaz | Co udělá |
|---|---|
| `/plot sell <cena> [strop]` | chunk, ve kterém stojíš, na prodej; `strop` je nejvyšší y, kam jde položit blok, nebo `none` (bez něj `default-cap`) |
| `/plot corner`, pak `/plot sell area <cena> [strop]` | všechny chunky mezi rohem a místem, kde stojíš (nejvýš `most-area`) |
| `/plot sell radius <chunky> <cena> [strop]` | čtverec kolem tebe |
| `/plot unsell [area \| radius <chunky>]` | stáhne z prodeje |
| `/plot cap <y \| none>` | strop tohohle chunku, na prodej i koupeného |
| `/plot revoke` | vezme koupený pozemek zpět: claim se vrátí týmu, který ho prodal, **nic se nevrací** |

Tým prodává jen půdu, kterou drží **serverový tým** claimů, nebo tým zapsaný **id** v `sellers` (`/plot info` týmu ukáže id týmu, který chunk drží; jména se neporovnávají, tým si jméno může změnit). Půda, kterou nikdo nedrží, se odmítne: v FTB Chunks by si ji kdokoli zabral zadarmo, takže ji nejdřív zaber pro server.

Obrazovka **Plots** v editoru ukáže všechny chunky na prodej a koupené pozemky s majitelem, cenou, záznam prodejů, strop a stažení z prodeje nebo zpět.

## FTB Chunks a bez něj

`keeper`: `auto` (FTB Chunks, je-li nainstalovaný, jinak vlastní evidence Keystone), `ftbchunks` (jen FTB Chunks; bez něj plots nic neprodá a řekne proč) nebo `keystone`.

- **S FTB Chunks** koupě uvolní claim prodávajícího a zabere chunk pro tým kupujícího **naráz**: když claim pro kupujícího selže, claim prodávajícího se udělá znovu a peníze se vrátí. Pozemek ze zóny nespotřebuje kupujícímu jeho vlastní claimy: Keystone mu zvedne limit FTB o jeden za každý (`count-in-claim-limit = false`, výchozí).
- **Claim, který zmizí** - `max_idle_days_before_unclaim` v FTB Chunks, admin unclaim, rozpuštěný tým - ukončí pozemek: ten ze zóny se **vrátí do prodeje** za cenu a strop zóny a znovu ho zabere tým, který ho prodal. Pozemky se kontrolují každých pár sekund a jen tehdy, když má FTB Chunks data načtená.
- **Bez modu na claimy** vede evidenci Keystone: koupený pozemek patří kupujícímu a s `protect` (zapnuto) se tam pokládání a ničení bloků od kohokoli jiného - a v chunku na prodej od kohokoli mimo tým - odmítne. Truhly, entity a výbuchy hlídá jiná ochrana serveru.

## Prodej mezi hráči

Výchozí vypnuto (`player-sales.enabled`). Když je zapnuto, hráč s `keystone.plots.sell` dá půdu na prodej přes `/plot sell <cena>` v chunku nebo z K → Plots:

- **koupený pozemek** prodá jen jeho kupec; ostatní půdu týmu jen jeho **vlastník nebo officer**;
- kupující zaplatí prodávajícímu bez `player-sales.fee` procent (co nejde zaplatit mincí, zůstane v poplatku); kdo není online, dostane peníze při dalším připojení, jednou;
- když prodávající mezitím claim zruší, prodá, odejde z týmu nebo přijde o hodnost, koupě se odmítne a nabídka zmizí z trhu;
- půda od hráče se kupujícímu počítá do jeho limitu claimů, ledaže to byl pozemek ze zóny, který měl prodávající mimo limit (pak claim navíc přejde s ním).

## Bezpečné z podstaty

Koupě běží od začátku do konce na serverovém vlákně: dva hráči s Koupit ve stejném ticku, dvojklik ani odpojení uprostřed nikdy nestrhnou dvakrát ani neudělají dva majitele. Peníze se vezmou slot po slotu, jen když každý slot pořád drží, co se spočítalo; claim se předá celý, nebo vůbec; drobné, peníze prodávajícímu a záznam až potom. Každý prodej zůstává v záznamu prodejů napořád.

## Nastavení

| Nastavení | Výchozí | |
|---|---|---|
| `enabled` | false | celý modul; čte se jednou, při startu serveru, takže zapnutí chce restart |
| `keeper` | `auto` | kdo drží půdu |
| `currency.kind` | `items` | `items` nebo `command` |
| `coins` | prázdné | mince a jejich hodnoty |
| `currency.take-command`, `currency.give-command`, `currency.unit` | prázdné | peníze jiného modu |
| `most-per-player` | 0 | kolik pozemků smí mít jeden hráč, 0 bez limitu |
| `count-in-claim-limit` | false | jestli se pozemky ze zóny počítají do limitu FTB |
| `sellers` | prázdné | id týmů kromě serverového, jejichž půdu tým prodává |
| `default-cap` | `none` | strop, když `/plot sell` žádný neuvede |
| `player-sales.enabled`, `player-sales.fee` | false, 0 | prodej mezi hráči |
| `player-sales.return-days` | 30 | pozemek, který hráč prodal, se mu vrátí, když kupujícímu claim zanikne - pokud byl někdo z týmu prodávajícího online během tolika dní; jinak ho nabídne server (za cenu zóny, nebo za to, co kupující zaplatil). 0: prodávajícímu se nevrací nikdy |
| `protect` | true | vlastní ochrana Keystone bez modu na claimy |
| `notify` | true | řádek při vstupu do chunku na prodej |
| `border.enabled`, `border.colour`, `border.reach` | true, `#e5484d`, 3 | červený okraj (klientská část) |
| `most-area` | 1024 | kolik chunků vezme jeden příkaz na oblast |

Oprávnění: `keystone.plots` (všichni, dostává `default`), `keystone.plots.sell` (prodej vlastní půdy, `default`, platí jen s `player-sales.enabled`), `keystone.plots.admin` (tým).

## Pro vlastní nástroje

`GET /v1/plots` a `GET /v1/plots/sales` (scope `plots.read`); `POST /v1/plots/offer`, `/withdraw`, `/cap`, `/revoke` (vlastnický scope `plots.write`). Každá změna je událost `PlotChanged` (`offered`, `changed`, `withdrawn`, `bought`, `revoked`, `lapsed`) pro webovou mapu, Discord bota nebo vlastní účetnictví.
