Nodera / Dokumentace

Vše podstatné na jednom místě.

BTC peněženka, obchod a transakce

Jak nastavit serverovou BTC odměnu, hráčskou peněženku, výměnu za herní peníze, samoobslužný obchod a bezpečně kontrolovat nákupy.

Na této stránce

BTC v tomto modulu je virtuální komunitní měna serveru. Není to Bitcoin, kryptomenová peněženka ani reálná platební služba. Slouží k odměňování aktivity, nákup připravených produktů a volitelnou výměnu za běžné SCUM peníze.

Výhodou je jednotná historie každé změny zůstatku. Hráč vidí svou peněženku, administrátor umí dohledat nákup a při neúspěšném doručení systém nepředstírá úspěch.

Kde to najdeš v adminu

Co můžeš nastavit

Odměny za aktivitu

Určíš, kolik BTC hráč získá za určitý počet aktivních minut. Odměnu můžeš úplně vypnout a samostatně zapnout upozornění. Zvol tempo, které podporuje hraní, ale nerozbije ceny v obchodě.

Peněženka a výpis

Hráčský příkaz může být například /wallet. Výstup zobrazuje zůstatek a omezený počet posledních pohybů. Discord peněženka může pravidelně obnovovat jednu zprávu; URL webhooku se řídí ve společném nastavení Discord webhooků, ne přímo v produktu.

Výměna BTC a herních peněz

Nákupní kurz říká, kolik běžných SCUM peněz hráč zaplatí za 1 BTC. Prodejní kurz určuje, kolik obdrží zpět za 1 BTC. Rozdíl mezi kurzy je záměrná ekonomická brzda. Před zapnutím si spočítej, jak rychle hráči vydělávají obě měny.

BTC Shop

Kategorie jsou uživatelské skupiny produktů. Produkt má název, cenu, jedinečný slug a připravený bezpečný účinek. Hráč nakupuje příkazem /buy slug. Produkt může vydat pack, vozidlo, předmět, FAME nebo jinou podporovanou odměnu. Interní příkaz nevkládej do názvu ani popisu produktu.

Doporučený postup nastavení

  1. V Nastaveních zvol server a zapni pouze ty části, které chceš používat.
  2. Nastav odměnu za aktivitu a oba směnné kurzy. Zkontroluj, zda prodejní kurz není výhodnější než nákupní.
  3. Připrav krátký hráčský příkaz pro peněženku a srozumitelné zprávy.
  4. V kategoriích vytvoř jednoduchou strukturu, například Vozidla, Jídlo a pití, Zdravotnictví nebo Packy.
  5. V Shopu vytvoř produkty. Každému dej jedinečný slug, cenu a ověřený způsob doručení.
  6. Otestuj levný produkt s testovacím zůstatkem. Sleduj, zda se správně vytvořil výdej BTC i doručení.
  7. Po spuštění pravidelně kontroluj Transakce a upravuj ceny podle reálného příjmu BTC.

Co se stane při nákupu

Hráč napíše například /buy rope. Nodera ověří produkt, hráče, cenu a zůstatek. Potom vytvoří nákup a pošle doručení přes NODERAgent. Úspěch se zapíše až podle výsledku. Pokud je výsledek jednoznačně neúspěšný, transakce zůstane dohledatelná a systém může bezpečně vrátit zůstatek podle typu operace. Nejasný výsledek se nezopakuje naslepo, aby hráč nedostal tutéž hodnotnou věc dvakrát.

Volitelná Discord soukromá zpráva může hráči potvrdit nákup. Vyžaduje propojenou Discord identitu; chybějící propojení nesmí změnit samotnou účetní historii.

Příklad z Main serveru

Stav databáze k 1. 9. 2026.

OblastMain příklad
Aktivita1 BTC za každých 60 minut aktivity, upozornění zapnuto.
PeněženkaPříkaz /wallet, Discord obnova každých 30 sekund, zobrazených nejvíce 50 pohybů.
VýměnaNákup 1 BTC za 4 000 běžných peněz; prodej 1 BTC za 500.
Obchod8 aktivních kategorií. Příklady: lano 2 BTC (/buy rope), materiál pro vlajku 5 BTC, cargo drop 25 BTC, Rager 70 BTC.
ZnačkaNázev „BTC Shop“, veřejný slug btc-shop.

Kontrola a časté problémy

  • Hráč nezná zůstatek: ověř přesný wallet příkaz a to, zda je modul i jeho rollout povolen.
  • Nákup je zamítnut: zkontroluj zůstatek, stav produktu, slug a případnou kolizi příkazu s jiným modulem.
  • BTC bylo odečteno, ale odměna není potvrzena: otevři Transakce a zkontroluj konečný výsledek doručení. Nevytvářej ručně druhý nákup bez vyhodnocení prvního.
  • Discord DM nepřišla: zkontroluj propojení hráče s Discordem a nastavení zpráv. Samotná DM není účetním dokladem; rozhoduje transakční záznam.
  • Ekonomika příliš rychle roste: sníží aktivitu nebo zvýší ceny. Historické pohyby se změnou kurzu zpětně nepřepočítají.

Soukromí a cookies

Cookies máte pod kontrolou.

Používáme nezbytné cookies pro fungování webu. Analytické a marketingové cookies zapneme až po vašem souhlasu. Přečtěte si naše zásady cookies a informace o ochraně osobních údajů. Souhlas můžete kdykoli odvolat nebo změnit prostřednictvím tohoto nastavení.