hoi4dev 0.1.0.3__tar.gz

hoi4dev-0.1.0.3/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hoi4dev-0.1.0.3/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.1
+Name: hoi4dev
+Version: 0.1.0.3
+Summary: HOI4DEV: Hearts of Iron IV Development Tools
+Home-page: https://github.com/Magolor/
+Author: Magolor
+Author-email: magolorcz@gmail.com
+Project-URL: Author, https://github.com/Magolor/
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.9, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# HOI4DEV
+
+**Warning: This package is currently underdeveloped and does not guarantee any consistency.**
+
+**Tutorial Coming Soon...**
+
+**Compatible with HOI4 Version**: 
+
+### Configuration
+
+After installation, you need to setup the config to start working for a specific mod project. By default, `init_config()` creates a config at `~/.hoi4dev/config.json`, you can setup the paths manually.
+
+On MacOS:
+```bash
+{
+    "HOI4_GAME_PATH": "/Users/<YOUR_USER_NAME_HERE>/Library/Application Support/Steam/steamapps/common/Hearts of Iron IV",
+    "HOI4_MODS_PATH": "/Users/<YOUR_USER_NAME_HERE>/Documents/Paradox Interactive/Hearts of Iron IV/mod",
+    "HOI4_MODS_COPY_PATH": "/Users/<YOUR_USER_NAME_HERE>/Documents/Paradox Interactive/Hearts of Iron IV/mod",
+    "CURRENT_MOD_PATH": "/Users/<YOUR_USER_NAME_HERE>/Documents/Paradox Interactive/Hearts of Iron IV/mod/<YOUR_MOD_NAME>"
+}
+```
+
+On Windows:
+```bash
+{
+    "HOI4_GAME_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\Hearts of Iron IV",
+    "HOI4_MODS_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\workshop\\content\\394360",
+    "HOI4_MODS_COPY_PATH": "C:\\Users\\<YOUR_USER_NAME_HERE>\\Documents\\Paradox Interactive\\Hearts of Iron IV\\mod",
+    "CURRENT_MOD_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\workshop\\content\\394360\\<YOUR_MOD_NAME>"
+}
+```
+
+The `HOI4_MODS_COPY_PATH` is usually useless, but sometimes it may be required if your user name contains Chinese or other non-UTF-8 characters. Though, it is still worth warning that **This package is known to malfunction if you are running on Windows with non-UTF-8 characters. May be fixed in the future.**
+
+## Basic Features
+
+### CCL (Clausewitz scripting language) and JSON conversion
+
+```python
+from hoi4dev import *
+# Load JSON file
+A = LoadJson("xxx.json")
+
+# Convert JSON to CCL
+with open("xxx.txt", "w") as f:
+    f.write(Dict2CCL(A) + "\n")
+
+# Load CCL file
+with open("ccl.txt", "r") as f:
+    A_ccl = f.read()
+
+# Convert CCL to JSON
+
+```
+
+### Image conversion
+
+```python
+from hoi4dev import *
+
+# Load a png
+a = ImageLoad("xxx.png")
+
+# Zoom & auto-Crop to target size
+A = ImageZoom(a, w=512, h=512)
+
+# Save Image:
+ImageSave(A, "xxx.dds") # automatically compress dds with dxt5
+ImageSave(A, "xxx.tga") # automatically flip tga for flags
+```
+
+### Find your COMPILED mod
+
+```python
+# Use `F` to find your COMPILED mod files
+path_to_your_mod = F("")
+# Add a thumbnail manually
+CopyFile("thumbnail.png", F("thumbnail.png"))
+```
+
+### Conversion between YML localisation and TXT files
+
+```python
+AddLocalisation("xxx.txt", scope="ABC", translate=False)
+```
+
+In the txt file, use `[<LANGUAGE_ABBREVIATION>.<KEY>]`, use `@` to copy the `scope`
+For example, consider the following `txt` file, under "ABC" scope:
+```
+[en.key01]
+test1
+test2
+[zh.@key01]
+
+中文测例1
+中文测例2
+[zh.key01]
+中文测例3
+中文测例4
+```
+It will be converted to:
+```yml
+l_english:
+  "key01":0 "test1\ntest2"
+```
+
+```yml
+l_simp_chinese:
+  "ABC_key01":0 "中文测例1\n中文测例2"
+  "key01":0 "中文测例3\n中文测例4"
+```
+
+Currently `translate` supports either a local translation model or a Large Language Model, but it requires additonal setups (e.g., huggingface `transformer` or `openai`).
+
+Instead of conversion to YML, you can also convert to JSON using:
+```python
+ReadTxtLocs("xxx.txt", scope="ABC")
+```
+
+For example, the above text file will be parsed as `{'key01: {'en': 'test1\ntest2', 'zh': '中文测例3\n中文测例4'}, 'ABC_key01': {'zh': '中文测例1\n中文测例2'}}`.
+
+### Conversion of dates
+
+Want to know how many days you need to set in `on_actions` for the event to happen at a specific date? Or you need to number of weeks for a focus?
+```python
+get_num_days("1001.06.01", "1001.12.01") // 7   # 26 weeks
+
+get_end_date("1002.12.01", 1298)                # 1006.06.21
+```
+
+Actually, when adding events, `hoi4dev` allows you to automatically set the dates in `on_actions`. We will specify how to use that in the `events` tutorial (Coming Soon).
+
+## Advanced Features
+
+See example scripts in `example_scripts/`. Those scripts may not all able to run as they lack project resource files, but can be useful to help you understand the `hoi4dev` mechanism and classical workflows. For example, consider example scripts in `PIHC_v_0_2_1_2024_10_06/`
+
+On the one hand, there are some useful little tools that can be created using `hoi4dev` in `scripts/*/`:
+
+For example `scripts/states_editor/szj.py` shows how you can batch change the owner of certain states by converting all state history files to JSON, modifying them, and save them back.
+
+`scripts/add_kitin_state_group_gui.py` batch creates a map GUI gfxs (results are in `scripts/region_gui/`). This rely on preprocessed map information by `scripts/C01_build_the_map.py`.
+
+`scripts/adv_gen/script.py` and `scripts/mil_gen/script.py` allow you generate a huge amount of political advisors and military generals with a single `.csv` file. You can create Chinese translation if all your mod developers are from Chinese, for example.
+
+...
+
+On the other hand, scripts starting with `scripts/CXX_....` demonstrates how a regular mod workflow runs. `v0.2.1.py` is the main thread, generating a mod from scratch (not able to run here due to lack of project resource files).
+
+## Demos
+
+We plan to share an end-to-end mod project built with the package in the near future. Stay tuned.
+
+## Frequent Issues
+
+### Windows Computer with non-UTF-8 characters / pyheaven running error with JSON files
+
+**This package is known to malfunction if you are running on Windows with non-UTF-8 characters. May be fixed in the future.**
+
+This error is usually occurred when operating JSON files containing Chinese. The error occurred due to version difference of `jsonlines`.
+
+Therefore, you may try to modify the dependency `pyheaven`:
+```python
+# In pyheaven/serialize_utils/py 3
+def SaveJson(obj, path, backend:Literal['json','jsonl','demjson','simplejson','jsonpickle']='json', indent:Optional[int]=None, append:bool=False, *args, **kwargs):
+    """Save an object as json (or jsonl) file.
+
+    Args:
+        obj: The object to be saved.
+        path: The save path.
+        backend (str): Specify backend for saving an object in json format. Please refer to function `BUILTIN_JSON_BACKENDS()` for built-in backends.
+        indent (int/None): The `indent` argument for saving in json format, only works if backend is not "jsonl".
+        append (bool): If True, use "a" mode instead of "w" mode, only works if backend is "jsonl".
+    Returns:
+        None
+    """
+    assert (backend in BUILTIN_JSON_BACKENDS()), (f"backend not found! Supported backends: {BUILTIN_JSON_BACKENDS()}")
+    CreateFile(path); path = p2s(path)
+    if backend=='jsonl':
+        assert (indent is None), ("'jsonl' format does not support parameter 'indent'!")
+        with jsonlines.open(path, "a" if append else "w", encoding='utf-8', errors='ignore') as f:
+            for data in obj:
+                f.write(data)
+    else:
+        assert (append is False), ("'json' format does not support parameter 'append'!")
+        module = globals()[backend]
+        with open(path, "w", encoding='utf-8', errors='ignore') as f:
+            if backend in ['json','simplejson']:
+                module.dump(obj, f, indent=indent, *args, **kwargs)
+            else:
+                f.write(module.dumps(obj, indent=indent, *args, **kwargs))
+```
+
+Remove or add `encoding='utf-8', errors='ignore'` depending on your error may solve this issue. You may also want to change `LoadJson` function in the same file. (If you find any convenient fix to this error, feel free to contact me or create a new issue to update `pyheaven`).

