Mods / PlayerList

Category: #Other #QoL
Author: BillyGalbreath
Side: Client
Created: Jul 28th 2023 at 9:05 AM
Last modified: Jun 16th at 9:09 AM
Downloads: 22967
Follow Unfollow 120

Latest file for Various v1.19.x: 1-click install

Shows a player list when you hold down tab (similar to Minecraft).




You can configure the ping thresholds using the config file at "VintagestoryData/ModConfig/playerlist.json"

You can set these for your own client, or your entire server. Server values have a higher priority.




Servers can add their own header and footer to the list. Just open the playerlist.json file and add the strings you want. VTML is supported.

These variables are also supported:

  • ServerName - Displays the server name that's specified in serverconfig.json
  • MaxPlayers - The maximum number of players allowed
  • CurPlayers - The current amount of connected players
  • Month - The in-game month
  • Day - The in-game day
  • Year - The in-game year

An example for most of these variables can be seen on my Pl3x server.

Here is the config for that:

  "thresholds": [ 100, 250, 500 ],
  "header": "<strong>Pl3x - {Month} {Day}, Year {Year}</strong>\n<i>\u2014\u005b {CurPlayers}/{MaxPlayers} \u005d\u2014</i>",
  "footer": "<i>\</i>"



Remember, I build these mods for myself and my family. Not you. I owe you nothing. I just like sharing what I've built with others for free. You will receive minimal to no support when using any of my mods.


Version For Game version Downloads Release date Changelog Download 1-click mod install*
v2.1.2 2078 Jun 16th at 9:09 AM Show Install now
v2.1.1 314 Jun 15th at 5:27 AM Show Install now
v2.1.0 24 Jun 15th at 2:25 AM Show Install now
v2.0.4 574 Jun 12th at 10:31 PM Show Install now
v2.0.3 47 Jun 12th at 8:41 PM Show Install now
v2.0.2 159 Jun 12th at 8:11 PM Show Install now
v2.0.1 27 Jun 12th at 7:57 PM Show Install now
v2.0.0 30 Jun 12th at 7:26 PM Show Install now
v1.8.1 3109 Apr 29th at 5:15 AM Show Install now
v1.8.0 4784 Feb 7th at 4:43 PM Show Install now
v1.7.4 659 Feb 4th at 7:43 PM Show Install now
v1.7.3 621 Jan 30th at 2:47 PM Show Install now
v1.7.2 335 Jan 28th at 1:26 AM Show Install now
v1.7.1 123 Jan 24th at 9:28 PM Show Install now
v1.7.0 60 Jan 24th at 9:10 PM Show Install now
v1.6.0 7227 Sep 14th 2023 at 4:08 PM Show Install now
v1.5.2 535 Sep 7th 2023 at 12:37 AM Show Install now
v1.5.1 862 Aug 10th 2023 at 6:03 AM Show Install now
v1.5.0 117 Aug 10th 2023 at 3:22 AM Show Install now
v1.4.0 221 Aug 6th 2023 at 12:04 PM Show Install now
v1.3.0 207 Aug 3rd 2023 at 1:42 PM Show Install now
v1.2.0 245 Jul 29th 2023 at 11:23 PM Show Install now
v1.1.1 144 Jul 29th 2023 at 3:00 AM Show Install now
v1.1.0 116 Jul 29th 2023 at 2:54 AM Show Install now
v1.0.2 138 Jul 28th 2023 at 9:47 AM Show Install now
v1.0.1 109 Jul 28th 2023 at 9:38 AM Show Install now
v1.0.0 102 Jul 28th 2023 at 9:09 AM Show Install now

28 Comments (oldest first | newest first)

💬 DejFidOFF, Jun 18th at 7:02 AM


Some version after 0.7.4 did not work for me, maybe some crossmod error. But the latest works. Is it possible to setup a bigger gui in config?

💬 BillyGalbreathAuthor, Jun 15th at 2:27 AM

