Mods / Bookkeeper

Tags:
Utility
Author:
Feyd
Side:
Both
Created:
5 days ago
Last modified:
3 days ago
Downloads:
686
Follow Unfollow 92
Recommended download (for Vintage Story 1.21.6):
ManifestMod_v1.1.0.zip  1-click install

Bookkeeper

 

Know what you have. Know where it is.

Bookkeeper adds a craftable lectern that lets you browse every item stored in nearby containers — chests, vessels, crates, and more. Open the manifest, search for what you need, and click an item to highlight exactly which containers hold it.

No more opening 30 chests looking for that one copper ingot.


How It Works

 

  1. Craft a Bookkeeper's Lectern (see recipe below)
  2. Place it on a proper foundation — planks, bricks, stone, cobblestone, tile, or any other crafted flooring
  3. Look at the lectern and press K to open the Storage Manifest
  4. OR right-click the lectern to open the Manifest window.
  5. Browse or search — all items in nearby containers are displayed in a paginated grid
  6. Click any item to close the manifest and highlight the containers holding that item with blue markers in the world
  7. Right-click a highlighted block to dismiss individual markers

Crafting the Lectern

 

Crafted on a 3x3 grid:

[Chisel] [Parchment] [Charcoal]
[      ] [  Planks  ] [        ]
[      ] [  Planks  ] [        ]

 

  • Chisel — any metal type (used as a tool, not consumed)
  • Parchment — 1 piece
  • Charcoal — 1 piece
  • Planks — 2 plank blocks (any wood type)

Features

 

  • Search bar — filter items by name in real time
  • Paginated display — 90 items per page (10 columns × 9 rows) with page navigation
  • Item consolidation — identical items across multiple containers are combined into a single entry showing total count
  • Location highlighting — clicking an item highlights up to 20 container locations with blue overlay markers
  • Marker removal — right-click any highlighted block to dismiss it individually
  • Foundation requirement — the lectern must be placed on crafted flooring (planks, bricks, worked stone, tile, etc.) to function, reinforcing the idea of a proper bookkeeper's workspace

Scan Range

 

The lectern scans containers within a 2-chunk horizontal radius (~64 blocks) and ±5 blocks vertically from your position. This covers a typical base footprint while keeping performance snappy.


What Gets Scanned

 

Any block entity that implements IBlockEntityContainer with a valid inventory, including:

  • Chests
  • Vessels
  • Crates
  • Labeled chests
  • Barrels (items inside, not liquids)
  • Any modded containers that follow the standard VS container interface

Not scanned: Player inventory, items on the ground, or items in your hands. A good example would be vessels. They will not show up unless contained within another container.


Limitations

 

  • Vertical range is limited — the scan covers ±5 blocks from your Y position, so items stored far above or below you (deep basements, tall towers) may not appear. Move closer vertically if needed.
  • Container blocks themselves don't appear — the manifest shows what's inside containers, not the containers as entries. A chest full of items will show those items; an empty chest won't appear at all.
  • Maximum 20 locations per item — if an item type exists in more than 20 containers, only the first 20 locations are tracked for highlighting.
  • Single player / server compatible — works in both singleplayer and multiplayer. Each player sees their own manifest based on their position. NOTE: this mod has not been tested in a multiplayer game.

Hotkey

 

K — Open/close the Storage Manifest (rebindable in Controls settings under "Open Storage Manifest") Note: you must be standing in front of the lectern for the mod to function.


Installation

 

  1. Drop the mod zip into your VintagestoryData/Mods folder
  2. Restart the game
  3. Craft the lectern and place it on a proper foundation

Version History

 

v1.0.0 — Initial release

  • Bookkeeper's Lectern with search, pagination, and container highlighting
  • Foundation requirement for immersive placement
  • Copper-trimmed oak lectern with open book model

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.1.0 manifest 382 3 days ago ManifestMod_v1.1.0.zip 1-click install

Added the ability to right-click the lectern in order to open the manifest window.

1.0.0 manifest 304 5 days ago Empty ManifestMod.zip 1-click install

23 Comments (oldest first | newest first)

Punizher19, 14 hours ago

Feyd id like to tell you there might be a problem my game crashes when i open the bookkeeper's lectern

 

Feyd , 21 hours ago

SparrowOfRealms

 

The Bookkeeper mod doesn't modify or replace any vanilla storage blocks. It only reads the contents of nearby containers (chests, barrels, etc.) and displays them in its GUI. Your actual items stay exactly where they are in the original vanilla containers — the mod never moves, copies, or wraps them.

SparrowOfRealms, 22 hours ago

Is this mod safe to add and remove to an existing world? looks very awesome, just wondering since most storage mods are unsafe to remove without deleting all your original chests' items

TheSinisterRat, 1 day ago

fervidace

 

These discussions are important things to have throughout the course of human history, and are not made banal nor unimportant because of how often they transpire - it is often the case that many agree a new technology is bad or destructive, and yet that technology is adapted in a wide-scale because of bad actors who force it on the rest of their species by their endorsing, accepting, and use of said technology.

 