hoi4dev-0.1.0.3/README.md

@@ -0,0 +1,193 @@
+# HOI4DEV
+
+**Warning: This package is currently underdeveloped and does not guarantee any consistency.**
+
+**Tutorial Coming Soon...**
+
+**Compatible with HOI4 Version**: 
+
+### Configuration
+
+After installation, you need to setup the config to start working for a specific mod project. By default, `init_config()` creates a config at `~/.hoi4dev/config.json`, you can setup the paths manually.
+
+On MacOS:
+```bash
+{
+    "HOI4_GAME_PATH": "/Users/<YOUR_USER_NAME_HERE>/Library/Application Support/Steam/steamapps/common/Hearts of Iron IV",
+    "HOI4_MODS_PATH": "/Users/<YOUR_USER_NAME_HERE>/Documents/Paradox Interactive/Hearts of Iron IV/mod",
+    "HOI4_MODS_COPY_PATH": "/Users/<YOUR_USER_NAME_HERE>/Documents/Paradox Interactive/Hearts of Iron IV/mod",
+    "CURRENT_MOD_PATH": "/Users/<YOUR_USER_NAME_HERE>/Documents/Paradox Interactive/Hearts of Iron IV/mod/<YOUR_MOD_NAME>"
+}
+```
+
+On Windows:
+```bash
+{
+    "HOI4_GAME_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\Hearts of Iron IV",
+    "HOI4_MODS_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\workshop\\content\\394360",
+    "HOI4_MODS_COPY_PATH": "C:\\Users\\<YOUR_USER_NAME_HERE>\\Documents\\Paradox Interactive\\Hearts of Iron IV\\mod",
+    "CURRENT_MOD_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\workshop\\content\\394360\\<YOUR_MOD_NAME>"
+}
+```
+
+The `HOI4_MODS_COPY_PATH` is usually useless, but sometimes it may be required if your user name contains Chinese or other non-UTF-8 characters. Though, it is still worth warning that **This package is known to malfunction if you are running on Windows with non-UTF-8 characters. May be fixed in the future.**
+
+## Basic Features
+
+### CCL (Clausewitz scripting language) and JSON conversion
+
+```python
+from hoi4dev import *
+# Load JSON file
+A = LoadJson("xxx.json")
+
+# Convert JSON to CCL
+with open("xxx.txt", "w") as f:
+    f.write(Dict2CCL(A) + "\n")
+
+# Load CCL file
+with open("ccl.txt", "r") as f:
+    A_ccl = f.read()
+
+# Convert CCL to JSON
+
+```
+
+### Image conversion
+
+```python
+from hoi4dev import *
+
+# Load a png
+a = ImageLoad("xxx.png")
+
+# Zoom & auto-Crop to target size
+A = ImageZoom(a, w=512, h=512)
+
+# Save Image:
+ImageSave(A, "xxx.dds") # automatically compress dds with dxt5
+ImageSave(A, "xxx.tga") # automatically flip tga for flags
+```
+
+### Find your COMPILED mod
+
+```python
+# Use `F` to find your COMPILED mod files
+path_to_your_mod = F("")
+# Add a thumbnail manually
+CopyFile("thumbnail.png", F("thumbnail.png"))
+```
+
+### Conversion between YML localisation and TXT files
+
+```python
+AddLocalisation("xxx.txt", scope="ABC", translate=False)
+```
+
+In the txt file, use `[<LANGUAGE_ABBREVIATION>.<KEY>]`, use `@` to copy the `scope`
+For example, consider the following `txt` file, under "ABC" scope:
+```
+[en.key01]
+test1
+test2
+[zh.@key01]
+
+中文测例1
+中文测例2
+[zh.key01]
+中文测例3
+中文测例4
+```
+It will be converted to:
+```yml
+l_english:
+  "key01":0 "test1\ntest2"
+```
+
+```yml
+l_simp_chinese:
+  "ABC_key01":0 "中文测例1\n中文测例2"
+  "key01":0 "中文测例3\n中文测例4"
+```
+
+Currently `translate` supports either a local translation model or a Large Language Model, but it requires additonal setups (e.g., huggingface `transformer` or `openai`).
+
+Instead of conversion to YML, you can also convert to JSON using:
+```python
+ReadTxtLocs("xxx.txt", scope="ABC")
+```
+
+For example, the above text file will be parsed as `{'key01: {'en': 'test1\ntest2', 'zh': '中文测例3\n中文测例4'}, 'ABC_key01': {'zh': '中文测例1\n中文测例2'}}`.
+
+### Conversion of dates
+
+Want to know how many days you need to set in `on_actions` for the event to happen at a specific date? Or you need to number of weeks for a focus?
+```python
+get_num_days("1001.06.01", "1001.12.01") // 7   # 26 weeks
+
+get_end_date("1002.12.01", 1298)                # 1006.06.21
+```
+
+Actually, when adding events, `hoi4dev` allows you to automatically set the dates in `on_actions`. We will specify how to use that in the `events` tutorial (Coming Soon).
+
+## Advanced Features
+
+See example scripts in `example_scripts/`. Those scripts may not all able to run as they lack project resource files, but can be useful to help you understand the `hoi4dev` mechanism and classical workflows. For example, consider example scripts in `PIHC_v_0_2_1_2024_10_06/`
+
+On the one hand, there are some useful little tools that can be created using `hoi4dev` in `scripts/*/`:
+
+For example `scripts/states_editor/szj.py` shows how you can batch change the owner of certain states by converting all state history files to JSON, modifying them, and save them back.
+
+`scripts/add_kitin_state_group_gui.py` batch creates a map GUI gfxs (results are in `scripts/region_gui/`). This rely on preprocessed map information by `scripts/C01_build_the_map.py`.
+
+`scripts/adv_gen/script.py` and `scripts/mil_gen/script.py` allow you generate a huge amount of political advisors and military generals with a single `.csv` file. You can create Chinese translation if all your mod developers are from Chinese, for example.
+
+...
+
+On the other hand, scripts starting with `scripts/CXX_....` demonstrates how a regular mod workflow runs. `v0.2.1.py` is the main thread, generating a mod from scratch (not able to run here due to lack of project resource files).
+
+## Demos
+
+We plan to share an end-to-end mod project built with the package in the near future. Stay tuned.
+
+## Frequent Issues
+
+### Windows Computer with non-UTF-8 characters / pyheaven running error with JSON files
+
+**This package is known to malfunction if you are running on Windows with non-UTF-8 characters. May be fixed in the future.**
+
+This error is usually occurred when operating JSON files containing Chinese. The error occurred due to version difference of `jsonlines`.
+
+Therefore, you may try to modify the dependency `pyheaven`:
+```python
+# In pyheaven/serialize_utils/py 3
+def SaveJson(obj, path, backend:Literal['json','jsonl','demjson','simplejson','jsonpickle']='json', indent:Optional[int]=None, append:bool=False, *args, **kwargs):
+    """Save an object as json (or jsonl) file.
+
+    Args:
+        obj: The object to be saved.
+        path: The save path.
+        backend (str): Specify backend for saving an object in json format. Please refer to function `BUILTIN_JSON_BACKENDS()` for built-in backends.
+        indent (int/None): The `indent` argument for saving in json format, only works if backend is not "jsonl".
+        append (bool): If True, use "a" mode instead of "w" mode, only works if backend is "jsonl".
+    Returns:
+        None
+    """
+    assert (backend in BUILTIN_JSON_BACKENDS()), (f"backend not found! Supported backends: {BUILTIN_JSON_BACKENDS()}")
+    CreateFile(path); path = p2s(path)
+    if backend=='jsonl':
+        assert (indent is None), ("'jsonl' format does not support parameter 'indent'!")
+        with jsonlines.open(path, "a" if append else "w", encoding='utf-8', errors='ignore') as f:
+            for data in obj:
+                f.write(data)
+    else:
+        assert (append is False), ("'json' format does not support parameter 'append'!")
+        module = globals()[backend]
+        with open(path, "w", encoding='utf-8', errors='ignore') as f:
+            if backend in ['json','simplejson']:
+                module.dump(obj, f, indent=indent, *args, **kwargs)
+            else:
+                f.write(module.dumps(obj, indent=indent, *args, **kwargs))
+```
+
+Remove or add `encoding='utf-8', errors='ignore'` depending on your error may solve this issue. You may also want to change `LoadJson` function in the same file. (If you find any convenient fix to this error, feel free to contact me or create a new issue to update `pyheaven`).

