Economy and Shop

Multi-currency balances, shop catalog, cheques, daily rewards, and mob drops. Modules: economy, shop. Config: economy.yml, prices.yml, daily.yml. Defaults: Default economy.yml · Default prices.yml · Default daily.yml · Config Reference.

Player how-to

1. Check balance: /sa money (or Vault-aware placeholders). Pay others: /sa pay <player> <amount> (confirm above pay-confirm-threshold).
2. Shop: /sa shop hub (balance and worth preview) → Buy / Sell, or /sa buy / /sa sell hand / /sa sellall.
3. Daily reward: /sa daily (cooldown and payout from daily.yml; optional GUI action [daily_claim]).
4. Cheques (when enabled for a currency): /sa cheque withdraw <economy> <amount> → right-click to deposit, or /sa cheque deposit.
5. Block incoming pays: /sa paytoggle (defaults in player-utilities.yml → privacy).

Staff how-to

1. Open economy GUI: /sa economy manage. Give/set/take: /sa economy give|set|take ….
2. Create currencies in-game or under economies: in economy.yml, then /sa reload economy.
3. Edit shop prices in prices.yml → /sa reload shop. Daily: edit daily.yml → /sa reload daily.
4. Mythic exclusive drops: economy.yml → mob-drops.mobs.mythicmobs.<InternalName>. Spawner budgets: Spawners.

Multi-Currency Economy

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

Top-level keys (economy.yml)

Key	Default	Effect
enabled	true	Master economy toggle
pay-confirm-threshold	10000	Chat confirm for /sa pay above this amount
pay-feedback.actionbar	true	Action bar when paid
pay-feedback.sound-enabled	true	Sound when paid
pay-feedback.sound	ENTITY_EXPERIENCE_ORB_PICKUP	Pay receive sound
vault-integration	true	Register primary economy with Vault
primary-economy	money	Economy id exposed to Vault

Default Currencies

ID	Symbol	Starting balance	Notes
money	$ (before)	100.00	Primary; cheques off
tokens	T (after)	0	Cheques off
points	pts (after)	0 (max 1,000,000)	Cheques off; drop-item: []
vouchers	V (after)	500	Example cheque currency (cheque.enabled: true)

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

Per-economy options

Key	Effect
display-name / symbol / symbol-position / format	Display formatting
starting-balance / min-balance / max-balance	Limits (max-balance: 0 = unlimited)
gui-icon / description / permission	GUI + optional use gate ("" = everyone)
drop-item	Physical mob-drop look ([] disables item drops for that currency)
cheque	Per-currency cheque settings (see Money cheques)

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.

Key	Default	Effect
mob-drops.enabled	true	Master toggle for currency drops
pickup-mode	auto-claim	auto-claim or physical (right-click claim)
prevent-hopper-dropper-transfer	true	Block hopper/dropper movement of currency items
preserve-on-clearlag	true	Survive clearlag sweeps
custom-mobs.vanilla-only	false	true = only normal Minecraft mobs
spawn-reasons.disabled	SPAWNER_EGG	Skip drops for listed spawn reasons
spawn-reasons.spawner-kill-limit.enabled	true	Global per-spawner kill budget
spawn-reasons.spawner-kill-limit.max-kills-per-spawner	15	Default kill budget
mobs.default / mobs.entities	(tables)	Vanilla drop tables
mobs.mythicmobs	{}	Per-MythicMobs exclusive tables

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)

Key	Default	Effect
settings.currency	money	Currency used for sell payouts
settings.default-buy	0	Default buy when an entry omits buy
settings.default-sell	0	Default sell when an entry omits sell

Per-material under prices::

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 (balance / worth preview, 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]	Catalog lookup (held item if omitted)
/sa worth [hand|inventory]	Sell worth total (hand by default)
/sa value [hand|inventory]	Line breakdown (inventory by default)

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 + /sa daily claim (or YAML [daily_claim]). Requires the economy module for money payouts. Reload: /sa reload daily.

Key	Default	Effect
cooldown-hours	24	Hours between claims
reward.economy	money	Currency id credited
reward.money	250	Amount credited on claim
reward.items	bread ×8	List of { material, amount } stacks (supports crucible: ids when Mythic resolves)

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