Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Anti-AFK system for preventing AFK XP gain #305

Merged
merged 6 commits into from
Jul 20, 2024
Merged

Anti-AFK system for preventing AFK XP gain #305

merged 6 commits into from
Jul 20, 2024

Conversation

Archy-X
Copy link
Owner

@Archy-X Archy-X commented Jul 14, 2024

  • This is an optional feature that detects and blocks repetitive AFK skill XP gain, encouraging active play
  • Must be manually enabled with the anti_afk.enabled option in the main config
  • There are 8 types of checks that can block AFK XP gain in the following skills: Farming, Foraging, Mining, Fishing, Excavation, Fighting, Archery, and Defense
  • The checks work in one of three ways: detecting identical player coordinates, facing direction (pitch/yaw), or the entity being involved
  • Checks are configured in the anti_afk.checks section
    • Specific checks can be toggled with the enabled option
    • The min_count option is the number of identical XP gain conditions in a row for the player to be blocked from gaining XP
    • The max_distance option for some checks is the threshold for which movement below that value is still considered identical
  • Logging for failing anti-AFK checks can be enabled with the anti_afk.logging_enabled option
    • The log_threshold is an expression determining the count of identical conditions required for logging an event. The min_count variable can be used in this expression to reference the min_count in the checks section for a check type.
    • Logs will be sent to any online player with the auraskills.antiafk.notify permission (op by default)
    • Logs are saved to storage can can be viewed for any player with the /skills antiafk logs <player> [page] [perPage] command (auraskills.command.antiafk.logs permission)
  • Important disclaimer: A player failing checks and being logged does not necessarily mean they are cheating or using a macro, as false positives can be common for legitmate players, especially if min_count is low. An example is a player using a mob farm manually can still trigger anti-AFK checks. Always monitor logged players manually before taking any action.

@Archy-X Archy-X merged commit 5f98216 into master Jul 20, 2024
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant