Back to mods
Simple Player List project artwork

Modrinth · Minecraft mod

Simple Player List

Introduces the ability to customize server's player list

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Simple Player List release should I use?

Updated last month
Latest stable file 2.1.0+26.3
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

Simple Player List 2.1.0+26.3 targets 26.1, 26.1.1, 26.1.2 with Fabric. Do not install it on the client. It must be installed on the dedicated server. All 2 required mods have matching files.

Where it goes

Is Simple Player List required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked server-only.

What else does Simple Player List 2.1.0+26.3 need?

2.1.0+26.3. Change the file and its required mods may change too.

All 2 required mods have matching files

Install Fabric API, Text Placeholder API first. We found matching files for this game-version and loader setup.

Fabric API Needed by Simple Player List 2.1.0+26.3
required
Matching file found Matched file: 0.166.2+26.3
Text Placeholder API Needed by Simple Player List 2.1.0+26.3
required
Matching file found Matched file: 3.2.0+26.3

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Simple Player List without breaking your instance.

Built for Simple Player List 2.1.0+26.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 2.1.0+26.3. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API, Text Placeholder API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 2.1.0+26.3. It opens that exact file at the source.

About this project

What does Simple Player List add?

Simple Player List

Simple Player List is a Minecraft mod which introduces the ability to customize server's player list (Tab list) using
Placeholder API.
It supports colored text as well as server and player information.

Configuration

Upon loading the mod for the first time, a default configuration file will be generated at
config/simpleplayerlist.json:

{
  "header": [
    "<bold>Default Config</bold>",
    2.0,
    "<gray>To change this, edit",
    "config/simpleplayerlist.json</gray>",
    2.0,
    "<aqua><st>                                        </st></aqua>"
  ],
  "footer": [
    "<aqua><st>                                        </st></aqua>",
    2.0,
    "<gray>TPS: %server:tps_colored_alt%<dark_gray>/</dark_gray>%server:mspt_colored_alt% <dark_gray>-</dark_gray> Ping: %player:ping_colored_alt%</gray>"
  ],
  "tick_update_interval": 20
}

Each entry in the header and footer arrays can be either a text line or a number. Number how many blank lines to
insert.

This file uses Placeholder API's formatting system. Refer to:

This mod also adds three new alternatives to the default placeholders: %server:tps_colored_alt%,
%server:mspt_colored_alt% and %player:ping_colored_alt%.
These variants provide improved color logic and presentation, and their colors can be changed with the good,
moderate, bad and critical arguments (e.g. %server:tps_colored_alt good:aqua critical:#ff0000%).

Commands

To apply changes made to the configuration file, use the in-game command /simpleplayerlist reload.
Players can run /simpleplayerlist to toggle the mod on their end.

Dependencies

Project description from Modrinth.

Pick your setup

Simple Player List by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

10 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Simple Player List versions and loaders

6 of 6 releases match

Looking for an older file? The official Modrinth project page is in Resources.