Skip to main content

Transactions concept

This page explains how money moves in dzbot from a user and operations perspective.

Money model at a glance​

dzbot uses two balance types:

  • Player balance: personal money used by the player account in the shop
  • Faction treasury: shared money pool for each faction

These balances are separate. A player and their faction do not automatically share one wallet.

Where players can see and use money​

Navigation paths:

  • Shop -> Profile (quick balance view)
  • Shop -> Transactions (history and player-to-player transfer)

From the transactions area, players can:

  • view their own transaction history
  • send money to another player (if this action is enabled for them)

When sending money, the transfer is limited by the sender's currently available balance.

Where faction money is handled​

Navigation path:

  • Shop -> Factions -> Faction details -> Treasure

In this area, faction members can deposit to or withdraw from the faction treasury, depending on their faction member rights.

For the full faction model, see Factions concept.

Where admins can manage balances​

Admins have dedicated money controls in the admin area.

Navigation paths:

  • Server Admin -> Transactions
  • Server Admin -> Players -> Player details -> Transactions
  • Server Admin -> Factions -> Faction details -> Treasure

Typical admin actions:

  • review transactions across the whole server
  • review transaction history
  • filter player transaction history by category, time range, or amount
  • add, remove, or set balances

Typical ways money changes​

The most common balance changes are:

  • shop checkout (player balance decreases)
  • shop order cancellation/refund (player balance increases)
  • player-to-player transfers (one decreases, one increases)
  • faction deposit/withdraw (player and faction move in opposite directions)
  • periodic and event-based systems (for example subscriptions, base alarms, bounties, casino)

Safety and permissions​

The system uses two key safety rules:

  • balances cannot go below zero
  • visibility and money actions depend on the assigned rights

Transaction timestamps follow the server time configuration.

This keeps financial actions controlled while still allowing delegated workflows for staff and faction members.