STYGION Dokumentace Hledat v dokumentaci

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á.

Keystone 0.5.0 Aktualizováno 5 min čtení
Na téhle stránce 8 částí
  1. Mince
  2. Pro hráče
  3. Bankéř, na kterého hráči kliknou
  4. Placení z účtu
  5. Nic se neztratí, nic nevznikne
  6. Kniha
  7. Editor a API
  8. Nastavení

Banka: účty v mincích serveru

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.

Kód
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.

Kód
[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.

Pomohla vám tahle stránka?

Otevře panel zpětné vazby s touhle stránkou v příloze. Přistane do jedné fronty se vším ostatním.