Version: 1.1.0 (Beta)

Changelog Summary

Version: 1.1.0 (Beta)

New Features:

1. Language-Based Cheating Ban Detection:

   • Added support to detect cheating bans in multiple languages (French, Spanish, Italian, etc.).

2. Role Ping for Cheater Alt Detection:

   • Added a new configuration option rolePingForCheaterAlt.
   • If enabled and a roleID is defined, the specified role will be pinged in the admin chat when a cheater alt is detected.

3. Configuration Options for Embeds:

   • Introduced enableBMBans config option to enable or disable fetching and displaying BattleMetrics ban information.
   • Enhanced the logic to conditionally include Community Ban List (CBL) and cheater ban information based on config options.

Improvements:

1. Connection Delay for Kicking Players:

   • Implemented a delay before kicking players to ensure they are fully connected.

2. Handling Embed Character Limits:

   • Added logic to split long embeds into multiple parts if they exceed Discord’s 6,000 character limit.

Bug Fixes:

1. EOS ID Handling:

   • Fixed an issue where missing EOS IDs caused incorrect cheater ban detections.

2. Proper Formatting in Embeds:

   • Ensured proper spacing and formatting in embeds even when certain information is disabled.

3. False Cheater Ban Triggers:

   • Addressed issues causing false cheater ban triggers due to missing or incorrectly parsed EOS IDs.

Configuration Changes:

• New Config Options:
  • enableBMBans: Enable or disable fetching and displaying BattleMetrics ban information.
  • rolePingForCheaterAlt: Enable or disable role pinging in the admin chat when a cheater alt is detected.
  • roleID: Define the role ID to be pinged when rolePingForCheaterAlt is enabled.

Note: This release is a beta version intended for testing the new features and improvements. It is not recommended for public use at this stage.

v1.0.0

Release Notes

Version 1.0.0 - Stable Beta

New Features

• Cheater ALT Detection and Kicking: The plugin can now detect and kick cheater alts when a player joins. This feature is configurable through the enableCheaterAltKicks option in the config.
• Community Ban List Integration: Added the ability to fetch and display Community Ban List information for players. This feature can be enabled or disabled using the showCBLInfo config option.
• BattleMetrics Cheater Bans Display: The plugin now shows cheater bans a player has from BattleMetrics. This can be toggled with the showCheaterBans config option.
• BattleMetrics Bans Display: The plugin now shows total bans a player has from BattleMetrics INCLUDING shared bans.

Improvements

• Enhanced Error Handling: Improved error handling to ensure the plugin sends an embed even if there is an error fetching data.
• Refactored Embed Generation: Updated the embed generation logic to ensure all fields are populated correctly, preventing empty field errors.
• Admin Chat Notifications: The plugin now only sends admin chat notifications when a player with cheater bans joins, not when the !altcheck command is run by an admin.

Bug Fixes

• Resolved Unhandled Promise Rejections: Fixed issues causing unhandled promise rejections during API calls.
• Removed Last Banned Field: The "last banned" field has been removed due to inconsistent data retrieval.

Instructions for Configuring the Plugin

1. BattleMetrics API Key: To obtain a BattleMetrics API key:

   • Log in to your BattleMetrics account.
   • Click on your user icon next to the logout button.
   • Navigate to "Account Management".
   • Scroll down to "Personal Access Tokens" and click on "Manage Access Tokens".
   • Create a new token with the ability to view, search, and list bans (refer to the screenshot below).

2. BattleMetrics Server ID:

   • Go to your server's homepage on BattleMetrics.
   • Locate the eight-digit number in the search bar after /squad. This is your server ID.

Configuration Options

{
    "plugin": "AltChecker",
    "enabled": true,
    "discordClient": "discord",
    "commandPrefix": "!altcheck",
    "channelID": "1207476436320124999",
    "kickIfAltDetected": false,
    "onlyKickOnlineAlt": true,
    "kickReason": "ALT detected. Protection kick",
    "battleMetricsApiKey": "YOUR_BATTLEMETRICS_API_KEY",
    "battleMetricsServerId": "YOUR_SERVER_ID",
    "showCBLInfo": true,
    "showCheaterBans": true,
    "enableCheaterAltKicks": true,
    "adminChatChannelID": "ADMIN_CHAT_CHANNEL_ID"
}

Usage

Use the command prefix defined in the configuration to check for alts and ban information. For example:

!altcheck 76561199612537643