hoi4dev-0.1.0.3/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools >= 64"]
+build-backend = "setuptools.build_meta"

hoi4dev-0.1.0.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

hoi4dev-0.1.0.3/setup.py

@@ -0,0 +1,41 @@
+from setuptools import setup, find_packages
+
+import pathlib
+here = pathlib.Path(__file__).parent.resolve()
+version = '0.1.0.3'
+short_description = "HOI4DEV: Hearts of Iron IV Development Tools"
+long_description = (here / "README.md").read_text(encoding="utf-8")
+
+print(f"Installing HOI4DEV version: {version}.")
+setup(
+    name = "hoi4dev",
+    version = version,
+    author = "Magolor",
+    author_email = "magolorcz@gmail.com",
+    description = short_description,
+    long_description = long_description,
+    long_description_content_type="text/markdown",
+    url = "https://github.com/Magolor/",
+    project_urls={
+        "Author":"https://github.com/Magolor/",
+    },
+    python_requires=">=3.9, <4",
+    packages=find_packages(),
+    package_dir={"":"src"},
+    entry_points = '''
+        [console_scripts]
+        hoi4dev=hoi4dev.cli:cli
+    ''',
+    classifiers = [
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Build Tools",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Operating System :: MacOS :: MacOS X",
+        "Operating System :: Microsoft :: Windows",
+    ],
+    package_data={
+        'hoi4dev': ['resources/**/*'],
+    }
+)

