So a bit of confusion on how to make the map.

What do you recommend as a good host for it?

A video tutorial might be great for this.

DudeBroccoli186

You can have a look at the linked Demo site and there if you click Guide / Contribute you can see how that works and yes it is ingame signs with special text on them.

Sorry, but I dont understand how the signs work.

Is it an actual sign in the Vintage Story server?

If so what would I put on it if I want it to show up as a base and it to be called OG Base

NLTim Yes there is some code for a integration with the a webmab to sync player positons or maybe more but I never worked on that on the webmap side of it. Someone else wanted to work on this for their own webmap implemenation. So its not functional as of now for webcartographer

PeachyPotato since the recent changes to moddb adding new version tags will show the mod as modified since it is now marked compatible with new version which did not need a new verison of the mod to be uploaded.

alright this'll drive me crazy

Last modified: 8 hours ago

but the file was uploaded June 2nd and still has the same version tags What was modified here?

The sources contain an additional mod 'webcartographersync' which is not listed here in the mod DB. What is the status of that? Sounds pretty cool to have the players show up on the map.

Benko_1000 how do you open the map? if it you just open the .html file in a browser the geojson loading will not work

Is there some extra setting to enable traders? I ran the mod on the server with default settings and dont see any of them on the map. Does it have to run local to see them?

I see the traders in the geojson file and i have them enabled in the map with the eye icons, but they are not there. I assume in the files are the coordinates relative to spawn (i also moved the spawn but only around 4k blocks, so i would still see them if they were off)

from the traders geojson file

