VintagestoryData folder

From Vintage Story Wiki
Revision as of 07:22, 14 July 2024 by Bluelightning32 (talk | contribs) (Overview of what's in the folder)
Other languages:

Windows

On Windows, Vintage Story user data is stored in:

%APPDATA%\VintagestoryData

which by default translates to

C:\Users\YourUserName\AppData\Roaming\VintagestoryData

Windows allows to navigate to this folder using %APPDATA%. You can type %APPDATA%\VintagestoryData in the navigation bar.

Basic1APPDATA.png

We also recommend to pin this folder to your 'Quick access':

Basic1QuickAccess.png

In-game screenshots are stored in your Pictures folder, usually C:\Users\YourUserName\Pictures\Vintagestory.

Linux

On Linux, Vintage Story user data is stored in:

$XDG_CONFIG_HOME/VintagestoryData

By default it usually translates to

~/.config/VintagestoryData

Vintage Story Flatpak currently uses a different location:

~/.var/app/at.vintagestory.VintageStory/config/VintagestoryData

Screenshots are stored in [XDG_PICTURES_DIR]/Vintagestory, which by default is: ~/Pictures/Vintagestory.

Folder Structure

VintagestoryData
Backups
Backups created with the /genbackup command. These files have the same format as the files in the Saves folder. So to restore backup, copy the file to the Saves folder.
BackupSaves
Backups created from the Modify World dialog, which is found by clicking the edit icon on a world in the Singeplayer tab of the launcher. These files have the same format as the files in the Saves folder. So to restore backup, copy the file to the Saves folder.
Cache
unpack
Unzipped copies of mods. Each time the client or server needs to run a mod, it will check whether the corresponding subfolder under Cache exists. If not, it will create the folder and unzip the mod into it.
Logs
Macros
ModConfig
Each mod may optionally create a json file in this folder for configuration settings. These files are intended to be human edited, but only while the game is not running.
Mods
Alternate location to add mods. The primary mod location is the Mod folder under the program installation.
Playerdata
playerdata.json
Privilege information for each player on the server.
playergroups.json
playersbanned.json
playerswhitelisted.json
Saves
savename.vcdbs
Main game save file, in sqlite3 format.
savename.vcdbs-shm
Shared memory used to communicate database changes between all processes that have the database open. Since only one process has the database open at any time, arguably VS should be using sqlite3 exclusive locking mode instead to avoid creating this file and make database operations slightly faster.
savename.vcdbs-wal
Journalled changes to the database that have not been compacted into checkpoint yet.
serverconfig.json
Server settings that can be edited in the file folder (while the game is shut down), or through the /serverconfig command while the game is running.
servermagicnumbers.json
Risky performance tuning parameters that almost never need to be changed.
WorldEdit
Icon Sign.png

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.

Modding
Modding Introduction Getting Started Theme Pack
Content Modding Content Mods Developing a Content Mod Basic Tutorials Intermediate Tutorials Advanced Tutorials Content Mod Concepts
Code Modding Code Mods Setting up your Development Environment
Property Overview ItemEntityBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsWorld properties
Workflows & Infrastructure Modding Efficiency TipsMod-engine compatibilityMod ExtensibilityVS Engine
Additional Resources Community Resources Modding API Updates Programming Languages List of server commandsList of client commandsClient startup parametersServer startup parameters
Example ModsAPI DocsGitHub Repository