While electricity was often demonized because of a combination of a lack of information, religious fearmongering leading to a rejection of new technology, and the fact that there were genuine dangers and unknowns regarding the act of harnessing it, there were benefits and upsides that outweighed those things. Electricity was immediately proven to have potential applications that benefitted the human race at large - electromagnetism, the potential for harvesting it for use in waterwheels, the ideas of electric horses or electric machine men to do work for us, yadda yadda yadda. It had actual benefits, and these benefits did not require electricity to wholesale steal materials from creatives who had put their souls and art out for the general public to appreciate and incorporate into their daily lives. Electricity has had a lot of negatives - coal, mining of minerals, untold environmental damage; we could even go on to blame it for the likes of tanks and planes dropping bombs and so on and so forth - but it was also immediately shown to have positives, it was immediately promised to be useful and would help everyone. Its misuse came later, not immediately with the revealing of the new technology.

 

The printing press democratized reading, allowed for the proliferation of books, shook the stranglehold that the church had on literature, and gave rise to societies that could consider themselves widely literate. Yes, it cost many monks and professional writers their profession as it was, but it also enabled countless writers to create manuscripts, scripture, poetry, et cetera et cetera. It is a beneficial technology that has advanced our culture, not stolen from and regurgitated it back at us from a corporate machine.

 

To photography, I recognize that it hurt portrait artists and painters who specialized in creating likenesses of people, but it did not replace them entirely. It did not steal their artworks, did not need to scrape them from a central repository in order to be trained, did not then fully replace those people and stamp out their livelihoods. These painters were still in demand, could still turn their skills to the arts, were still wanted and not being replaced by something soulless. Good photography is an art all on its own, it created more artists - AI creates people who do not know the processes of what they output, and who make those outputs off of the backs of those who put in real time and effort and as a result were outputting real human connection.

 

I would argue that looms and mass-produced cloth works would have been a better example for you to use, and countless lost their livlihoods, the richness of their family history and techniques, and so on. The only reason this was needed was so we could have our supposedly endless growth, our ever increasing demand and that drive to fulfill that demand, no matter who we hurt along the way. AI is very similar there - taking skill and true art and replacing it with something that barely has a human touch, if any at all.

 

The chainsaw isn't made from stealing the handsaws of those who it replaces. It enables those already cutting trees to cut trees faster. Those who were not coding or doing art or writing before are not doing it now, they're stealing and rehashing. The time investment is purely because the glorified chatbot doesn't have a sense of consciousness or understanding of what it is doing - just an LLM and a human who both do not understand the process of what they are aping on.

 

AI gives to corporations: creates people who do not know what they are doing who then claim they have done something, replaces those who have put in time and effort, enables the wealthy to starve us more of jobs and creativity and the act of creation, drives the construction of more and more large swathes of industrialized land, consumes water, consumes electricity, outputs waste, increases demand for mining, so on and so forth. Even if it was not even in the top percentile of the worst offender for any of those things, it still increases the burden on an already struggling, steadily worsening planet.

 

I apologize for the wall of text. Despite that, I barely scratched the surface on any of these because I don't really see the point - nothing I have said is very well hidden information, nothing requires an extensive understanding. It is all right there, easily found, and oft repeated, and I can't see how my saying them again on some corner of the internet will change the thoughts of people who have already seen the above and decided that it's alright to ignore in favour of just being one of the ones who change with the world. The question is whether or not this change results in more harm or more benefit for the world at large - that is one area where we can derive the morality of that change from. AI could have been something great - it showed great promise in data and data-related fields. Outside of that, well, you already see a few of my stances. Doesn't even touch on how it has been changing the human brain and attention span and knowledge retention, much the same as writing did - though whereas that gave us a new brain capable of much greater things, AI so far has created people who's brains offload thinking itself. Among other things.

 

fervidace, 1 day ago

TheSinisterRat You make fair points, but at the same time these discussions can be had about an infinite amount of things that humans have created over the course of history. Electricity itself can be viewed to be just as scary as AI, especially in its infancy, and people were having the same disscusions at the early days of electricity that we all are today about whether AI is good or bad. Damn near nothing is inherently perfectly good or bad. A lot of bad things came to be from the creation of the internet, but a lot of good things as well. What about the creation of the printing press? What about modern photography? Many creative jobs were lost in the development of those. The examples are endless. The world is ever changing. Some people will want to change with it, and some won't, neither option is objectively immoral within reason.When it comes to things like coding, people forget that it still does take time and does take skill to go through the trial and error to get something that is functional. Sure it easier than raw coding, but why not use every tool avaliable to you? If you need to go cut down a tree are you going to use a hand saw over a chainsaw because of the fear that the chainsaw can take off your arm? Its far from perfect, but its still majorly in its infancy. The enviromental factors can certainly be a concern, but there is essentially nothing in a normal day to day life that doesnt have a negative effect on the environment. Datacenters, agriculture, batteries, transportation, even brushing your teeth, they all have a negative effect on the environment and water displacement from AI isn't even close to being one of the worst offenders.