hoi4dev-0.1.0.3/src/hoi4dev/__init__.py

@@ -0,0 +1,22 @@
+from .utils import *
+from .translation import *
+from .init import *
+from .maps import *
+from .ideologies import *
+from .ideas import *
+from .modifiers import *
+from .traits import *
+from .countries import *
+from .diplomacy import *
+from .characters import *
+from .equipments import *
+from .technologies import *
+from .divisions import *
+from .decisions import *
+from .focuses import *
+from .events import *
+from .bops import *
+from .intelligence_agencies import *
+from .achievements import *
+
+__version__ = "0.1.0.3"

hoi4dev-0.1.0.3/src/hoi4dev/achievements/__init__.py

@@ -0,0 +1,43 @@
+from ..utils import *
+from ..translation import AddLocalisation
+
+def AddAchievement(unique_id, path, translate=True):
+    '''
+    Add an achievement to the mod.
+    Args:
+        unique_id: str. The unique id of your entire mod.
+        path: str. The path of the resource files of the achievement. The resources should include the achievement icon, the achievement definition and the localisation.
+        translate: bool. Whether to translate the localisation of the achievement.
+    Return:
+        None
+    '''
+    tag = path.strip('/').split('/')[-1].upper()
+    file_name = f"custom_achievements_{unique_id}.json"
+    info = LoadJson(pjoin(path,"info.json"))
+    name = info.pop('name', None)
+    
+    # Add idea localisation
+    AddLocalisation(pjoin(path,"locs.txt"), scope=f"ACHIEVEMENT_{tag}", translate=translate)
+    
+    # Initialize achievement definition
+    Edit(F(pjoin("data","common","achievements",file_name)), {'unique_id': unique_id, f"ACHIEVEMENT_{tag}": info}, clear=False)
+    
+    # Add achievement icons
+    scales = get_mod_config('img_scales'); w, h = scales['achievement']
+    icon = ImageFind(pjoin(path,"default"))
+    if icon is None:
+        icon = ImageFind(F(pjoin("hoi4dev_settings", "imgs", "defaults", "default_achievement")), find_default=False)
+        assert (icon is not None), "The default achievement icon is not found!"
+    icon = ImageZoom(icon, w=w, h=h)
+    ImageSave(icon, F(pjoin("gfx","achievements",f"ACHIEVEMENT_{tag}")), format='dds')
+    
+    grey_icon = icon.clone()
+    grey_icon.type = "grayscale"
+    ImageSave(grey_icon, F(pjoin("gfx","achievements",f"ACHIEVEMENT_{tag}_grey")), format='dds')
+    
+    not_eligible_icon = icon.clone()
+    X = ImageFind(F(pjoin("hoi4dev_settings", "imgs", "defaults", "X")), find_default=False)
+    X = ImageZoom(X, w=int(w*0.9), h=int(h*0.9))
+    assert (icon is not None), "The default achievement not eligible icon is not found!"
+    not_eligible_icon.composite(X, gravity='center')
+    ImageSave(not_eligible_icon, F(pjoin("gfx","achievements",f"ACHIEVEMENT_{tag}_not_eligible")), format='dds')