It's working fine for me and everyone else, DejFidOFF

💬 DejFidOFF, Jun 14th at 9:41 PM

2.0.4 Not working. mod cuts end of the names. Still using 0.7.4 because this one only work properly at my server.

💬 BKS_Kit, Jun 8th at 12:55 PM

Hello, I don't understand why this mod doesn't work in my world when I install it. I searched through the commands to find the keys, but they don't appear in the list.

💬 BillyGalbreathAuthor, Jun 2nd at 11:15 AM

This is by design. If you have it installed on the Server then all connecting Clients will be required to download it, too, KxttyKxt

💬 KxttyKxt, Jun 2nd at 1:35 AM

Hey! This mod's selected "Side" is Client, but my friend had to download it to join my world. Just wanted to let you know.

💬 MadGnome, Apr 26th at 9:22 PM

Love the mod, super handy for a server.

I do see the options in the config for a threshold which is nice.  If you are ever looking to do an update, ever consider having a configuration option to switch out the good/avg/bad connection image with the clients actual ping number?  Perhaps color coded along with the same stats for the thresholds.

Either way, thanks for this simple and yet awesome mod!

💬 BillyGalbreathAuthor, Feb 9th at 4:44 PM

Ricodemus It's not a "target", but a "minimum version" - if I bump it to 1.19.0 then the warning goes away in 1.19.x versions of the game, but then 1.18.x clients wont be able to use it anymore. ;)

💬 Ricodemus, Feb 9th at 3:27 PM

Your modinfo.json is still targeting "game": "1.18.8"

💬 BillyGalbreathAuthor, Jan 30th at 2:48 PM

Thank you for the report BarenAD.

I have released a possible fix (if it was caused by this mod, at least) ^_^

💬 BarenAD, Jan 30th at 12:02 PM


hi! I found compatibility issues with the following mods: PlayerList with Status Hud Continued. See youtube video for full demonstration:
In short: in the presence of both mods and when a player is excluded, a crash occurs. But if you open the inventory, there is no problem. This is especially critical when using a the mod FairPlayGuardian because players are excluded for mods, but they crumble and cannot understand the problem.
I do not know what the problem is, so I informed both authors about it :)

💬 DisorderlyF, Jan 28th at 5:08 PM

BillyGalbreath Apologies for the poor wording. We are in agreement about the takeaway. I simply felt the need to point out that the experience on Linux is slightly more complicated as well. I opted for an unofficial packaging of 7zip for Linux, as my usual archival program, XArchiver, was not working. If it does in fact work with Ark or File Roller, I will use those in future. Either way, I'm no longer running into issues as long as I edit directly from the archive as opposed to extracting and recompressing.

💬 BillyGalbreathAuthor, Jan 20th at 1:41 PM

You could have used any archive program of your own preference. I just assume people use windows (it's a safe assumption) so I recommend the best for that platform, which is 7zip. As for linux, the standard Ark or File Roller, etc would suffice.

The takeaway you should have got was to open the archive and edit the file in place, not extract it. ;)

💬 DisorderlyF, Jan 20th at 10:45 AM

Apologies for the delay, some IRL things got in the way of me replying. As far as I can tell, the mod works using the method below. However, it was more trouble than initially expected because as far as I can tell, as the 7Zip devs don't package the app for Linux in any official capacity. However, once I was able to sort that, the method you mentioned worked.

💬 BillyGalbreathAuthor, Jan 9th at 5:34 AM


You don't extract and recompress the zip. Use a tool like 7zip to open the zip and you can edit the file inside there.