TheSinisterRat, 2 days ago (modified 2 days ago)

fervidace

 

Your defense is that it increases rainfall in the area? So water-ecosystems that normally don't have large quanities of water pulled out of them can just get buggered now because you want to not have to do any thinking or learning on your own and would prefer to increase energy costs, environmental demand, and displace water? You're serious? That's the defense to the water concerns?

 

"Yeah, it's environmentally disruptive, but in a way I deem acceptable."

 

No rebuttal for the rampant theft, the increasing hardship it is putting on people, the fact that we have people 'coding' without knowing how to code, thereby making them entirely reliant on a corporate-backed machine, pushing out those who have actually done work... We can pretend it's relegated only to modding, sure, but that would be playing pretend when we're talking real-world consequences.

 

You are leaping to the defense of something destructive, is used inappropriately, and ultimately replaces human creativity and learning with corporate-backed slop, and I genuinely cannot understand how you can find that a defensible position. Cringe anti-innovation.What an utterly ridiculous sentiment - as if we shouldn't have conversations as a species about what is worth and not worth developing.

 

How many people do you think have used 'I'm merely innovating' as justification for morally reprehensible works?

EnderMelody, 2 days ago

fervidace and again, im not saying whether or not the tool should be used, im simply stating that it should be clearly stated when it is used and be fully up to the user to decide. And that, especially with its current state, ridiculing someone for being weary is ridiculous.

fervidace, 3 days ago

SammySemicolon Ehh, the water doesn't dissapear. Its been shown that the average rainfall increases in areas where there are large industries(not just AI) that use evaporative water cooling systems because of the extra water in the atmosphere. The real issue is water pollution, which, who knows, maybe AI will aid in a solution for that at some point. 

fervidace, 3 days ago

EnderMelody What you're saying is completely fair. But it can't progress without people progressing it, and part of that is using it. A profit free modding enviroment is the perfect place for its capabilities to be tested and for people to learn how to use it effectively.

 

MooseCampbell, 3 days ago (modified 3 days ago)

EnderMelody 259 downloads and not a single comment about the mod not working or actively harming performance would suggest any complaints about ai at this current time are, at best, unfounded

As for FarmerBrown's comment, its just a bot spamming multiple mods

EnderMelody, 3 days ago

@fervidace not speaking for the previous person as i dont know their opinion on it, but ai isnt a problem because of new tool thing bad, its that its actually pretty bad at coding in general. And having someone who doesnt know code vibe code an entire project through it can be dangerous especially with performance in mind. shaming people for being rightfully weary of something like this is both bad and rude. the main thing imo for these kinds of projects is for the uploader to be clear about the use of ai and how much was used, and allowing the user to choose based on this info is important with the current state of the tool.
Feyd awesome, that improves the usability of the mod greatly!

Feyd , 3 days ago

EnderMelody, thespy24574 - I've added the ability to simply right-click on the lectern to open the manifest window. I've also updated the documentation.

Cheers!

FarmerBrown, 3 days ago

Why must AI art be used for the mod?

SammySemicolon, 3 days ago

Feyd It's less so the ai codebase and just the art you used, Generative AI just outright robs art from all parts of life without any respect for credit or copyright all while devouring nearly millions of liters of water per day.

Feyd , 4 days ago

MooseCampbell, fervidace & thespy24574 - many thanks for the kind words. You have no idea how much I appreciate it!

My goal with this mod is to eventually allow the management of all inventory items from a single window.

I'll be in touch.

MooseCampbell, 4 days ago

AI use is a total non issue

fervidace, 4 days ago

SammySemicolon Feyd Get that cringe anti innovation crap outa here. If people didnt use the tools at their disposal over the course of history we'd still be lighting our houses with torches and using knapped tools to build our houses brick by brick.

Feyd , 4 days ago

EnderMelody & thespy24574 - I should have time this evening to knock this out. Your input helps me improve the mod so thanks for the feedback!

Feyd , 4 days ago

SammySemicolon that's why I added the disclaimer to the mod description. I'm not an artist and I'm not a programmer. Coding without AI takes too much of my time so it's vibe-mods or nothing. If it becomes a problem with many here, I'll just remove all my mods and call it a day. 

Honestly, sharing these mods may become too time consuming for me and I end up having to pull them anyway.

Maybe someone can take my idea and write it without using Ai, Id be happy to share the source code with them.

SammySemicolon, 4 days ago (modified 4 days ago)

I'd love to use this but the very likely AI generated mod icon and AI source code is pushing me away.

Astyanaxx, 4 days ago

Lovely idea! 

thespy24574, 4 days ago (modified 4 days ago)

I agree with Ender, just make it a right clickable block that does the same task instead of a keybind. It makes more sense this way.

EnderMelody, 4 days ago

why use a keybinding to open the menu instead of just right clicking the block. more keybinding bloat is extremely annoying.