SoapsUniverse

Economy

Last updated Oct 28, 2026

Economy

Charge players to use portals with money, items, experience, or custom items. Version 1.0.7.

Staff how-to

  1. For money: install Vault + an economy provider; set economy.enabled: true.
  2. /st setcost <portal> <amount> [type] — money (default), material, EXP, or HAND.
  3. Or /st manage <portal> → Economy and Timing.
  4. Money balance checks (no charge) are set only via manage/GUI conditions — not /st setcondition money.

Requirements for Money

  1. Vault installed
  2. A Vault-compatible economy plugin (EssentialsX, CMI, etc.)
  3. economy.enabled: true in config.yml

Item and XP costs do not require Vault.

Economy config

Key Default Effect
economy.enabled true Use Vault for money costs/conditions
economy.currency-format $%.2f Display format
economy.payment-timing before Charge before or after teleport
economy.refund-on-failure true Refund money if teleport fails

Setting a Cost

/st setcost <portal> <amount> [type]

Permission: st.command.setcost

Money

/st setcost spawn 100

Charges $100 (or your economy currency). Type defaults to MONEY.

Items

/st setcost nether 5 DIAMOND

Consumes 5 diamonds on teleport.

Experience

/st setcost arena 30 EXP

Requires 30 experience points (total XP, not levels). EXPERIENCE is accepted as an alias.

Custom item in hand

Hold the item, then:

/st setcost vip hand [amount]

Uses the exact item in your hand (name, lore, enchantments). Amount defaults to 1.

Free portal

/st setcost spawn 0

Payment Timing and Refunds

From config.yml (see table above). Players see insufficient-funds messages with required and current amounts.

Cost vs Money Condition

Feature /st setcost Money condition (GUI / /st manage)
Purpose Charges the player Checks Vault balance only
Money removed? Yes No
Typical use Toll gates VIP balance gates

There is no /st setcondition … money chat shortcut; balance checks are manage/GUI only. See Conditions.

Examples

/st setcost tollgate 500
/st setcost dungeon_entry 3 DIAMOND
/st setcost enchant_portal 50 EXP
/st setcost spawn 0

PlaceholderAPI

Track spending and balance in scoreboards:

  • %soapsteleporter_economy_balance%
  • %soapsteleporter_economy_spent%

See Placeholders.

Next Steps

Defaults: Default config.yml · Config Reference

Still stuck? Ask about this page