| title | FAQ & Troubleshooting |
|---|---|
| nav_order | 10 |
This document answers common questions and provides solutions to frequent issues with EzAfk.
Q: How do I install EzAfk?
A: Place the EzAfk jar in your server's plugins folder and restart the server.
Q: How do I change the plugin language?
A: Set messages.language in config.yml to your desired language code (e.g., en, es, nl, ru, zh, ja, de).
Q: How do I reload the configuration?
A: Use /afk reload (requires ezafk.reload permission).
Q: How do I exempt a player from AFK detection?
A: Grant them the ezafk.bypass permission or use /afk bypass <player> (requires ezafk.bypass.manage).
Q: MySQL is not connecting.
A: Check your mysql.yml settings, ensure the database is running, and verify credentials. See server logs for errors.
Q: WorldGuard/TAB/PlaceholderAPI integration is not working.
A: Make sure the plugin is installed and enabled. Check config.yml integration settings and server logs for errors.
Q: Players are not being kicked for AFK.
A: Ensure kick.enabled is true in config.yml and the timeout is set correctly. Check for permission conflicts.
Q: Messages are not translated.
A: Make sure the correct language file exists in messages/ and is set in config.yml.
Q: How do I add a new action to the AFK GUI?
A: Edit gui.yml and add a new entry under actions: following the format of existing actions.
Q: How do I customize placeholders?
A: See docs/messages.md for a list of supported placeholders and where they are used.
For more help, see the README.md, configuration guide, or open an issue on GitHub.