PlayersTab

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 ()

Option A — Recommended (r2modman / Gale Mod Manager)

• Open r2modman, Gale or Mod Manager.
• Select your game profile.
• Search for “AntsLab PlayersTab”.
• Click Install.
• Click Start modded to launch the game.

These managers automatically pull the correct BepInExPack for your game.

Option B — Manual install

• Install BepInEx 5.x for your game (usually via the game’s BepInExPack).
• Download the mod’s.zip and extract it.
• Place AntsLab.PlayersTab.dll into your game folder under:

/BepInEx/plugins/AntsLab.PlayersTab/

• 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 (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.