Skip to content

Astroworld-MC/AstroSimpleAFK

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AstroSimpleAFK

Lightweight AFK detection plugin for Paper 1.20+ servers. Automatically marks idle players as AFK with a configurable prefix in the tab list, and broadcasts AFK/return messages to chat.

Features

  • Automatic AFK detection after configurable idle timeout (default 5 minutes)
  • Displays [AFK] prefix in the tab list
  • Resets AFK on movement, chat, or interaction
  • Manual AFK toggle with /afk
  • Broadcast messages when players go AFK or return
  • Bypass permission for staff
  • Fully configurable messages and timing

Installation

  1. Download AstroSimpleAFK-1.0.0.jar
  2. Drop the JAR into your server's plugins/ folder
  3. Restart the server
  4. Edit plugins/AstroSimpleAFK/config.yml to customize

Commands

Command Description Permission
/afk Toggle your AFK status astroafk.command
/afk reload Reload the config file astroafk.reload

Permissions

Permission Description Default
astroafk.command Allows toggling AFK status Everyone
astroafk.reload Allows reloading config OP
astroafk.bypass Bypass AFK detection OP

Configuration

# Time in seconds before marked AFK (default 300 = 5 minutes)
timeout-seconds: 300

# Prefix in tab list (supports & color codes)
afk-prefix: "&7[AFK] "

# Broadcast AFK/return messages
broadcast-enabled: true
broadcast-afk-message: "&7%player% is now AFK."
broadcast-return-message: "&7%player% is no longer AFK."

Links

Built by Astroworld - Minecraft Economy Survival Server

Need hosting? Try Astroworld Hosting

License

MIT License

Packages

 
 
 

Contributors

Languages