{"type":"FeatureCollection","crs":{"Name":"urn:ogc:def:crs:EPSG::3857","type":"name","properties":{"name":"urn:ogc:def:crs:EPSG::3857"}},"name":"traders","features":[

{"type":"Feature","properties":{"name":"Yern","wares":"Agriculture trader","z":140},"geometry":{"type":"Point","coordinates":[262,9704]}},

{"type":"Feature","properties":{"name":"Puck","wares":"Kitchenware Trader","z":138},"geometry":{"type":"Point","coordinates":[3690,5136]}},

{"type":"Feature","properties":{"name":"Ahanu","wares":"Clothing trader","z":140},"geometry":{"type":"Point","coordinates":[-2073,4593]}},

{"type":"Feature","properties":{"name":"Timaf","wares":"Treasure hunter trader","z":167},"geometry":{"type":"Point","coordinates":[2646,4360]}},...

ty, link is now fixed

Hey so the demo page seems to be down, I get a page that says:
Server Not Found

PhobosFogg

the modes are listed here

I would only change between 3 and 4 the rest are more basic ones, 3 is with color and 4 is the medieval style

Th3Dilli if the color file is missing while trying an export the server crashes, could you add a warning and skip the export?

Apr 07 15:32:58 Elwing vintage-story-server[3399990]: 7.4.2025 06:32:58 [Server Notification] WebCartographer is now starting...
Apr 07 15:32:58 Elwing vintage-story-server[3399990]: 7.4.2025 06:32:58 [Server Notification] WebCartographer is now preparing for FixWhiteLines or ExtractWorldMap ...
Apr 07 15:32:58 Elwing vintage-story-server[3399990]: 7.4.2025 06:32:58 [Server Error] [webcartographer] blockColorMapping.json is missing:!!!
Apr 07 15:32:58 Elwing podman[3402388]: 2025-04-07 15:32:58.429007925 +0900 JST m=+0.027178435 container died e60f34e40ace548b29c005dc9cff00a30cbadea96f7d0e374211d8857555dcbc (image=localhost/vintage-story-server:latest, name=vintage-story-server, io.buildah.version=1.28.2, org.opencontainers.image.ref.name=ubuntu, org.opencontainers.image.version=22.04, PODMAN_SYSTEMD_UNIT=vintage-story-server.service)

What do the modes do?  What's the significance of Mode 4?

LaDestitute

That does not sound normal. best is if you deleted the old files and then copy in the new ones

I have a map uploaded to a site hosted, its otherwise great but is it normal that after I upload all the numbered folders within data of the root directory the map has copies if itself if i zoom in/out?
I notice the map tends to make copies of the center of the area being made if I zoom in too much but otherwise is normal

ongandu

it only exports on start or when you use the WebCartographer color exporter  you can trigger it using .exportcolors too

when you add more to automap.js and set ExportUntaggedSigns: true you can add any you like

Hi Th3Dilli, thanks for putting this mod together works really well.

I got a few questions:

• When and how often does the mod triggers exports? Currently I have to set the `ExportOnStart` option to `true` otherwise it never exports.
  • Does it have to be done manually? If so is there a server command or `.exportcolors` is the correct way?
• In the guide it says we can place three types of AM markers, SERVER, BASE and MISC, is I add more e.g PORT to the `autoload.js` will it they be picked up?
  • If they are not picked up, do I need to use `ExportUntaggedSigns`?

Thanks very much again.

LIONSVendi

looks like your 
OutputDirectory settings is set wrong

it should be something like 
"OutputDirectory": "c:\this\is\my\path\",

Morggin 

You do not need to mark traders they will get exported automatically

zackadiax24

maybe one day it will be added to the ingame map

If only i could get those teleporter lines on my in game map.

How do we mark a trader?  Is <AM:TL>

Th3Dilli

I don´t know if I doing something wrong her on my side but if I start my private server it shows me this error.

Can you help me?

6.1.2025 12:28:59 [Server Error] [webcartographer] An exception was thrown when trying to start the mod:
6.1.2025 12:28:59 [Server Error] [webcartographer] Exception: Bad JSON escape sequence: \U. Path 'OutputDirectory', line 3, position 26.
at Newtonsoft.Json.JsonTextReader.ReadStringIntoBuffer(Char quote)
at Newtonsoft.Json.JsonTextReader.ReadStringValue(ReadType readType)
at Newtonsoft.Json.JsonTextReader.ReadAsString()
at Newtonsoft.Json.JsonReader.ReadForType(JsonContract contract, Boolean hasConverter)
at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.PopulateObject(Object newObject, JsonReader reader, JsonObjectContract contract, JsonProperty member, String id)
at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.CreateObject(JsonReader reader, Type objectType, JsonContract contract, JsonProperty member, JsonContainerContract containerContract, JsonProperty containerMember, Object existingValue)
at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.CreateValueInternal(JsonReader reader, Type objectType, JsonContract contract, JsonProperty member, JsonContainerContract containerContract, JsonProperty containerMember, Object existingValue)
at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.Deserialize(JsonReader reader, Type objectType, Boolean checkAdditionalContent)
at Newtonsoft.Json.JsonConvert.DeserializeObject(String value, Type type, JsonSerializerSettings settings)
at Newtonsoft.Json.JsonConvert.DeserializeObject[T](String value, JsonSerializerSettings settings)
at Newtonsoft.Json.JsonConvert.DeserializeObject[T](String value)
at Vintagestory.Common.APIBase.LoadModConfig[T](String filename) in VintagestoryLib\Common\API\APIBase.cs:line 102
at WebCartographer.WebCartographer.LoadConfig() in /home/dilli/drive_linux/git_repos/vintagestory/mods/WebCartographer/WebCartographer/WebCartographer.cs:line 106
at WebCartographer.WebCartographer.StartServerSide(ICoreServerAPI api) in /home/dilli/drive_linux/git_repos/vintagestory/mods/WebCartographer/WebCartographer/WebCartographer.cs:line 36
at Vintagestory.Common.ModLoader.TryRunModPhase(Mod mod, ModSystem system, ICoreAPI api, ModRunPhase phase) in VintagestoryLib\Common\API\ModLoader.cs:line 664
6.1.2025 12:28:59 [Server Error] Failed to start system WebCartographer.WebCartographer

Would be great if you could help me with this.

Regards Chris

oh ty, fixed now, there is separate version for 1.19 and 1.20 (just redownload 0.5.9 for 1.19)
Cosmic9

Th3Dilli
you have the latest version tagging 1.19.8 as a supported version. doesn't seem supported to me.

24.10.2024 08:33:41 [Error] [webcartographer] Could not resolve some dependencies:
24.10.2024 08:33:41 [Error] [webcartographer] game@1.20.0-pre.1 - Version mismatch (has 1.19.8)

sorry new version should fix that

I am getting strange SQL errors:

[Server Error] Exception: SQLite Error 1: 'no such column: postion'.
at Microsoft.Data.Sqlite.SqliteException.ThrowExceptionForRC(Int32 rc, sqlite3 db)
at Microsoft.Data.Sqlite.SqliteCommand.PrepareAndEnumerateStatements(Stopwatch timer)+MoveNext()
at Microsoft.Data.Sqlite.SqliteCommand.GetStatements(Stopwatch timer)+MoveNext()
at Microsoft.Data.Sqlite.SqliteDataReader.NextResult()
at Microsoft.Data.Sqlite.SqliteCommand.ExecuteReader(CommandBehavior behavior)
at Microsoft.Data.Sqlite.SqliteCommand.ExecuteScalar()
at WebCartographer.SavegameDataLoader.GetServerMapRegionsCount() in /home/dilli/drive_linux/git_repos/vintagestory/mods/WebCartographer/WebCartographer/SavegameDataLoader.cs:line 149
at WebCartographer.Extractor.ExtractStructures() in /home/dilli/drive_linux/git_repos/vintagestory/mods/WebCartographer/WebCartographer/Extractor.cs:line 115
at WebCartographer.Extractor.Run() in /home/dilli/drive_linux/git_repos/vintagestory/mods/WebCartographer/WebCartographer/Extractor.cs:line 99

What can possible make this to happen?

Running VS Server 1.19.8, when trying the older version it all works. But doesn't generate the map as it should :(

Thalius

redownload the mod now there was an issue so i replaced the current release file

I am trying this mod for the first time, and am not getting a config file generated on my server. Restarted the server a couple of times, and no config file.

Th3Dilli

webcartographer_0.5.2.zip

"ExportOnStart": true,
"SaveMode": true,
"StopOnDone": false

With this options, after finish map exportin server stucks at savemode and people can´t connect to.

hooray, thank you for new update !

Downside, if you turn the "ExportOnStart": true to false and leave the mod in the /mod directory next server restart it delete all in webmap data folder. It is really bad.

DejFidOFF

can you send me a full server-main.txt on discord pls

Th3Dilli

No just only one mod in the mod directory 0.5.1

DejFidOFF

that should mean you have the mod loaded twice (two versions?)

0.5.1

28.2.2024 06:57:37 [Error] [webcartographer] An exception was thrown when trying to load assembly:
28.2.2024 06:57:37 [Error] [webcartographer] Exception: Assembly with same name is already loaded
at System.Runtime.Loader.AssemblyLoadContext.<LoadFromPath>g____PInvoke|5_0(IntPtr ptrNativeAssemblyBinder, UInt16* ilPath, UInt16* niPath, ObjectHandleOnStack retAssembly)
at System.Runtime.Loader.AssemblyLoadContext.LoadFromAssemblyPath(String assemblyPath)
at System.Reflection.Assembly.LoadFrom(String assemblyFile)
at Vintagestory.Common.ModContainer.<>c__DisplayClass35_0.<LoadAssembly>b__0(String path) in VintagestoryLib\Common\API\ModContainer.cs:line 449
at System.Linq.Enumerable.SelectListIterator`2.MoveNext()
at System.Linq.Enumerable.WhereEnumerableIterator`1.ToList()
at Vintagestory.Common.ModContainer.LoadAssembly(ModCompilationContext compilationContext, ModAssemblyLoader loader) in VintagestoryLib\Common\API\ModContainer.cs:line 448

DejFidOFF
try the 0.5.1 this one exports the correct worldextent so if you changed the default spawn that could be the reason for it

First thank you so much for your work. But, file exported, 125MB in /data folder but index.html output is just only black screen :( ( also sent color data ).

Versora

you can hop on my discord and post your logs there, then I can have a look at what might be wrong

I dunno what I be doing wrong but I do not have a webmap folder, and I know I did things correctly.

MKRhere

I do not have telegram but you can join my discord linked above and ask there some stuff if you want

the main issue with the standalone approach is gonna be the blockcolors
currently, the game client sets up all the blocks and adds the textures then you can grep a random color from a blocks upwards facing block through the game api
if you do a standalone approach you need to do that manually meaning you need to get a copy of the game client (since that only contains the textures) and assemble all blocks + mod block and extract the up facing texture and get a color
and then extract the color for each block and you have to redo that with every game or mod update

> no one invested the time to make a tool

We're working on a tool to read the save file (and render a map) without launching a server. We're currently going through reversing the binary blobs in the database. We'd love more help from people more involved with the game (modders, etc). If you'd like to help out, even if it's occasionally providing an observation, reach out to me muthukumarthefeathersin, or join our Telegram chat (search for "madrasmc"). Thanks!

is there an easier way to do this right now? 
short answere no since no one invested the time to make a tool that can do all at once without having to go through this process

the first issues is the server does not know anything about colors and does not even have the textures
second the game stores the blocks as number id and a table to look them up but everytime you add update a mode that may change, so we can only really rely on the block name but we need to spin up an entire server to resolve the mods , load the data from db and turn that into block data with their names so we can lookup the color that can only be exported on the client


sure this could be made more user friendly and maybe simple but would requiere more work, so unless someone takes up that challange this is the best thing you have right now, the previouse iteration of this "system" was to use a client side mod to export chunk images on the client and then use gdal command line tools to stitch them together to then make a webmap of it so this is already a huge improvement but sure it can be improved even more

afaik their is a mod that is not yet on the moddb, made by VeryGoodDog on github, it is in a usable state but not fully finished as far as I am ware


for the powershell script yeah I am sorry that hasn't been tested in a while, thank you for providing the upated version I will add the to the repo

i have now added instructions of how todo it without using docker to the discription I hope that helps

So this took a bit of effort to get working for a modded server. I'm not sure if the export.ps1 was ever tested because it had syntax errors (one of the if checks was not correct), would break because of existing files (if you ran it again due to lack of -Force usage), and funademental flaws such as Expand-Archive not supporting .tar.gz files.

I haven't code dived the color exporter mod, but it seems very redundant to be running an entire copy of the game to run this mod, have the cartographer mod then iterate over a different save file (to get around the save file being locked), and to rely on the user to preemptively provide a blockColorMapping.json. Can those colors really not be determined server side, and is there no way in an existing game to access the data you need from the save file (despite being able to actually run that save file on the server)?

Additionally, it seems needless to fail if the blockColorMapping has client mods listed; would be better to just make it a warning and continue anyways. If there are actually server mods missing that we need colors for then make them hot pink so the resulting map obviously has problems that require a correct blockColorMapping.json.

If you run the webmap and its broken (console is complaining about ol.js), be sure you aren't blocking cdn.jsdelivr.net.

This is the export.ps1 file I ended up with:

$ErrorActionPreference = 'Stop'
Set-StrictMode -Version Latest

$TYPE = 'stable'
$VERSION = '1.18.15'
$DEST = "$(Get-Location)/cartographer"
$SAVEFILE = "$env:APPDATA/VintagestoryData/Saves/server world.vcdbs" # Change this to whatever your save file is named

docker compose stop cartographer

Copy-Item -Force $SAVEFILE -Destination "default.vcdbs"

if ((Test-Path $DEST)) {
Remove-Item -Path $DEST -Recurse | Out-Null
}
if ((Test-Path map_data)) {
Remove-Item -Path map_data -Recurse | Out-Null
}
New-Item -ItemType Directory -Path $DEST -Force | Out-Null
New-Item -ItemType Directory -Path html -Force | Out-Null
New-Item -ItemType Directory -Path map_data -Force | Out-Null
New-Item -ItemType Directory -Path "$DEST/cartographerData/ModConfig" -Force | Out-Null
New-Item -ItemType Directory -Path "$DEST/cartographerData/Mods" -Force | Out-Null

$SERVER = "vs_server_$VERSION.tar.gz"

$URL_SERVER = "https://cdn.vintagestory.at/gamefiles/$TYPE/vs_server_linux-x64_$VERSION.tar.gz"

if (-not (Test-Path $SERVER)) {
Invoke-WebRequest -Uri $URL_SERVER -OutFile $SERVER
}
if (-not (Test-Path "$DEST/assets")) {
# Expand-Archive -Path $SERVER -DestinationPath $DEST
tar -xzf $SERVER -C $DEST
}

if ((Test-Path "serverconfig.json")) {
Copy-Item -Force "serverconfig.json" "$DEST/cartographerData/serverconfig.json"
} else {
New-Item -Force -ItemType File "serverconfig.json", "$DEST/cartographerData/serverconfig.json" | Out-Null
}

if ((Test-Path "servermagicnumbers.json")) {
Copy-Item -Force "servermagicnumbers.json" "$DEST/cartographerData/servermagicnumbers.json"
} else {
New-Item -Force -ItemType File "$DEST/cartographerData/servermagicnumbers.json" | Out-Null
}

Copy-Item -Force "WebCartographerConfig.json" "$DEST/cartographerData/ModConfig/WebCartographerConfig.json"
Copy-Item -Force "blockColorMapping.json" "$DEST/cartographerData/ModConfig/blockColorMapping.json"
New-Item -Force -ItemType File "$DEST/cartographerData/Saves/default.vcdbs" | Out-Null
Copy-Item -Force "default.vcdbs" "$DEST/cartographerData/Saves/default.vcdbs"

if ((Test-Path "Mods")) {
Copy-Item -Force -Recurse "Mods" "$DEST/cartographerData"
}

# Doesn't appear to currently be necessary, but it could potentially be
if ((Test-Path "ModConfig")) {
Copy-Item -Force -Recurse "ModConfig" "$DEST/cartographerData"
}

docker compose up cartographer

if ((Test-Path html/data)) {
Remove-Item -Path html/data -Recurse | Out-Null
}
Copy-Item -Force -Recurse "./map_data/world" "./html/data/world/"
Copy-Item -Force -Recurse "./map_data/geojson" "./html/data/"
if ((Test-Path "./map_data/heightmap")) {
Copy-Item -Force -Recurse "./map_data/heightmap" "./html/data/"
}
Remove-Item -Path map_data -Recurse | Out-Null

docker compose up webmap -d

Write-Output "Done creating webmap - Check it out at http://localhost:4242"

xxpowerofsoundxx The webmap is a lot more useful than simply a large image since you can filter what you see, pan and zoom around, click to get commands to add the waypoint in game, etc; but the exported images you could just tile together to form a map if thats all you want.

Is there anyway to just export my game map as an image or something instead of all the docker, server, rigamorole? I don't understnad why there's no simple translation too for this. 

apperently ther are some issues running verson 0.1.0 on Windows atm,
to get around those delete WebCartographer.exe.config
and copy everything from Lib64 next to the WebCartographer.exe

Also a note, I had to copy sqlite3.dll personally into the WC directory.

Config:
{
"Mode": 1,
"DatabaseFile": "C:\Users\admin\AppData\Roaming\VintagestoryData\Saves\default.vcdbs",
"OutputDirectory": "C:\Apache24\htdocs\vcmap",
"ExtractWorldMap": true,
"ExtractStructures": true,
"AbsolutePositions": false,
"ExportHeightmap": true,
"IgnoreSnowBelow": 0,
"ExportSigns": true,
"ExportUntaggedSigns": false,
"TileSize": 256,
"MaxDegreeOfParallelism": -1,
"ExportPgw": true
}

I can confirm the same error on Windows Server 2019

Looks like it's looking for a personal directory at "C:\Users\Tyron"

DemonBigj781

could you share your config?
preferable on discord (oh forgot to add the discord link)

i get this erroe when i set up the server

[Server Error] Failed opening savegame.System.BadImageFormatException: An attempt was made to load a program with an incorrect format. (Exception from HRESULT: 0x8007000B)
at System.Data.SQLite.UnsafeNativeMethods.sqlite3_config(Int32 op, SQLiteLogCallback func, IntPtr pvUser)
at System.Data.SQLite.SQLite3.StaticIsInitialized()
at System.Data.SQLite.SQLiteLog.Initialize()
at System.Data.SQLite.SQLiteConnection..ctor(String connectionString)
at Vintagestory.API.Common.SQLiteDBConnection.OpenOrCreate(String filename, String& errorMessage, Boolean requireWriteAccess, Boolean corruptionProtection, Boolean doIntegrityCheck) in C:\Users\Tyron\Documents\vintagestory\game\VintagestoryApi\Common\IO\SQLiteDBConnection.cs:line 76