The AltChecker plugin, originally developed by JetDave, has been revamped into a Discord and game server integration tool. This refactored version was created to detect alternate accounts, identify cheater bans, and efficiently managing player interactions. By integrating BattleMetrics and the Community Ban List, the updated plugin offers better alt-checking capabilities, ensuring a more secure and well-regulated environment.
- Check for alternate accounts based on IP addresses.
- Fetch and display ban information from BattleMetrics.
- Fetch and display reputation and ban information from the Community Ban List.
- Configurable options for displaying Community Ban List information and cheater bans.
- Automatically kick cheaters or their alts and notify admins.
- Node.js installed on your server.
- A Discord bot token.
- BattleMetrics API key.
- Community Ban List access.
{
"plugin": "AltChecker",
"enabled": true,
"discordClient": "discord",
"commandPrefix": "!altcheck",
"channelID": "your_discord_channel_id",
"kickIfAltDetected": false,
"onlyKickOnlineAlt": true,
"kickReason": "ALT detected. Protection kick",
"battleMetricsApiKey": "your_battlemetrics_api_key",
"battleMetricsServerId": "your_battlemetrics_server_id",
"showCBLInfo": true,
"showCheaterBans": true,
"enableCheaterAltKicks": true,
"roleID": "",
"rolePingForCheaterAlt": true,
"enableDoubleAltPings": true,
"adminChatChannelID": "your_admin_chat_channel_id"
}To get a BattleMetrics API key:
-
Sign in to your BattleMetrics account.
-
Click on the user icon next to the logout button.
-
Select "Account Management" on the right side.
-
Scroll to the bottom of the page to the "Personal Access Tokens" section.
-
Click on "Manage Access Tokens".
-
Create a new token and give it a name.
-
Ensure the token has the view, search and list bans permission.
-
Copy the generated token and use it in your
config.json.
To find your BattleMetrics server ID:
- Log in to your BattleMetrics account.
- Go to your servers homepage.
- In the servers tab under Squad, locate the eight-digit number in the search bar after
/squad. This is your server ID for BattleMetrics.
Use the command prefix defined in the configuration to check for alts and ban information. For example:
!altcheck 76561198000000000
THIS COMMAND MUST BE RAN IN THE CHANNEL DEFINED IN THE CONFIG channelID IT WILL NOT RUN ANYWHERE ELSE.
This project is licensed under the GNU General Public License - see the LICENSE file for details.
Contributions are welcome! Please submit a pull request or open an issue to discuss any changes.