Skip to main content

Check EssentialsX AFK kick exemptions for a staff role

Applies to: EssentialsX; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

An AFK kick policy can affect ordinary players and staff differently. Verify the timeout and exemption nodes with controlled accounts before changing the live player experience.

Follow the procedure

  1. Record the intended AFK indication time and kick time. Check whether another plugin or server setting also disconnects idle players so you can identify the actual cause.
  2. Inspect the AFK options in the generated EssentialsX configuration. Note their units and disabled-value behaviour for the installed release.
  3. Choose an ordinary test player and a staff test player. Inspect their inherited AFK-related permissions, especially any kick exemption granted through a broad staff parent.
  4. Use a short temporary trial window on a test server or quiet maintenance session. Leave both accounts idle under the same conditions and observe the messages and disconnect reason.
  5. Test a deliberate movement or activity action to confirm it resets the expected timer. Keep a record of what EssentialsX considers activity in your configuration.
  6. Restore the approved production timeout after the trial and keep only the intended staff exemption. Document the policy so an AFK disconnect is not mistaken for a crash.

Check the result

The ordinary account should follow the configured kick policy while an explicitly exempt staff role follows its reviewed exception. Compare timestamps and disconnect messages. A server that pauses when empty or another idle-kick component can change the observation, so identify which system issued the actual disconnect.

If the result is wrong

If every role avoids the kick, inspect inherited exemptions before shortening the timeout further. If staff are kicked unexpectedly, compare the exact exemption node with the official permission list. Restore the previous policy if the trial disrupts players; do not disable all idle protections without understanding the conflicting component.

References and related help