Examples match release 1.0.0. Back up your configuration before editing. Use this plugin's reload command where supported; restart after dependency or JAR changes.
Settings in this file
Values shown below are sanitized defaults from the release JAR. Empty private fields must be configured locally.
Master switch for the feature.
Setting
Action taken after a confirmed detection.
Setting
Action taken when the client does not complete the check.
Setting
Delay before checks start after joining; twenty ticks are approximately one second.
Setting
Time allowed for a probe response in server ticks.
Setting
Delay between signature probes in server ticks.
Setting
Number of confirmation checks used before detection is finalized.
Setting
Name prefixes excluded from Java-client probes.
Setting
Enable or disable the individual mod signature probes.
Setting
Additional client signatures rejected by JoinGuard. Review this list against your server rules.
Setting
Detection counts and commands run after repeated detections.
Setting
Player-facing messages and command feedback. Preserve the placeholder spelling used in each default.
Setting
Default configuration
Preserve YAML indentation. Never publish your configured keys, tokens or player data.
enabled: true
detected-action: KICK
timeout-action: KICK
join-delay-ticks: 1
response-timeout-ticks: 60
between-probes-ticks: 1
confirmation-checks: 2
bedrock-name-prefixes: [".", "*"]
disallowed-mods:
freecam:
enabled: true
display-name: "Freecam"
translation-keys: ["key.freecam.toggle"]
meteor:
enabled: true
display-name: "Meteor Client"
translation-keys: ["key.meteor-client.open-gui", "key.meteor-client.open-commands"]
wurst:
enabled: true
display-name: "Wurst Client"
translation-keys: ["key.wurst.zoom"]
xaero-minimap:
enabled: true
display-name: "Xaero's Minimap"
translation-keys: ["gui.xaero_minimap", "effect.xaerominimap.no_minimap"]
xaero-world-map:
enabled: true
display-name: "Xaero's World Map"
translation-keys: ["gui.xaero_world_map_settings", "effect.xaeroworldmap.no_world_map"]
xray:
enabled: true
display-name: "Xray Client Mod"
translation-keys: ["key.xray.toggle", "key.xray.open_config"]
blocked-client-signatures:
- meteor
- wurst
- liquidbounce
- bleachhack
- aristois
- impact
- futureclient
- rusherhack
- lambda
- xaerominimap
- xaero_minimap
- xaeroworldmap
- xaero_world_map
- xray
- litematica
- tweakeroo
- mousetweaks
- mouse_tweaks
- inventoryprofilesnext
- inventory_profiles_next
- healthindicators
- damageindicators
- macrokeybind
- craftingtweaks
- crafting_tweaks
repeat-detection:
enabled: true
ban-after-detections: 2
ban-commands:
- "ban {player} [JoinGuard] Repeated use of a prohibited client modification: {mod}"
messages:
prefix: "&8[&bxAntiFreecam JoinGuard&8] "
checking: ""
passed: ""
kick: ["&cYou are using a prohibited client modification ({mod}).", "&cRemove it before reconnecting."]
ban: ["&cYou have been banned.", "&7Reason: Repeated use of a prohibited client modification ({mod})."]
timeout-kick: ["&cThe client integrity check could not be completed.", "&7Remove packet blockers or unsupported client modifications and reconnect."]
alert: "&c{player} &7failed the JoinGuard check: &f{mod} &8(&7{reason}&8)"
reload: "&aJoinGuard configuration reloaded."
check-started: "&aStarted a new JoinGuard check for &f{player}&a."
player-not-found: "&cThat player is not online."
no-permission: "&cYou do not have permission."
usage: "&7Usage: &f/xafjg reload&7, &f/xafjg check <player>&7, &f/xafjg status [player]&7, &f/xafjg violations <player>&7, &f/xafjg forgive <player>&7, &f/xafjg license [verify]"
status: "&7Checks: &f{checks} &7Passed: &a{passed} &7Detected: &c{detected} &7Timeouts: &e{timeouts} &7Pending: &f{pending}"
player-status: "&7{player}: &f{status}"
violations: "&7{player} has &f{count} &7confirmed detection(s)."
forgiven: "&aCleared all detections for &f{player}&a."
violation-not-found: "&cNo stored detections were found for that player."