hoi4dev-0.1.0.3/src/hoi4dev/bops/__init__.py

@@ -0,0 +1,61 @@
+from ..utils import *
+from ..translation import AddLocalisation
+
+def AddBoP(path, translate=True):
+    '''
+    Add a balance of power to the mod.
+    Args:
+        path: str. The path of the resource files of the bop. The resources should include the left side icon, right side icon, the bop definition and the localisation.
+        translate: bool. Whether to translate the localisation of the bop.
+    Return:
+        None
+    It is recommended to use 'sides' to define the sides of the bop, which is a dictionary mapping from the side name to the side. 'left' and 'right' are reserved for the left and right side of the bop.
+    Any side definition using 'side' instead of 'sides' will NOT be processed by this function.
+    '''
+    tag = path.strip('/').split('/')[-1].upper()
+    info = merge_dicts([{
+        'left_side': f'BOP_{tag}_LEFT_SIDE',
+        'right_side': f'BOP_{tag}_RIGHT_SIDE',
+        'initial_value': 0.0,
+    },LoadJson(pjoin(path,"info.json"))])
+    name = info.pop('name', None)
+    sides = info.pop('sides', list())
+    modifiers = info.pop('modifiers', list())
+    for s in sides:
+        S = s.upper()
+        sides[s] = merge_dicts([{
+            'id': f'BOP_{tag}_{S}_SIDE',
+            'icon': f'GFX_BOP_{tag}_{S}_SIDE',
+        },sides[s]])
+        for i, key in enumerate(dup_gen('range')):
+            if key in sides[s]:
+                sides[s][key] = merge_dicts([{
+                    'id': f'BOP_{tag}_{S}_SIDE_r{i}',
+                },sides[s][key]])
+            else:
+                break
+    for s in sides:
+        info[find_dup('side', info)] = sides[s]
+    
+    # Add bop localisation
+    AddLocalisation(pjoin(path,"locs.txt"), scope=f"BOP_{tag}", translate=translate)
+    
+    # Initialize bop definition
+    Edit(F(pjoin("data","common","bop",f"BOP_{tag}.json")), {f"BOP_{tag}": info})
+    
+    # Add bop modifiers
+    if modifiers: Edit(F(pjoin("data","common","modifiers",f"BOP_{tag}.json")), modifiers)
+    
+    # Add bop icons
+    scales = get_mod_config('img_scales'); w, h = scales['bop']
+    sprites = []
+    for s in sides:
+        S = s.upper()
+        icon = ImageFind(pjoin(path,"icons",s))
+        if icon is None:
+            icon = ImageFind(F(pjoin("hoi4dev_settings", "imgs", "default_bop")), find_default=False)
+            assert (icon is not None), "The default balance of power icon is not found!"
+        icon = ImageZoom(icon, w=w, h=h)
+        ImageSave(icon, F(pjoin("gfx","interface","bop",f"BOP_{tag}_{S}_SIDE")), format='dds')
+        sprites.append({'spriteType': {"name": f"GFX_BOP_{tag}_{S}_SIDE", "texturefile": pjoin("gfx","interface","bop",f"BOP_{tag}_{S}_SIDE.dds")}})
+    Edit(F(pjoin("data","interface","bop",f"BOP_{tag}.json")), {'spriteTypes': merge_dicts(sprites,d=True)})