Economy

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

---

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.

---

Setting a Cost

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

Permission: st.command.setcost

Money

/st setcost spawn 100

Charges $100 (or your economy currency).

Items

/st setcost nether 5 DIAMOND

Consumes 5 diamonds on teleport.

Experience

/st setcost arena 30 EXP

Requires 30 XP levels or points per your economy integration.

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:

Option	Default	Behavior
payment-timing	before	Charge before or after teleport
refund-on-failure	true	Refund money if teleport fails

Players see insufficient-funds messages with required and current amounts.

---

Cost vs Money Condition

Feature	/st setcost	/st setcondition ... money
Purpose	Charges the player	Checks balance only
Money removed?	Yes	No
Typical use	Toll gates	VIP balance gates

---

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

• Conditions for non-monetary requirements
• Interactive Management to set costs in the GUI
• Integrations for Vault setup notes