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.
Settings (panel .env)
Section titled “Settings (panel .env)”| 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 |
Install
Section titled “Install”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.
Made by Shotty Games. Not an official Minecraft product; not approved by or associated with Mojang or Microsoft.