PaperAfk

Paper plugin that sends AFK players to a personal, protected room in a separate void world, with a jukebox that remembers each player's favourite music disc.

Requires Paper 1.21.4+ and Java 21.

Features

• /afk toggles between your current location and your own AFK room
• Auto-AFK after inactivity; moving, chatting, commands or interacting bring you back
• AFK players are greyed out with a suffix in the tab list
• The AFK world is protected: no damage, block changes, item drops or pickups, ender pearls or chorus fruit
• /afk is blocked for a while after PvP combat
• Right-click the room's jukebox to pick any music disc; the choice is saved per player
• AFK players are returned on quit and on server shutdown

Build

./gradlew build          # build/libs/PaperAfk-<version>.jar
./gradlew runServer      # local test server

Commands and permissions

Command	Permission	Default
/afk	paperafk.afk (only if require-afk-permission)	everyone
/afk <player>	paperafk.afk.other (only if require-afk-other-permission)	op
	paperafk.bypass.combat skips the combat cooldown	op

Config

afk-world-name: afk_world   # recreated empty on every server start
room-size: 10               # blocks, minimum 8
room-distance: 100          # blocks between rooms

require-afk-permission: false
require-afk-other-permission: true

afk-indicator: zZ

auto-afk:
  enabled: true
  time-minutes: 5
  show-overlay: true

combat:
  cooldown-seconds: 30
  admin-bypass: true

License

Apache-2.0