herbix / hoi4modutilities

A VSCode extension that contains utilities for Heart of Iron IV mods developers
MIT License
83 stars 10 forks source link

HOI4 Mod Utilities

This extension add tools for Heart of Iron IV modding. Some of the tools may work on other Paradox games.

Support me on Patreon

Features

For feature details and user manual, please refer to HOI4 Mod Utilities Wiki.

Steps to start

  1. Install and enable this extension in VSCode.
  2. Set Heart of Iron IV install path. You can:
    • (Since v0.7.0, or on vscode web) Open command palette using Ctrl+Shift+P. Use command Select HOI4 install path to browse the folder that installed Heart of Iron IV.
    • Update setting hoi4ModUtilities.installPath (you can open settings page of VSCode using Ctrl+,) to the folder that installed Heart of Iron IV.
  3. Open your mod develop folder.
  4. (Optional) Open command palette using Ctrl+Shift+P. Use command Select mod file to set working mod descriptor (the .mod file).
  5. Use these entries:
    • Command palette (Ctrl+Shift+P) commands: Preview World Map and Preview HOI4 file*.
    • Preview HOI4 file (Preview HOI4 file button)* button on right-top tool bar of text editor.
    • Open a .dds or .tga file.

* Preview HOI4 file (Preview HOI4 file button) button/command is invisible, except on .gfx, map/default.map, technology tree or national focus tree files.

Demos

World map preview

World map preview demo

Focus tree preview

Focus tree preview demo

Event tree preview

Event tree preview demo

Technology tree preview

Technology tree preview demo

GUI Preview

GUI preview demo

Extension Settings

Setting Type Description
hoi4ModUtilities.installPath string Hearts of Iron IV install path. Without this, most features are broken.
hoi4ModUtilities.loadDlcContents boolean Whether to load DLC images when previewing files. Enabling this will use more memory (All DLCs are around 600MB).
hoi4ModUtilities.modFile string Path to the working .mod file. This file is used to read replace_path. If not specified, will use first .mod file in first folder of the workspace.
hoi4ModUtilities.enableSupplyArea boolean If you are developing mod for HOI4(version<=1.10). Use this to check enable supply area.
hoi4ModUtilities.previewLocalisation enum Language of content in event tree preview.
hoi4ModUtilities.featureFlags array of string Feature flags are used to disable or enable features. Reloading is required after changing this. Please refer to Wiki on Github for details.

Known Issues

Release Notes - [0.12.1]

Added

Contribute

Support