Repository navigation
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
enableCheaterAltKicksoption 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
showCBLInfoconfig option. - BattleMetrics Cheater Bans Display: The plugin now shows cheater bans a player has from BattleMetrics. This can be toggled with the
showCheaterBansconfig 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
!altcheckcommand 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
-
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).
-
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