Installation

Installation

Requirements

• Paper 1.21.x (1.21, 1.21.1, 1.21.4, 1.21.8 — any Paper build for 1.21)
• Java 21 or newer
• No additional dependencies

Step-by-step

1. Download TabPlayerHider_1.0_1.21.jar from the Releases page
2. Copy the JAR into your server's plugins/ folder
3. Start (or restart) the server — the plugin generates plugins/TabPlayerHider/config.yml automatically
4. Edit config.yml and add your bot names under hidden-players
5. Run /tph reload in-game (or restart again) — bots disappear from the tab list immediately

First Use

Open plugins/TabPlayerHider/config.yml:

enabled: true
hidden-players:
  - "BotName1"
  - "BotName2"

Replace BotName1 / BotName2 with the exact in-game names (case-sensitive) of the players you want hidden.

Alternatively, without touching the file, you can use commands:

/tph hide BotName1
/tph hide BotName2

Updating

1. Stop the server
2. Delete (or replace) the old JAR in plugins/
3. Drop the new JAR in plugins/
4. Start the server — your config.yml is preserved automatically

Uninstalling

1. Stop the server
2. Delete plugins/TabPlayerHider_*.jar
3. Optionally delete plugins/TabPlayerHider/ (config folder)
4. Start the server

No database or extra files are created.