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

• Install BepInEx for Mage Arena.
• Copy BanList.dll to Mage Arena/BepInEx/plugins.
• 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.”