Skip to main content

Shop system for players

This page explains how players use the shop: browsing items, placing orders, tracking status, and managing subscriptions.

For related guides, see:

What players can do​

  • Browse available item sets in the shop catalog.
  • Add item sets to cart and checkout to a saved place or manual coordinates.
  • View order history and cancel undelivered orders.
  • Buy and manage subscriptions.

Shop catalog behavior​

  • The shop page groups item sets by category.
  • If no item categories exist, the shop shows item sets as a flat list without category tabs.
  • If categories exist and some item sets have no category assignment, those item sets appear under an Uncategorized group.
  • Visibility depends on access rights and group restrictions:
    • Item set allowed groups.
    • Category allowed groups.
  • Per-player limits are enforced before adding to cart and again at checkout.
  • If a player has shop.see_unavailable, unavailable items can still be visible for review.

Cart and checkout flow​

Navigation path:

  • Shop -> Cart

Steps:

  1. Add one or more item sets to cart.
  2. Open Cart and verify quantity, total, and delivery position.
    • If the system granted items that should ship with the next order, they appear in the normal cart list with price 0.
    • Those free cart items can stay selected for the current checkout or be deselected and left in the cart for a later order.
    • Free cart items can be ordered on their own, just like any other cart item.
    • Free cart items do not increase the checkout total and are not affected by coupons.
  3. Select a payment source:
    • Personal Wallet (default) — charged to the player's own balance.
    • Faction Treasury — available if the player belongs to one or more factions with the place_order member right; a selector shows eligible factions and their current balance.
  4. Checkout:
    • by saved place (personal orders only), or
    • by coordinates.
  5. The system validates:
    • shop and checkout rights (shop.access, shop.checkout),
    • valid location,
    • per-item order limits,
    • sufficient balance (personal or faction depending on selection),
    • non-empty cart.
  6. On success, balance is charged and order is created as pending.

When paying from a faction treasury the order is recorded as a faction order, not a personal order (see Factions).

Order history and cancellation​

Navigation path:

  • Shop -> Orders

  • The orders page shows recent personal orders only with status details (created, delivered, refunded, canceled).

  • Faction orders are not shown here; they appear in the Orders tab on the faction detail page.

  • Players can cancel only undelivered personal orders.

  • Canceling an undelivered order refunds the full amount back to player balance.

  • Delivered orders cannot be canceled by players.

When players receive their order​

  • Orders are not spawned immediately at checkout.
  • Delivery happens on the next dzbot-managed restart.
  • After successful transfer/restart, order status changes to delivered.

Tip: If you rely on the shop, restarts should be performed through dzbot so transfer hooks run consistently.

Player subscriptions flow​

Navigation path:

  • Shop -> Subscriptions

Steps:

  1. Open Subscriptions.
  2. Choose an active offer and add it, which creates an inactive subscription draft.
  3. Edit the subscription and set:
    • description,
    • place/location,
    • angle,
    • active state.
  4. Save changes. Active subscriptions are applied during restart cycles.

Additional behavior:

  • Players can cancel their own subscriptions.
  • Players can respawn (regenerate) event identifiers for their own subscriptions.
  • If a subscription is faction-owned, faction rights control who can edit/cancel it (change_subscriptions).