AFK blocks

Blocks players place outside mines (spawn, cells, AFK areas) that build up rewards every interval, also while the owner is offline, up to a cap of hours.


Configuration	`afk-blocks.yml`
Data	`data/afk-blocks.yml`
Menu	`menus/afk-block.yml`
Command	`/afkblock` (aliases `/afkblocks`, `/bloqueafk`)
Module	`afk-blocks`

How they are used

The player places the item they received.
Right click the block opens its menu and claims what built up.
Sneak + break, or the menu button, picks it up.
/afkblock list shows where theirs are.

Only items from /afkblock give are AFK blocks: they carry a hidden tag, so placing a normal block of the same material does nothing.

Configuration

yaml

settings:
  default-limit: 2
  limits:                               # permission: limit, the highest wins
    pulseprison.afkblocks.limit.vip: 4
    pulseprison.afkblocks.limit.mvp: 8

types:
  basic:
    enabled: true
    name: "@afk-blocks.items.basic-name"
    item:
      material: LODESTONE               # must be a block
      name: "@afk-blocks.items.basic-name"
      lore:
        - "@afk-blocks.items.basic-lore"
      glow: true
    interval-seconds: 60
    offline-cap-hours: 12               # stops building up after 12 h without a claim, 0 for no cap
    allowed-worlds: []                  # empty: every world except the private mine world
    allowed-regions: []                 # WorldGuard regions, empty: anywhere
    deny-in-mines: true                 # can't be placed in rank mines
    permission: ""
    rewards:
      - currency: tokens
        amount: "{intervals} * 150"     # {intervals}: finished intervals
      - currency: money
        amount: "{intervals} * 2500"
    claim-actions: []

Where they can be placed

allowed-worlds, allowed-regions (needs WorldGuard), deny-in-mines and permission are checked in order. Other plugins' protections, such as WorldGuard, are always respected: if the player can't build there, they can't place the block.

To limit AFK blocks to a spawn area:

yaml

allowed-regions: [afk, spawn]

Staff with pulseprison.afkblocks.admin skip allowed-regions and can open and pick up anyone's blocks.

Commands

Command	Permission	Does
`/afkblock` · `/afkblock list`	everyone	Your AFK blocks
`/afkblock give <player> <type>`	`pulseprison.afkblocks.admin`	Gives an AFK block
`/afkblock reload`	`pulseprison.afkblocks.admin`	Reloads `afk-blocks.yml`