SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

Bookkeeper

by Feyd · for Vintage Story

Know what you have. Know where it is.

16KDownloads
1.21.6Latest game version
Vintage Story ModDBSource

About Bookkeeper

From Vintage Story ModDB

Know what you have. Know where it is.

Bookkeeper


Know what you have. Know where it is.

Bookkeeper adds a craftable lectern that becomes a complete read-only index of every
container, tool rack, display case, and shelf around your base. Open the ledger to
browse, search, and filter your entire stockpile by category — then locate exactly
which containers hold what you need, all from one place. No more digging through rows
of chests just to find out where something is.

 

Read-only by design. Bookkeeper only "reads" your storage — it never withdraws,
deposits, moves, merges, or deletes anything. Nothing in your containers is ever
modified. (Want to move items remotely as well? That lives in the companion mod
Quartermaster — Bookkeeper is the pure look-but-don't-touch locator.)

 

How It Works
1. Craft a Bookkeeper's Lectern (see recipe below)
2. Place it anywhere — no foundation or special flooring required
3. Look at the lectern and press K, or right-click it, to open the ledger
4. Browse, search, or filter by category — all items in nearby containers are shown in a paginated grid
5. Locate an item to find which containers hold it — without ever opening a chest

Locating Items
Middle-click any item to close the ledger and highlight the containers holding it, with
blue markers, floating text labels visible through walls, and temporary map waypoints.
Right-click a highlighted block to dismiss it individually; markers, labels, and
waypoints for a container also clear automatically as you open it.

 

Crafting the Lectern

<table style="border-collapse: collapse; width: 19.4476%;" border="1"> <tbody> <tr> <td style="width: 1.05263%; text-align: center;">Chisel</td> <td style="width: 1.05263%; text-align: center;">Parchment</td> <td style="width: 1.13122%; text-align: center;">Charcoal</td> </tr> <tr> <td style="width: 1.05263%; text-align: center;">&nbsp;</td> <td style="width: 1.05263%; text-align: center;">Plank</td> <td style="width: 1.13122%; text-align: center;">&nbsp;</td> </tr> <tr> <td style="width: 1.05263%; text-align: center;">&nbsp;</td> <td style="width: 1.05263%; text-align: center;">Plank</td> <td style="width: 1.13122%; text-align: center;">&nbsp;</td> </tr> </tbody> </table>

&nbsp;

- Chisel &mdash; any chisel (top-left); used as a tool, so it isn't consumed
- Paper (parchment) &mdash; 1 (top-middle)
- Charcoal &mdash; 1 piece (top-right)
- Planks &mdash; 2 plank blocks, any wood type (center column row 2 &amp; 3)

&nbsp;

Features
- Search bar &mdash; filter items by name in real time
- Category filters &mdash; toggle any combination of Food, Tools, Fuel, Wood, Wearables, Ores &amp; Metals, and Building to narrow the grid; with none selected, everything
- Paginated display &mdash; 90 items per page (10 columns &times; 9 rows) with Prev/Next navigation
- Item consolidation &mdash; identical items across multiple containers are combine single entry showing the total count (decorative chest/clutter variants are kept distinct, shown by their real name and icon)
- Location highlighting &mdash; middle-clicking an item highlights up to 20 container locations with blue overlay markers
- Floating text labels &mdash; item name labels (e.g., "Iron shovel") appear above highlighted containers, visible through walls, so you can find items without li
- Distance fade &mdash; labels fade out gradually between 20&ndash;40 blocks
- Marker removal &mdash; right-click any highlighted block to dismiss it individual markers, labels, and waypoints for a container also clear automatically as you open it
- Tool rack and display scanning &mdash; items on tool racks, display cases, and sh are catalogued alongside chest and vessel contents
- Place it anywhere &mdash; the lectern has no foundation requirement and works on surface

&nbsp;

Configuration
The mod generates a configuration file automatically on first launch. To customize scan range, edit the file at:

- Linux: ~/.config/VintagestoryData/ModConfig/BookkeeperConfig.json
- macOS: ~/Library/Application Support/VintagestoryData/ModConfig/Bookkeeper<br />- Windows: %AppData%/VintagestoryData/ModConfig/BookkeeperConfig.json</p> <p>Default settings:</p> <p>``json
{
"ChunkRadius": 2,
"VerticalRange": 5,
"HonorClaims": true
}

- ChunkRadius &mdash; how many chunks around the player to scan horizontally (default 2). Each chunk is 32 blocks, so a value of 2 scans a 5&times;5 chunk area (~160&times;160 blocks).
- VerticalRange &mdash; how many blocks above and below the player to scan (default&nbsp;5).
- HonorClaims &mdash; when true, containers inside a land claim you don't have permission to use are hidden from the ledger. Owners/granted players and unclaimed land are unaffected. Set to false to ignore claims entirely.

Edit the values, save the file, and restart the world for changes to take effect.

Scan Range

By default, the lectern scans containers within a 2-chunk horizontal radius (~160 blocks
across) and &plusmn;5 blocks vertically from your position. This covers a typical base footprint while keeping performance snappy. Both values are configurable &mdash; see Configuration above.

&nbsp;

What Gets Scanned

Standard storage block entities within range, including:

- Chests
- Vessels
- Crates
- Labeled chests
- Barrels (items inside, not liquids)
- Tool racks
- Display cases
- Shelves
- Most modded containers that follow the standard VS container interface

Highlights

From source data

Game versions

Supports 2 Vintage Story versions, the newest being 1.21.6.

Footprint

Rated a light load on a server.

Bookkeeper on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Bookkeeper on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Utility”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Runs on your server

From source side support

Vintage Story ModDB lists Bookkeeper as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.21.6 and 1 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24
  • ✓AuthorFeyd, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Bookkeeper, answered

Generated from the mod’s own source data.

Do my players need to install Bookkeeper?

Vintage Story ModDB lists Bookkeeper as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Bookkeeper is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Bookkeeper on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Bookkeeper in one click.