Description

ZKMod is a Project Zomboid Steam Workshop Mod to collect and save player and world statistics on the server in CSV files.

Mod page on Steam: https://steamcommunity.com/sharedfiles/filedetails/?id=2733284288

Workshop ID: 2733284288 / Mod ID: ZKMod

Configuration

You may configure or turn features off in <servername>_SandboxVars.lua. If you don't configure anything default values are used.

Example configuration:

SandboxVars = {
    [...]
    ZKMod = {
        ServerSaveWorldEvery = 1,
        ServerSaveWorldHistoryEvery = 2,
        ServerSaveOnlinePlayersEvery = 1,
        ServerSaveSafehousesEvery = 3,
        ServerSaveFactionsEvery = 3,
        ClientSendPlayerDataAliveEvery = 2,
        ClientSendPlayerDataDeath = 1,
        ClientSendEventLevelPerk = 1,
        ClientSendPlayerPerksDataEvery = 3,
        ClientSendPlayerInventoryDataEvery = 3,
        ServerTimeOffsetMinutes = 120
    },
}

Support

Here's my Ko-fi: https://ko-fi.com/ikeserver Thanks in advance!

Changelog

ZKMod 2.2 (2026-08-05)

• Fixed Steam IDs being corrupted by reading the Java long value as a Lua number; the string-returning username lookup is now used

ZKMod 2.1 (2026-08-01)

• Build 42 CSV output now tries the normal .csv path first and falls back to an additional .txt extension, such as world.csv.txt, when needed

ZKMod 2.0.3 (2025-12-21)

• Fixed structure for Build 41

ZKMod 2.0.0 (2025-12-13)

• Build 42 Multiplayer support

ZKMod 1.4.1 (2022-11-24)

• Feature: player inventory saved once after connecting in addition to the periodic saving
• Fix: Weapon parts/magazines not saved correctly

ZKMod 1.4 (2022-11-24)

• Feature: player inventory saved to playerinventory_(name).csv if ClientSendPlayerInventoryDataEvery is set

ZKMod 1.3.1 (2022-10-20)

• Fix: String values containing " or ; were not escaped properly, possibly causing invalid CSV lines

ZKMod 1.3 (2022-02-22)

• Feature: player perks saved to playerperks_(name).csv if ClientSendEventLevelPerk and/or ClientSendPlayerPerksDataEvery is set
• Feature: player_(name).csv: added injured, health, wetness, boredom, infectionLevel, fakeInfectionLevel

ZKMod 1.2.1 (2022-02-08)

• Fix: worldData save not triggered
• Fix: Player safehouse data not saved correctly

ZKMod 1.2 (2022-02-08)

• Feature: safehouses.csv: safehouse info
• Feature: factions.csv: faction info
• Feature: player_(name).csv: added faction info, safehouse info, favorite weapon name and hits
• all features can be configured or turned off in sandbox settings

ZKMod 1.1 (2022-02-02)

• Feature: world(_history).csv: added extended weather data
• Feature: player_(name).csv: added isFemale
• Feature: events_history.csv: Saving player perk level ups (multiline)
• Feature: players_online.csv: Players currently online (single line)

ZKMod 1.0.1 (2022-01-28)

• Fix: worldData.worldAgeDays incorrect
• new preview image

ZKMod 1.0 (2022-01-27)

• collects player and game world statistics
• saves collected data to CSV files on the server