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.

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 hub 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