Back to mods

Vintage Story Mod DB · Vintage Story mod

VS Server Stats

VSServerStats is a lightweight server-side mod that tracks player statistics and exposes them via a built-in HTTP API on port of your choosing. Still heavily WIP, but it works! Tracked stats: • Deaths and player kills • Total playtime • Distance walked •

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

Quick answer

Which VS Server Stats release should I use?

Updated 6 months ago
Latest stable file 0.0.4
Game version 1.19.0, 1.19.1, 1.19.2
Loader Built-in Vintage Story mod system

VS Server Stats 0.0.4 targets 1.19.0, 1.19.1, 1.19.2. Do not install it on the client. It must be installed on the dedicated server. No extra mods listed for this file.

Where it goes

Is VS Server Stats 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 Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked server-only.

What else does VS Server Stats 0.0.4 need?

0.0.4. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add VS Server Stats without breaking your instance.

Built for VS Server Stats 0.0.4. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.0.4. It targets 1.19.0, 1.19.1, 1.19.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  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 0.0.4. It opens that exact file at the source.

About this project

What does VS Server Stats add?

VSServerStats is a lightweight server-side mod that tracks player statistics and exposes them via a built-in HTTP API on port of your choosing. Still heavily WIP, but it works!

Tracked stats:

  • Deaths and player kills
  • Total playtime
  • Distance walked
  • First/last seen dates
  • Player appearance (skin, hair, eye color, character class)

Endpoints:

  • GET /stats — server info, online players, all player stats
  • GET /appearance — player appearance/skin configuration

Stats are saved to ModData/vsserverstats.json and persist across restarts. Designed to be consumed by custom web dashboards or external tools.

Plans for the future

  • Add armor visibility that is currently equiped, command a player can run like /savefit so it stays
  • Maybe add statistics page to the game itself, so its visible without webpage interface

Project description from Vintage Story Mod DB.

Pick your setup

VS Server Stats releases for each Vintage Story version.

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

81 available setups

Showing the newest 12 of 81 game versions. Older files are in the list below.

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

Recent files

VS Server Stats versions and loaders

2 of 2 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.