PasiAfkZone

It's not just another AFK zone plugin, it's PasiAFKZone, a customizable AFK reward system with timed rewards, bossbars and per-world zones :>

If you have any suggestions, write to me and I will try to implement them :>

Why PasiAFKZone?

AFK zones are a great way to reward players for spending time on your server, but managing rewards, timers and messages can quickly become complicated.

PasiAFKZone gives you control over your AFK zone, reward system and player experience through a configurable setup.

• Automatic timed rewards
• Multiple configurable rewards
• Individual reward chances and permission requirements
• Customizable bossbars and timers
• Configurable AFK zone selection
• Per-IP reward limits
• Custom messages and visual effects

Plans for future features:

• PlaceholderAPI support
• More reward options
• Additional visual effects

✅ Already done

Nothing

Installation

1. Stop server
2. Place plugin in plugins folder
3. Start server
4. Configure the plugin in config.yml
5. Use /pasiafkzone help to check available commands

Features and description

🎁 Automatic Reward System

Reward players automatically for spending time in your AFK zone.

Configure how often rewards are rolled and define as many reward commands as you need. Each reward can have its own chance and permission requirement.

You can reward players with in-game currency, items, experience or anything else supported by your server's command system.

---

⚙️ Flexible Reward Configuration

Every reward can be configured separately.

• Custom reward commands
• Individual reward chances
• Permission requirements
• Multiple rewards per reward roll
• Custom reward display text

Reward chances can exceed 100%, allowing you to configure your reward system according to your needs.

---

⏱️ Custom Timers and Bossbars

Let players see how long they have spent in your AFK zone or how long remains until their next reward.

Configure the timer format and customize the display using:

• ActionBar messages
• Bossbars
• Custom titles and subtitles
• Custom colors and formatting

Bossbars support configurable colors, styles and permission requirements.

---

🗺️ Configurable AFK Zones

Define the corners of your AFK zone and configure its location through the plugin.

Use the selection wand to select two positions and manage zones with the available commands.

This makes it possible to create a dedicated AFK area for your server instead of relying on a single hardcoded location.

---

🛡️ Per-IP Reward Limits

Prevent multiple accounts from collecting AFK rewards simultaneously from the same IP address.

Configure how many players sharing an IP address can receive rewards at once, or disable the limit entirely.

This is especially useful for servers that want to limit reward farming with multiple accounts.

---

💾 Player Data Saving

Configure when player data should be saved to the database.

Available options allow saving data when a player leaves the server or exits the AFK zone.

This gives you control over when player progress is persisted.

---

⚙️ Compatibility

Platform

Platform	Support	Notes
Paper & Purpur	✅	Recommended
Spigot	⚠️	Not independently verified
Mohist & Leaf	⚠️	Not independently verified
Bukkit	⚠️	Not independently verified
Folia	🕒	Not confirmed
Velocity & BungeeCord	❌	Not a proxy plugin

Versions

Version	Support	Notes
1.21+	✅	Recommended
Below 1.21	⚠️	Not confirmed

Commands (1.0)

💻 Commands

Command	Aliases	Arguments	Description
/pasiafkzone	/paz	<subcommand>	Main plugin command
├─ help	—	—	Display the help menu
├─ reload	—	—	Reload plugin configuration
├─ wand	—	—	Give the selection wand
├─ create	—	<zone>	Create a zone
└─ delete	—	<zone>	Delete a zone

Additional aliases can be configured through command-aliases in the configuration.

Permissions (1.0)

❌ Permissions

Plugin Permissions List:

• pasiafkzone.use – Allows using the main plugin command.
• pasiafkzone.reload – Allows reloading the plugin.
• pasiafkzone.wand – Allows obtaining the zone selection wand.
• pasiafkzone.create – Allows creating zones.
• pasiafkzone.delete – Allows deleting zones.

Default permissions:

• pasiafkzone.use – Enabled for everyone by default.
• pasiafkzone.reload – Operators only by default.
• pasiafkzone.wand – Operators only by default.
• pasiafkzone.create – Operators only by default.
• pasiafkzone.delete – Operators only by default.

