Configuring the verification

These settings control when and how Sonar's bot verification is conducted. Adjust these settings only if you really know what you're doing.

Determines when new players are verified. Options:

  • ALWAYS: All new players are checked (Recommended)

  • DURING_ATTACK: Players are only checked during an attack

  • NEVER: No verification for new players

Default: ALWAYS

timing: ALWAYS

Sets the gamemode during verification. Options:

  • SURVIVAL: all UI components are visible

  • CREATIVE: all UI components are hidden

  • ADVENTURE: all UI components are visible (Recommended)

Default: ADVENTURE

gamemode: ADVENTURE

Specifies the username used in the cached LoginSuccess packet. Default: Sonar

cached-username: Sonar

Logs all new verification attempts. Default: true

log-connections: true

Logs verification attempts only during attacks. Default: false

log-during-attack: false

Logs all player movements during verification, useful for debugging. Not recommended for production servers. Default: false

debug-xyz-positions: false

Enables verification checks for Geyser (Bedrock) players. This is experimental and may cause issues. Default: true

check-geyser-players: true

The time (in milliseconds) before disconnecting a player if they stop sending packets. Default: 8000

read-timeout: 8000

The time (in milliseconds) before disconnecting a player if the server stops sending packets. Default: 10000

write-timeout: 10000

The cooldown period (in milliseconds) before a player can reconnect during verification. Default: 8000

rejoin-delay: 8000

The duration (in milliseconds) for which Sonar remembers the number of failed verifications for a player. Default: 120000

remember-time: 120000

The duration (in milliseconds) an IP is blocked after repeated verification failures. Default: 600000

blacklist-time: 600000

The number of failed verifications before an IP is blacklisted. Set to 0 to disable blacklisting. Default: 2

blacklist-threshold: 2

A list of protocol IDs that are blocked from joining the server. Default: [] (empty)

blacklisted-protocols: []

Last updated