DOCS berries.games ↗

Claims, combat & economy

Claims

Players never land inside someone's claim. BerryRTP finds these plugins by itself; there's nothing to set up:

Plugin Counts as claimed
WorldGuard Any region, except the ones in worldguard-ignore-regions
GriefPrevention Any claim
Lands Any land or area
Towny Any town block (wilderness is fine)
protection:
  avoid-claims: true
  worldguard: true
  griefprevention: true
  lands: true
  towny: true
  # WorldGuard regions it's fine to land in
  worldguard-ignore-regions: [wilderness, pvp_zone]

The console shows Hooked into GriefPrevention: players won't land in claims. (or similar) on startup for each plugin it finds. Ready spots are re-checked right before use, so a claim made after a spot was found still counts.

Away from other players

defaults:
  avoid-players: 50     # blocks, 0 = off

No one lands within 50 blocks of another player. Set it per world like any other setting.

Combat

Stops players using /rtp (and the queue) to escape a fight.

combat:
  enabled: true
  pvp-tag-seconds: 10
  placeholder: ""
  in-combat-value: "true"
  block-queue: true

Built-in PvP tag. No other plugin needed. After hitting or being hit by a player (arrows and pets count), both players can't RTP for pvp-tag-seconds. They're told how long is left. Set it to 0 to turn it off.

Your combat plugin. If you already use one, put its PlaceholderAPI "in combat" placeholder in placeholder, and the value it shows while fighting in in-combat-value. For example:

combat:
  placeholder: "%deluxecombat_in_combat%"
  in-combat-value: "true"

Check your combat plugin's docs for its exact placeholder. This needs PlaceholderAPI. Both checks can be on at once.

Players with berryrtp.bypass.combat are never blocked. Taking damage during a warmup also cancels it (rtp.cancel-on-damage).

Economy

Charge for teleports. Needs Vault and an economy plugin such as EssentialsX or CMI.

economy:
  enabled: true
  permission-prefix: "berryrtp.cost."
  ranks:
    vip: 50
  queue-cost: 0

defaults:
  cost: 100

worlds:
  world_the_end:
    cost: 500
  • Each world's price is its cost. The player is charged when they land, so a cancelled teleport is free.
  • /rtp checks they can afford it first and tells them if not (not-enough-money).
  • Ranks pay less: give berryrtp.cost.vip and VIPs pay 50. The lowest price a player has wins.
  • queue-cost is charged to each player when their queue match teleports.
  • berryrtp.bypass.cost teleports for free. /rtp send is always free.
  • Show the price in menus with <cost>.

The console shows Hooked into Vault (EssentialsX Economy): RTP costs are on. when it's working.