Managing AFK Players During Pixelmon Battles
The AFK Battle section contains the options Pixelmon uses for this part of the server. Set battle inactivity timers and determine how Pixelmon handles turns for AFK players.
Pixelmon AFK Battle Settings
The settings below are listed in the same order as they appear in afk_handler.yml. The table preserves each default and identifies the accepted value type. The Setting column shows a reader-friendly name first, followed by the matching afk_handler.yml key for reference.
| Setting and Config Key | Default and Accepted Values | Description |
|---|---|---|
| Enabled enabled | Default: false Values: true or false | Whether or not the AFK handler is enabled. |
| AFK Activate Seconds afk-activate-seconds | Default: 90 Values: whole number | The amount of time (in seconds) that a player can be unresponsive in battle before the AFK handler takes control. |
| AFK Timer Turn Seconds afk-timer-turn-seconds | Default: 15 Values: whole number | The amount of time that the AFK handler takes to make a move. |
Important AFK Battle Setting Notes
Defaults and Value Types
Boolean toggles, numeric rates, timers, lists, and mappings use different value formats. Preserve the value type shown in the table and keep collection syntax intact when changing afk_handler.yml.
Settings That Work Together
Several afk battle options can affect the same outcome. Review related rates, limits, timers, and lists together before deciding that one value is responsible for a result.
Testing Changes
Change one related group of settings at a time so its effect is easy to measure.
Test the result under the conditions affected by the setting, including relevant dimensions, player states, or encounter types.
Keep a copy of the previous values so unexpected balance or performance changes can be reversed quickly.
Final Thoughts
AFK Battle settings are easier to balance when changes are deliberate and documented. Start with the defaults, adjust only what the server needs, and verify the result before moving on to the next group.
Need Help?
If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.