Advanced In-Game Admin and Ban Enforcer for Procon v2

Full Documentation (Wiki) • Procon v1 (legacy branch)

AdKats is a comprehensive admin toolset with over 100 in-game commands and extensive customization options. It focuses on making in-game admins more efficient and accurate, with flexibility for almost any server setup.

Designed for groups with high-traffic servers and many admins, but works just as well for small servers.

Supported Games: BF3, BF4, BF Hardline, BFBC2

• 100+ In-Game Commands — Kill, kick, ban, punish, move, whitelist, message, and more. Accessible from in-game chat, Procon's chat window, the database, or other plugins.
• Role-Based Access Control — Custom user roles with granular command permissions. Roles sync automatically across servers.
• Cross-Server Ban Enforcer — Multi-metric enforcement by GUID, IP, and name. Bans are checked on player join across all connected servers.
• Infraction Tracking — Escalating punishments based on player history. All players treated equally regardless of who issues the punishment.
• Player Reputation System — Numeric reputation scoring based on commands issued from and against players.
• AntiCheat — Stats-based cheat detection using Battlelog and EZScale data. Automatic detection and banning for damage mods, aimbots, and magic bullet.
• Setting Sync — Database-driven settings replicated across all Procon layers. Change once, apply everywhere.
• Report & Admin Call System — With email and PushBullet notifications.
• VPN/Proxy Detection — External API checks with schedule-based enforcement.
• Ping Enforcer — Automated kick for high-latency players.
• AFK Manager — Automatic kick for idle players.
• SpamBot — Customizable timed message broadcasting.
• Surrender Vote System — Player-initiated round surrender voting.
• Cross-Server Messaging — Player-to-player communication across servers.
• TeamSpeak & Discord Integration — Perks and monitoring via VOIP platforms.
• Challenge System — Round-based competitive challenges.
• On-Spawn Loadout Enforcer — BF4 infantry and vehicle loadout enforcement via AdKatsLRT.

Full documentation is available on the AdKats Wiki, including:

• Commands Reference — all 100+ in-game commands
• Settings Guide — complete configuration reference
• AntiCheat System — cheat detection setup
• Ban Enforcer — cross-server ban management
• Infraction System — punishment tracking
• External Commands API — integrating with AdKats from other plugins

• Procon v2
• MySQL Database — Used for cross-server settings, ban enforcement, player tracking, and all persistent data.
• CChatGUIDStatsLogger (XpKiller's Stats Logger) — Required for player stats tracking and database logging. Not yet refactored for v9.

1. Download the latest release from the Releases page.
2. Place the .cs plugin files in your Procon v2 plugins directory.
3. Set up a MySQL database and import src/adkats.sql for the initial schema.
4. Enable the plugin in Procon and configure your database connection in the plugin settings.
5. Follow the in-game setup prompts to complete initial configuration.

src/
  AdKats.cs              # Main plugin entry point
  AdKats/                # Modular components (partial classes)
    Actions.cs           # Kill processing and action execution
    AntiCheat.cs         # Stats-based cheat detection
    BanEnforcer.cs       # Cross-server ban enforcement
    Challenges.cs        # Round-based challenge system
    Commands.cs          # Command parsing and execution
    Database.cs          # Database communication (Dapper ORM)
    Events.cs            # Procon event handlers
    External.cs          # VPN/proxy detection
    EZScale.cs           # EZScale API integration
    Integrations.cs      # Email, PushBullet, Discord, TeamSpeak
    Messaging.cs         # Chat message parsing and player messaging
    Models.cs            # Data model classes
    Players.cs           # Player state tracking
    Settings.cs          # Plugin settings and configuration
    Threading.cs         # Thread management and synchronization
    Utilities.cs         # Helper functions
  lib/                   # Game data files (loadouts, weapon codes)
  adkats.sql             # Database schema
  *.json                 # Weapon stats, reputation data, update manifests

• .NET 8 SDK (for formatting and style checks)
• Procon v2 (for runtime testing)

The project uses dotnet format with an .editorconfig for style enforcement. CI runs these checks automatically on pushes to master and on pull requests.

# Check for style violations
dotnet format --verify-no-changes

# Auto-fix style violations
dotnet format

Releases are automated via GitHub Actions. To create a release:

1. Tag the commit with a version tag: git tag v9.0.0
2. Push the tag: git push origin v9.0.0
3. GitHub Actions will package the source files and create a release automatically.

• AdKats Forum Thread — Discussion and support on myrcon.net
• AdKatsLRT Extension — On-spawn loadout enforcer for BF4

AdKats was originally created by Daniel J. Gradinjan (ColColonCleaner) for A Different Kind (ADK) on April 20, 2013. Version 8.0+ was maintained by Hedius. Version 9.0 is a rewrite for Procon v2.

For the full legacy changelog (v0.0.1 through v7.6.0.10), see the legacy branch.

GNU General Public License v3