VIP Only Effects

Tutorial: Creating VIP-Only Effects

This tutorial will show you how to restrict specific beacon effects so only players with a certain permission can benefit from them.

Scenario

You want to create a "VIP Flight" effect that only donors with the permission server.vip can use.

Step 1: Create the Effect File

Create a new file in plugins/BeaconPlus/effects/vip_fly.yml.

Display Name: "&b&lVIP Flight"
Description: "Exclusive flight for VIP members!"
Enabled: true
Item:
  type: FEATHER
  meta:
    display-name: "&b&lVIP Flight"
Levels:
  - Cost:
      vault: 0
    Power Consumption: 50
    Effects:
      - Type: FLY
        Height: -1
    Condition:
      Type: HAS_PERMISSION
      Permission: "server.vip"

Step 2: How it Works

The Condition block at the level level ensures that the effect is only applied if the player meets the requirements.

• Type: HAS_PERMISSION: This tells BeaconPlus to check for a permission node.
• Permission: "server.vip": The node to check for.
• Effect Application: If a player WITHOUT this permission enters the beacon range, the plugin will skip applying the FLY effect to them, but other players (with the permission) will still get it.

Step 3: Global Restrictions (Optional)

If you want the entire beacon to be VIP-only, you can add a condition to the main beacon.yml under Beacon Effect Condition.

Tip

You can also use HAS_PERMISSION with Negate: true to create effects that don't apply to certain groups (e.g., preventing staff from getting accidental boosts).