If you extract and recompress you have a much higher potential to mess stuff up (like your pastebin shows it's missing the textures for the ping icons).

  1. install 7zip.
  2. right click the zip and choose "7zip -> open archive".
  3. right click the modinfo.json and choose "edit".
  4. make your desired edits.
  5. save and close file.
  6. confirm you want 7zip to update the file in the archive.
  7. close the 7zip program, you're done.
💬 DisorderlyF, Jan 8th at 4:49 AM

Following the instructions to make the mod work without it also installed on the server, then recompressing the extracted contents into a .zip file crashes the game.

The crash log mentions an issue in line 45 of PlayerListHud.cs (also links to what I assume is the project path on your computer)

full crash log here:

NOTE: initially the .zip file didn't work, log claimed there was no modinfo.json file. This issue was resolved by renaming the .zip file to match the name before it was extracted.

EDIT: I've also confirmed that downgrading to version 1.5.2 does not resolve the issue

💬 BillyGalbreathAuthor, Jan 2nd at 5:24 PM


Please read the description fully. I explain how to get it to work with no server side requirement.

💬 Arimil, Dec 30th 2023 at 9:53 AM

I think this should be listed as a server mod, since from my testing this does not function unless installed on the server.

💬 Kaofan, Sep 30th 2023 at 9:42 AM


I recommend adding player icons, player ping (e.g. 30 ms) to this mod and making the table background transparent (Tab)

💬 Ruyeex, Sep 23rd 2023 at 1:50 PM

Can you add the image of players.

Also roles as well?

💬 Kaofan, Sep 14th 2023 at 2:30 PM



"keybind-description": "Przytrzymaj, aby wyświetlić listę graczy"

💬 Elocrypt, Aug 9th 2023 at 4:00 AM


Works wonders! (Meant to send this a while ago)
Thank you for the fix!

💬 BillyGalbreathAuthor, Aug 6th 2023 at 12:07 PM


so sorry about that. I had not properly tested it on client side only installs. I fixed the issue in 1.4.0 by properly overriding all the keyboard/mouse input methods for the HUD so I could properly ignore them and not grab them.

Thank you for the report, I would have never known otherwise ^_^

💬 Elocrypt, Aug 5th 2023 at 9:38 PM


I installed this mod, edited the modinfo.json to be client sided and tested on a server. The mod worked, I pressed TAB and the playerlist came up and worked just fine. Although, I had an issue where I was unable to interact with anything (Opening closing doors, swinging a weapon, picking things up, opening chests, etc,), all I was able to do was move my character around, use chat, look around, move things in my inventory and throw things out of my inventory with Q.

Changing the keybind did not solve the issue. The mod is not on the server itself, only my client. 

After disabling the mod I was able to interact with things again.

💬 DanaCraluminum, Jul 29th 2023 at 8:42 PM


change this

CairoFont font = new() {
    Color = (double[])GuiStyle.DialogDefaultTextColor.Clone(),
    Fontname = GuiStyle.StandardFontName,
    UnscaledFontsize = GuiStyle.SmallFontSize,
    Orientation = EnumTextOrientation.Left

to this

if (player.Entitlements?.Count > 0 && GlobalConstants.playerColorByEntitlement.TryGetValue(player.Entitlements[0].Code, out var color))
    font = new()
        Color = color,
        Fontname = GuiStyle.StandardFontName,
        UnscaledFontsize = GuiStyle.SmallFontSize,
        Orientation = EnumTextOrientation.Left
    font = new()
        Color = (double[])GuiStyle.DialogDefaultTextColor.Clone(),
        Fontname = GuiStyle.StandardFontName,
        UnscaledFontsize = GuiStyle.SmallFontSize,
        Orientation = EnumTextOrientation.Left
💬 BillyGalbreathAuthor, Jul 29th 2023 at 8:29 PM

DanaCraluminum I highly doubt it, unless the game has the vhtml for that in the IPlayer.PlayerName field automagically.

💬 DanaCraluminum, Jul 29th 2023 at 8:18 PM

Does it show colors? E.g. if player name is Yelow (Supporter) or Green (VS Team)

💬 Rythillian, Jul 29th 2023 at 10:10 AM

simple and highly needed, great mod!

(edit comment delete)