Skip to content

Zomboid Players (Pelican panel plugin)

Adds a Players page to Project Zomboid servers on the Pelican panel: who is online now, each player’s total playtime, number of sessions, last session (when and how long), last seen, first seen and deaths, plus a slide-over with a player’s recent sessions. Totals at the top: online now, players seen, playtime in the last 7 days and all time.

Everything comes from the server’s own *_user.txt logs (“fully connected”, “disconnected player” and “died at” lines), read through Wings: the current run’s log every 5 minutes (and on Read logs now), and each finished run in Logs/logs_<date>/ once. The results are kept in the panel’s database, so history survives old logs being deleted. A session that is still open when the server stops is ended at the last line of that run’s log.

The page shows for servers whose egg name contains “zomboid”, to users who may read the server’s files.

Setting Default
ZOMBOID_PLAYERS_EGG_MATCH zomboid text the egg name must contain
ZOMBOID_PLAYERS_LOG_DIR .cache/Logs the game’s log folder, relative to the server files (the egg’s -cachedir)
ZOMBOID_PLAYERS_LOG_TIMEZONE UTC time zone of the times in the logs
ZOMBOID_PLAYERS_EVERY_MINUTES 5 how often the logs are read on their own

Copy zomboid-players/ into the panel’s plugins/ folder and run php artisan p:plugin:install zomboid-players (it creates four tables: zomboid_player_sessions, zomboid_player_deaths, zomboid_players, zomboid_log_files).

php tests/UserLogParserTest.php checks the log parser.