Your first zone

1. Select the area

1. Take the wand: /szpontafkzone wand. By default it is a blaze rod; change the item with wand.item in config.yml.
2. Left-click a floor block in one corner and right-click a block at head height in the opposite corner.

Instead of the wand you can stand in two opposite corners and use /szpontafkzone pos1 and /szpontafkzone pos2.

After you set a corner, the selection borders are drawn with particles for 10 seconds. Change the time with wand.preview-seconds and the particle with wand.particle.

Caution

A player counts in a zone while the block at their feet is inside its area. The zone must therefore include the space above the floor; ideally it is at least 3 blocks high. When you select two floor blocks only, the plugin warns you that the zone is 1 block high.

2. Create the zone

/szpontafkzone create afk

The command creates zones/afk.yml and enables the zone right away. The zone id is the file name without .yml; you use it in commands and placeholders.

An id is 1–32 characters long: lowercase a-z, digits and single dashes (e.g. spawn-afk). Letters with diacritics, spaces and underscores are not allowed.

3. Set up the rewards

A new zone has two reward tracks, guaranteed and bonus (with a chance), and each of them has the tiers default and vip. The tracks contain only harmless example messages. Add the real reward as a console command to the actions of a tier:

rewards:
  guaranteed:
    interval-seconds: 600
    tiers:
      default:
        priority: 10
        permission: ''
        chance-percent: 100
        actions:
          - '[console] give {player} diamond 1'
          - '[message] {prefix}&aYou received a reward!'

Save the file and use /szpontafkzone reload.

For details, see Reward tracks and tiers and Actions.

4. Grant the VIP tier

The vip tier of the template needs the szpontafkzone.tier.vip permission. Operators do not get it automatically. Grant it, for example with LuckPerms:

/lp group vip permission set szpontafkzone.tier.vip true

5. Check the zone

• /szpontafkzone info afk shows the zone details: status, world, area with its size, priority, permission, players in the zone, file and reward tracks with their tiers.
• /szpontafkzone show afk draws the zone borders with particles.
• /szpontafkzone list lists all zones with their status.

If players get nothing, see the FAQ.