GatekeepCLUB-AutoScoreBan icon

AutoScoreBan

Automatically bans players with a score below a configurable threshold when hosting a lobby. Vanilla-compatible and friend-safe.

Last updated 6 hours ago
Total downloads 5
Total rating 0 
Categories Mods AI Generated Vanilla compatible
Dependency string GatekeepCLUB-AutoScoreBan-1.0.1
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

AutoScoreBan

AutoScoreBan is a vanilla-friendly BepInEx mod for STRAFTAT that automatically protects your hosted lobbies from low-score or under-experienced opponents.

When you host a lobby, incoming players have their score automatically queried from the official Steam Leaderboard. If their score is below your configured threshold, they are automatically banned from the lobby and disconnected from the server.


Features

  • Host-Only Protection: Only enforces rules when you are the lobby host. The mod stays completely passive when you join someone else's lobby as a client.
  • Configurable Score Threshold: Set any required score threshold ($N$) via config or in-game mod menus (e.g., ModMenu).
  • Steam Friends Protection: Never bans your Steam friends, regardless of their score.
  • Unranked Filter: Configurable option to treat unranked players (0 leaderboard score) as score 0 and ban them if required.
  • Custom Ban Reason: Disconnected players receive your personalized message (default: "I'm doing this for your own good").
  • In-Game Notifications: Clean notifications in the in-game pause/chat match log whenever a player is banned.
  • Vanilla Matchmaking Friendly: Includes [assembly: StraftatMod(true)] attribute, ensuring you are not placed into an isolated matchmaking pool.
  • LobbyRank Compatible: Operates smoothly alongside mods like LobbyRank.

Configuration

The configuration file is automatically created at: BepInEx/config/com.balu.straftat.autoscoreban.cfg

You can edit it with any text editor, or in-game using configuration managers (like ModMenu).

Option Type Default Description
MinScore int 1000 Minimum score required to join your lobby. Players below this will be banned.
Enabled bool true Enable or disable the auto-ban functionality.
IgnoreFriends bool true When true, your Steam friends are never banned regardless of score.
BanUnranked bool true Treat players without a leaderboard entry as having 0 score (and ban if MinScore > 0).
BanReason string I'm doing this for your own good The message displayed to the player upon being kicked/banned.
NotifyInChat bool true Display an in-game pause/chat log notification when a ban occurs.

Installation

With Mod Manager (Recommended)

  1. Install Thunderstore Mod Manager or r2modman.
  2. Click Install with Mod Manager on this page.

Manual Installation

  1. Ensure BepInExPack is installed.
  2. Download this archive.
  3. Place AutoScoreBan.dll into your STRAFTAT/BepInEx/plugins/ directory.
  4. Launch the game.

Changelog

1.0.1

  • Changed default ban message to "I'm doing this for your own good".
  • Updated config descriptions to English.
  • Refined documentation.

1.0.0

  • Initial release.
  • Steam Leaderboard querying with score threshold enforcement.
  • Host-only safeguard, friend exemption, and custom ban message support.
  • Full vanilla matchmaking compatibility.