Economy and Shop

Multi-Currency Economy

economy.yml defines independent currencies. Each has its own balances, formatting, and optional permission gate.

Default Currencies

ID	Symbol	Starting balance
money	$ (before)	100.00
tokens	T (after)	0
points	pts (after)	0 (max 1,000,000)

Create more via /sa economy create <id> or by editing economies: in economy.yml.

Vault Integration

vault-integration: true
primary-economy: money

When enabled, the primary economy registers with Vault so third-party plugins can read balances.

Admin Management

/sa economy manage
/sa economy give <player> <amount> [currency]
/sa economy set <player> <amount> [currency]
/sa economy take <player> <amount> [currency]
/sa economy create <id>

Mob Currency Drops

Physical (or direct) currency rewards from mob kills when mob-drops.enabled is true.

Setting	Description
pickup-mode	auto-claim or physical (right-click claim)
prevent-hopper-dropper-transfer	Block hopper movement of currency items
preserve-on-clearlag	Survive clearlag sweeps (works even when mob-drops generation is off)
spawn-reasons.disabled	Skip drops for listed spawn reasons
spawn-reasons.spawner-kill-limit	Global per-spawner kill budget
mobs.default / mobs.entities	Vanilla drop tables
mobs.mythicmobs	Per-MythicMobs exclusive tables
custom-mobs.vanilla-only	true = no Mythic/Citizens drops

MythicMobs drop tables

If a Mythic mob has an entry under mobs.mythicmobs.<InternalName>, only that table is used (no default/entity merge).

mob-drops:
  custom-mobs:
    vanilla-only: false
  mobs:
    mythicmobs:
      SkeletonKing:
        drops:
          # Physical claimable items (uses economies.<id>.drop-item look, unless overridden)
          - currency: tokens
            chance: 1.0
            min-items: 5
            max-items: 10
            delivery: item
            drop-item:                 # optional per-rule appearance
              material: EMERALD
              display-name: "<green>King Token</green>"
              amount-per-item: 1.0

          # Direct balance credit to the killer (no item)
          - currency: money
            chance: 1.0
            min-amount: 50
            max-amount: 100
            delivery: direct

Field	Meaning
currency	Economy id from economies:
chance	0.0–1.0
min-items / max-items	Item count (delivery: item)
min-amount / max-amount	Currency amount (delivery: direct; also accepted as aliases for min/max-items)
delivery	item (default) or direct / balance / give
drop-item	Optional override of the physical item look
amount-per-item	Value credited per physical item (or multiplier for direct)

Requires MythicMobs installed for Mythic identity detection. See Integrations.

Money cheques

Physical cheques for withdraw/deposit when enabled per currency under economies.<id>.cheque in economy.yml.

economies:
  money:
    cheque:
      enabled: false
      material: PAPER
      name: "<green>{currency} Cheque</green>"
      lore:
        - "<gray>Value: <white>{amount}</white></gray>"
        - "<dark_gray>Right-click to deposit</dark_gray>"
      min-withdraw: 1
      max-withdraw: 1000000
      glow: true

Default currencies ship with cheques disabled. The example vouchers currency has cheques enabled for testing (/sa cheque withdraw vouchers 250).

Command	Usage	Permission
/sa cheque withdraw <economy> <amount>	Create a cheque item	soapsadmin.cheque / soapsadmin.cheque.withdraw
/sa cheque deposit	Redeem held cheque	soapsadmin.cheque / soapsadmin.cheque.deposit

Works on Paper and Spigot. If withdraw says cheques are disabled, set economies.<id>.cheque.enabled: true for that currency.

WorldGuard currency flag

When WorldGuard is present, region flag soapscurrency (default ALLOW) controls SoapsAdmin mob currency. Set to DENY to disable drops in that region:

/rg flag <region> soapscurrency deny

Spawner kill budget

Global limit: spawn-reasons.spawner-kill-limit in economy.yml.
Per-spawner override: spawner editor → Kill Budget (stored in data/server/spawners.yml).

Full editor docs: Spawners.

Shop (prices.yml)

settings:
  currency: money
  default-buy: 0
  default-sell: 0

DIAMOND:
  buy:
    money: 100
    tokens: 5
  sell: 50

crucible:MyCustomSword:
  buy:
    money: 500
  sell: 250

Crucible / Mythic item keys use the same crucible: / mythic: / mm: prefixes as recipes. Buy and sell resolve ExactChoice stacks by Mythic item id when MythicCrucible is loaded.

Reload: /sa reload shop

Command	Description
/sa shop	Shop GUI (Buy / Sell)
/sa buy <item> [amount]	Purchase
/sa sell hand	Sell held item
/sa sell inventory / /sa sellall	Sell inventory
/sa sell <category>	Sell by category (blocks, ores, materials, potions, equipment, …)
/sa price <item>	Lookup
/sa worth inventory	Inventory value

Buy GUI

Paginated catalog from prices.yml buy entries:

Control	Behavior
Search (hopper)	Chat filter; type clear to reset
Category	Cycle filters: blocks, materials, ores, potions, equipment, tools, combat, food, farming, mob-drops, high-value, misc
Prev / next	Page arrows
Item click	Buy 1 / 16 (shift) / 64 (right)

High value keeps items in the top quartile of catalog buy prices (floor 25 in primary currency).

Max balance: if a sell would exceed the currency max, items are not removed and the player is told the balance is full (including autosell).

Economy reset all

/sa economy resetall -confirm
/sa economy resetall <economy> -confirm

With -confirm, the primary (or named) economy resets immediately. Without the flag, players get a chat confirm prompt. Works through custom-command economy overrides (flags are preserved).

Daily Rewards

daily.yml + animated /sa daily roulette GUI.

Pay and Privacy

/sa paytoggle blocks incoming payments. Defaults in player-utilities.yml → privacy:.

Logging, Tax, Pay All

Command	Description
/sa moneylog	Transaction log
/sa payall <amount>	Pay all online
/sa tax <amount>	Deduct from all online

Autosell

Players add materials to an autosell list; matching pickups sell at shop sell price (player-utilities.yml).

Configuration notes

Goal	Setting
Boss / Mythic physical drops	Dedicated currency + delivery: item (optional drop-item) under mobs.mythicmobs
Silent balance reward	delivery: direct
Block selling rare materials	prices.yml → default-sell: 0 or per-item sell: 0
External shop plugin	Disable shop module; keep economy enabled for balances and drops