AntsLab PlayersTab

A tiny, zero‑HUD scoreboard that shows all players grouped by team when you hold TAB. Clean, lightweight, and configurable.

Built for BepInEx 5.x · IMGUI · C# 7.3

✨ What it does

• Hold TAB to open a list of players.

• Players are grouped by team and sorted alphabetically within each group.

  • Sorcerers (team 0)
  • Warlocks (team 2)
  • Others (any other team value)

• Headers are color‑coded; text uses the game’s menu font when available.

📦 Installation (Thunderstore)

Option A — Recommended (r2modman / Gale / Thunderstore Mod Manager)

1. Open r2modman, Gale or Thunderstore Mod Manager.
2. Select your game profile.
3. Search for “AntsLab PlayersTab”.
4. Click Install.
5. Click Start modded to launch the game.

These managers automatically pull the correct BepInExPack for your game.

Option B — Manual install

1. Install BepInEx 5.x for your game (usually via the game’s BepInExPack on Thunderstore).

2. Download the mod’s .zip from Thunderstore and extract it.

3. Place AntsLab.PlayersTab.dll into your game folder under:

   <GameFolder>/BepInEx/plugins/AntsLab.PlayersTab/
   

4. Run the game once to generate the config file.

Uninstall

Delete the folder BepInEx/plugins/AntsLab.PlayersTab/ (and the config at BepInEx/config/antslab.playerstab.cfg if you want a clean slate).

🕹️ How to use

• Press and hold TAB → the panel appears.
• Release TAB → it hides.
• Names are sorted A→Z within each team.
• If a player has no readable name (common during lobby phase), it won't count to generate the list, but if you want it to work, you can change the config (see ShowNamelessPlayers).

⚙️ Configuration

All options are in BepInEx/config/antslab.playerstab.cfg (created after first run).

🧩 Compatibility & limitations

• Unity version: The scan uses the Unity 2022+ API (FindObjectsByType). On older Unity versions, the list may appear empty.
• Field names: If your game changes internal field names (playerMovement, playerTeam, playername), the mod may fail to detect players or teams.

🔧 Troubleshooting

The panel doesn’t show up

• Make sure you’re holding TAB.
• If you’re in a lobby and names aren’t available, set ShowNamelessPlayers = true.
• Check BepInEx/LogOutput.log — you should see: AntsLab PlayersTab 1.0.0 loaded.
• Verify your Unity version is 2022+ and the game actually has a PlayerMovement component with playername/playerTeam fields.

Names are cut off

• Increase RowHeight and/or PanelWidth.
• Or Decrease FontSize.

Header labels look odd

• Disable UseMenuFont to fall back to the default IMGUI font.

🏗️ Building from source

• Target BepInEx 5.x (game’s Mono profile) and C# 7.3.

• Reference assemblies:

  • BepInEx.dll
  • UnityEngine.dll (+ IMGUI)
  • HarmonyLib.dll

• Plugin attributes:

  • BepInPlugin("antslab.playerstab", "AntsLab PlayersTab", "1.0.0")

The project is a standard BepInEx plugin. Drop the built DLL into BepInEx/plugins/AntsLab.PlayersTab/.

📜 Changelog

1.0.0

• Initial release. Team‑grouped, alphabetized player list on TAB. Configurable KeyBind, position, width, font size, row height, refresh cadence, and nameless behavior.

🙌 Credits & license

• Author: Ant_Redstone
• Thanks: BepInEx team & community.
• License: See package on Thunderstore (or repository) for current licensing terms.

❓ FAQ

Does this reveal hidden players? No. It only reads the online player names and list them.

Is this a cheat? It’s just a visual list. Respect server rules and your game’s modding policy.

Can I change team names or colors? Not via config in this version. They’re mapped as 0 → Sorcerers, 2 → Warlocks, and Others. You can fork the source to customize.