BanList

Player Ban Mod (Mage Arena)

A BepInEx plugin for managing and banning players in Mage Arena. Provides an in-game UI to view active players, manage bans, and optional automatic moderation.

Features

• UI (F2 key): Active Players and Banned Players tabs
  • Active: view/kick/ban players currently in lobby
  • Banned: paged list with live search and unban actions. Sorted by most recent ban, has support for thousands of stored bans.
• Auto-ban (optional):
  • Modded rank detection
  • Offensive name detection (configurable keywords - by default: "discord.gg", "cheat")
  • Modded name detection (colored, bold, italic, etc)
• Recent Players: Displays 10 recent players in the UI, and stores up to a hundred in JSON.
• Allows kicking/banning in-game, and in lobby.
• Large ban list handling (async load, pages, chunking)
• Persistent storage in JSONL file

Installation

1. Install BepInEx for Mage Arena.
2. Copy BanList.dll to Mage Arena/BepInEx/plugins/.
3. Launch the game; the plugin loads automatically.

Usage

• Press F2 to toggle the UI.
• Active Players tab: Kick or Ban players in the lobby or in-game.
• Banned Players tab: Search by name or SteamID; use Prev/Next to paginate; Unban entries.

Configuration

File: BepInEx/config/com.playerban.mod.cfg

• Section BannedPlayers
  • BannedSteamIds: moved to BanList/Bans/banned_players.jsonl - do not use config area for importing bans
• Section Settings
  • AutobanModdedRanks (bool): auto-ban players with custom/modded rank strings (you can change this in the F2 menu)
  • AutobanOffensiveNames (bool): auto-ban names containing configured tokens (you can change this in the F2 menu)
  • OffensiveNames (string): comma-separated keywords (e.g., discord.gg,cheat)
  • UIToggleKey (KeyCode): key used to toggle the UI (default F2)

File: BepInEx/plugins/BanList/Bans/banned_players.jsonl

• Add or remove bans manually from here, or share ban lists.

File: Bepinex/plugins/Banlist/RecentPlayers/recent_players.jsonl

• View up to 100 recent players.

Notes:

• Auto-ban checks run while not in-game (menus/lobby). They pause during a match.
• Offensive name matching ignores case and spaces.

Troubleshooting

• UI not opening: ensure you’re host and in a lobby; press F2. If it doesnt open on the first try, wait a moment, and try again.
• Auto-ban not triggering: confirm toggles enabled; ensure not in-game; check logs for [AutoBan] lines.
• Kick fails: Check logs, and report bug in Modding Discord.

Notes on Modded Title and Colored Names

• Lobby rank strings are displayed verbatim by the game; any string not containing a canonical rank (Lackey, Sputterer, Novice, Apprentice, Savant, Master, Grand Master, Archmagus, Magus Prime, Supreme Archmagus) is considered “modded.”