Default config (1.0)

🔧 Config

# PasiAFKZone configuration
# The full default config is included with the plugin.
# Edit config.yml to customize your AFK zone, rewards, messages and timers.

messages:
  entered: ''
  left: ''
  # The %rewards% line will be duplicated for every reward given
  reward: ''

on_reward:
  broadcast: "&7<player> wlasnie otrzymal nagrodę afk &6(/warp afk)"
  particle: "HEART"
  sound: "ENTITY_PLAYER_LEVELUP"

save-on-database:
  on_server_quit: true
  on_zone_quit: true

# Set any of the lines to "" if you want to disable them
in-zone:
  title: ''
  subtitle: ''
  actionbar: '&#48ff00» ⌚ &#7dfab1%time% &#48ff00⌚ «'
  bossbar:
    bossbar1:
      name: "&#48ff00⌚ &7| &#48ff00ɴᴀɢʀᴏᴅᴀ &#7dfab1ᴀꜰᴋ &#48ff00ᴢᴀ: &#7dfab1%time%"
      # Colors: see Adventure BossBar.Color documentation
      color: GREEN
      # Styles: see Adventure BossBar.Overlay documentation
      style: SOLID
      permission: 'gracz'

# How often should a reward be rolled? (in seconds)
reward-time-seconds: 900

# Chances can exceed 100%
# You can add as many rewards as you would like
rewards:
  display: ''
  commands:
    key:
      command: case give %player% afk 1
      permission: 'gracz'
      chance: 100
    dollars:
      command: eco give %player% 200
      permission: 'gracz'
      chance: 100
    xp:
      command: xp add %player% 100 points
      permission: 'gracz'
      chance: 100
    vPLNs:
      command: pc add %player% vpln 0.01 strefaafk(gracz)
      permission: 'gracz'
      chance: 100

# Zone coordinates
zone:
  location1: survival;-105.0;70.0;-99.0;0.0;0.0
  location2: survival;-99.0;65.0;-105.0;0.0;0.0

prefix: '&#fcbc00ᴘ&#f9c900ᴀ&#f7d700ѕ&#f4e400ɪ&#f1f200ᴍ&#eeff00ᴄ &7» '

# 1 - HH:MM:SS, e.g. 01:25:35
# 2 - Short format, e.g. 20m
# 3 - Text format, e.g. 01h 25m 35s
timer-format: 3

# You must define at least one alias
# Requires a restart to update
command-aliases:
  - afkzone
  - strefaafk
  - paz

# How many players can gain rewards at once from a single IP?
# Set to -1 for unlimited
per-ip-limit: 1

# Should bossbar progress start full or empty?
# 0 - Decreasing value (starts filled)
# 1 - Increasing value (starts empty)
bossbar-mode: 0

# Should the plugin notify you when a new update is available?
update-notifier:
  enabled: true

Note: The plugin's supplied configuration also contains language strings for help, reload, time units, selection wand, zone management, command errors and update notifications. Keep those sections from your actual config.yml when publishing the full default configuration.

Other plugins

If you enjoy PasiAFKZone, you may also like my other projects.

• 👻 PasiVanish – Lightweight and highly configurable vanish plugin.
• 💤 PasiAntyThrow – Configurable item-throwing restriction plugin.
• ⚔️ PasiCriticals – Lightweight and customizable critical hit plugin.
• ⚔️ More plugins are coming soon...

---

❤️ Thank you for downloading PasiAFKZone!

Thanks to everyone who uses this plugin, I really appreciate every download, every suggestion and every review. ❤️

Every download motivates me to continue developing free Minecraft plugins for the community.

See you in the next update! 🚀

🎯 Goals

1. 1 ❌
2. 5 ❌
3. 10 ❌
4. 50 ❌
5. 100 ❌

Support

If you have any ideas, bug reports or feature requests, feel free to join the Discord server below.