Vault

Vault Economy

WildRTP can charge players for RTP using Vault and any Vault-compatible economy plugin, such as EssentialsX Economy.

Requirements

• Vault
• A Vault-compatible economy plugin
• Vault enabled in config.yml

Configuration

hooks:
  vault:
    enabled: true
    settings:
      pay-by-distance:
        enabled: false
        price-per-block: 0.01
      pay-by-teleport:
        enabled: true
        price: 5.0

WildRTP supports two payment methods:

• Pay by teleport — fixed price per RTP.
• Pay by distance — price per horizontal block travelled.

When both are enabled, they are added together:

fixed price + horizontal distance × price per block

The Y-axis is ignored.

Per-World Pricing

Payment settings can be overridden for individual worlds:

custom:
  world_nether:
    hooks:
      vault:
        settings:
          pay-by-distance:
            enabled: true
            price-per-block: 0.02
          pay-by-teleport:
            enabled: true
            price: 10.0

World settings inherit global values individually, so you only need to specify what you want to change.

To make a world free:

custom:
  free_world:
    hooks:
      vault:
        settings:
          pay-by-distance:
            enabled: false
          pay-by-teleport:
            enabled: false

hooks.vault.enabled is global. Per-world settings can override payment options, but cannot enable the Vault hook themselves.

Payment Behavior

• Players are charged only after a safe RTP location is found.
• Failed RTP searches do not charge players.
• Insufficient funds or failed transactions cancel the teleport.
• If a paid teleport fails, WildRTP attempts to refund the full amount.
• If Vault or the economy provider is unavailable, RTP remains free and a warning is logged.
• If both payment methods are disabled, RTP is free.

Applying Changes

Payment prices and per-world settings can be reloaded with:

/wild reload

Requires:

wildrtp.reload

Changing hooks.vault.enabled requires a server restart.