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.
  • Mark item sets as favourites for quick reordering.
  • 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.

Finding something​

The categories are a sidebar on a wide screen and a bottom sheet on a phone, each carrying the number of items in it. Above them sits a search field that ranks matches across the whole catalog, so a player who knows what they want does not have to remember which category it lives in.

Favourites​

Navigation path:

  • Shop -> Favourites

  • Every item card carries a star. Starring an item puts it into the Favourites category, which always sits at the top of the category list.

  • Favourites are per player and per server, and the counter next to the category shows how many are stored.

  • Below the starred items, a Frequently ordered block suggests what the player ordered most often in the last 90 days — counted per order, not per piece, and capped at six suggestions. Items that are already starred are left out of it.

  • Favourites follow the same visibility rules as the rest of the shop: an item hidden by group restrictions, switched to unavailable, or whose per-player order limit is used up disappears from the list until it can be ordered again.

  • Deleting an item set removes it from everyone's favourites.

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

The page lists your subscriptions first, then what the server offers: plans in tier series (for example priority access in Bronze, Silver and Gold), standalone memberships, and spawn subscriptions.

Booking a membership:

  1. Choose the plan and Subscribe.
  2. If the server offers both, choose whether to pay with your in-game balance or in euros.
  3. In-game: the first month is charged from your balance right away and the membership starts.
  4. Euros: read and accept the server's subscription terms and confirm that the subscription starts immediately (you lose the right of withdrawal once it has started), then pay on Stripe's page. The membership starts as soon as Stripe confirms the payment.

Booking a spawn subscription works the same, with the spawn location and angle chosen first. A spawn billed per paid restart costs nothing until the next paid restart; pausing or cancelling beforehand prevents the charge.

Managing a monthly subscription:

  • Cancel — it keeps running until the end of the paid month and then ends; nothing is refunded for the rest of the month. Take back cancellation until then.
  • Upgrade / Downgrade within a series — up applies right away and charges the difference for the rest of the month; down applies at the next renewal and can be taken back with Keep current plan.
  • Payment method & invoices (euro subscriptions) — opens Stripe's page for your card and invoices.
  • If a renewal cannot be paid, the subscription shows Payment open and its benefits pause until it is paid. After 7 days it ends.
  • A permanent ban on the server ends your subscriptions at the end of the paid month.

Additional behavior:

  • Players can respawn (regenerate) event identifiers for their own spawn subscriptions.
  • If a subscription is faction-owned, faction rights control who can edit/cancel it (change_subscriptions). Factions pay spawn subscriptions in in-game money from their treasury.
  • Guests see the server's plans at /subscriptions and sign in to book.

When a subscription cannot spawn​

If the game server could not place your subscription at the last restart — usually because the spot is blocked — the subscription shows a Spawn problem badge and explains what happened. The charge for that restart comes back automatically, to whatever paid it: your own balance, or the faction treasury for a faction-owned subscription. Nothing is charged at all if that restart was free or your balance was too low.

Pick a spot on open ground so it can spawn at the next restart.

The Charges drawer lists the billing history restart by restart, each marked as charged, refunded, not spawned, free, or skipped because the balance was too low.

Also in Discord: /shop shows your balance and latest order, and /orders all your orders with their delivery status. Ordering and cancelling stay here — see Discord commands.