Skip to main content

Economy System

Integrates with Vault (EssentialsX, CMI, iConomy, BOSEconomy, etc.) or CoinsEngine for per-tool costs and rewards.

Configuration​

economy:
  enabled: true
  currency: "vault"  # or "coins"
  costs:
    pickaxe: 10.0  # cost per use
    axe: 5.0
    bucket: 1.0
    hoe: 2.0
  rewards:
    pickaxe: 1.0  # reward per block
    axe: 0.5      # reward per log
    bucket: 0.1   # reward per operation
    hoe: 0.3      # reward per crop

See Configuration for the full key reference.

Behavior​

  • Cost: checked and deducted before the operation runs; blocked with a message if the player can't afford it.
  • Reward: calculated from operation count (blocks/logs/crops) and added to balance on success.
  • Action bar: shows cumulative cost/reward for 5 seconds, then auto-resets. Vault shows 💰 -$10.00 / 💰 +$5.00 (decimal); CoinsEngine shows 🪙 -10 / 🪙 +10 (integer).

Bypass​

sigmatools.bypass.economy - no costs deducted, no rewards given. See Permissions.

Messages​

Customizable in messages.yml:

economy:
  insufficient-funds: "&c💰 You need %amount% %currency% to use this tool!"
  cost-deducted: "&e💰 Cost: %amount% %currency%"
  reward-earned: "&a💰 Reward: %amount% %currency%"

API​

SigmaToolsAPI api = Bukkit.getServicesManager().load(SigmaToolsAPI.class);
EconomyResult balance = api.getBalance(player);
EconomyResult deduct = api.deduct(player, 10.0);
EconomyResult reward = api.reward(player, 5.0);

See Also​