Vic3 mapdata editor

*Read this in other languages: English, 简体中文

A Brief Introduction

Vic3 mapdata editor is an open source province editor based off Jomini.

Abilities

✅ Visualize and edit Vic3 states(Keeping track of region_state)
✅ Visualize and edit Vic3 state resources、city provinces、population and buildings
✅ Visualize and edit Vic3 strategy_region

TODO

A more intuitive way to display nations（Without using more files）
Optimize visualization performance，Fix CROS bug
Visualize and edit adjacencies
Real-time visualization and editing of city provinces
A live instance on the web that is created with docker
Refactor JavaScript to TypeScript?)
Good autocomplete
Good user and developer documentation
Scalable UI(I'm not joking，this is really difficult)
Update the map based on save files(So long! The main thing is I don't understand how the saves written!)
In summary, I welcome all suggestions for modifications

Quick Guide

By the new version, if you install vanilla game, you can just launch the ediotr without put anything!

If your game installation failed, please follow the guides below:

In data folder of the repo:

buildings: place all documents in game/common/history/buildings to this folder
outputs: remain it empty if you save nothing
pops: place all documents in game/common/history/pops to this folder
state_regions: place all documents in game/map_data/state_regions to this folder
strategic_regions: place all documents in game/common/history/strategic_regions to this folder
states: place all documents in game/common/history/states to this folder
adjacencies.csv: as the same name document in game/map_data
provinces.png: as the same name document in game/map_data
rivers.png: as the same name document in game/map_data

Double-click start.exe and launch the editor.

There are serval mode of the editor: prov,state,edit,strategy,and country

prov: Just for look the default map and generate a color which can not shown in the map
state: Click to select a state_region, and edit the property of this state_region
edit: Editing the history/state. Click to select a prov, ctrl+click to select multiple provs, shift + click to select all of the provs of the state_region which contains your selected prov, press the mouse left key and drag and release to select a series of provs in a rectangle selecting area,edit the input of state and country, press convert button to convert.
strategy: Click to select a state_region, ctrl+click to select multiple state_regions, edit the strategy_region, press convert button to convert.
terrain: Show the terrain if you put map_data/province_terrains.txt
country: Just for watch and it has the risk of crash

In your editing, the save button should be press to save the files. All of the save file would be in data/outputs If you select debug in the tray menu, in your next editing(fresh it or click open in the tray menu after you close the previous editor), the editor would read your previous saving as the inputs.

Finally you will get a series of document, you should place them in mod folder(where you create your mod!), and make them replace the vanilla files

in .metadata/metadata.json:

{
    "name": "Yourmod",
    "id": "your.mod",
    "version": "0.01",
    "supported_game_version": "",
    "short_description": "",
    "tags": ["funny modding"],
    "relationships": [],
    "game_custom_data": {
        "multiplayer_synchronized": true,
        "replace_paths": [
            "common/history/states",
            "common/history/pops",
            "common/history/buildings",
            "map_data/state_regions",
            "common/strategic_regions"
        ]
    }
}

In your mod folder there is only one file, they are:

common/history/states/00_states.txt
map_data/state_regions/01_state_regions.txt
common/strategic_regions/02_strategic_regions.txt
common/history/buildings/04_buildings.txt
common/history/pops/05_pops.txt

DZappala/Victoria3-map-editor

Vic3 mapdata editor

A Brief Introduction

Abilities

TODO

Quick Guide