Added markdownlint to Github CI

- Markdown will now be validated as part of Github CI
- Applied auto-fix to most common issues (mostly whitespace related)
- Fixed manually some of more complex cases

Some valid markdownlint rules are currently disabled, to avoid failing
CI, can be enabled in future

.github/ISSUE_TEMPLATE/bug_report.md

@@ -15,6 +15,7 @@ Please attach game logs: `VCMI_client.txt`, `VCMI_server.txt` etc.
 
 **To Reproduce**
 Steps to reproduce the behavior:
+
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
@@ -24,7 +25,7 @@ Steps to reproduce the behavior:
 A clear and concise description of what you expected to happen.
 
 **Actual behavior**
-A clear description what is currently happening 
+A clear description what is currently happening
 
 **Did it work earlier?**
 If this something which worked well some time ago, please let us know about version where it works or at date when it worked.
@@ -33,8 +34,9 @@ If this something which worked well some time ago, please let us know about vers
 If applicable, add screenshots to help explain your problem.
 
 **Version**
- - OS: [e.g. Windows, macOS Intel, macOS ARM, Android, Linux, iOS]
- - Version: [VCMI version]
+
+- OS: [e.g. Windows, macOS Intel, macOS ARM, Android, Linux, iOS]
+- Version: [VCMI version]
 
 **Additional context**
 Add any other context about the problem here.

.github/workflows/github.yml

@@ -402,3 +402,9 @@ jobs:
           run: |
             sudo apt install python3-jstyleson
             python3 CI/validate_json.py
+
+        - name: Validate Markdown
+          uses: DavidAnson/markdownlint-cli2-action@v18
+          with:
+            config: 'CI/example.markdownlint-cli2.jsonc'
+            globs: '**/*.md'

CI/example.markdownlint-cli2.jsonc

@@ -0,0 +1,280 @@
+{
+	"config" : {
+		"default" : true,
+
+		// MD001/heading-increment : Heading levels should only increment by one level at a time : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md001.md
+		"MD001": false,
+
+		// MD003/heading-style : Heading style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md003.md
+		"MD003": {
+			"style": "atx"
+		},
+
+		// MD004/ul-style : Unordered list style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md004.md
+		"MD004": false,
+		// FIXME: enable and consider fixing
+		//{
+		//	"style": "consistent"
+		//},
+
+		// MD005/list-indent : Inconsistent indentation for list items at the same level : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md005.md
+		"MD005": true,
+
+		// MD007/ul-indent : Unordered list indentation : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md007.md
+		"MD007": {
+			// Spaces for indent
+			"indent": 2,
+			// Whether to indent the first level of the list
+			"start_indented": false,
+			// Spaces for first level indent (when start_indented is set)
+			"start_indent": 0
+		},
+
+		// MD009/no-trailing-spaces : Trailing spaces : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md009.md
+		"MD009": {
+			// Spaces for line break
+			"br_spaces": 2,
+			// Allow spaces for empty lines in list items
+			"list_item_empty_lines": false,
+			// Include unnecessary breaks
+			"strict": false
+		},
+
+		// MD010/no-hard-tabs : Hard tabs : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md010.md
+		"MD010": {
+			// Include code blocks
+			"code_blocks": false,
+			// Fenced code languages to ignore
+			"ignore_code_languages": [],
+			// Number of spaces for each hard tab
+			"spaces_per_tab": 4
+		},
+		
+		// MD011/no-reversed-links : Reversed link syntax : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md011.md
+		"MD011": true,
+		
+		// MD012/no-multiple-blanks : Multiple consecutive blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md012.md
+		"MD012": {
+			// Consecutive blank lines
+			"maximum": 1
+		},
+
+		// MD013/line-length : Line length : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md013.md
+		"MD013": false,
+		
+		// MD014/commands-show-output : Dollar signs used before commands without showing output : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md014.md
+		"MD014": true,
+
+		// MD018/no-missing-space-atx : No space after hash on atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md018.md
+		"MD018": true,
+
+		// MD019/no-multiple-space-atx : Multiple spaces after hash on atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md019.md
+		"MD019": true,
+
+		// MD020/no-missing-space-closed-atx : No space inside hashes on closed atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md020.md
+		"MD020": true,
+
+		// MD021/no-multiple-space-closed-atx : Multiple spaces inside hashes on closed atx style heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md021.md
+		"MD021": true,
+
+		// MD022/blanks-around-headings : Headings should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md022.md
+		"MD022": {
+			// Blank lines above heading
+			"lines_above": 1,
+			// Blank lines below heading
+			"lines_below": 1
+		},
+
+		// MD023/heading-start-left : Headings must start at the beginning of the line : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md023.md
+		"MD023": true,
+
+		// MD024/no-duplicate-heading : Multiple headings with the same content : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md024.md
+		"MD024": false,
+		// FIXME: false positives?
+		//{
+		//	// Only check sibling headings
+		//	"allow_different_nesting": true,
+		//	// Only check sibling headings
+		//	"siblings_only": true
+		//},
+
+		// MD025/single-title/single-h1 : Multiple top-level headings in the same document : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md025.md
+		"MD025": {
+			// Heading level
+			"level": 1,
+			// RegExp for matching title in front matter
+			"front_matter_title": "^\\s*title\\s*[:=]"
+		},
+
+		// MD026/no-trailing-punctuation : Trailing punctuation in heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md026.md
+		"MD026": {
+			// Punctuation characters
+			"punctuation": ".,;:!。，；：！"
+		},
+
+		// MD027/no-multiple-space-blockquote : Multiple spaces after blockquote symbol : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md027.md
+		"MD027": true,
+
+		// MD028/no-blanks-blockquote : Blank line inside blockquote : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md028.md
+		"MD028": true,
+
+		// MD029/ol-prefix : Ordered list item prefix : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md029.md
+		"MD029": false,
+		// FIXME: false positives or broken formatting
+		//{
+		//	// List style
+		//	"style": "ordered"
+		//},
+
+		// MD030/list-marker-space : Spaces after list markers : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md030.md
+		"MD030": {
+			// Spaces for single-line unordered list items
+			"ul_single": 1,
+			// Spaces for single-line ordered list items
+			"ol_single": 1,
+			// Spaces for multi-line unordered list items
+			"ul_multi": 1,
+			// Spaces for multi-line ordered list items
+			"ol_multi": 1
+		},
+
+		// MD031/blanks-around-fences : Fenced code blocks should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md031.md
+		"MD031": {
+			// Include list items
+			"list_items": false
+		},
+
+		// MD032/blanks-around-lists : Lists should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md032.md
+		"MD032": true,
+
+		// MD033/no-inline-html : Inline HTML : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md033.md
+		"MD033": false,
+		// FIXME: enable and consider fixing
+		//{
+		//	// Allowed elements
+		//	"allowed_elements": []
+		//},
+
+		// MD034/no-bare-urls : Bare URL used : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md034.md
+		"MD034": true,
+
+		// MD035/hr-style : Horizontal rule style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md035.md
+		"MD035": {
+			// Horizontal rule style
+			"style": "consistent"
+		},
+
+		// MD036/no-emphasis-as-heading : Emphasis used instead of a heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md036.md
+		"MD036": false,
+		// FIXME: enable and consider fixing
+		// {
+		// 	// Punctuation characters
+		// 	"punctuation": ".,;:!?。，；：！？"
+		// },
+
+		// MD037/no-space-in-emphasis : Spaces inside emphasis markers : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md037.md
+		"MD037": true,
+
+		// MD038/no-space-in-code : Spaces inside code span elements : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md038.md
+		"MD038": true,
+
+		// MD039/no-space-in-links : Spaces inside link text : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md039.md
+		"MD039": true,
+
+		// MD040/fenced-code-language : Fenced code blocks should have a language specified : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md040.md
+		"MD040": false,
+		// FIXME: enable and consider fixing
+		//{
+		//// List of languages
+		//	"allowed_languages": [ "cpp", "json", "jsonc", "json5", "sh" ],
+		//// Require language only
+		//	"language_only": true
+		//},
+
+		// MD041/first-line-heading/first-line-h1 : First line in a file should be a top-level heading : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md041.md
+		"MD041": {
+			// Heading level
+			"level": 1,
+			// RegExp for matching title in front matter
+			"front_matter_title": "^\\s*title\\s*[:=]"
+		},
+
+		// MD042/no-empty-links : No empty links : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md042.md
+		"MD042": true,
+
+		// MD043/required-headings : Required heading structure : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md043.md
+		"MD043": false,
+
+		// MD044/proper-names : Proper names should have the correct capitalization : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md044.md
+		"MD044": false,
+
+		// MD045/no-alt-text : Images should have alternate text (alt text) : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md045.md
+		"MD045": false,
+
+		// MD046/code-block-style : Code block style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md046.md
+		"MD046": {
+			// Block style
+			"style": "fenced"
+		},
+
+		// MD047/single-trailing-newline : Files should end with a single newline character : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md047.md
+		"MD047": true,
+		
+		// MD048/code-fence-style : Code fence style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md048.md
+		"MD048": {
+			// Code fence style
+			"style": "backtick"
+		},
+
+		// MD049/emphasis-style : Emphasis style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md049.md
+		"MD049": {
+			// Emphasis style
+			"style": "asterisk"
+		},
+
+		// MD050/strong-style : Strong style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md050.md
+		"MD050": {
+			// Strong style
+			"style": "asterisk"
+		},
+		
+
+
+		// MD051/link-fragments : Link fragments should be valid : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md051.md
+		"MD051": true,
+
+		// MD052/reference-links-images : Reference links and images should use a label that is defined : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md052.md
+		"MD052": {
+			// Include shortcut syntax
+			"shortcut_syntax": false
+		},
+
+		// MD053/link-image-reference-definitions : Link and image reference definitions should be needed : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md053.md
+		"MD053": {
+			// Ignored definitions
+			"ignored_definitions": [
+			  "//"
+			]
+		},
+
+		// MD054/link-image-style : Link and image style : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md054.md
+		"MD054": {
+			// Allow autolinks
+			"autolink": true,
+			// Allow inline links and images
+			"inline": true,
+			// Allow full reference links and images
+			"full": true,
+			// Allow collapsed reference links and images
+			"collapsed": true,
+			// Allow shortcut reference links and images
+			"shortcut": true,
+			// Allow URLs as inline links
+			"url_inline": true
+		},
+		
+		// MD058 - Tables should be surrounded by blank lines
+		"MD058" : true
+
+	}
+}

docs/Readme.md

@@ -1,11 +1,11 @@
+# VCMI Project
+
 [![VCMI](https://github.com/vcmi/vcmi/actions/workflows/github.yml/badge.svg?branch=develop&event=push)](https://github.com/vcmi/vcmi/actions/workflows/github.yml?query=branch%3Adevelop+event%3Apush)
 [![Github Downloads](https://img.shields.io/github/downloads/vcmi/vcmi/1.5.0/total)](https://github.com/vcmi/vcmi/releases/tag/1.5.0)
 [![Github Downloads](https://img.shields.io/github/downloads/vcmi/vcmi/1.5.6/total)](https://github.com/vcmi/vcmi/releases/tag/1.5.6)
 [![Github Downloads](https://img.shields.io/github/downloads/vcmi/vcmi/1.5.7/total)](https://github.com/vcmi/vcmi/releases/tag/1.5.7)
 [![Github Downloads](https://img.shields.io/github/downloads/vcmi/vcmi/total)](https://github.com/vcmi/vcmi/releases)
 
-# VCMI Project
-
 VCMI is an open-source recreation of Heroes of Might & Magic III engine, giving it new and extended possibilities.
 
 <p>
@@ -15,14 +15,13 @@ VCMI is an open-source recreation of Heroes of Might & Magic III engine, giving
   <img src="https://github.com/vcmi/VCMI.eu/blob/master/static/img/screenshots/1.4.0/Quick%20Hero%20Select%20Bastion.jpg?raw=true" alt="New widget for Hero selection, featuring Pavillon Town" style="height:120px;"/>
 </p>
 
-
 ## Links
 
- * Homepage:   https://vcmi.eu/
- * Forums:     https://forum.vcmi.eu/
- * Bugtracker: https://github.com/vcmi/vcmi/issues
- * Discord:    https://discord.gg/chBT42V
- * GPT Store:  https://chat.openai.com/g/g-1kNhX0mlO-vcmi-assistant
+* Homepage:   <https://vcmi.eu/>
+* Forums:     <https://forum.vcmi.eu/>
+* Bugtracker: <https://github.com/vcmi/vcmi/issues>
+* Discord:    <https://discord.gg/chBT42V>
+* GPT Store:  <https://chat.openai.com/g/g-1kNhX0mlO-vcmi-assistant>
 
 ## Latest release
 
@@ -31,6 +30,7 @@ Loading saves made with different major version of VCMI is usually **not** suppo
 Please see corresponding installation guide articles for details for your platform.  
 
 ## Installation guides
+
 - [Windows](players/Installation_Windows.md)
 - [macOS](players/Installation_macOS.md)
 - [Linux](players/Installation_Linux.md)
@@ -70,6 +70,7 @@ See also installation guide for [Heroes Chronicles](players/Heroes_Chronicles.md
 ## Documentation and guidelines for developers
 
 Development environment setup instructions:
+
 - [Building VCMI for Android](developers/Building_Android.md)
 - [Building VCMI for iOS](developers/Building_iOS.md)
 - [Building VCMI for Linux](developers/Building_Linux.md)
@@ -78,6 +79,7 @@ Development environment setup instructions:
 - [Conan](developers/Conan.md)
 
 Engine documentation: (NOTE: may be outdated)
+
 - [Development with Qt Creator](developers/Development_with_Qt_Creator.md)
 - [Coding Guidelines](developers/Coding_Guidelines.md)
 - [Bonus System](developers/Bonus_System.md)
@@ -95,6 +97,6 @@ Engine documentation: (NOTE: may be outdated)
 ## Copyright and license
 
 VCMI Project source code is licensed under GPL version 2 or later.
-VCMI Project assets are licensed under CC-BY-SA 4.0. Assets sources and information about contributors are available under following link: https://github.com/vcmi/vcmi-assets
+VCMI Project assets are licensed under CC-BY-SA 4.0. Assets sources and information about contributors are available under following link: <https://github.com/vcmi/vcmi-assets>
 
 Copyright (C) 2007-2024  VCMI Team (check AUTHORS file for the contributors list)

docs/developers/AI.md

@@ -6,12 +6,13 @@ There are two types of AI: adventure and battle.
 **Battle AIs** are responsible for fighting, i.e. moving stacks on the battlefield  
 
 We have 3 battle AIs so far:
+
 * BattleAI - strongest
 * StupidAI - for neutrals, should be simple so that experienced players can abuse it
 * Empty AI - should do nothing at all. If needed another battle AI can be introduced.  
 
-Each battle AI consist of a few classes, but the main class, kind of entry point usually has the same name as the package itself. In BattleAI it is the BattleAI class. It implements some battle specific interface, do not remember. Main method there is activeStack(battle::Unit* stack). It is invoked by the system when it's time to move your stack. The thing you use to interact with the game and receive the gamestate is usually referenced in the code as cb. CPlayerSpecificCallback it should be. It has a lot of methods and can do anything. For instance it has battleGetUnitsIf(), which returns all units on the battlefield matching some lambda condition.
-Each side in a battle is represented by an CArmedInstance object. CHeroInstance and CGDwelling, CGMonster and more are subclasses of CArmedInstance. CArmedInstance contains a set of stacks. When the battle starts, these stacks are converted to battle stacks. Usually Battle AIs reference them using the interface battle::Unit *.
+Each battle AI consist of a few classes, but the main class, kind of entry point usually has the same name as the package itself. In BattleAI it is the BattleAI class. It implements some battle specific interface, do not remember. Main method there is activeStack(battle::Unit*stack). It is invoked by the system when it's time to move your stack. The thing you use to interact with the game and receive the gamestate is usually referenced in the code as cb. CPlayerSpecificCallback it should be. It has a lot of methods and can do anything. For instance it has battleGetUnitsIf(), which returns all units on the battlefield matching some lambda condition.
+Each side in a battle is represented by an CArmedInstance object. CHeroInstance and CGDwelling, CGMonster and more are subclasses of CArmedInstance. CArmedInstance contains a set of stacks. When the battle starts, these stacks are converted to battle stacks. Usually Battle AIs reference them using the interface battle::Unit*.
 Units have bonuses. Nearly everything aspect of a unit is configured in the form of bonuses. Attack, defense, health, retaliation, shooter or not, initial count of shots and so on.
 When you call unit->getAttack() it summarizes all these bonuses and returns the resulting value.  
 
@@ -38,17 +39,20 @@ BattleAI itself handles all the rest and issues actual commands
 Adventure AI responsible for moving heroes on map, gathering things, developing town. Main idea is to gather all possible tasks on map, prioritize them and select the best one for each heroes. Initially was a fork of VCAI
 
 ### Parts
+
 Gateway - a callback for server used to invoke AI actions when server thinks it is time to do something. Through this callback AI is informed about various events like hero level up, tile revialed, blocking dialogs and so on. In order to do this Gaateway implements specific interface. The interface is exactly the same for human and AI
 Another important actor for server interaction is CCallback * cb. This one is used to retrieve gamestate information and ask server to do things like hero moving, spell casting and so on. Each AI has own instance of Gateway and it is a root object which holds all AI state. Gateway has an event method yourTurn which invokes makeTurn in another thread. The last passes control to Nullkiller engine.
 
 Nullkiller engine - place where actual AI logic is organized. It contains a main loop for gathering and prioritizing things. Its algorithm:
+
 * reset AI state, it avoids keeping some memory about the game in general to reduce amount of things serialized into savefile state. The only serialized things are in nullkiller->memory. This helps reducing save incompatibility. It should be mostly enough for AI to analyze data avaialble in CCallback
 * main loop, loop iteration is called a pass
-** update AI state, some state is lazy and updates once per day to avoid performance hit, some state is recalculated each loop iteration. At this stage analysers and pathfidner work
+**update AI state, some state is lazy and updates once per day to avoid performance hit, some state is recalculated each loop iteration. At this stage analysers and pathfidner work
 ** gathering goals, prioritizing and decomposing them
 ** execute selected best goals
 
 Analyzer - a module gathering data from CCallback *. Its goal to make some statistics and avoid making any significant decissions.
+
 * HeroAnalyser - decides upong which hero suits better to be main (army carrier and fighter) and which is better to be a scout (gathering unguarded resources, exploring)
 * BuildAnalyzer - prepares information on what we can build in our towns, and what resources we need to do this
 * DangerHitMapAnalyser - checks if enemy hero can rich each tile, how fast and what is their army strangth
@@ -61,9 +65,11 @@ Analyzer - a module gathering data from CCallback *. Its goal to make some stati
 * PriorityEvaluator - gathers information on task rewards, evaluates their priority using Fuzzy Light library (fuzzy logic)
 
 ### Goals
+
 Units of activity in AI. Can be AbstractGoal, Task, Marker and Behavior
 
 Task - simple thing which can be done right away in order to gain some reward. Or a composition of simple things in case if more than one action is needed to gain the reward.
+
 * AdventureSpellCast - town portal, water walk, air walk, summon boat
 * BuildBoat - builds a boat in a specific shipyard
 * BuildThis - builds a building in a specified town
@@ -78,6 +84,7 @@ Task - simple thing which can be done right away in order to gain some reward. O
 * StayAtTown - stay at town for the rest of the day (to regain mana)
 
 Behavior - a core game activity
+
 * CaptureObjectsBehavior - generally it is about visiting map objects which give reward. It can capture any object, even those which are behind monsters and so on. But due to performance considerations it is not allowed to handle monsters and quests now.
 * ClusterBehavior - uses information of ObjectClusterizer to unblock objects hidden behind various blockers. It kills guards, completes quests, captures garrisons.
 * BuildingBehavior - develops our towns
@@ -89,6 +96,7 @@ Behavior - a core game activity
 * DefenceBehavior - defend towns by eliminating treatening heroes or hiding in town garrison
 
 AbstractGoal - some goals can not be completed because it is not clear how to do this. They express desire to do something, not exact plan. DeepDecomposer is used to refine such goals until they are turned into such plan or discarded. Some examples:
+
 * CaptureObject - you need to visit some object (flag a shipyard for instance) but do not know how
 * CompleteQuest - you need to bypass bordergate or borderguard or questguard but do not know how
 AbstractGoal usually comes in form of composition with some elementar task blocked by abstract objective. For instance CaptureObject(Shipyard), ExecuteHeroChain(visit x, build boat, visit enemy town). When such composition is decomposed it can turn into either a pair of herochains or into another abstract composition if path to shipyard is also blocked with something.

docs/developers/Bonus_System.md

@@ -6,8 +6,8 @@ The bonus system of VCMI is a set of mechanisms that make handling of different
 
 Each bonus originates from some node in the bonus system, and may have propagator and limiter objects attached to it. Bonuses are shared around as follows:
 
-1.  Bonuses with propagator are propagated to "matching" descendants in the red DAG - which descendants match is determined by the propagator. Bonuses without a propagator will not be propagated. 
-2.  Bonuses without limiters are inherited by all descendants in the black DAG. If limiters are present, they can restrict inheritance to certain nodes.
+1. Bonuses with propagator are propagated to "matching" descendants in the red DAG - which descendants match is determined by the propagator. Bonuses without a propagator will not be propagated.
+2. Bonuses without limiters are inherited by all descendants in the black DAG. If limiters are present, they can restrict inheritance to certain nodes.
 
 Inheritance is the default means of sharing bonuses. A typical example is an artefact granting a bonus to attack/defense stat, which is inherited by the hero wearing it, and then by creatures in the hero's army.
 A common limiter is by creature - e.g. the hero Eric has a specialty that grants bonuses to attack, defense and speed, but only to griffins.
@@ -15,9 +15,9 @@ Propagation is used when bonuses need to be shared in a different direction than
 
 ### Technical Details
 
--   Propagation is done by copying bonuses to the target nodes. This happens when bonuses are added.
--   Inheritance is done on-the-fly when needed, by traversing the black DAG. Results are cached to improve performance.
--   Whenever a node changes (e.g. bonus added), a global counter gets increased which is used to check whether cached results are still current.
+- Propagation is done by copying bonuses to the target nodes. This happens when bonuses are added.
+- Inheritance is done on-the-fly when needed, by traversing the black DAG. Results are cached to improve performance.
+- Whenever a node changes (e.g. bonus added), a global counter gets increased which is used to check whether cached results are still current.
 
 ## Operations on the graph
 
@@ -26,6 +26,7 @@ There are two basic types of operations that can be performed on the graph:
 ### Adding a new node
 
 When node is attached to a new black parent (the only possibility - adding parent is the same as adding a child to it), the propagation system is triggered and works as follows:
+
 - For the attached node and its all red ancestors
 - For every bonus
 - Call propagator giving the new descendant - then attach appropriately bonuses to the red descendant of attached node (or the node itself).
@@ -54,7 +55,7 @@ Updaters are objects attached to bonuses. They can modify a bonus (typically by
 
 The following example shows an artifact providing a bonus based on the level of the hero that wears it:
 
-```javascript
+```jsonc
    "core:greaterGnollsFlail":
    {
        "text" : { "description" : "This mighty flail increases the attack of all gnolls under the hero's command by twice the hero's level." },

docs/developers/Building_Android.md

@@ -1,26 +1,26 @@
 # Building Android
 
-The following instructions apply to **v1.2 and later**. For earlier versions the best documentation is https://github.com/vcmi/vcmi-android/blob/master/building.txt (and reading scripts in that repo), however very limited to no support will be provided from our side if you wish to go down that rabbit hole.
+The following instructions apply to **v1.2 and later**. For earlier versions the best documentation is <https://github.com/vcmi/vcmi-android/blob/master/building.txt> (and reading scripts in that repo), however very limited to no support will be provided from our side if you wish to go down that rabbit hole.
 
 *Note*: building has been tested only on Linux and macOS. It may or may not work on Windows out of the box.
 
 ## Requirements
 
-1. CMake 3.20+: download from your package manager or from https://cmake.org/download/
+1. CMake 3.20+: download from your package manager or from <https://cmake.org/download/>
 2. JDK 11, not necessarily from Oracle
-3. Android command line tools or Android Studio for your OS: https://developer.android.com/studio/
+3. Android command line tools or Android Studio for your OS: <https://developer.android.com/studio/>
 4. Android NDK version **r25c (25.2.9519653)**, there're multiple ways to obtain it:
     - install with Android Studio
     - install with `sdkmanager` command line tool
-    - download from https://developer.android.com/ndk/downloads
+    - download from <https://developer.android.com/ndk/downloads>
     - download with Conan, see [#NDK and Conan](#ndk-and-conan)
 5. Optional:
-    - Ninja: download from your package manager or from https://github.com/ninja-build/ninja/releases
-    - Ccache: download from your package manager or from https://github.com/ccache/ccache/releases
+    - Ninja: download from your package manager or from <https://github.com/ninja-build/ninja/releases>
+    - Ccache: download from your package manager or from <https://github.com/ccache/ccache/releases>
 
 ## Obtaining source code
 
-Clone https://github.com/vcmi/vcmi with submodules. Example for command line:
+Clone <https://github.com/vcmi/vcmi> with submodules. Example for command line:
 
 ```
 git clone --recurse-submodules https://github.com/vcmi/vcmi.git
@@ -31,6 +31,7 @@ git clone --recurse-submodules https://github.com/vcmi/vcmi.git
 We use Conan package manager to build/consume dependencies, find detailed usage instructions [here](./Conan.md). Note that the link points to the state of the current branch, for the latest release check the same document in the [master branch](https://github.com/vcmi/vcmi/blob/master/docs/developers/Сonan.md).
 
 On the step where you need to replace **PROFILE**, choose:
+
 - `android-32` to build for 32-bit architecture (armeabi-v7a)
 - `android-64` to build for 64-bit architecture (aarch64-v8a)
 
@@ -38,7 +39,7 @@ On the step where you need to replace **PROFILE**, choose:
 
 Conan must be aware of the NDK location when you execute `conan install`. There're multiple ways to achieve that as written in the [Conan docs](https://docs.conan.io/1/integrations/cross_platform/android.html):
 
-- the easiest is to download NDK from Conan (option 1 in the docs), then all the magic happens automatically. On the step where you need to replace **PROFILE**, choose _android-**X**-ndk_ where _**X**_ is either `32` or `64`.
+- the easiest is to download NDK from Conan (option 1 in the docs), then all the magic happens automatically. On the step where you need to replace **PROFILE**, choose *android-**X**-ndk* where ***X*** is either `32` or `64`.
 - to use an already installed NDK, you can simply pass it on the command line to `conan install`: (note that this will work only when consuming the pre-built binaries)
 
 ```

docs/developers/Building_Linux.md

@@ -11,15 +11,15 @@ Older distributions and compilers might work, but they aren't tested by Github C
 
 To compile, the following packages (and their development counterparts) are needed to build:
 
--   CMake
--   SDL2 with devel packages: mixer, image, ttf
--   zlib and zlib-devel
--   Boost C++ libraries v1.48+: program-options, filesystem, system, thread, locale
--   Recommended, if you want to build launcher or map editor: Qt 5, widget and network modules
--   Recommended, FFmpeg libraries, if you want to watch in-game videos: libavformat and libswscale. Their name could be libavformat-devel and libswscale-devel, or ffmpeg-libs-devel or similar names. 
--   Optional:
-    - if you want to build scripting modules: LuaJIT
-    - to speed up recompilation: Ccache
+- CMake
+- SDL2 with devel packages: mixer, image, ttf
+- zlib and zlib-devel
+- Boost C++ libraries v1.48+: program-options, filesystem, system, thread, locale
+- Recommended, if you want to build launcher or map editor: Qt 5, widget and network modules
+- Recommended, FFmpeg libraries, if you want to watch in-game videos: libavformat and libswscale. Their name could be libavformat-devel and libswscale-devel, or ffmpeg-libs-devel or similar names.
+- Optional:
+  - if you want to build scripting modules: LuaJIT
+  - to speed up recompilation: Ccache
 
 ### On Debian-based systems (e.g. Ubuntu)
 
@@ -41,7 +41,7 @@ NOTE: `fuzzylite-devel` package is no longer available in recent version of Fedo
 
 On Arch-based distributions, there is a development package available for VCMI on the AUR.
 
-It can be found at https://aur.archlinux.org/packages/vcmi-git/
+It can be found at <https://aur.archlinux.org/packages/vcmi-git/>
 
 Information about building packages from the Arch User Repository (AUR) can be found at the Arch wiki.
 
@@ -109,9 +109,9 @@ This will generate `vcmiclient`, `vcmiserver`, `vcmilauncher` as well as .so lib
 
 ### RPM package
 
-The first step is to prepare a RPM build environment. On Fedora systems you can follow this guide: http://fedoraproject.org/wiki/How_to_create_an_RPM_package#SPEC_file_overview
+The first step is to prepare a RPM build environment. On Fedora systems you can follow this guide: <http://fedoraproject.org/wiki/How_to_create_an_RPM_package#SPEC_file_overview>
 
-0. Enable RPMFusion free repo to access to ffmpeg libs:
+1. Enable RPMFusion free repo to access to ffmpeg libs:
 
 ```sh
 sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
@@ -120,33 +120,34 @@ sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-rele
 > [!NOTE]
 > The stock ffmpeg from Fedora repo is no good as it lacks a lots of codecs
 
-1. Perform a git clone from a tagged branch for the right Fedora version from https://github.com/rpmfusion/vcmi; for example for Fedora 38: <pre>git clone -b f38 --single-branch https://github.com/rpmfusion/vcmi.git</pre>
+2. Perform a git clone from a tagged branch for the right Fedora version from <https://github.com/rpmfusion/vcmi>; for example for Fedora 38: <pre>git clone -b f38 --single-branch https://github.com/rpmfusion/vcmi.git</pre>
 
-2. Copy all files to ~/rpmbuild/SPECS with command: <pre>cp vcmi/*  ~/rpmbuild/SPECS</pre>
+3. Copy all files to ~/rpmbuild/SPECS with command: <pre>cp vcmi/*  ~/rpmbuild/SPECS</pre>
 
-3. Fetch all sources by using spectool:
+4. Fetch all sources by using spectool:
 
 ```sh
 sudo dnf install rpmdevtools
 spectool -g -R ~/rpmbuild/SPECS/vcmi.spec
 ```
 
-4. Fetch all dependencies required to build the RPM:
+5. Fetch all dependencies required to build the RPM:
 
 ```sh
 sudo dnf install dnf-plugins-core
 sudo dnf builddep ~/rpmbuild/SPECS/vcmi.spec
 ```
 
-4. Go to ~/rpmbuild/SPECS and open terminal in this folder and type: 
+6. Go to ~/rpmbuild/SPECS and open terminal in this folder and type:
+
 ```sh
 rpmbuild -ba ~/rpmbuild/SPECS/vcmi.spec
 ```
 
-5. Generated RPM is in folder ~/rpmbuild/RPMS
+7. Generated RPM is in folder ~/rpmbuild/RPMS
 
 If you want to package the generated RPM above for different processor architectures and operating systems you can use the tool mock.
-Moreover, it is necessary to install mock-rpmfusion_free due to the packages ffmpeg-devel and ffmpeg-libs which aren't available in the standard RPM repositories(at least for Fedora). Go to ~/rpmbuild/SRPMS in terminal and type: 
+Moreover, it is necessary to install mock-rpmfusion_free due to the packages ffmpeg-devel and ffmpeg-libs which aren't available in the standard RPM repositories(at least for Fedora). Go to ~/rpmbuild/SRPMS in terminal and type:
 
 ```sh
 mock -r fedora-38-aarch64-rpmfusion_free path_to_source_RPM

docs/developers/Building_Windows.md

@@ -12,8 +12,8 @@ Windows builds can be made in more than one way and with more than one tool. Thi
 - CMake [download link](https://cmake.org/download/). During install after accepting license agreement make sure to check "Add CMake to the system PATH for all users".
 - To unpack pre-build Vcpkg: [7-zip](http://www.7-zip.org/download.html)
 - Optional:
-    - To create installer: [NSIS](http://nsis.sourceforge.net/Main_Page)
-    - To speed up recompilation: [CCache](https://github.com/ccache/ccache/releases)
+  - To create installer: [NSIS](http://nsis.sourceforge.net/Main_Page)
+  - To speed up recompilation: [CCache](https://github.com/ccache/ccache/releases)
 
 ### Choose an installation directory
 
@@ -21,12 +21,14 @@ Create a directory for VCMI development, eg. `C:\VCMI` We will call this directo
 
 Warning! Replace `%VCMI_DIR%` with path you've chosen for VCMI installation in the following commands.
 
-It is recommended to avoid non-ascii characters in the path to your working folders. The folder should not be write-protected by system.   
+It is recommended to avoid non-ascii characters in the path to your working folders. The folder should not be write-protected by system.
 
 Good locations:
+
 - `C:\VCMI`
 
 Bad locations:
+
 - `C:\Users\Michał\VCMI (non-ascii character)`
 - `C:\Program Files (x86)\VCMI (write protection)`
 
@@ -38,13 +40,14 @@ You have two options: to use pre-built libraries or build your own. We strongly
 
 #### Download and unpack archive
 
-Vcpkg Archives are available at our GitHub: https://github.com/vcmi/vcmi-deps-windows/releases
+Vcpkg Archives are available at our GitHub: <https://github.com/vcmi/vcmi-deps-windows/releases>
 
 - Download latest version available.
 EG: v1.6 assets - [vcpkg-export-x64-windows-v143.7z](https://github.com/vcmi/vcmi-deps-windows/releases/download/v1.6/vcpkg-export-x64-windows-v143.7z)  
 - Extract archive by right clicking on it and choosing "7-zip -> Extract Here".
 
 #### Move dependencies to target directory
+
 Once extracted, a `vcpkg` directory will appear with `installed` and `scripts` subfolders inside.
 Move extracted `vcpkg` directory into your `%VCMI_DIR%`
 
@@ -57,19 +60,19 @@ Be aware that building Vcpkg might take a lot of time depend on your CPU model a
 
 #### Clone vcpkg
 
-1.  open SourceTree
-2.  File -\> Clone
-3.  select **<https://github.com/microsoft/vcpkg/>** as source
-4.  select **%VCMI_DIR%/vcpkg** as destination
-5.  click **Clone**
+1. open SourceTree
+2. File -\> Clone
+3. select **<https://github.com/microsoft/vcpkg/>** as source
+4. select **%VCMI_DIR%/vcpkg** as destination
+5. click **Clone**
 
 From command line use:
 
-    git clone https://github.com/microsoft/vcpkg.git %VCMI_DIR%/vcpkg
+`git clone https://github.com/microsoft/vcpkg.git %VCMI_DIR%/vcpkg`
 
 #### Build vcpkg and dependencies
 
-- Run 
+- Run
 `%VCMI_DIR%/vcpkg/bootstrap-vcpkg.bat`
 - For 32-bit build run:
 `%VCMI_DIR%/vcpkg/vcpkg.exe install tbb:x64-windows fuzzylite:x64-windows sdl2:x64-windows sdl2-image:x64-windows sdl2-ttf:x64-windows sdl2-mixer[mpg123]:x64-windows boost:x64-windows qt5-base:x64-windows ffmpeg:x64-windows luajit:x64-windows`
@@ -85,6 +88,7 @@ Extract `ccache` to a folder of your choosing, add the folder to the `PATH` envi
 ## Build VCMI
 
 #### From GIT GUI
+
 - Open SourceTree
 - File -> Clone
 - select `https://github.com/vcmi/vcmi/` as source
@@ -94,26 +98,30 @@ Extract `ccache` to a folder of your choosing, add the folder to the `PATH` envi
 - click Clone
 
 #### From command line  
+
 - `git clone --recursive https://github.com/vcmi/vcmi.git %VCMI_DIR%/source`  
 
 ### Generate solution for VCMI  
+
 - Create `%VCMI_DIR%/build` folder  
 - Open a command line prompt at `%VCMI_DIR%/build`  
-- Execute `cd %VCMI_DIR%/build`    
+- Execute `cd %VCMI_DIR%/build`
 - Create solution (Visual Studio 2022 64-bit) `cmake %VCMI_DIR%/source -DCMAKE_TOOLCHAIN_FILE=%VCMI_DIR%/vcpkg/scripts/buildsystems/vcpkg.cmake -G "Visual Studio 17 2022" -A x64`
 
 ### Compile VCMI with Visual Studio
+
 - Open `%VCMI_DIR%/build/VCMI.sln` in Visual Studio
 - Select `Release` build type in the combobox
 - If you want to use ccache:
-    - Select `Manage Configurations...` in the combobox
-    - Specify the following CMake variable: `ENABLE_CCACHE=ON`
-    - See the [Visual Studio documentation](https://learn.microsoft.com/en-us/cpp/build/customize-cmake-settings?view=msvc-170#cmake-variables-and-cache) for details
+  - Select `Manage Configurations...` in the combobox
+  - Specify the following CMake variable: `ENABLE_CCACHE=ON`
+  - See the [Visual Studio documentation](https://learn.microsoft.com/en-us/cpp/build/customize-cmake-settings?view=msvc-170#cmake-variables-and-cache) for details
 - Right click on `BUILD_ALL` project. This `BUILD_ALL` project should be in `CMakePredefinedTargets` tree in Solution Explorer.
 - VCMI will be built in `%VCMI_DIR%/build/bin` folder!
 
 ### Compile VCMI with MinGW via MSYS2
-- Install MSYS2 from https://www.msys2.org/
+
+- Install MSYS2 from <https://www.msys2.org/>
 - Start the `MSYS MinGW x64`-shell
 - Install dependencies: `pacman -S mingw-w64-x86_64-SDL2 mingw-w64-x86_64-SDL2_image mingw-w64-x86_64-SDL2_mixer mingw-w64-x86_64-SDL2_ttf mingw-w64-x86_64-boost mingw-w64-x86_64-gcc mingw-w64-x86_64-ninja mingw-w64-x86_64-qt5-static mingw-w64-x86_64-qt5-tools mingw-w64-x86_64-tbb`
 - Generate and build solution from VCMI-root dir: `cmake --preset windows-mingw-release && cmake --build --preset windows-mingw-release`
@@ -134,8 +142,10 @@ Vcpkg might be very unstable due to limited popularity and fact of using bleedin
 
 Pre-built version we provide is always manually tested with all supported versions of MSVC for both Release and Debug builds and all known quirks are listed below.
 
-#$# Build is successful but can not start new game
+### Build is successful but can not start new game
+
 Make sure you have:
+
 * Installed Heroes III from disk or using GOG installer
 * Copied `Data`, `Maps` and `Mp3` folders from Heroes III to: `%USERPROFILE%\Documents\My Games\vcmi\`
 

docs/developers/Building_iOS.md

@@ -6,7 +6,8 @@
 2. Xcode: <https://developer.apple.com/xcode/>
 3. CMake 3.21+: `brew install --cask cmake` or get from <https://cmake.org/download/>
 4. Optional:
-  - CCache to speed up recompilation: `brew install ccache`
+
+- CCache to speed up recompilation: `brew install ccache`
 
 ## Obtaining source code
 

docs/developers/Building_macOS.md

@@ -91,7 +91,7 @@ Open `VCMI.xcodeproj` from the build directory, select `vcmiclient` scheme and h
 
 ## Packaging project into DMG file
 
-After building, run `cpack` from the build directory. If using Xcode generator, also pass `-C `<configuration name> with the same configuration that you used to build the project.
+After building, run `cpack` from the build directory. If using Xcode generator, also pass `-C`<configuration name> with the same configuration that you used to build the project.
 
 If you use Conan, it's expected that you use **conan-generated** directory at step 4 of [Conan package manager](Conan.md).
 

docs/developers/CMake.md

@@ -1,23 +1,21 @@
 # CMake options
 
 * `-D CMAKE_BUILD_TYPE=Debug`
-    * Enables debug info and disables optimizations
+  * Enables debug info and disables optimizations
 * `-D CMAKE_EXPORT_COMPILE_COMMANDS=ON`
-    * Creates `compile_commands.json` for [clangd](https://clangd.llvm.org/) language server.
-    
-        For clangd to find the JSON, create a file named `.clangd` with this content
-        ```
-        CompileFlags:
-        	CompilationDatabase: build
-        ```
-        and place it here:
-        ```
-        .
-        ├── vcmi -> contains sources and is under git control
-        ├── build -> contains build output, makefiles, object files,...
-        └── .clangd
-        ```
+  * Creates `compile_commands.json` for [clangd](https://clangd.llvm.org/) language server. For clangd to find the JSON, create a file named `.clangd` with this content
+     ```
+    CompileFlags:
+    CompilationDatabase: build
+    ```
+    and place it here:
+    ```
+    .
+    ├── vcmi -> contains sources and is under git control
+    ├── build -> contains build output, makefiles, object files,...
+    └── .clangd
+    ```
 * `-D ENABLE_CCACHE:BOOL=ON`
-    * Speeds up recompilation
+  * Speeds up recompilation
 * `-G Ninja`
-    * Use Ninja build system instead of Make, which speeds up the build and doesn't require a `-j` flag
+  * Use Ninja build system instead of Make, which speeds up the build and doesn't require a `-j` flag

docs/developers/Code_Structure.md

@@ -29,9 +29,10 @@ Most of VCMI configuration files uses Json format and located in "config" direct
 ### Main purposes of client
 
 Client is responsible for:
--   displaying state of game to human player
--   capturing player's actions and sending requests to server
--   displaying changes in state of game indicated by server
+
+- displaying state of game to human player
+- capturing player's actions and sending requests to server
+- displaying changes in state of game indicated by server
 
 ### Rendering of graphics
 
@@ -44,9 +45,9 @@ In rendering, Interface object system is quite helpful. Its base is CIntObject c
 
 Server is responsible for:
 
--   maintaining state of the game
--   handling requests from all clients participating in game
--   informing all clients about changes in state of the game that are
+- maintaining state of the game
+- handling requests from all clients participating in game
+- informing all clients about changes in state of the game that are
     visible to them
 
 ## Lib
@@ -59,11 +60,11 @@ iOS platform pioneered single process build, where server is a static library an
 
 Lib contains code responsible for:
 
--   handling most of Heroes III files (.lod, .txt setting files)
--   storing information common to server and client like state of the game
--   managing armies, buildings, artifacts, spells, bonuses and other game objects
--   handling general game mechanics and related actions (only adventure map objects; it's an unwanted remnant of past development - all game mechanics should be handled by the server)
--   networking and serialization
+- handling most of Heroes III files (.lod, .txt setting files)
+- storing information common to server and client like state of the game
+- managing armies, buildings, artifacts, spells, bonuses and other game objects
+- handling general game mechanics and related actions (only adventure map objects; it's an unwanted remnant of past development - all game mechanics should be handled by the server)
+- networking and serialization
 
 #### Serialization
 
@@ -94,7 +95,6 @@ Forward declarations of the lib in headers of other parts of the project need to
 `<other forward declarations>`  
 `<classes>`
 
-
 ##### New project part
 
 If you're creating new project part, place `VCMI_LIB_USING_NAMESPACE` in its `StdInc.h` to be able to use lib classes without explicit namespace in implementation files. Example: <https://github.com/vcmi/vcmi/blob/develop/launcher/StdInc.h>
@@ -121,4 +121,4 @@ VCMI includes [FuzzyLite](http://code.google.com/p/fuzzy-lite/) library to make
 
 ### Duels
 
-### ERM parser
+### ERM parser

docs/developers/Coding_Guidelines.md

@@ -4,7 +4,7 @@
 
 VCMI implementation bases on C++17 standard. Any feature is acceptable as long as it's will pass build on our CI, but there is list below on what is already being used.
 
-Any compiler supporting C++17 should work, but this has not been thoroughly tested. You can find information about extensions and compiler support at http://en.cppreference.com/w/cpp/compiler_support
+Any compiler supporting C++17 should work, but this has not been thoroughly tested. You can find information about extensions and compiler support at <http://en.cppreference.com/w/cpp/compiler_support>
 
 ## Style Guidelines
 
@@ -20,7 +20,7 @@ Inside a code block put the opening brace on the next line after the current sta
 
 Good:
 
-``` cpp
+```cpp
 if(a) 
 {
 	code();
@@ -30,7 +30,7 @@ if(a)
 
 Bad:
 
-``` cpp
+```cpp
 if(a) {
 	code();
 	code();
@@ -41,14 +41,14 @@ Avoid using unnecessary open/close braces, vertical space is usually limited:
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 	code();
 ```
 
 Bad:
 
-``` cpp
+```cpp
 if(a) {
 	code();
 }
@@ -58,7 +58,7 @@ Unless there are either multiple hierarchical conditions being used or that the
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 {
 	if(b)
@@ -68,7 +68,7 @@ if(a)
 
 Bad:
 
-``` cpp
+```cpp
 if(a)
 	if(b)
 		code();
@@ -78,7 +78,7 @@ If there are brackets inside the body, outside brackets are required.
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 {
 	for(auto elem : list)
@@ -90,7 +90,7 @@ if(a)
 
 Bad:
 
-``` cpp
+```cpp
 if(a)
 	for(auto elem : list)
 	{
@@ -102,7 +102,7 @@ If "else" branch has brackets then "if" should also have brackets even if it is
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 {
 	code();
@@ -118,7 +118,7 @@ else
 
 Bad:
 
-``` cpp
+```cpp
 if(a)
 	code();
 else
@@ -134,7 +134,7 @@ If you intentionally want to avoid usage of "else if" and keep if body indent ma
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 {
 	code();
@@ -148,7 +148,7 @@ else
 
 Bad:
 
-``` cpp
+```cpp
 if(a)
 	code();
 else
@@ -160,7 +160,7 @@ When defining a method, use a new line for the brace, like this:
 
 Good:
 
-``` cpp
+```cpp
 void method()
 {
 }
@@ -168,7 +168,7 @@ void method()
 
 Bad:
 
-``` cpp
+```cpp
 void Method() {
 }
 ```
@@ -179,14 +179,14 @@ Use white space in expressions liberally, except in the presence of parenthesis.
 
 **Good:**
 
-``` cpp
+```cpp
 if(a + 5 > method(blah('a') + 4))
 	foo += 24;
 ```
 
 **Bad:**
 
-``` cpp
+```cpp
 if(a+5>method(blah('a')+4))
 foo+=24;
 ```
@@ -199,13 +199,13 @@ Use a space before and after the address or pointer character in a pointer decla
 
 Good:
 
-``` cpp
+```cpp
 CIntObject * images[100];
 ```
 
 Bad:
 
-``` cpp
+```cpp
 CIntObject* images[100]; or
 CIntObject *images[100];
 ```
@@ -214,14 +214,14 @@ Do not use spaces before parentheses.
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 	code();
 ```
 
 Bad:
 
-``` cpp
+```cpp
 if (a)
 	code();
 ```
@@ -230,7 +230,7 @@ Do not use extra spaces around conditions inside parentheses.
 
 Good:
 
-``` cpp
+```cpp
 if(a && b)
 	code();
 
@@ -240,7 +240,7 @@ if(a && (b || c))
 
 Bad:
 
-``` cpp
+```cpp
 if( a && b )
 	code();
 
@@ -252,14 +252,14 @@ Do not use more than one space between operators.
 
 Good:
 
-``` cpp
+```cpp
 if((a && b) || (c + 1 == d))
 	code();
 ```
 
 Bad:
 
-``` cpp
+```cpp
 if((a && b)  ||  (c + 1 == d))
 	code();
 
@@ -273,14 +273,14 @@ When allocating objects, don't use parentheses for creating stack-based objects
 
 Good:
 
-``` cpp
+```cpp
 std::vector<int> v; 
 CGBoat btn = new CGBoat();
 ```
 
 Bad:
 
-``` cpp
+```cpp
 std::vector<int> v(); // shouldn't compile anyway 
 CGBoat btn = new CGBoat;
 ```
@@ -289,14 +289,14 @@ Avoid overuse of parentheses:
 
 Good:
 
-``` cpp
+```cpp
 if(a && (b + 1))
 	return c == d;
 ```
 
 Bad:
 
-``` cpp
+```cpp
 if((a && (b + 1)))
 	return (c == d);
 ```
@@ -305,7 +305,7 @@ if((a && (b + 1)))
 
 Base class list must be on same line with class name.
 
-``` cpp
+```cpp
 class CClass : public CClassBaseOne, public CClassBaseOne
 {
 	int id;
@@ -321,7 +321,7 @@ When 'private:', 'public:' and other labels are not on the line after opening br
 
 Good:
 
-``` cpp
+```cpp
 class CClass
 {
 	int id;
@@ -333,7 +333,7 @@ public:
 
 Bad:
 
-``` cpp
+```cpp
 class CClass
 {
 	int id;
@@ -344,7 +344,7 @@ public:
 
 Good:
 
-``` cpp
+```cpp
 class CClass
 {
 protected:
@@ -357,7 +357,7 @@ public:
 
 Bad:
 
-``` cpp
+```cpp
 class CClass
 {
 
@@ -373,7 +373,7 @@ public:
 
 Constructor member and base class initialization must be on new line, indented with tab with leading colon.
 
-``` cpp
+```cpp
 CClass::CClass()
 	: CClassBaseOne(true, nullptr), id(0), bool parameters(false)
 {
@@ -387,7 +387,7 @@ Switch statements have the case at the same indentation as the switch.
 
 Good:
 
-``` cpp
+```cpp
 switch(alignment)
 {
 case EAlignment::EVIL:
@@ -407,7 +407,7 @@ default:
 
 Bad:
 
-``` cpp
+```cpp
 switch(alignment)
 {
 	case EAlignment::EVIL:
@@ -447,7 +447,7 @@ break;
 
 Good:
 
-``` cpp
+```cpp
 auto lambda = [this, a, &b](int3 & tile, int index) -> bool
 {
 	do_that();
@@ -456,7 +456,7 @@ auto lambda = [this, a, &b](int3 & tile, int index) -> bool
 
 Bad:
 
-``` cpp
+```cpp
 auto lambda = [this,a,&b](int3 & tile, int index)->bool{do_that();};
 ```
 
@@ -464,7 +464,7 @@ Empty parameter list is required even if function takes no arguments.
 
 Good:
 
-``` cpp
+```cpp
 auto lambda = []()
 {
 	do_that();
@@ -473,7 +473,7 @@ auto lambda = []()
 
 Bad:
 
-``` cpp
+```cpp
 auto lambda = []
 {
 	do_that();
@@ -484,7 +484,7 @@ Do not use inline lambda expressions inside if-else, for and other conditions.
 
 Good:
 
-``` cpp
+```cpp
 auto lambda = []()
 {
 	do_that();
@@ -497,7 +497,7 @@ if(lambda)
 
 Bad:
 
-``` cpp
+```cpp
 if([]()
 {
 	do_that();
@@ -511,7 +511,7 @@ Do not pass inline lambda expressions as parameter unless it's the last paramete
 
 Good:
 
-``` cpp
+```cpp
 auto lambda = []()
 {
 	do_that();
@@ -521,7 +521,7 @@ obj->someMethod(lambda, true);
 
 Bad:
 
-``` cpp
+```cpp
 obj->someMethod([]()
 {
 	do_that();
@@ -530,7 +530,7 @@ obj->someMethod([]()
 
 Good:
 
-``` cpp
+```cpp
 obj->someMethod(true, []()
 {
 	do_that();
@@ -543,7 +543,7 @@ Serialization of each element must be on it's own line since this make debugging
 
 Good:
 
-``` cpp
+```cpp
 template <typename Handler> void serialize(Handler & h, const int version)
 {
 	h & identifier;
@@ -555,7 +555,7 @@ template <typename Handler> void serialize(Handler & h, const int version)
 
 Bad:
 
-``` cpp
+```cpp
 template <typename Handler> void serialize(Handler & h, const int version)
 {
 	h & identifier & description & name & dependencies;
@@ -566,7 +566,7 @@ Save backward compatibility code is exception when extra brackets are always use
 
 Good:
 
-``` cpp
+```cpp
 template <typename Handler> void serialize(Handler & h, const int version)
 {
 	h & identifier;
@@ -586,7 +586,7 @@ template <typename Handler> void serialize(Handler & h, const int version)
 
 Bad:
 
-``` cpp
+```cpp
 template <typename Handler> void serialize(Handler & h, const int version)
 {
 	h & identifier;
@@ -604,7 +604,7 @@ template <typename Handler> void serialize(Handler & h, const int version)
 
 For any new files, please paste the following info block at the very top of the source file:
 
-``` cpp
+```cpp
 /*
  * Name_of_File.h, part of VCMI engine
  *
@@ -622,13 +622,13 @@ The above notice have to be included both in header and source files (.h/.cpp).
 
 For any header or source file code must be in following order:
 
-1.  Licensing information
-2.  pragma once preprocessor directive
-3.  include directives
-4.  Forward declarations
-5.  All other code
+1. Licensing information
+2. pragma once preprocessor directive
+3. include directives
+4. Forward declarations
+5. All other code
 
-``` cpp
+```cpp
 /*
  * Name_of_File.h, part of VCMI engine
  *
@@ -652,7 +652,7 @@ If you comment on the same line with code there must be one single space between
 
 Good:
 
-``` cpp
+```cpp
 if(a)
 {
 	code(); //Do something
@@ -665,7 +665,7 @@ else // Do something.
 
 Bad:
 
-``` cpp
+```cpp
 if(a)
 {
 	code();//Do something
@@ -680,7 +680,7 @@ If you add single-line comment on own line slashes must have same indent as code
 
 Good:
 
-``` cpp
+```cpp
 // Do something
 if(a)
 {
@@ -692,7 +692,7 @@ if(a)
 
 Bad:
 
-``` cpp
+```cpp
 			// Do something
 if(a)
 {
@@ -706,7 +706,7 @@ Avoid comments inside multi-line if-else conditions. If your conditions are too
 
 Good:
 
-``` cpp
+```cpp
 bool isMyHeroAlive = a && b || (c + 1 > 15);
 bool canMyHeroMove = myTurn && hero.movePoints > 0;
 if(isMyHeroAlive && canMyHeroMove)
@@ -717,7 +717,7 @@ if(isMyHeroAlive && canMyHeroMove)
 
 Bad:
 
-``` cpp
+```cpp
 if((a && b || (c + 1 > 15)) //Check if hero still alive
 	&& myTurn && hero.movePoints > 0) //Check if hero can move
 {
@@ -727,7 +727,7 @@ if((a && b || (c + 1 > 15)) //Check if hero still alive
 
 You should write a comment before the class definition which describes shortly the class. 1-2 sentences are enough. Methods and class data members should be commented if they aren't self-describing only. Getters/Setters, simple methods where the purpose is clear or similar methods shouldn't be commented, because vertical space is usually limited. The style of documentation comments should be the three slashes-style: ///.
 
-``` cpp
+```cpp
 /// Returns true if a debug/trace log message will be logged, false if not.
 /// Useful if performance is important and concatenating the log message is a expensive task.
 bool isDebugEnabled() const;
@@ -738,7 +738,7 @@ The above example doesn't follow a strict scheme on how to comment a method. It
 
 If you need a more detailed description for a method you can use such style:
 
-``` cpp
+```cpp
 /// <A short one line description>
 ///
 /// <Longer description>
@@ -749,7 +749,7 @@ If you need a more detailed description for a method you can use such style:
 /// @return Description of the return value
 ```
 
-A good essay about writing comments: http://ardalis.com/when-to-comment-your-code
+A good essay about writing comments: <http://ardalis.com/when-to-comment-your-code>
 
 ### Casing
 
@@ -775,7 +775,7 @@ Outdated. There is separate entry for [Logging API](Logging_API.md)
 
 If you want to trace the control flow of VCMI, then you should use the macro LOG_TRACE or LOG_TRACE_PARAMS. The first one prints a message when the function is entered or leaved. The name of the function will also be logged. In addition to this the second macro, let's you specify parameters which you want to print. You should print traces with parameters like this:
 
-``` cpp
+```cpp
 LOG_TRACE_PARAMS(logGlobal, "hero '%s', spellId '%d', pos '%s'.", hero, spellId, pos);
 ```
 
@@ -797,14 +797,14 @@ Do not use uncommon abbreviations for class, method, parameter and global object
 
 Bad:
 
-``` cpp
+```cpp
 CArt * getRandomArt(...)
 class CIntObject
 ```
 
 Good:
 
-``` cpp
+```cpp
 CArtifact * getRandomArtifact(...)
 class CInterfaceObject
 ```
@@ -827,7 +827,7 @@ The header StdInc.h should be included in every compilation unit. It has to be i
 
 Do not declare enumerations in global namespace. It is better to use strongly typed enum or to wrap them in class or namespace to avoid polluting global namespace:
 
-``` cpp
+```cpp
 enum class EAlignment
 {
 	GOOD,
@@ -848,7 +848,7 @@ namespace EAlignment
 
 If the comment duplicates the name of commented member, it's better if it wouldn't exist at all. It just increases maintenance cost. Bad:
 
-``` cpp
+```cpp
 size_t getHeroesCount(); //gets count of heroes (surprise?)
 ```
 
@@ -862,16 +862,16 @@ Don't return const objects or primitive types from functions -- it's pointless.
 
 Bad:
 
-``` cpp
+```cpp
 const std::vector<CGObjectInstance *> guardingCreatures(int3 pos) const;
 ```
 
 Good:
 
-``` cpp
+```cpp
 std::vector<const CGObjectInstance *> guardingCreatures(int3 pos) const;
 ```
 
 ## Sources
 
-[Mono project coding guidelines](http://www.mono-project.com/Coding_Guidelines)
+[Mono project coding guidelines](http://www.mono-project.com/Coding_Guidelines)

docs/developers/Conan.md

@@ -27,7 +27,7 @@ The following platforms are supported and known to work, others might require ch
     - **Windows**: libraries are built with x86_64-mingw-w64-gcc version 10 (which is available in repositories of Ubuntu 22.04)
     - **Android**: libraries are built with NDK r25c (25.2.9519653)
 
-2. Download the binaries archive and unpack it to `~/.conan` directory from https://github.com/vcmi/vcmi-dependencies/releases/latest
+2. Download the binaries archive and unpack it to `~/.conan` directory from <https://github.com/vcmi/vcmi-dependencies/releases/latest>
 
     - macOS: pick **dependencies-mac-intel.txz** if you have Intel Mac, otherwise - **dependencies-mac-arm.txz**
     - iOS: pick ***dependencies-ios.txz***
@@ -65,7 +65,7 @@ If you use `--build=never` and this command fails, then it means that you can't
 
 VCMI "recipe" also has some options that you can specify. For example, if you don't care about game videos, you can disable FFmpeg dependency by passing `-o with_ffmpeg=False`. If you only want to make release build, you can use `GENERATE_ONLY_BUILT_CONFIG=1` environment variable to skip generating files for other configurations (our CI does this).
 
-_Note_: you can find full reference of this command [in the official documentation](https://docs.conan.io/1/reference/commands/consumer/install.html) or by executing `conan help install`.
+*Note*: you can find full reference of this command [in the official documentation](https://docs.conan.io/1/reference/commands/consumer/install.html) or by executing `conan help install`.
 
 ### Using our prebuilt binaries for macOS/iOS
 
@@ -86,7 +86,7 @@ This subsection describes platform specifics to build libraries from source prop
 
 #### Building for macOS/iOS
 
-- To build Locale module of Boost in versions >= 1.81, you must use `compiler.cppstd=11` Conan setting (our profiles already contain it). To use it with another profile, either add this setting to your _host_ profile or pass `-s compiler.cppstd=11` on the command line.
+- To build Locale module of Boost in versions >= 1.81, you must use `compiler.cppstd=11` Conan setting (our profiles already contain it). To use it with another profile, either add this setting to your *host* profile or pass `-s compiler.cppstd=11` on the command line.
 - If you wish to build dependencies against system libraries (like our prebuilt ones do), follow [below instructions](#using-recipes-for-system-libraries) executing `conan create` for all directories. Don't forget to pass `-o with_apple_system_libs=True` to `conan install` afterwards.
 
 #### Building for Android
@@ -105,11 +105,11 @@ After applying patch(es):
 2. Run `make`
 3. Copy file `qtbase/jar/QtAndroid.jar` from the build directory to the **package directory**, e.g. `~/.conan/data/qt/5.15.14/_/_/package/SOME_HASH/jar`.
 
-_Note_: if you plan to build Qt from source again, then you don't need to perform the above _After applying patch(es)_ steps after building.
+*Note*: if you plan to build Qt from source again, then you don't need to perform the above *After applying patch(es)* steps after building.
 
 ##### Using recipes for system libraries
 
-1. Clone/download https://github.com/kambala-decapitator/conan-system-libs
+1. Clone/download <https://github.com/kambala-decapitator/conan-system-libs>
 2. Execute `conan create PACKAGE vcmi/CHANNEL`, where `PACKAGE` is a directory path in that repository and `CHANNEL` is **apple** for macOS/iOS and **android** for Android. Do it for each library you need.
 3. Now you can execute `conan install` to build all dependencies.
 

docs/developers/Development_with_Qt_Creator.md

@@ -6,7 +6,7 @@ Qt Creator is the recommended IDE for VCMI development on Linux distributions, b
 - Almost no manual configuration when used with CMake. Project configuration is read from CMake text files,
 - Easy to setup and use with multiple different compiler toolchains: GCC, Visual Studio, Clang
 
-You can install Qt Creator from repository, but better to stick to latest version from Qt website: https://www.qt.io/download-qt-installer-oss
+You can install Qt Creator from repository, but better to stick to latest version from Qt website: <https://www.qt.io/download-qt-installer-oss>
 
 ## Configuration
 
@@ -21,4 +21,4 @@ The build dir should be set to something like /trunk/build for the debug build a
 There is a problem with QtCreator when debugging both vcmiclient and vcmiserver. If you debug the vcmiclient, start a game, attach the vcmiserver process to the gdb debugger(Debug \> Start Debugging \> Attach to Running External Application...) then breakpoints which are set for vcmiserver will be ignored. This looks like a bug, in any case it's not intuitively. Two workarounds are available luckily:
 
 1. Run vcmiclient (no debug mode), then attach server process to the debugger
-2. Open two instances of QtCreator and debug vcmiserver and vcmiclient separately(it works!)
+2. Open two instances of QtCreator and debug vcmiserver and vcmiclient separately(it works!)

docs/developers/Logging_API.md

@@ -2,14 +2,14 @@
 
 ## Features
 
--   A logger belongs to a "domain", this enables us to change log level settings more selectively
--   The log format can be customized
--   The color of a log entry can be customized based on logger domain and logger level
--   Logger settings can be changed in the settings.json file
--   No std::endl at the end of a log entry required
--   Thread-safe
--   Macros for tracing the application flow
--   Provides stream-like and function-like logging
+- A logger belongs to a "domain", this enables us to change log level settings more selectively
+- The log format can be customized
+- The color of a log entry can be customized based on logger domain and logger level
+- Logger settings can be changed in the settings.json file
+- No std::endl at the end of a log entry required
+- Thread-safe
+- Macros for tracing the application flow
+- Provides stream-like and function-like logging
 
 ## Class diagram
 
@@ -17,14 +17,14 @@
 
 Some notes:
 
--   There are two methods `configure` and `configureDefault` of the class `CBasicLogConfigurator` to initialize and setup the logging system. The latter one setups default logging and isn't dependent on VCMI's filesystem, whereas the first one setups logging based on the user's settings which can be configured in the settings.json.
--   The methods `isDebugEnabled` and `isTraceEnabled` return true if a log record of level debug respectively trace will be logged. This can be useful if composing the log message is a expensive task and performance is important.
+- There are two methods `configure` and `configureDefault` of the class `CBasicLogConfigurator` to initialize and setup the logging system. The latter one setups default logging and isn't dependent on VCMI's filesystem, whereas the first one setups logging based on the user's settings which can be configured in the settings.json.
+- The methods `isDebugEnabled` and `isTraceEnabled` return true if a log record of level debug respectively trace will be logged. This can be useful if composing the log message is a expensive task and performance is important.
 
 ## Usage
 
 ### Setup settings.json
 
-``` javascript
+``` jsonc
 {
     "logging" : {
         "console" : {
@@ -87,6 +87,7 @@ global -\> info
 ### How to get a logger
 
 There exist only one logger object per domain. A logger object cannot be copied. You can get access to a logger object by using the globally defined ones like `logGlobal` or `logAi`, etc... or by getting one manually:
+
 ```cpp
 Logger * logger = CLogger::getLogger(CLoggerDomain("rmg"));
 ```
@@ -104,22 +105,22 @@ Don't include a '\n' or std::endl at the end of your log message, a new line wil
 
 The following list shows several log levels from the highest one to the lowest one:
 
--   error -\> for errors, e.g. if resource is not available, if a initialization fault has occurred, if a exception has been thrown (can result in program termination)
--   warn -\> for warnings, e.g. if sth. is wrong, but the program can continue execution "normally"
--   info -\> informational messages, e.g. Filesystem initialized, Map loaded, Server started, etc...
--   debug -\> for debugging, e.g. hero moved to (12,3,0), direction 3', 'following artifacts influence X: .. or pattern detected at pos (10,15,0), p-nr. 30, flip 1, repl. 'D'
--   trace -\> for logging the control flow, the execution progress or fine-grained events, e.g. hero movement completed, entering CMapEditManager::updateTerrainViews: posx '10', posy '5', width '10', height '10', mapLevel '0',...
+- error -\> for errors, e.g. if resource is not available, if a initialization fault has occurred, if a exception has been thrown (can result in program termination)
+- warn -\> for warnings, e.g. if sth. is wrong, but the program can continue execution "normally"
+- info -\> informational messages, e.g. Filesystem initialized, Map loaded, Server started, etc...
+- debug -\> for debugging, e.g. hero moved to (12,3,0), direction 3', 'following artifacts influence X: .. or pattern detected at pos (10,15,0), p-nr. 30, flip 1, repl. 'D'
+- trace -\> for logging the control flow, the execution progress or fine-grained events, e.g. hero movement completed, entering CMapEditManager::updateTerrainViews: posx '10', posy '5', width '10', height '10', mapLevel '0',...
 
 The following colors are available for console output:
 
--   default
--   green
--   red
--   magenta
--   yellow
--   white
--   gray
--   teal
+- default
+- green
+- red
+- magenta
+- yellow
+- white
+- gray
+- teal
 
 ### How to trace execution
 
@@ -143,10 +144,10 @@ The program execution can be traced by using the macros TRACE_BEGIN, TRACE_END a
 
 A domain is a specific part of the software. In VCMI there exist several domains:
 
--   network
--   ai
--   bonus
--   network
+- network
+- ai
+- bonus
+- network
 
 In addition to these domains, there exist always a super domain called "global". Sub-domains can be created with "ai.battle" or "ai.adventure" for example. The dot between the "ai" and "battle" is important and notes the parent-child relationship of those two domains. A few examples how the log level will be inherited:
 

docs/developers/Lua_Scripting_System.md

@@ -2,7 +2,7 @@
 
 ## Configuration
 
-``` javascript
+``` jsonc
 {
  	//general purpose script, Lua or ERM, runs on server
  	"myScript":
@@ -87,75 +87,75 @@ VCMI uses LuaJIT, which is Lua 5.1 API, see [upstream documentation](https://www
 
 Following libraries are supported
 
--   base
--   table
--   string
--   math
--   bit
+- base
+- table
+- string
+- math
+- bit
 
 ## ERM
 
 ### Features
 
--   no strict limit on function/variable numbers (technical limit 32 bit integer except 0))
--   TODO semi compare
--   DONE macros
+- no strict limit on function/variable numbers (technical limit 32 bit integer except 0))
+- TODO semi compare
+- DONE macros
 
 ### Bugs
 
--   TODO Broken XOR support (clashes with \`X\` option)
+- TODO Broken XOR support (clashes with \`X\` option)
 
 ### Triggers
 
--   TODO **!?AE** Equip/Unequip artifact
--   WIP **!?BA** when any battle occurs
--   WIP **!?BF** when a battlefield is prepared for a battle
--   TODO **!?BG** at every action taken by any stack or by the hero
--   TODO **!?BR** at every turn of a battle
--   *!?CM (client only) click the mouse button.*
--   TODO **!?CO** Commander triggers
--   TODO **!?DL** Custom dialogs
--   DONE **!?FU** function
--   TODO **!?GE** "global" event
--   TODO **!?GM** Saving/Loading
--   TODO **!?HE** when the hero \# is attacked by an enemy hero or
+- TODO **!?AE** Equip/Unequip artifact
+- WIP **!?BA** when any battle occurs
+- WIP **!?BF** when a battlefield is prepared for a battle
+- TODO **!?BG** at every action taken by any stack or by the hero
+- TODO **!?BR** at every turn of a battle
+- *!?CM (client only) click the mouse button.*
+- TODO **!?CO** Commander triggers
+- TODO **!?DL** Custom dialogs
+- DONE **!?FU** function
+- TODO **!?GE** "global" event
+- TODO **!?GM** Saving/Loading
+- TODO **!?HE** when the hero \# is attacked by an enemy hero or
     visited by an allied hero
--   TODO **!?HL** hero gains a level
--   TODO **!?HM** every step a hero \# takes
--   *!?IP Multiplayer support.*
--   TODO **!?LE** (!$LE) An Event on the map
--   WIP **!?MF** stack taking physical damage(before an action)
--   TODO **!?MG** casting on the adventure map
--   *!?MM scroll text during a battle*
--   TODO **!?MR** Magic resistance
--   TODO **!?MW** Wandering Monsters
--   WIP **!?OB** (!$OB) visiting objects
--   DONE **!?PI** Post Instruction.
--   TODO **!?SN** Sound and ERA extensions
--   *!?TH town hall*
--   TODO **!?TL** Real-Time Timer
--   TODO **!?TM** timed events
+- TODO **!?HL** hero gains a level
+- TODO **!?HM** every step a hero \# takes
+- *!?IP Multiplayer support.*
+- TODO **!?LE** (!$LE) An Event on the map
+- WIP **!?MF** stack taking physical damage(before an action)
+- TODO **!?MG** casting on the adventure map
+- *!?MM scroll text during a battle*
+- TODO **!?MR** Magic resistance
+- TODO **!?MW** Wandering Monsters
+- WIP **!?OB** (!$OB) visiting objects
+- DONE **!?PI** Post Instruction.
+- TODO **!?SN** Sound and ERA extensions
+- *!?TH town hall*
+- TODO **!?TL** Real-Time Timer
+- TODO **!?TM** timed events
 
 ### Receivers
 
 #### VCMI
 
--   **!!MC:S@varName@** - declare new "normal" variable (technically
+- **!!MC:S@varName@** - declare new "normal" variable (technically
     v-var with string key)
--   TODO Identifier resolver
--   WIP Bonus system
+- TODO Identifier resolver
+- WIP Bonus system
 
 #### ERA
 
--   DONE !!if !!el !!en
--   TODO !!br !!co
--   TODO !!SN:X
+- DONE !!if !!el !!en
+- TODO !!br !!co
+- TODO !!SN:X
 
 #### WoG
 
 - TODO !!AR Артефакт (ресурс) в определенной позиции
 - TODO !!BA Битва
- - !!BA:A$ return 1 for battle evaluation
+- !!BA:A$ return 1 for battle evaluation
 - TODO !!BF Препятствия на поле боя
 - TODO !!BG Действий монстров в бою
 - TODO !!BH Действия героя в бою
@@ -201,4 +201,4 @@ Following libraries are supported
 - *!#VC Контроль переменных*
 - WIP !!VR Установка переменных
 
-### Persistence
+### Persistence

docs/developers/Networking.md

@@ -5,12 +5,14 @@
 For implementation details see files located at `lib/network` directory.
 
 VCMI uses connection using TCP to communicate with server, even in single-player games. However, even though TCP is stream-based protocol, VCMI uses atomic messages for communication. Each message is a serialized stream of bytes, preceded by 4-byte message size:
+
 ```
 int32_t messageSize;
 byte messagePayload[messageSize];
 ```
 
 Networking can be used by:
+
 - game client (vcmiclient / VCMI_Client.exe). Actual application that player interacts with directly using UI.
 - match server (vcmiserver / VCMI_Server.exe / part of game client). This app controls game logic and coordinates multiplayer games.
 - lobby server (vcmilobby). This app provides access to global lobby through which players can play game over Internet.
@@ -28,11 +30,13 @@ For gameplay, VCMI serializes data into a binary stream. See [Serialization](Ser
 ## Global lobby communication
 
 For implementation details see:
+
 - game client: `client/globalLobby/GlobalLobbyClient.h
 - match server: `server/GlobalLobbyProcessor.h
 - lobby server: `client/globalLobby/GlobalLobbyClient.h
 
 In case of global lobby, message payload uses plaintext json format - utf-8 encoded string:
+
 ```
 int32_t messageSize;
 char jsonString[messageSize];
@@ -43,6 +47,7 @@ Every message must be a struct (json object) that contains "type" field. Unlike
 ### Communication flow
 
 Notes:
+
 - invalid message, such as corrupted json format or failure to validate message will result in no reply from server
 - in addition to specified messages, match server will send `operationFailed` message on failure to apply player request
 
@@ -51,7 +56,8 @@ Notes:
 - client -> lobby: `clientRegister`
 - lobby -> client: `accountCreated`
 
-#### Login 
+#### Login
+
 - client -> lobby: `clientLogin`
 - lobby -> client: `loginSuccess`
 - lobby -> client: `chatHistory`
@@ -59,10 +65,12 @@ Notes:
 - lobby -> client: `activeGameRooms`
 
 #### Chat Message
+
 - client -> lobby: `sendChatMessage`
 - lobby -> every client: `chatMessage`
 
 #### New Game Room
+
 - client starts match server instance
 - match -> lobby: `serverLogin`
 - lobby -> match: `loginSuccess`
@@ -73,19 +81,23 @@ Notes:
 - lobby -> every client: `activeGameRooms`
 
 #### Joining a game room
+
 See [#Proxy mode](proxy-mode)
 
 #### Leaving a game room
+
 - client closes connection to match server
 - match -> lobby: `leaveGameRoom`
 
-#### Sending an invite:
+#### Sending an invite
+
 - client -> lobby: `sendInvite`
 - lobby -> target client: `inviteReceived`
 
 Note: there is no dedicated procedure to accept an invite. Instead, invited player will use same flow as when joining public game room
 
 #### Logout
+
 - client closes connection
 - lobby -> every client: `activeAccounts`
 
@@ -94,6 +106,7 @@ Note: there is no dedicated procedure to accept an invite. Instead, invited play
 In order to connect players located behind NAT, VCMI lobby can operate in "proxy" mode. In this mode, connection will be act as proxy and will transmit gameplay data from client to a match server, without any data processing on lobby server.
 
 Currently, process to establish connection using proxy mode is:
+
 - Player attempt to join open game room using `joinGameRoom` message
 - Lobby server validates requests and on success - notifies match server about new player in lobby using control connection
 - Match server receives request, establishes new connection to game lobby, sends `serverProxyLogin` message to lobby server and immediately transfers this connection to VCMIServer class to use as connection for gameplay communication
@@ -101,4 +114,4 @@ Currently, process to establish connection using proxy mode is:
 - Game client receives message and establishes own side of proxy connection - connects to lobby, sends `clientProxyLogin` message and transfers to ServerHandler class to use as connection for gameplay communication
 - Lobby server accepts new connection and moves it into a proxy mode - all packages that will be received by one side of this connection will be re-sent to another side without any processing.
 
-Once the game is over (or if one side disconnects) lobby server will close another side of the connection and erase proxy connection
+Once the game is over (or if one side disconnects) lobby server will close another side of the connection and erase proxy connection

docs/developers/RMG_Description.md

@@ -74,4 +74,4 @@ For every zone, a few random obstacle sets are selected. [Details](https://githu
 
 ### Filling space
 
-Tiles which need to be `blocked` but are not `used` are filled with obstacles. Largest obstacles which cover the most tiles are picked first, other than that they are chosen randomly.
+Tiles which need to be `blocked` but are not `used` are filled with obstacles. Largest obstacles which cover the most tiles are picked first, other than that they are chosen randomly.

docs/developers/Serialization.md

@@ -140,7 +140,7 @@ CLoadFile/CSaveFile classes allow to read data to file and store data to file. T
 
 #### Networking
 
-See [Networking](Networking.md) 
+See [Networking](Networking.md)
 
 ### Additional features
 
@@ -259,4 +259,4 @@ Foo *loadedA, *loadedB;
 
 The feature recognizes pointers by addresses. Therefore it allows mixing pointers to base and derived classes. However, it does not allow serializing classes with multiple inheritance using a "non-first" base (other bases have a certain address offset from the actual object).
 
-Pointer cycles are properly handled. This feature makes sense for savegames and is turned on for them.
+Pointer cycles are properly handled. This feature makes sense for savegames and is turned on for them.

docs/maintainers/Project_Infrastructure.md

@@ -9,30 +9,30 @@ So far we using following services:
 ### Most important
 
 - VCMI.eu domain paid until July of 2019.
- - Owner: Tow
- - Our main domain used by services.
+  - Owner: Tow
+  - Our main domain used by services.
 - VCMI.download paid until November of 2026.
- - Owner: SXX
- - Intended to be used for all assets downloads.
- - Domain registered on GANDI and **can be renewed by anyone without access to account**.
+  - Owner: SXX
+  - Intended to be used for all assets downloads.
+  - Domain registered on GANDI and **can be renewed by anyone without access to account**.
 - [DigitalOcean](https://cloud.digitalocean.com/) team.
- - Our hosting sponsor.
- - Administrator access: SXX, Warmonger.
- - User access: AVS, Tow.
+  - Our hosting sponsor.
+  - Administrator access: SXX, Warmonger.
+  - User access: AVS, Tow.
 - [CloudFlare](https://www.cloudflare.com/a/overview) account.
- - Access through shared login / password.
- - All of our infrastructure is behind CloudFlare and all our web. We manage our DNS there.
+  - Access through shared login / password.
+  - All of our infrastructure is behind CloudFlare and all our web. We manage our DNS there.
 - [Google Apps (G Suite)](https://admin.google.com/) account.
- - It's only for vcmi.eu domain and limited to 5 users. Each account has limit of 500 emails / day.
- - One administrative email used for other services registration.
- - "noreply" email used for outgoing mail on Wiki and Bug Tracker.
- - "forum" email used for outgoing mail on Forums. Since we authenticate everyone through forum it's should be separate email.
- - Administrator access: Tow, SXX.
-- [Google Play Console](https://play.google.com/apps/publish/) account.
- - Hold ownership over VCMI Android App.
- - Owner: SXX
- - Administrator access: Warmonger, AVS, Ivan.
- - Release manager access: Fay.
+  - It's only for vcmi.eu domain and limited to 5 users. Each account has limit of 500 emails / day.
+  - One administrative email used for other services registration.
+  - "noreply" email used for outgoing mail on Wiki and Bug Tracker.
+  - "forum" email used for outgoing mail on Forums. Since we authenticate everyone through forum it's should be separate email.
+- Administrator access: Tow, SXX.
+  - [Google Play Console](https://play.google.com/apps/publish/) account.
+  - Hold ownership over VCMI Android App.
+  - Owner: SXX
+  - Administrator access: Warmonger, AVS, Ivan.
+  - Release manager access: Fay.
 
 Not all services let us safely share login credentials, but at least when possible at least two of core developers must have access to them in case of emergency.
 
@@ -41,20 +41,20 @@ Not all services let us safely share login credentials, but at least when possib
 We want to notify players about updates on as many social services as possible.
 
 - Facebook page: <https://www.facebook.com/VCMIOfficial>
- - Administrator access: SXX, Warmonger
+  - Administrator access: SXX, Warmonger
 - Twitter account: <https://twitter.com/VCMIOfficial>
- - Administrator access: SXX.
- - User access via TweetDeck:
-- VK / VKontakte page: <https://vk.com/VCMIOfficial>
- - Owner: SXX
- - Administrator access: AVS
+  - Administrator access: SXX.
+- User access via TweetDeck:
+  - VK / VKontakte page: <https://vk.com/VCMIOfficial>
+- Owner: SXX
+  - Administrator access: AVS
 - Steam group: <https://steamcommunity.com/groups/VCMI>
- - Administrator access: SXX
- - Moderator access: Dydzio
-- Reddit: <https://reddit.com/r/vcmi/>
- - Administrator access: SXX
-- ModDB entry: <http://www.moddb.com/engines/vcmi>
- - Administrator access: SXX
+  - Administrator access: SXX
+- Moderator access: Dydzio
+  - Reddit: <https://reddit.com/r/vcmi/>
+- Administrator access: SXX
+  - ModDB entry: <http://www.moddb.com/engines/vcmi>
+- Administrator access: SXX
 
 ### Communication channels
 
@@ -70,48 +70,46 @@ We want to notify players about updates on as many social services as possible.
 ### Other services
 
 - Launchpad PPA: <https://launchpad.net/~vcmi>
- - Member access: AVS
- - Administrator access: Ivan, SXX
+  - Member access: AVS
+  - Administrator access: Ivan, SXX
 - Snapcraft Dashboard: <https://dashboard.snapcraft.io/>
- - Administrator access: SXX
+  - Administrator access: SXX
 - Coverity Scan page: <https://scan.coverity.com/projects/vcmi>
- - Administrator access: SXX, Warmonger, AVS
+  - Administrator access: SXX, Warmonger, AVS
 - OpenHub page: <https://www.openhub.net/p/VCMI>
- - Administrator access: Tow
+  - Administrator access: Tow
 - Docker Hub organization: <https://hub.docker.com/u/vcmi/>
- - Administrator access: SXX
+  - Administrator access: SXX
 
 Reserve accounts for other code hosting services:
 
 - GitLab organization: <https://gitlab.com/vcmi/>
- - Administrator access: SXX
+  - Administrator access: SXX
 - BitBucket organization: <https://bitbucket.org/vcmi/>
- - Administrator access: SXX
+  - Administrator access: SXX
 
 ## What's to improve
 
-1.  Encourage Tow to transfer VCMI.eu to GANDI so it's can be also renewed without access.
-2.  Use 2FA on CloudFlare and just ask everyone to get FreeOTP and then use shared secret.
-3.  Centralized way to post news about game updates to all social media.
+1. Encourage Tow to transfer VCMI.eu to GANDI so it's can be also renewed without access.
+2. Use 2FA on CloudFlare and just ask everyone to get FreeOTP and then use shared secret.
+3. Centralized way to post news about game updates to all social media.
 
-# Project Servers Configuration
+## Project Servers Configuration
 
 This section dedicated to explain specific configurations of our servers for anyone who might need to improve it in future.
 
-## Droplet configuration
-
-### Droplet and hosted services
+### Droplet configuration
 
 Currently we using two droplets:
 
 - First one serve all of our web services:
- - [Forum](https://forum.vcmi.eu/)
- - [Bug tracker](https://bugs.vcmi.eu/)
- - [Wiki](https://wiki.vcmi.eu/)
- - [Slack invite page](https://slack.vcmi.eu/)
+  - [Forum](https://forum.vcmi.eu/)
+  - [Bug tracker](https://bugs.vcmi.eu/)
+  - [Wiki](https://wiki.vcmi.eu/)
+  - [Slack invite page](https://slack.vcmi.eu/)
 - Second serve downloads:
- - [Legacy download page](http://download.vcmi.eu/)
- - [Build download page](https://builds.vcmi.download/)
+  - [Legacy download page](http://download.vcmi.eu/)
+  - [Build download page](https://builds.vcmi.download/)
 
 To keep everything secure we should always keep binary downloads separate from any web services.
 
@@ -131,4 +129,4 @@ We only expose floating IP that can be detached from droplet in case of emergenc
 - Address: beholder.vcmi.eu (67.207.75.182)
 - Port 22 serve SFTP for file uploads as well as CI artifacts uploads.
 
-If new services added firewall rules can be adjusted in [DO control panel](https://cloud.digitalocean.com/networking/firewalls).
+If new services added firewall rules can be adjusted in [DO control panel](https://cloud.digitalocean.com/networking/firewalls).

docs/maintainers/Release_Process.md

@@ -1,12 +1,16 @@
 # Release Process
 
 ## Versioning
+
 For releases VCMI uses version numbering in form "1.X.Y", where:
+
 - 'X' indicates major release. Different major versions are generally not compatible with each other. Save format is different, network protocol is different, mod format likely different.
 - 'Y' indicates hotfix release. Despite its name this is usually not urgent, but planned release. Different hotfixes for same major version are fully compatible with each other.
 
 ## Branches
+
 Our branching strategy is very similar to GitFlow:
+
 - `master` branch has release commits. One commit - one release. Each release commit should be tagged with version `1.X.Y` when corresponding version is released. State of master branch represents state of latest public release.
 - `beta` branch is for stabilization of ongoing release. Beta branch is created when new major release enters stabilization stage and is used for both major release itself as well as for subsequent hotfixes. Only changes that are safe, have minimal chance of regressions and improve player experience should be targeted into this branch. Breaking changes (e.g. save format changes) are forbidden in beta.
 - `develop` branch is a main branch for ongoing development. Pull requests with new features should be targeted to this branch, `develop` version is one major release ahead of `beta`.
@@ -14,12 +18,14 @@ Our branching strategy is very similar to GitFlow:
 ## Release process step-by-step
 
 ### Initial release setup (major releases only)
+
 Should be done immediately after start of stabilization stage for previous release
 
 - Create project named `Release 1.X`
 - Add all features and bugs that should be fixed as part of this release into this project
 
 ### Start of stabilization stage (major releases only)
+
 Should be done 2 weeks before planned release date. All major features should be finished at this point.
 
 - Create `beta` branch from `develop`
@@ -34,6 +40,7 @@ Should be done 2 weeks before planned release date. All major features should be
 - Bump version and build ID for Android on `beta` branch
 
 ### Release preparation stage
+
 Should be done 1 week before release. Release date should be decided at this point.
 
 - Make sure to announce codebase freeze deadline (1 day before release) to all developers
@@ -45,21 +52,23 @@ Should be done 1 week before release. Release date should be decided at this poi
 - - Update downloads counter in `docs/readme.md`
 
 ### Release preparation stage
+
 Should be done 1 day before release. At this point beta branch is in full freeze.
 
 - Merge release preparation PR into `beta`
 - Merge `beta` into `master`. This will trigger CI pipeline that will generate release packages
 - Create draft release page, specify `1.x.y` as tag for `master` after publishing
 - Check that artifacts for all platforms have been built by CI on `master` branch
-- Download and rename all build artifacts to use form "VCMI-1.X.Y-Platform.xxx" 
+- Download and rename all build artifacts to use form "VCMI-1.X.Y-Platform.xxx"
 - Attach build artifacts for all platforms to release page
 - Manually extract Windows installer, remove `$PLUGINSDIR` directory which contains installer files and repackage data as .zip archive
 - Attach produced zip archive to release page as an alternative Windows installer
 - Upload built AAB to Google Play and send created release draft for review (usually takes several hours)
 - Prepare pull request for [vcmi-updates](https://github.com/vcmi/vcmi-updates)
-- (major releases only) Prepare pull request with release update for web site https://github.com/vcmi/VCMI.eu
+- (major releases only) Prepare pull request with release update for web site <https://github.com/vcmi/VCMI.eu>
 
 ### Release publishing phase
+
 Should be done on release date
 
 - Trigger builds for new release on Ubuntu PPA

docs/maintainers/Ubuntu_PPA.md

@@ -1,6 +1,7 @@
 # Ubuntu PPA
 
 ## Main links
+
 - [Team](https://launchpad.net/~vcmi)
 - [Project](https://launchpad.net/vcmi)
 - [Sources](https://code.launchpad.net/~vcmi/vcmi/+git/vcmi)
@@ -14,31 +15,42 @@
 ## Automatic daily builds process
 
 ### Code import
+
 - Launchpad performs regular (once per few hours) clone of our git repository.
 - This process can be observed on [Sources](https://code.launchpad.net/~vcmi/vcmi/+git/vcmi) page.
 - If necessary, it is possible to trigger fresh clone immediately (Import Now button)
+
 ### Build dependencies
+
 - All packages required for building of vcmi are defined in [debian/control](https://github.com/vcmi/vcmi/blob/develop/debian/control) file
 - Launchpad will automatically install build dependencies during build
 - Dependencies of output .deb package are defined implicitly as dependencies of packages required for build
+
 ### Recipe building
+
 - Every 24 hours Launchpad triggers daily builds on all recipes that have build schedule enable. For vcmi this is [Daily recipe](https://code.launchpad.net/~vcmi/+recipe/vcmi-daily)
 - Alternatively, builds can be triggered manually using "request build(s) link on recipe page. VCMI uses this for [Stable recipe](https://code.launchpad.net/~vcmi/+recipe/vcmi-stable)
+
 ### Recipe content (build settings)
+
 - Version of resulting .deb package is set in recipe content, e.g `{debupstream}+git{revtime}` for daily builds
 - Base version (referred as `debupstream` on Launchpad is taken from source code, [debian/changelog](https://github.com/vcmi/vcmi/blob/develop/debian/changelog) file
 - CMake configuration settings are taken from source code, [debian/rules](https://github.com/vcmi/vcmi/blob/develop/debian/rules) file
 - Branch which is used for build is specified in recipe content, e.g. `lp:vcmi master`
+
 ## Workflow for creating a release build
+
 - if necessary, push all required changes including `debian/changelog` update to `vcmi/master` branch
 - Go to [Sources](https://code.launchpad.net/~vcmi/vcmi/+git/vcmi) and run repository import.
 - Wait for import to finish, which usually happens within a minute. Press F5 to actually see changes.
 - Go to [Stable recipe](https://code.launchpad.net/~vcmi/+recipe/vcmi-stable) and request new builds
 - Wait for builds to finish. This takes quite a while, usually - over a hour, even more for arm builds
 - Once built, all successfully built packages are automatically copied to PPA linked to the recipe
-- If any of builds have failed, open page with build info and check logs. 
+- If any of builds have failed, open page with build info and check logs.
+
 ## People with access
-- [alexvins](https://github.com/alexvins) (https://launchpad.net/~alexvins)
-- [ArseniyShestakov](https://github.com/ArseniyShestakov) (https://launchpad.net/~sxx)
-- [IvanSavenko](https://github.com/IvanSavenko) (https://launchpad.net/~saven-ivan)
-- (Not member of VCMI, creator of PPA) (https://launchpad.net/~mantas)
+
+- [alexvins](https://github.com/alexvins) (<https://launchpad.net/~alexvins>)
+- [ArseniyShestakov](https://github.com/ArseniyShestakov) (<https://launchpad.net/~sxx>)
+- [IvanSavenko](https://github.com/IvanSavenko) (<https://launchpad.net/~saven-ivan>)
+- (Not member of VCMI, creator of PPA) (<https://launchpad.net/~mantas>)

docs/modders/Animation_Format.md

@@ -2,13 +2,13 @@
 
 VCMI allows overriding HoMM3 .def files with .json replacement. Compared to .def this format allows:
 
--   Overriding individual frames from json file (e.g. icons)
--   Modern graphics formats (targa, png - all formats supported by VCMI image loader)
--   Does not requires any special tools - all you need is text editor and images.
+- Overriding individual frames from json file (e.g. icons)
+- Modern graphics formats (targa, png - all formats supported by VCMI image loader)
+- Does not requires any special tools - all you need is text editor and images.
 
 ## Format description
 
-``` javascript
+``` jsonc
 {
     // Base path of all images in animation. Optional.
     // Can be used to avoid using long path to images 
@@ -58,12 +58,13 @@ VCMI allows overriding HoMM3 .def files with .json replacement. Compared to .def
 ### Replacing a button
 
 This json file will allow replacing .def file for a button with png images. Buttons require following images:
+
 1. Active state. Button is active and can be pressed by player
 2. Pressed state. Player pressed button but have not released it yet
 3. Blocked state. Button is blocked and can not be interacted with. Note that some buttons are never blocked and can be used without this image
 4. Highlighted state. This state is used by only some buttons and only in some cases. For example, in main menu buttons will appear highlighted when mouse cursor is on top of the image. Another example is buttons that can be selected, such as settings that can be toggled on or off
 
-```javascript
+```jsonc
 	"basepath" : "interface/MyButton", // all images are located in this directory
 
 	"images" :
@@ -80,7 +81,7 @@ This json file will allow replacing .def file for a button with png images. Butt
 
 This json file allows defining one animation sequence, for example for adventure map objects or for town buildings.
 
-```javascript
+```jsonc
 	"basepath" : "myTown/myBuilding", // all images are located in this directory
 
 	"sequences" :

docs/modders/Bonus/Bonus_Duration_Types.md

@@ -4,14 +4,14 @@ Bonus may have any of these durations. They acts in disjunction.
 
 ## List of all bonus duration types
 
--   PERMANENT
--   ONE_BATTLE: at the end of battle
--   ONE_DAY: at the end of day
--   ONE_WEEK: at the end of week (bonus lasts till the end of week, NOT 7 days)
--   N_TURNS: used during battles, after battle bonus is always removed
--   N_DAYS
--   UNTIL_BEING_ATTACKED: removed after any damage-inflicting attack
--   UNTIL_ATTACK: removed after attack and counterattacks are performed
--   STACK_GETS_TURN: removed when stack gets its turn - used for defensive stance
--   COMMANDER_KILLED
--   UNTIL_OWN_ATTACK: removed after attack (not counterattack) is performed
+- PERMANENT
+- ONE_BATTLE: at the end of battle
+- ONE_DAY: at the end of day
+- ONE_WEEK: at the end of week (bonus lasts till the end of week, NOT 7 days)
+- N_TURNS: used during battles, after battle bonus is always removed
+- N_DAYS
+- UNTIL_BEING_ATTACKED: removed after any damage-inflicting attack
+- UNTIL_ATTACK: removed after attack and counterattacks are performed
+- STACK_GETS_TURN: removed when stack gets its turn - used for defensive stance
+- COMMANDER_KILLED
+- UNTIL_OWN_ATTACK: removed after attack (not counterattack) is performed

docs/modders/Bonus/Bonus_Limiters.md

@@ -15,7 +15,7 @@ The limiters take no parameters:
 
 Example:
 
-``` javascript
+``` jsonc
 "limiters" : [ "SHOOTER_ONLY" ]
 ```
 
@@ -25,12 +25,12 @@ Example:
 
 Parameters:
 
--   Bonus type
--   (optional) bonus subtype
--   (optional) bonus sourceType and sourceId in struct
--   example: (from Adele's bless):
+- Bonus type
+- (optional) bonus subtype
+- (optional) bonus sourceType and sourceId in struct
+- example: (from Adele's bless):
 
-``` javascript
+``` jsonc
 	"limiters" : [
 		{
 			"type" : "HAS_ANOTHER_BONUS_LIMITER",
@@ -50,20 +50,21 @@ Parameters:
 
 Parameters:
 
--   Creature id (string)
--   (optional) include upgrades - default is false
+- Creature id (string)
+- (optional) include upgrades - default is false
 
 ### CREATURE_ALIGNMENT_LIMITER
 
 Parameters:
 
--   Alignment identifier
+- Alignment identifier
 
 ### CREATURE_LEVEL_LIMITER
 
 If parameters is empty, level limiter works as CREATURES_ONLY limiter
 
 Parameters:
+
 - Minimal level
 - Maximal level
 
@@ -71,24 +72,24 @@ Parameters:
 
 Parameters:
 
--   Faction identifier
+- Faction identifier
 
 ### CREATURE_TERRAIN_LIMITER
 
 Parameters:
 
--   Terrain identifier
+- Terrain identifier
 
 Example:
 
-``` javascript
+``` jsonc
 "limiters": [ {
 	"type":"CREATURE_TYPE_LIMITER",
 	"parameters": [ "angel", true ]
 } ],
 ```
 
-``` javascript
+``` jsonc
 "limiters" : [ {
 	"type" : "CREATURE_TERRAIN_LIMITER",
 	"parameters" : ["sand"]
@@ -106,13 +107,13 @@ Parameters:
 The following limiters must be specified as the first element of a list,
 and operate on the remaining limiters in that list:
 
--   allOf (default when no aggregate limiter is specified)
--   anyOf
--   noneOf
+- allOf (default when no aggregate limiter is specified)
+- anyOf
+- noneOf
 
 Example:
 
-``` javascript
+``` jsonc
 "limiters" : [
     "noneOf",
     "IS_UNDEAD",
@@ -121,4 +122,4 @@ Example:
         "parameters" : [ "SIEGE_WEAPON" ]
     }
 ]
-```
+```

docs/modders/Bonus/Bonus_Propagators.md

@@ -2,9 +2,9 @@
 
 ## Available propagators
 
--   BATTLE_WIDE: Affects both sides during battle
--   VISITED_TOWN_AND_VISITOR: Used with Legion artifacts (town visited by hero)
--   PLAYER_PROPAGATOR: Bonus will affect all objects owned by player. Used by Statue of Legion.
--   HERO: Bonus will be transferred to hero (for example from stacks in his army).
--   TEAM_PROPAGATOR: Bonus will affect all objects owned by player and his allies.
--   GLOBAL_EFFECT: This effect will influence all creatures, heroes and towns on the map.
+- BATTLE_WIDE: Affects both sides during battle
+- VISITED_TOWN_AND_VISITOR: Used with Legion artifacts (town visited by hero)
+- PLAYER_PROPAGATOR: Bonus will affect all objects owned by player. Used by Statue of Legion.
+- HERO: Bonus will be transferred to hero (for example from stacks in his army).
+- TEAM_PROPAGATOR: Bonus will affect all objects owned by player and his allies.
+- GLOBAL_EFFECT: This effect will influence all creatures, heroes and towns on the map.

docs/modders/Bonus/Bonus_Range_Types.md

@@ -16,4 +16,4 @@ For replacing ONLY_ENEMY_ARMY alias, you should use the following parameters of
 	"limiters" : [ "OPPOSITE_SIDE" ]
 ```
 
-If some propagators was set before, it was actually ignored and should be replaced to code above. And OPPOSITE_SIDE limiter should be first, if any other limiters exists.
+If some propagators was set before, it was actually ignored and should be replaced to code above. And OPPOSITE_SIDE limiter should be first, if any other limiters exists.

docs/modders/Bonus/Bonus_Sources.md

@@ -19,4 +19,4 @@
 - STACK_EXPERIENCE
 - COMMANDER
 - GLOBAL
-- OTHER
+- OTHER

docs/modders/Bonus/Bonus_Types.md

@@ -57,9 +57,9 @@ Bonus that does not account for propagation and gives extra resources per day wi
 
 Increases amount of movement points available to affected hero on new turn
 
-- subtype: 
-	- heroMovementLand: only land movement will be affected
-	- heroMovementSea: only sea movement will be affected
+- subtype:
+  - heroMovementLand: only land movement will be affected
+  - heroMovementSea: only sea movement will be affected
 - val: number of movement points (100 points for a tile)
 
 ### WATER_WALKING
@@ -158,7 +158,7 @@ Allows affected heroes to learn spells from each other during hero exchange
 
 Reduces movement points penalty when moving on terrains with movement cost over 100 points. Can not reduce movement cost below 100 points
 
-- val: penalty reduction, in movement points per tile. 
+- val: penalty reduction, in movement points per tile.
 
 ### WANDERING_CREATURES_JOIN_BONUS
 
@@ -346,8 +346,8 @@ Heroes affected by this bonus can not retreat or surrender in battle (Shackles o
 Negates all natural immunities for affected stacks. (Orb of Vulnerability)
 
 - subtype:
-	- immunityBattleWide: Entire battle will be affected by bonus
-	- immunityEnemyHero: Only enemy hero will be affected by bonus
+  - immunityBattleWide: Entire battle will be affected by bonus
+  - immunityEnemyHero: Only enemy hero will be affected by bonus
 
 ### OPENING_BATTLE_SPELL
 
@@ -383,9 +383,9 @@ Increases movement speed of units in battle
 Increases base damage of creature in battle
 
 - subtype:
-	- creatureDamageMin: increases only minimal damage 
-	- creatureDamageMax: increases only maximal damage
-	- creatureDamageBoth: increases both minimal and maximal damage
+  - creatureDamageMin: increases only minimal damage
+  - creatureDamageMax: increases only maximal damage
+  - creatureDamageBoth: increases both minimal and maximal damage
 - val: additional damage points
 
 ### SHOTS
@@ -447,8 +447,8 @@ Affected units can not receive good or bad morale
 Affected unit can fly on the battlefield
 
 - subtype:
-	- movementFlying: creature will fly (slowly move across battlefield)
-	- movementTeleporting: creature will instantly teleport to destination, skipping movement animation.
+  - movementFlying: creature will fly (slowly move across battlefield)
+  - movementTeleporting: creature will instantly teleport to destination, skipping movement animation.
 
 ### SHOOTER
 
@@ -525,19 +525,19 @@ Affected unit will ignore specified percentage of attacked unit defense (Behemot
 Affected units will receive reduced damage from attacks by other units
 
 - val: damage reduction, percentage
-- subtype: 
-	- damageTypeMelee: only melee damage will be reduced
-	- damageTypeRanged: only ranged damage will be reduced
-	- damageTypeAll: all damage will be reduced
+- subtype:
+  - damageTypeMelee: only melee damage will be reduced
+  - damageTypeRanged: only ranged damage will be reduced
+  - damageTypeAll: all damage will be reduced
 
 ### PERCENTAGE_DAMAGE_BOOST
 
 Affected units will deal increased damage when attacking other units
 
 - val: damage increase, percentage
-- subtype: 
-	- damageTypeMelee: only melee damage will increased
-	- damageTypeRanged: only ranged damage will increased
+- subtype:
+  - damageTypeMelee: only melee damage will increased
+  - damageTypeRanged: only ranged damage will increased
 
 ### GENERAL_ATTACK_REDUCTION
 
@@ -576,18 +576,18 @@ Affected unit will never receive retaliations when attacking
 Affected unit will gain new creatures for each enemy killed by this unit
 
 - val: number of units gained per enemy killed
-- subtype: 
-	- soulStealPermanent: creature will stay after the battle
-	- soulStealBattle: creature will be lost after the battle
+- subtype:
+  - soulStealPermanent: creature will stay after the battle
+  - soulStealBattle: creature will be lost after the battle
 
 ### TRANSMUTATION
 
 Affected units have chance to transform attacked unit to other creature type
 
 - val: chance for ability to trigger, percentage
-- subtype: 
-	- transmutationPerHealth: transformed unit will have same HP pool as original stack, 
-	- transmutationPerUnit: transformed unit will have same number of units as original stack
+- subtype:
+  - transmutationPerHealth: transformed unit will have same HP pool as original stack,
+  - transmutationPerUnit: transformed unit will have same number of units as original stack
 - addInfo: creature to transform to. If not set, creature will transform to same unit as attacker
 
 ### SUMMON_GUARDIANS
@@ -613,10 +613,10 @@ Affected unit will attack units on all hexes that surround attacked hex
 
 Affected unit will retaliate before enemy attacks, if able
 
-- subtype: 
-	- damageTypeMelee: only melee attacks affected
-	- damageTypeRanged: only ranged attacks affected. Note that unit also requires ability to retaliate in ranged, such as RANGED_RETALIATION bonus
-	- damageTypeAll: any attacks are affected
+- subtype:
+  - damageTypeMelee: only melee attacks affected
+  - damageTypeRanged: only ranged attacks affected. Note that unit also requires ability to retaliate in ranged, such as RANGED_RETALIATION bonus
+  - damageTypeAll: any attacks are affected
 
 ### SHOOTS_ALL_ADJACENT
 
@@ -627,9 +627,9 @@ Affected unit will attack units on all hexes that surround attacked hex in range
 Affected unit will kills additional units after attack
 
 - val: chance to trigger, percentage
-- subtype: 
-	- destructionKillPercentage: kill percentage of units, 
-	- destructionKillAmount: kill amount
+- subtype:
+  - destructionKillPercentage: kill percentage of units,
+  - destructionKillAmount: kill amount
 - addInfo: amount or percentage to kill
 
 ### LIMITED_SHOOTING_RANGE
@@ -669,6 +669,7 @@ Affected unit can attack walls during siege battles (Cyclops)
 ### CATAPULT_EXTRA_SHOTS
 
 Defines spell mastery level for spell used by CATAPULT bonus
+
 - subtype: affected spell
 - val: spell mastery level to use
 
@@ -760,18 +761,18 @@ Affected unit will deal additional damage after attack
 
 Affected unit will kill additional units after attack. Used for Death stare (Mighty Gorgon) ability and for Accurate Shot (Pirates, HotA)
 
-- subtype: 
-	- deathStareGorgon: only melee attack, random amount of killed units
-	- deathStareNoRangePenalty: only ranged attacks without obstacle (walls) or range penalty
-	- deathStareRangePenalty: only ranged attacks with range penalty
-	- deathStareObstaclePenalty: only ranged attacks with obstacle (walls) penalty
-	- deathStareRangeObstaclePenalty: only ranged attacks with both range and obstacle penalty
-	- deathStareCommander: fixed amount, both melee and ranged attacks
-- val: 
-	- for deathStareCommander: number of creatures to kill, total amount of killed creatures is (attacker level / defender level) \* val
-	- for all other subtypes: chance to kill, counted separately for each unit in attacking stack, percentage. At most (stack size \* chance) units can be killed at once, rounded up
+- subtype:
+  - deathStareGorgon: only melee attack, random amount of killed units
+  - deathStareNoRangePenalty: only ranged attacks without obstacle (walls) or range penalty
+  - deathStareRangePenalty: only ranged attacks with range penalty
+  - deathStareObstaclePenalty: only ranged attacks with obstacle (walls) penalty
+  - deathStareRangeObstaclePenalty: only ranged attacks with both range and obstacle penalty
+  - deathStareCommander: fixed amount, both melee and ranged attacks
+- val:
+  - for deathStareCommander: number of creatures to kill, total amount of killed creatures is (attacker level / defender level) \* val
+  - for all other subtypes: chance to kill, counted separately for each unit in attacking stack, percentage. At most (stack size \* chance) units can be killed at once, rounded up
 - addInfo:
-	- SpellID to be used as hit effect. If not set - 'deathStare' spell will be used. If set to "accurateShot" battle log messages will use alternative description
+  - SpellID to be used as hit effect. If not set - 'deathStare' spell will be used. If set to "accurateShot" battle log messages will use alternative description
 
 ### SPECIAL_CRYSTAL_GENERATION
 
@@ -816,9 +817,9 @@ Determines how many times per combat affected creature can cast its targeted spe
 - subtype - spell id, eg. spell.iceBolt
 - value - chance (percent)
 - additional info - \[X, Y, Z\]
-    - X - spell mastery level (1 - Basic, 3 - Expert)
-    - Y = 0 - all attacks, 1 - shot only, 2 - melee only
-    - Z (optional) - layer for multiple SPELL_AFTER_ATTACK bonuses and multi-turn casting. Empty or value less than 0 = not participating in layering.
+  - X - spell mastery level (1 - Basic, 3 - Expert)
+  - Y = 0 - all attacks, 1 - shot only, 2 - melee only
+  - Z (optional) - layer for multiple SPELL_AFTER_ATTACK bonuses and multi-turn casting. Empty or value less than 0 = not participating in layering.
   When enabled - spells from specific layer will not be cast until target has all spells from previous layer on him. Spell from last layer is on repeat if none of spells on lower layers expired.
 
 ### SPELL_BEFORE_ATTACK
@@ -826,12 +827,12 @@ Determines how many times per combat affected creature can cast its targeted spe
 - subtype - spell id
 - value - chance %
 - additional info - \[X, Y, Z\]
-    - X - spell mastery level (1 - Basic, 3 - Expert)
-    - Y = 0 - all attacks, 1 - shot only, 2 - melee only
-    - Z (optional) - layer for multiple SPELL_BEFORE_ATTACK bonuses and multi-turn casting. Empty or value less than 0 = not participating in layering.
+  - X - spell mastery level (1 - Basic, 3 - Expert)
+  - Y = 0 - all attacks, 1 - shot only, 2 - melee only
+  - Z (optional) - layer for multiple SPELL_BEFORE_ATTACK bonuses and multi-turn casting. Empty or value less than 0 = not participating in layering.
   When enabled - spells from specific layer will not be cast until target has all spells from previous layer on him. Spell from last layer is on repeat if none of spells on lower layers expired.
 
-### SPECIFIC_SPELL_POWER 
+### SPECIFIC_SPELL_POWER
 
 - value: Used for Thunderbolt and Resurrection cast by units (multiplied by stack size). Also used for Healing secondary skill (for core:spell.firstAid used by First Aid tent)
 - subtype - spell id
@@ -842,16 +843,16 @@ Determines how many times per combat affected creature can cast its targeted spe
 
 ### CREATURE_ENCHANT_POWER
 
- - val: Total duration of spells cast by creature, in turns
+- val: Total duration of spells cast by creature, in turns
 
 ### REBIRTH
 
 Affected stack will resurrect after death
 
-- val - percent of total stack HP restored, not rounded. For instance, when 4 Phoenixes with Rebirth chance of 20% die, there is 80% chance than one Phoenix will rise. 
+- val - percent of total stack HP restored, not rounded. For instance, when 4 Phoenixes with Rebirth chance of 20% die, there is 80% chance than one Phoenix will rise.
 - subtype:
-    - rebirthRegular: Phoenix, as described above.
-    - rebirthSpecial: At least one unit will always rise (Sacred Phoenix)
+  - rebirthRegular: Phoenix, as described above.
+  - rebirthSpecial: At least one unit will always rise (Sacred Phoenix)
 
 ### ENCHANTED
 
@@ -1000,9 +1001,9 @@ Affected heroes will be under effect of Visions spell, revealing information of
 
 - val: multiplier to effect range. Information is revealed within (val \* hero spell power) range
 - subtype:
-    - visionsMonsters: reveal information on monsters, 
-    - visionsHeroes: reveal information on heroes, 
-    - visionsTowns: reveal information on towns
+  - visionsMonsters: reveal information on monsters,
+  - visionsHeroes: reveal information on heroes,
+  - visionsTowns: reveal information on towns
 
 ### BLOCK_MAGIC_BELOW
 

docs/modders/Bonus/Bonus_Updaters.md

@@ -10,45 +10,49 @@ Check the files in *config/heroes/* for additional usage examples.
 
 ## GROWS_WITH_LEVEL
 
--   Type: Complex
--   Parameters: valPer20, stepSize=1
--   Effect: Updates val to
+- Type: Complex
+- Parameters: valPer20, stepSize=1
+- Effect: Updates val to
 
-`   ceil(valPer20 * floor(heroLevel / stepSize) / 20)`
+`ceil(valPer20 * floor(heroLevel / stepSize) / 20)`
 
 Example: The following updater will cause a bonus to grow by 6 for every
 40 levels. At first level, rounding will cause the bonus to be 0.
 
-`   "updater" : {`  
-`       "parameters" : [ 6, 2 ],`  
-`       "type" : "GROWS_WITH_LEVEL"`  
-`   }`
+``` jsonc
+"updater" : {
+    "parameters" : [ 6, 2 ],
+    "type" : "GROWS_WITH_LEVEL"
+}
+```
 
 Example: The following updater will cause a bonus to grow by 3 for every
 20 levels. At first level, rounding will cause the bonus to be 1.
 
-`   "updater" : {`  
-`       "parameters" : [ 3 ],`  
-`       "type" : "GROWS_WITH_LEVEL"`  
-`   }`
+``` jsonc
+"updater" : {
+    "parameters" : [ 3 ],
+    "type" : "GROWS_WITH_LEVEL"
+}
+```
 
 Remarks:
 
--   The rounding rules are designed to match the attack/defense bonus
+- The rounding rules are designed to match the attack/defense bonus
     progression for heroes with creature specialties in HMM3.
--   There is no point in specifying val for a bonus with a
+- There is no point in specifying val for a bonus with a
     GROWS_WITH_LEVEL updater.
 
 ## TIMES_HERO_LEVEL
 
--   Type: Simple
--   Effect: Updates val to
+- Type: Simple
+- Effect: Updates val to
 
-`   val * heroLevel`
+`val * heroLevel`
 
 Usage:
 
-`   "updater" : "TIMES_HERO_LEVEL"`
+`"updater" : "TIMES_HERO_LEVEL"`
 
 Remark: This updater is redundant, in the sense that GROWS_WITH_LEVEL
 can also express the desired scaling by setting valPer20 to 20\*val. It
@@ -56,34 +60,36 @@ has been added for convenience.
 
 ## TIMES_STACK_LEVEL
 
--   Type: Simple
--   Effect: Updates val to
+- Type: Simple
+- Effect: Updates val to
 
-`   val * stackLevel`
+`val * stackLevel`
 
 Usage:
 
-`   "updater" : "TIMES_STACK_LEVEL"`
+`"updater" : "TIMES_STACK_LEVEL"`
 
 Remark: The stack level for war machines is 0.
 
 ## ARMY_MOVEMENT
 
--   Type: Complex
--   Parameters: basePerSpeed, dividePerSpeed, additionalMultiplier,
+- Type: Complex
+- Parameters: basePerSpeed, dividePerSpeed, additionalMultiplier,
     maxValue
--   Effect: Updates val to val+= max((floor(basePerSpeed /
+- Effect: Updates val to val+= max((floor(basePerSpeed /
     dividePerSpeed)\* additionalMultiplier), maxValue)
--   Remark: this updater is designed for MOVEMENT bonus to match H3 army
+- Remark: this updater is designed for MOVEMENT bonus to match H3 army
     movement rules (in the example - actual movement updater, which
     produces values same as in default movement.txt).
--   Example:
+- Example:
 
-`   "updater" : {`  
-`       "parameters" : [ 20, 3, 10, 700 ],`  
-`       "type" : "ARMY_MOVEMENT"`  
-`   }`
+``` jsonc
+"updater" : {
+    "parameters" : [ 20, 3, 10, 700 ],
+    "type" : "ARMY_MOVEMENT"
+}
+```
 
 ## BONUS_OWNER_UPDATER
 
-TODO: document me
+TODO: document me

docs/modders/Bonus/Bonus_Value_Types.md

@@ -2,24 +2,24 @@
 
 Total value of Bonus is calculated using the following:
 
--   For each bonus source type we calculate new source value (for all bonus value types except PERCENT_TO_SOURCE and PERCENT_TO_TARGET_TYPE) using the following:
-` newVal = (val * (100 + PERCENT_TO_SOURCE) / 100))`
+- For each bonus source type we calculate new source value (for all bonus value types except PERCENT_TO_SOURCE and PERCENT_TO_TARGET_TYPE) using the following:
+`newVal = (val * (100 + PERCENT_TO_SOURCE) / 100))`
 
 - PERCENT_TO_TARGET_TYPE applies as PERCENT_TO_SOURCE to targetSourceType of bonus.
 
--   All bonus value types summarized and then used as subject of the following formula:
+- All bonus value types summarized and then used as subject of the following formula:
 
-` clamp(((BASE_NUMBER * (100 + PERCENT_TO_BASE) / 100) + ADDITIVE_VALUE) * (100 + PERCENT_TO_ALL) / 100), INDEPENDENT_MAX, INDEPENDENT_MIN)`
+`clamp(((BASE_NUMBER * (100 + PERCENT_TO_BASE) / 100) + ADDITIVE_VALUE) * (100 + PERCENT_TO_ALL) / 100), INDEPENDENT_MAX, INDEPENDENT_MIN)`
 
 Semantics of INDEPENDENT_MAX and INDEPENDENT_MIN are wrapped, and first means than bonus total value will be at least INDEPENDENT_MAX, and second means than bonus value will be at most INDEPENDENT_MIN.
 
 ## List of all bonus value types
 
--   ADDITIVE_VALUE
--   BASE_NUMBER
--   PERCENT_TO_ALL
--   PERCENT_TO_BASE
--   INDEPENDENT_MAX
--   INDEPENDENT_MIN
--   PERCENT_TO_SOURCE
--   PERCENT_TO_TARGET_TYPE
+- ADDITIVE_VALUE
+- BASE_NUMBER
+- PERCENT_TO_ALL
+- PERCENT_TO_BASE
+- INDEPENDENT_MAX
+- INDEPENDENT_MIN
+- PERCENT_TO_SOURCE
+- PERCENT_TO_TARGET_TYPE

docs/modders/Bonus_Format.md

@@ -4,7 +4,7 @@
 
 All parameters but type are optional.
 
-``` javascript
+``` jsonc
 {
 	// Type of the bonus. See Bonus Types for full list
 	"type":         "BONUS_TYPE",
@@ -78,10 +78,10 @@ All parameters but type are optional.
 
 All string identifiers of items can be used in "subtype" field. This allows cross-referencing between the mods and make config file more readable.
 See [Game Identifiers](Game_Identifiers.md) for full list of available identifiers
- 
+
 ### Example
 
-``` javascript
+``` jsonc
 "bonus" :
 {
 	"type" : "HATE",
@@ -90,4 +90,4 @@ See [Game Identifiers](Game_Identifiers.md) for full list of available identifie
 }
 ```
 
-This bonus makes creature do 50% more damage to Enchanters.
+This bonus makes creature do 50% more damage to Enchanters.

docs/modders/Building_Bonuses.md

@@ -12,17 +12,17 @@ should be moved to scripting.
 
 Includes:
 
--   mystic pond
--   treasury
--   god of fire
--   castle gates
--   cover of darkness
--   portal of summoning
--   escape tunnel
+- mystic pond
+- treasury
+- god of fire
+- castle gates
+- cover of darkness
+- portal of summoning
+- escape tunnel
 
 Function of all of these objects can be enabled by this:
 
-``` javascript
+``` jsonc
  "function" : "castleGates" 
 ```
 
@@ -31,13 +31,13 @@ Function of all of these objects can be enabled by this:
 Hardcoded functionality for now due to complexity of these objects.
 Temporary can be handles as unique buildings. Includes:
 
--   resource - resource
--   resource - player
--   artifact - resource
--   resource - artifact
--   creature - resource
--   resource - skills
--   creature - skeleton
+- resource - resource
+- resource - player
+- artifact - resource
+- resource - artifact
+- creature - resource
+- resource - skills
+- creature - skeleton
 
 ### hero visitables
 
@@ -46,10 +46,10 @@ handled via configurable objects system.
 
 Includes:
 
--   gives mana points
--   gives movement points
--   give bonus to visitor
--   permanent bonus to hero
+- gives mana points
+- gives movement points
+- give bonus to visitor
+- permanent bonus to hero
 
 ### generic functions
 
@@ -58,31 +58,31 @@ CBuilding class.
 
 #### unlock guild level
 
-``` javascript
+``` jsonc
  "guildLevels" : 1 
 ```
 
 #### unlock hero recruitment
 
-``` javascript
+``` jsonc
  "allowsHeroPurchase" : true 
 ```
 
 #### unlock ship purchase
 
-``` javascript
+``` jsonc
  "allowsShipPurchase" : true 
 ```
 
 #### unlock building purchase
 
-``` javascript
+``` jsonc
  "allowsBuildingPurchase" : true 
 ```
 
 #### unlocks creatures
 
-``` javascript
+``` jsonc
  "dwelling" : { "level" : 1, "creature" : "archer" } 
 ```
 
@@ -92,31 +92,31 @@ Turn into town bonus? What about creature-specific bonuses from hordes?
 
 #### gives resources
 
-``` javascript
+``` jsonc
  "provides" : { "gold" : 500 } 
 ```
 
 #### gives guild spells
 
-``` javascript
+``` jsonc
  "guildSpells" : [5, 0, 0, 0, 0] 
 ```
 
 #### gives thieves guild
 
-``` javascript
+``` jsonc
  "thievesGuildLevels" : 1 
 ```
 
 #### gives fortifications
 
-``` javascript
+``` jsonc
  "fortificationLevels" : 1 
 ```
 
 #### gives war machine
 
-``` javascript
+``` jsonc
  "warMachine" : "ballista" 
 ```
 
@@ -129,12 +129,12 @@ TODO: how to handle stackable bonuses like Necromancy Amplifier?
 
 Includes:
 
--   bonus to defender
--   bonus to alliance
--   bonus to scouting range
--   bonus to player
+- bonus to defender
+- bonus to alliance
+- bonus to scouting range
+- bonus to player
 
-``` javascript
+``` jsonc
 "bonuses" :
 {
 	"moraleToDefenders" :
@@ -162,12 +162,12 @@ Possible issue - with removing of fixed ID's buildings in different town
 may no longer share same ID. However Capitol must be unique across all
 town. Should be fixed somehow.
 
-``` javascript
+``` jsonc
  "onePerPlayer" : true 
 ```
 
 #### chance to be built on start
 
-``` javascript
+``` jsonc
  "prebuiltChance" : 75 
-```
+```

docs/modders/Campaign_Format.md

@@ -3,11 +3,12 @@
 ## Introduction
 
 Starting from version 1.3, VCMI supports its own campaign format.
-Campaigns have *.vcmp file format and it consists from campaign json and set of scenarios (can be both *.vmap and *.h3m)
+Campaigns have `*.vcmp file` format and it consists from campaign json and set of scenarios (can be both `*.vmap` and `*.h3m`)
 
 To start making campaign, create file named `header.json`. See also [Packing campaign](#packing-campaign)
 
 Basic structure of this file is here, each section is described in details below
+
 ```js
 {
     "version" : 1,
@@ -32,6 +33,7 @@ Basic structure of this file is here, each section is described in details below
 ## Header properties
 
 In header are parameters describing campaign properties
+
 ```js
     ...
     "regions": {...},
@@ -60,6 +62,7 @@ In header are parameters describing campaign properties
 ## Scenario description
 
 Scenario description looks like follow:
+
 ```js
 {
     "map": "maps/SomeMap",
@@ -77,7 +80,7 @@ Scenario description looks like follow:
 }
 ```
 
-- `"map"` map name without extension but with relative path. Both *.h3m and *.vmap maps are supported. If you will pack scenarios inside campaign, numerical map name should be used, see details in [packing campaign](#packing-campaign)
+- `"map"` map name without extension but with relative path. Both `*.h3m` and `*.vmap` maps are supported. If you will pack scenarios inside campaign, numerical map name should be used, see details in [packing campaign](#packing-campaign)
 - `"preconditions"` enumerate scenarios indexes which must be completed to unlock this scenario. For example, if you want to make sequential missions, you should specify `"preconditions": []` for first scenario, but for second scenario it should be `"preconditions": [0]` and for third `"preconditions": [0, 1]`. But you can allow non-linear conquering using this parameter
 - `"color"` defines color id for the region. Possible values are `0: red, 1: blue, tan: 2, green: 3, orange: 4, purple: 5, teal: 6, pink: 7`
 - `"difficulty"` sets initial difficulty for this scenario. If `"allowDifficultySelection"`is defined for campaign, difficulty may be changed by player. Possible values are `0: pawn, 1: knight, 2: rook, 3: queen, 4: king`
@@ -96,6 +99,7 @@ Scenario description looks like follow:
 ### Prolog/Epilog
 
 Prolog and epilog properties are optional
+
 ```js
 {
     "video": "NEUTRALA.smk", //video to show
@@ -164,12 +168,14 @@ If `startOptions` is `crossover`, heroes from specific scenario will be moved to
     "scenario": 0
 },
 ```
+
 - `"playerColor"` from what player color heroes shall be taken. Possible values are `0: red, 1: blue, tan: 2, green: 3, orange: 4, purple: 5, teal: 6, pink: 7`
 - `"scenario"` from which scenario heroes shall be taken. 0 means first scenario
 
 #### Hero start option
 
 If `startOptions` is `hero`, hero can be chosen as a starting bonus. Bonus format is following
+
 ```js
 {
     "playerColor": 0,
@@ -201,7 +207,7 @@ Predefined campaign regions are located in file `campaign_regions.json`
 - `"background"` optional - use own image name for background instead of adding "_BG" to the prefix as name
 - `"prefix"` used to identify all images related to campaign. In this example (if background parameter wouldn't exists), background picture will be `G3_BG`
 - `"suffix"` optional - use other suffixes than the default `En`, `Se` and `Co` for the three different images
-- `"infix"` used to identify all images related to region. In this example, it will be pictures whose files names begin with `G3A_..., G3B_..., G3C_..."` 
+- `"infix"` used to identify all images related to region. In this example, it will be pictures whose files names begin with `G3A_..., G3B_..., G3C_..."`
 - `"labelPos"` optional -  to add scenario name as label on map
 - `"colorSuffixLength"` identifies suffix length for region colourful frames. 0 is no color suffix (no colorisation), 1 is used for `R, B, N, G, O, V, T, P`, value 2 is used for `Re, Bl, Br, Gr, Or, Vi, Te, Pi`
 
@@ -213,6 +219,7 @@ This file is a zip archive.
 The scenarios should be named as in `"map"` field from header. Subfolders are allowed.
 
 ## Compatibility table
+
 | Version | Min VCMI | Max VCMI | Description |
 |---------|----------|----------|-------------|
-| 1       | 1.3      |          | Initial release |
+| 1       | 1.3      |          | Initial release |

docs/modders/Configurable_Widgets.md

@@ -21,6 +21,7 @@ In this tutorial we will recreate options tab to support chess timers UI.
 ### Creating mod structure
 
 To start making mod, create following folders structure;
+
 ```
 extendedLobby/
 |- content/
@@ -31,6 +32,7 @@ extendedLobby/
 ```
 
 File `mod.json` is generic and could look like this:
+
 ```json
 {
 	"name" : "Configurable UI tutorial mod",
@@ -44,7 +46,7 @@ File `mod.json` is generic and could look like this:
 }
 ```
 
-After that you can copy `extendedLobby/ folder to `mods/` folder and your mod will immediately appear in launcher but it does nothing for now.
+After that you can copy `extendedLobby/` folder to `mods/` folder and your mod will immediately appear in launcher but it does nothing for now.
 
 ### Making layout for timer
 
@@ -64,6 +66,7 @@ So we need to modify turn duration label and add combo box with timer types
 Open `optionsTab.json` and scroll it until you see comment `timer`. Three elements after this comment are related to timer.
 
 Let's find first element, which is label
+
 ```json
 {
 	"items"
@@ -85,6 +88,7 @@ Let's find first element, which is label
 ```
 
 And modify it a bit
+
 ```json
 {
 	"name": "labelTimer", //add name, only for convenience
@@ -98,6 +102,7 @@ And modify it a bit
 ```
 
 But we also need proper background image for this label. Add image widget BEFORE labelTimer widget:
+
 ```json
 {
 	"type": "picture",
@@ -109,6 +114,7 @@ But we also need proper background image for this label. Add image widget BEFORE
 	...
 },
 ```
+
 In order to make it work, add file `RmgTTBk.bmp` to `content/sprites/`
 
 Elements named `labelTurnDurationValue` and `sliderTurnDuration` we will keep without change - they are needed to configure classic timer.
@@ -272,6 +278,7 @@ After view part is done, let's make behavioural part.
 Let's hide elements, related to classic timer when chess timer is selected and show them back if classic selected.
 
 To do that, find `"variables"` part inside `optionsTab.json` and add there `"timers"` array, containing 2 elements:
+
 ```json
 "variables":
 {
@@ -300,7 +307,7 @@ Now we show and hide elements, but visually you still can some "artifacts":
 
 <img width="341" alt="Снимок экрана 2023-08-30 в 15 51 22" src="https://github.com/vcmi/vcmi/assets/9308612/8a4eecdf-2c44-4f38-a7a0-aff6b9254fe6">
 
-It's because options tab background image we use has those elements drawn. Let's hide them with overlay image `timchebk.bmp`. 
+It's because options tab background image we use has those elements drawn. Let's hide them with overlay image `timchebk.bmp`.
 It should be drawn before all other timer elements:
 
 ```json
@@ -328,8 +335,9 @@ It works and can switch elements, the only missing part is chess timer configura
 
 We should add text input fields, to specify different timers. We will use background for them `timerField.bmp`, copy it to `content/sprites/` folder of your mod.
 
-There are 4 different timers: base, turn, battle and creature. Read about them here: https://github.com/vcmi/vcmi/issues/1364
+There are 4 different timers: base, turn, battle and creature. Read about them here: <https://github.com/vcmi/vcmi/issues/1364>
 We can add editors for them into items list, their format will be following:
+
 ```json
 {
 	"name": "chessFieldBase",
@@ -345,6 +353,7 @@ We can add editors for them into items list, their format will be following:
 ```
 
 Add three remaining elements for different timers by yourself. You can play with all settings, except callback. There are 4 predefined callbacks to setup timers:
+
 - `parseAndSetTimer_base`
 - `parseAndSetTimer_turn`
 - `parseAndSetTimer_battle`
@@ -363,7 +372,7 @@ There are different basic types, which can be used as value.
 
 #### Primitive types
 
-Read JSON documentation for primitive types description: https://www.json.org/json-en.html
+Read JSON documentation for primitive types description: <https://www.json.org/json-en.html>
 
 #### Text
 
@@ -430,6 +439,7 @@ One of predefined values:
 ### Configurable objects
 
 Configurable object has following structure:
+
 ```json
 {
 	"items": [],
@@ -621,7 +631,7 @@ Filling area with texture
 
 `"color"`: [color](#color),
 
-`"text": string` optional, default text. Translations are not supported 
+`"text": string` optional, default text. Translations are not supported
 
 `"position"`: [position](#position)
 
@@ -748,11 +758,13 @@ Used only as special object for [combo box](#combo-box)
 `"position"`: [position](#position)
 
 `"items": []` array of overlay widgets with certain types and names:
- - `"name": "hoverImage"`, `"type": ` [picture](#picture) - image to be shown when cursor hovers elements
- - `"name": "labelName"`, `"type": ` [label](#label) - element caption
+
+- `"name": "hoverImage"`, `"type":` [picture](#picture) - image to be shown when cursor hovers elements
+- `"name": "labelName"`, `"type":` [label](#label) - element caption
 
 **Callbacks**
- - `sliderMove` connect to slider callback to correctly navigate over elements
+
+- `sliderMove` connect to slider callback to correctly navigate over elements
 
 #### Layout
 
@@ -769,7 +781,8 @@ Used only as special object for [combo box](#combo-box)
 While designing a new element, you can make it configurable to reuse all functionality described above. It will provide flexibility to further changes as well as modding capabilities.
 
 Class should inherit `InterfaceObjectConfigurable`.
-```C++
+
+```cpp
 #include "gui/InterfaceObjectConfigurable.h" //assuming we are in client folder
 
 class MyYesNoDialog: public InterfaceObjectConfigurable
@@ -781,7 +794,7 @@ class MyYesNoDialog: public InterfaceObjectConfigurable
 
 To make new object work, it's sufficient to define constructor, which receives const reference to `JsonNode`.
 
-```C++
+```cpp
 MyYesNoDialog::MyYesNoDialog(const JsonNode & config):
 	InterfaceObjectConfigurable(), //you can pass arguments same as for CIntObject
 {
@@ -808,13 +821,13 @@ MyYesNoDialog::MyYesNoDialog(const JsonNode & config):
 
 You can build custom widgets, related to your UI element specifically. Like in example above, there is Item widget, which can be also used on JSON config.
 
-```C++
+```cpp
 REGISTER_BUILDER("myItem", &MyYesNoDialog::buildMyItem);
 ```
 
 You have to define function, which takes JsonNode as an argument and return pointer to built widget
 
-```C++
+```cpp
 std::shared_ptr<MyYesNoDialog::Item> MyYesNoDialog::buildMyItem(const JsonNode & config)
 {
 	auto position = readPosition(config["position"]);
@@ -840,7 +853,7 @@ After that, if your JSON file has items with type "MyItem", the new Item element
 
 After calling `build(config)` variables defined in config JSON file become available. You can interpret them and use in callbacks or in element code
 
-```C++
+```cpp
 build(config);
 
 if(variables["colorfulText"].Bool())

docs/modders/Difficulty.md

@@ -7,7 +7,7 @@ Difficulty configuration is located in [config/difficulty.json](../config/diffic
 
 ## Format summary
 
-``` javascript
+``` jsonc
 {
 	"human": //parameters impacting human players only
 	{
@@ -63,4 +63,4 @@ For both types of bonuses, `source` should be specified as `OTHER`.
 ## Compatibility
 
 Starting from VCMI 1.4 `startres.json` is not available anymore and will be ignored if present in any mod.
-Thus, `Resourceful AI`  mod of version 1.2 won't work anymore.
+Thus, `Resourceful AI`  mod of version 1.2 won't work anymore.

docs/modders/Entities_Format/Artifact_Format.md

@@ -6,9 +6,9 @@ Artifact bonuses use [Bonus Format](../Bonus_Format.md)
 
 In order to make functional artifact you also need:
 
--   Icon for hero inventory (1 image)
--   Icon for popup windows (1 image, optional)
--   Animation for adventure map (1 animation)
+- Icon for hero inventory (1 image)
+- Icon for popup windows (1 image, optional)
+- Animation for adventure map (1 animation)
 
 ## Format
 

docs/modders/Entities_Format/Battle_Obstacle_Format.md

@@ -24,4 +24,4 @@
 	
 	// If set to true, obstacle will appear in front of units or other battlefield objects
 	"foreground" : false
-```
+```

docs/modders/Entities_Format/Battlefield_Format.md

@@ -22,4 +22,4 @@
 	
 	// List of battle hexes that will be always blocked on this battlefield (e.g. ship to ship battles)
 	"impassableHexes" : [ 10, 20, 50 ],
-```
+```

docs/modders/Entities_Format/Biome_Format.md

@@ -38,5 +38,3 @@ Currently algorithm picks randomly:
 - One or two sets of **rocks** (small objects)
 - One of each remaining types of object (**structure**, **animal**, **other**), until enough number of sets is picked.
 - Obstacles marked as **other** are picked last, and are generally rare.
-
-

docs/modders/Entities_Format/Creature_Format.md

@@ -8,22 +8,22 @@ In order to make functional creature you also need:
 
 ### Animation
 
--   Battle animation (1 def file)
--   Set of rendered projectiles (1 def files, shooters only)
--   Adventure map animation (1 def file)
+- Battle animation (1 def file)
+- Set of rendered projectiles (1 def files, shooters only)
+- Adventure map animation (1 def file)
 
 ### Images
 
--   Small portrait for hero exchange window (1 image)
--   Large portrait for hero window (1 image)
+- Small portrait for hero exchange window (1 image)
+- Large portrait for hero window (1 image)
 
 ### Sounds
 
--   Set of sounds (up to 8 sounds)
+- Set of sounds (up to 8 sounds)
 
 ## Format
 
-``` javascript
+``` jsonc
 // camelCase unique creature identifier
 "creatureName" : 
 {
@@ -217,4 +217,4 @@ In order to make functional creature you also need:
 		...
 	]
 }
-```
+```

docs/modders/Entities_Format/Creature_Help.md

@@ -5,6 +5,7 @@ This page helps you to create a creature (i.e. a unit that fights in a battle) f
 ## Utilities
 
 You need to download the two utilities [`DefPreview`](https://sourceforge.net/projects/grayface-misc/files/DefPreview-1.2.1/) and [`H3DefTool`](https://sourceforge.net/projects/grayface-misc/files/H3DefTool-3.4.2/) from the internet:
+
 - `DefPreview` converts a `.def` file to `.bmp` images
 - `H3DefTool` converts `.bmp` images to a `.def` file
 
@@ -21,7 +22,9 @@ The sun is always at zenith, so the shadow is always behind. The reason is that
 We don't know the right elevation angle for the view.
 
 ### 3D render
-You can render your creature using a 3D software like _Blender_. You can start with those free-licenced rigged 3D models:
+
+You can render your creature using a 3D software like *Blender*. You can start with those free-licenced rigged 3D models:
+
 - [Fantasy-bandit](https://www.cgtrader.com/free-3d-models/character/man/fantasy-bandit)
 - [Monster-4](https://www.cgtrader.com/free-3d-models/character/fantasy-character/monster-4-f5757b92-dc9c-4f5e-ad0d-593203d14fe2)
 - [Crypt-fiend-modular-character](https://www.cgtrader.com/free-3d-models/character/fantasy-character/crypt-fiend-modular-character-demo-scene)
@@ -33,57 +36,60 @@ You can render your creature using a 3D software like _Blender_. You can start w
 - [Shani](https://www.cgtrader.com/free-3d-models/character/woman/shani-3d-character)
 
 You can also create your 3D model from a single image:
-- _Stable Fast 3D_: https://huggingface.co/spaces/stabilityai/stable-fast-3d
-- _Unique3D_: https://huggingface.co/spaces/abreza/Unique3D
 
-To use it in _Blender_, create a `.blend` project and import the file. To render the texture:
-1. Add a _Principled BSDF_ material to the object
-1. Create a _Color Attribute_ in the _Shader Editor_ view
-1. Link the Color output of the _Color Attribute_ to the _Base color_ input of the _Principled BSDF_
+- *Stable Fast 3D*: <https://huggingface.co/spaces/stabilityai/stable-fast-3d>
+- *Unique3D*: <https://huggingface.co/spaces/abreza/Unique3D>
+
+To use it in *Blender*, create a `.blend` project and import the file. To render the texture:
+
+1. Add a *Principled BSDF* material to the object
+1. Create a *Color Attribute* in the *Shader Editor* view
+1. Link the Color output of the *Color Attribute* to the *Base color* input of the *Principled BSDF*
 
-You can improve details by cropping the source image on a detail and generate a model for this detail. Once both imported in _Blender_, melt them together.
+You can improve details by cropping the source image on a detail and generate a model for this detail. Once both imported in *Blender*, melt them together.
 
-Render the images without background by selecting png RVBA and disabling background (_Film_ -> _Filter_ -> _Transparent_). It avoids the creatures to have an ugly dark border. Then, to correctly separate the creature from the cyan area, in _GIMP_, apply the threeshold on the transparency by clicking on _Layer_ -> _Transparency_ -> _Alpha threeshold_.
+Render the images without background by selecting png RVBA and disabling background (*Film* -> *Filter* -> *Transparent*). It avoids the creatures to have an ugly dark border. Then, to correctly separate the creature from the cyan area, in *GIMP*, apply the threeshold on the transparency by clicking on *Layer* -> *Transparency* -> *Alpha threeshold*.
 
 The global FPS of the game is 10 f/s but you can render at a higher level and configure it in the `.json` files. We are not in the 1990's.
 
 ### IA render
 
-You can also use an AI like _Flux_ to generate the main creature representation: https://huggingface.co/spaces/multimodalart/FLUX.1-merged
+You can also use an AI like *Flux* to generate the main creature representation: <https://huggingface.co/spaces/multimodalart/FLUX.1-merged>
 
-Then you can add random animations for idle states with _SVD_: https://huggingface.co/spaces/xi0v/Stable-Video-Diffusion-Img2Vid
+Then you can add random animations for idle states with *SVD*: <https://huggingface.co/spaces/xi0v/Stable-Video-Diffusion-Img2Vid>
 
-Most of the time, the creatures do not move more than one pixel in an idle animation. The reason may be to avoid too much animation on screen and make the transition with the other animations always seamless. Use poses with _ControlNet_ or _OpenPose_. For specific animations, I recommend to use _Cinemo_ because it adds a description prompt but the resolution is smaller: https://huggingface.co/spaces/maxin-cn/Cinemo
+Most of the time, the creatures do not move more than one pixel in an idle animation. The reason may be to avoid too much animation on screen and make the transition with the other animations always seamless. Use poses with *ControlNet* or *OpenPose*. For specific animations, I recommend to use *Cinemo* because it adds a description prompt but the resolution is smaller: <https://huggingface.co/spaces/maxin-cn/Cinemo>
 
-Make animations seamless from one to another. To do this, you can draw the first and the last images with a prompt with _ToonCrafter_: https://huggingface.co/spaces/ChristianHappy/tooncrafter
+Make animations seamless from one to another. To do this, you can draw the first and the last images with a prompt with *ToonCrafter*: <https://huggingface.co/spaces/ChristianHappy/tooncrafter>
 
-Most of the time, you need to increase the resolution or the quality of your template image, so use _SUPIR_: https://huggingface.co/spaces/Fabrice-TIERCELIN/SUPIR
+Most of the time, you need to increase the resolution or the quality of your template image, so use *SUPIR*: <https://huggingface.co/spaces/Fabrice-TIERCELIN/SUPIR>
 
 ## Battle sound effect
 
-To create the audio effects, I recommend to use _Tango 2_: https://huggingface.co/spaces/declare-lab/tango2
+To create the audio effects, I recommend to use *Tango 2*: <https://huggingface.co/spaces/declare-lab/tango2>
 
-The quality is better than _Stable Audio_.
+The quality is better than *Stable Audio*.
 
 ## Map render
 
 We don't know the right elevation angle for the view but 45° elevation seems to be a good choice. For the sunlight direction, I would say 45° elevation and 45° azimut.
 
-The map creatures are not rendered on the map with vanishing points but in isometric. You can [get an orthogonal render in Blender](https://blender.stackexchange.com/a/135384/2768). If you are creating a creature and its updated version, most of the time, the both creatures are not oriented to the same side on the map. I think that the animation on the map is usually the _Mouse Over_ animation on battle.
+The map creatures are not rendered on the map with vanishing points but in isometric. You can [get an orthogonal render in Blender](https://blender.stackexchange.com/a/135384/2768). If you are creating a creature and its updated version, most of the time, the both creatures are not oriented to the same side on the map. I think that the animation on the map is usually the *Mouse Over* animation on battle.
 
-You can see that the view angle is higher than on a battle. To change the angle from a battle sprite, you can use _Zero 1-to-3_: https://huggingface.co/spaces/cvlab/zero123-live
+You can see that the view angle is higher than on a battle. To change the angle from a battle sprite, you can use *Zero 1-to-3*: <https://huggingface.co/spaces/cvlab/zero123-live>
 
-You can get higher resolution using this Video AI that can control the motion of the camera: https://huggingface.co/spaces/TencentARC/MotionCtrl_SVD
+You can get higher resolution using this Video AI that can control the motion of the camera: <https://huggingface.co/spaces/TencentARC/MotionCtrl_SVD>
 
-If you have a 3D software, you can get better quality by converting your image into 3D model and then render it from another angle using _Stable Fast 3D_: https://huggingface.co/spaces/stabilityai/stable-fast-3d
+If you have a 3D software, you can get better quality by converting your image into 3D model and then render it from another angle using *Stable Fast 3D*: <https://huggingface.co/spaces/stabilityai/stable-fast-3d>
 
-Follow this comment to retrieve the color: https://huggingface.co/stabilityai/TripoSR/discussions/1#65e8a8e5e214f37d85dad366
+Follow this comment to retrieve the color: <https://huggingface.co/stabilityai/TripoSR/discussions/1#65e8a8e5e214f37d85dad366>
 
 ### Shadow render
 
 There are no strong rules in the original game about the angle of the shadows on the map. Different buildings have inconsistent shadows. To draw the shadow, I recommend the following technique:
 
 Let's consider that the object is a vertical cone:
+
 | | | | | | | | | | |
 |---|---|---|---|---|---|---|---|---|---|
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
@@ -98,6 +104,7 @@ Let's consider that the object is a vertical cone:
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
 
 Locate the top and its projection to the ground:
+
 | | | | | | | | | | |
 |---|---|---|---|---|---|---|---|---|---|
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
@@ -112,6 +119,7 @@ Locate the top and its projection to the ground:
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
 
 Then draw a rectangle triangle on the left:
+
 | | | | | | | | | | |
 |---|---|---|---|---|---|---|---|---|---|
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
@@ -126,6 +134,7 @@ Then draw a rectangle triangle on the left:
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
 
 The square top is the projection of the shadow of the top of the cone:
+
 | | | | | | | | | | |
 |---|---|---|---|---|---|---|---|---|---|
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
@@ -140,6 +149,7 @@ The square top is the projection of the shadow of the top of the cone:
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |
 
 Then you can draw the rest of the shadow:
+
 | | | | | | | | | | |
 |---|---|---|---|---|---|---|---|---|---|
 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 | 🟦 |

docs/modders/Entities_Format/Faction_Format.md

@@ -8,42 +8,42 @@ In order to make functional town, you also need:
 
 ### Images
 
--   Creature backgrounds images, 120x100 and 130x100 versions (2 images)
--   Set of puzzle map pieces (48 images)
--   Background scenery (1 image)
--   Mage guild window view (1 image)
--   Town hall background (1 image)
+- Creature backgrounds images, 120x100 and 130x100 versions (2 images)
+- Set of puzzle map pieces (48 images)
+- Background scenery (1 image)
+- Mage guild window view (1 image)
+- Town hall background (1 image)
 
--   Set of town icons, consists from all possible combinations of: (8
+- Set of town icons, consists from all possible combinations of: (8
     images total)
-    -   small and big icons
-    -   village and fort icons
-    -   built and normal icons
-
--   Set for castle siege screen, consists from:
-    -   Background (1 image)
-    -   Destructible towers (3 parts, 3 images each)
-    -   Destructible walls (4 parts, 3 images each)
-    -   Static walls (3 images)
-    -   Town gates (5 images)
-    -   Moat (2 images)
+  - small and big icons
+  - village and fort icons
+  - built and normal icons
+
+- Set for castle siege screen, consists from:
+  - Background (1 image)
+  - Destructible towers (3 parts, 3 images each)
+  - Destructible walls (4 parts, 3 images each)
+  - Static walls (3 images)
+  - Town gates (5 images)
+  - Moat (2 images)
 
 ### Animation
 
--   Adventure map images for village, town and capitol (3 def files)
+- Adventure map images for village, town and capitol (3 def files)
 
 ### Music
 
--   Town theme music track (at least 1 music file)
+- Town theme music track (at least 1 music file)
 
 ### Buildings
 
 Each town requires a set of buildings (Around 30-45 buildings)
 
--   Town animation file (1 animation file)
--   Selection highlight (1 image)
--   Selection area (1 image)
--   Town hall icon (1 image)
+- Town animation file (1 animation file)
+- Selection highlight (1 image)
+- Selection area (1 image)
+- Town hall icon (1 image)
 
 ## Faction node (root entry for town configuration)
 
@@ -340,7 +340,9 @@ Each town requires a set of buildings (Around 30-45 buildings)
 ```
 
 ## Building node
+
 See [Town Building Format](Town_Building_Format.md)
 
 ## Structure node
-See [Town Building Format](Town_Building_Format.md)
+
+See [Town Building Format](Town_Building_Format.md)

docs/modders/Entities_Format/Faction_Help.md

@@ -3,90 +3,109 @@
 This page helps you to create from scratch a VCMI mod that adds a new faction. The faction mod structure is described [here](Faction_Format.md).
 
 ## Questioning the faction creation
+
 Before creating a faction, be aware that creating a faction mod is lots of work. You can start [creating creatures](Creature_Help.md) in a creature mod that can be converted into a faction mod after. This way, you are sure to release something. The smallest contribution is a hero portrait that you can suggest on an existing mod. You can also restore the former version of the [Ruins faction](https://github.com/vcmi-mods/ruins-town/tree/1bea30a1d915770e2fd0f95d158030815ff462cd). You would only have to remake the similar parts to the new version.
 
 ## Make a playable faction mod
-Before creating your content, retrieve the content of an existing faction mod like [Highlands town](https://github.com/vcmi-mods/highlands-town). To download the project, click on the _Code_ button and click on _Download ZIP_. The first thing to do is to change all the faction identifiers in the files following the [faction format](Faction_Format.md) and manage to play with the faction and the original without any conflict. To play to a faction, you have to add all the files in your _Mods_ folder. When it works, you will be able to modify the content step by step.
+
+Before creating your content, retrieve the content of an existing faction mod like [Highlands town](https://github.com/vcmi-mods/highlands-town). To download the project, click on the *Code* button and click on *Download ZIP*. The first thing to do is to change all the faction identifiers in the files following the [faction format](Faction_Format.md) and manage to play with the faction and the original without any conflict. To play to a faction, you have to add all the files in your *Mods* folder. When it works, you will be able to modify the content step by step.
 
 Keep in mind that the most important part of a faction mod, above the animations, the graphisms and the musics, is the concept because if you have to change it, you have to change everything else. All the remaining content can be improved by the community.
 
 ## Town screen
+
 ### Background
-Beware to direct all the shadows to the same direction. The easiest way to create the background is to use a text-to-image AI. The free most powerful AI at the moment is _Flux_ available here: https://huggingface.co/spaces/multimodalart/FLUX.1-merged
 
-In the _Advanced Options_, set the width to 800px and set the height to 374px.
+Beware to direct all the shadows to the same direction. The easiest way to create the background is to use a text-to-image AI. The free most powerful AI at the moment is *Flux* available here: <https://huggingface.co/spaces/multimodalart/FLUX.1-merged>
+
+In the *Advanced Options*, set the width to 800px and set the height to 374px.
 
 ### Buildings
-To render a building upon the background, I recommend to use an inpainting AI like _BRIA Inpaint_: https://huggingface.co/spaces/briaai/BRIA-2.3-Inpainting
+
+To render a building upon the background, I recommend to use an inpainting AI like *BRIA Inpaint*: <https://huggingface.co/spaces/briaai/BRIA-2.3-Inpainting>
 
 The idea is to select the area where you want to add the building. As a prompt, describe the new building. The advantage is a perfect match between the background and the building. Keep in mind that to correctly integrate a building image, it must contain the image of the background on its edges. It simulates the semi-transparency.
 
-You can also animate the building or the background using _Stable Video Diffusion_: https://huggingface.co/spaces/multimodalart/stable-video-diffusion
+You can also animate the building or the background using *Stable Video Diffusion*: <https://huggingface.co/spaces/multimodalart/stable-video-diffusion>
 
 ## Map dwellings
-You may want to get the same render as in the town, so you have to change the angle and the shadows. If you handle a 3D model software, you can start with _Stable Fast 3D_: https://huggingface.co/spaces/stabilityai/stable-fast-3d
+
+You may want to get the same render as in the town, so you have to change the angle and the shadows. If you handle a 3D model software, you can start with *Stable Fast 3D*: <https://huggingface.co/spaces/stabilityai/stable-fast-3d>
 
 The map dwellings are not rendered on the map with vanishing points but in isometric. You can [get an orthogonal render in Blender](https://blender.stackexchange.com/a/135384/2768).
 
-Without 3D, you can use _Zero 1-to-3_: https://huggingface.co/spaces/cvlab/zero123-live
+Without 3D, you can use *Zero 1-to-3*: <https://huggingface.co/spaces/cvlab/zero123-live>
 
-You can get higher resolution using this Video AI that can control the motion of the camera: https://huggingface.co/spaces/TencentARC/MotionCtrl_SVD
+You can get higher resolution using this Video AI that can control the motion of the camera: <https://huggingface.co/spaces/TencentARC/MotionCtrl_SVD>
 
-The buildings on the map are more satured than on town screen. If you have to reduce the size of an image, do not use interpolation (LANCZOS, Bilinear...) to get more details, not a blurred image. If you need to increase the resolution or the quality of your template image, use _SUPIR_: https://huggingface.co/spaces/Fabrice-TIERCELIN/SUPIR
+The buildings on the map are more satured than on town screen. If you have to reduce the size of an image, do not use interpolation (LANCZOS, Bilinear...) to get more details, not a blurred image. If you need to increase the resolution or the quality of your template image, use *SUPIR*: <https://huggingface.co/spaces/Fabrice-TIERCELIN/SUPIR>
 
 ## Map buildings
+
 The AIs badly understand the sun direction and the perspective angles. To generate the buildings on the adventure map:
 
 1. Open the HOMM3 map editor
 1. Put items all around a big empty area
 1. Make a screenshot
-1. Go on an AI like _BRIA Inpaint_: https://huggingface.co/spaces/briaai/BRIA-2.3-Inpainting
+1. Go on an AI like *BRIA Inpaint*: <https://huggingface.co/spaces/briaai/BRIA-2.3-Inpainting>
 1. Inpaint the (big) empty middle with the brush
 1. Use a prompt like: `A dark house, at the center of the image, map, isometric, parallel perspective, sunlight from the bottom right`
 
 ## Music
+
 Here are unused available themes:
 
 * [Synthetic Horizon](https://github.com/Fabrice-TIERCELIN/forge/raw/theme/content/music/factions/theme.ogg)
+
 1. Prompt: `Dystopy, Cinematic classical, Science fiction, 160 bpm, Best quality, Futuristic`
-1. Initially created for: _Forge town_
+1. Initially created for: *Forge town*
 
 * [Quantum Overture](https://github.com/Fabrice-TIERCELIN/asylum-town/raw/theme/asylum-town/content/Music/factions/AsylumTown.ogg)
+
 1. Prompt: `Clef shifting, Fantasy, Mystical, Overworldly, Cinematic classical`
-1. Initially created for: _Asylum town_
+1. Initially created for: *Asylum town*
 
 * [Warrior s March](https://github.com/vcmi-mods/ruins-town/assets/20668759/964f27de-6feb-4ef6-9d25-455f52938cef)
+
 1. Prompt: `Powerful percussions, Drums, Battle Anthem, Rythm, Warrior, 160 bpm, Celtic, New age, Instrumental, Accoustic, Medieval`
-1. Initially created for: _Ruins town_
+1. Initially created for: *Ruins town*
 
 * [Clan of Echoes](https://github.com/Fabrice-TIERCELIN/ruins-town/raw/theme/ruins-town/content/music/ruins.ogg)
+
 1. Prompt: `new age, medieval, celtic, warrior, battle, soundtrack, accoustic, drums, rythm`
-1. Initially created for: _Ruins town_
+1. Initially created for: *Ruins town*
 
 * [Enchanted Reverie](https://github.com/Fabrice-TIERCELIN/grove/raw/theme/Grove/content/Music/factions/GroveTown.ogg)
+
 1. Prompt: `Classical music, Soundtrack, Score, Instrumental, 160 bpm, ((((fantasy)))), mystic`
-1. Initially created for: _Grove town_
+1. Initially created for: *Grove town*
 
 * [World Discovery](https://github.com/vcmi-mods/asylum-town/assets/20668759/34438523-8a44-44ca-b493-127501b474a6)
+
 1. Prompt: `Clef shifting, fantasy, mystical, overworldly, Cinematic classical`
-1. Initially created for: _Asylum town_
+1. Initially created for: *Asylum town*
 
 * [Enchanted Ballad](https://github.com/vcmi-mods/fairy-town/assets/20668759/619e6e33-d940-4899-8c76-9c1e8d3d20aa)
+
 1. Prompt: `Females vocalize, Cinematic classical, Harp, Fairy tale, Princess, 160 bpm`
-1. Initially created for: _Fairy town_
+1. Initially created for: *Fairy town*
 
 * [Baroque Resurgence](https://github.com/Fabrice-TIERCELIN/courtyard_proposal/raw/theme/Courtyard/Content/music/factions/courtyard/CourtTown.ogg)
+
 1. Prompt: `Baroque, Instrumental, 160 bpm, Cinematic classical, Best quality`
-1. Initially created for: _Courtyard town_
+1. Initially created for: *Courtyard town*
 
 * [Harvest Parade](https://github.com/Fabrice-TIERCELIN/greenhouse-town/raw/theme/Greenhouse/content/Music/town.ogg)
+
 1. Prompt: `Marching band, Best quality, Happy, Vegetables`
-1. Initially created for: _Green town_
+1. Initially created for: *Green town*
 
-Those themes have been generated using _[Udio](https://udio.com)_.
+Those themes have been generated using *[Udio](https://udio.com)*.
 
 ## Screenshots
+
 Most of the time, the first screenshot is the townscreen because it's the most specific content.
 
 ## Recycle
-Some mods contain neutral heroes or creatures. You can integrate them in your faction mod. Don't forget to remove the content from the original mod.
+
+Some mods contain neutral heroes or creatures. You can integrate them in your faction mod. Don't forget to remove the content from the original mod.

docs/modders/Entities_Format/Hero_Class_Format.md

@@ -4,12 +4,12 @@
 
 In order to make functional hero class you also need:
 
--   Adventure animation (1 def file)
--   Battle animation, male and female version (2 def files)
+- Adventure animation (1 def file)
+- Battle animation, male and female version (2 def files)
 
 ## Format
 
-``` javascript
+``` jsonc
 // Unique identifier of hero class, camelCase
 "myClassName" :
 {
@@ -106,4 +106,4 @@ In order to make functional hero class you also need:
 		"conflux"    : 6
 	}
 }
-```
+```

docs/modders/Entities_Format/Hero_Type_Format.md

@@ -4,12 +4,12 @@
 
 In order to make functional hero you also need:
 
--   Portraits, small and big versions (2 images)
--   Specialty icons, small and big versions (2 images)
+- Portraits, small and big versions (2 images)
+- Specialty icons, small and big versions (2 images)
 
 ## Format
 
-``` javascript
+``` jsonc
 "myHeroName" :
 {
 	// Identifier of class this hero belongs to. Such as knight or battleMage
@@ -133,4 +133,4 @@ In order to make functional hero you also need:
 		"creature" : "griffin"
 	}
 }
-```
+```

docs/modders/Entities_Format/River_Format.md

@@ -28,4 +28,4 @@
 		...
 	]
 }
-```
+```

docs/modders/Entities_Format/Road_Format.md

@@ -17,4 +17,4 @@
 	// How many movement points needed to move hero
 	"moveCost" : 66
 }
-```
+```

docs/modders/Entities_Format/Secondary_Skill_Format.md

@@ -123,4 +123,4 @@ boost at advanced and expert levels.
 		}
 	}
 }
-```
+```

docs/modders/Entities_Format/Spell_Format.md

@@ -2,7 +2,7 @@
 
 ## Main format
 
-``` javascript
+``` jsonc
 {
 	"spellName":
 	{	
@@ -156,7 +156,7 @@
 
 TODO
 
-``` javascript
+``` jsonc
 {
 	"projectile": [
 		{"minimumAngle": 0 ,"defName":"C20SPX4"},
@@ -179,7 +179,7 @@ Json object with data common for all levels can be put here. These configuration
 
 This will make spell affect single target on all levels except expert, where it is massive spell.
 
-``` javascript
+``` jsonc
 "base":{
 	"range": 0
 },
@@ -192,7 +192,7 @@ This will make spell affect single target on all levels except expert, where it
 
 TODO
 
-``` javascript
+``` jsonc
 
 {
 	//Mandatory, localizable description. Use {xxx} for formatting
@@ -262,7 +262,7 @@ Configurable spells ignore *offensive* flag, *effects* and *cumulativeEffects*.
 
 TODO
 
-``` javascript
+``` jsonc
 
 "mod:effectId":{
 
@@ -283,7 +283,7 @@ TODO
 
 TODO
 
-``` javascript
+``` jsonc
 
 "mod:effectId":{
 
@@ -304,7 +304,7 @@ TODO
 
 Configurable version of Clone spell.
 
-``` javascript
+``` jsonc
 
 "mod:effectId":{
 
@@ -320,7 +320,7 @@ TODO
 
 If effect is automatic, spell behave like offensive spell (uses power, levelPower etc)
 
-``` javascript
+``` jsonc
 
 "mod:effectId":{
 
@@ -368,7 +368,7 @@ TODO
 If effect is automatic, spell behave like \[de\]buff spell (effect and
 cumulativeEffects ignored)
 
-``` javascript
+``` jsonc
 
 "mod:effectId":{
 
@@ -389,21 +389,21 @@ cumulativeEffects ignored)
 TODO
 
 - CREATURE target (only battle spells)
- - range 0: smart assumed single creature target
- - range "X" + smart modifier = enchanter casting, expert massive spells
- - range "X" + no smart modifier = armageddon, death ripple, destroy undead
- - any other range (including chain effect)
-  - smart modifier: smth like cloud of confusion in H4 (if I remember correctly :) )
-  - no smart modifier: like inferno, fireball etc. but target only creature
+- range 0: smart assumed single creature target
+- range "X" + smart modifier = enchanter casting, expert massive spells
+- range "X" + no smart modifier = armageddon, death ripple, destroy undead
+- any other range (including chain effect)
+- smart modifier: smth like cloud of confusion in H4 (if I remember correctly :) )
+- no smart modifier: like inferno, fireball etc. but target only creature
 
 - NO_TARGET
- - no target selection,(abilities, most adventure spells)
+- no target selection,(abilities, most adventure spells)
 
 - LOCATION
- - any tile on map/battlefield (inferno, fireball etc.), DD also here but with special handling
- - clearTarget - destination hex must be clear (unused so far)
- - clearAfffected - all affected hexes must be clear (forceField, fireWall)
+- any tile on map/battlefield (inferno, fireball etc.), DD also here but with special handling
+- clearTarget - destination hex must be clear (unused so far)
+- clearAfffected - all affected hexes must be clear (forceField, fireWall)
 
 - OBSTACLE target
- - range 0: any single obstacle
- - range X: all obstacles
+- range 0: any single obstacle
+- range X: all obstacles

docs/modders/Entities_Format/Terrain_Format.md

@@ -75,4 +75,4 @@
 	"terrainViewPatterns" : "",
 	
 }
-```
+```

docs/modders/Entities_Format/Town_Building_Format.md

@@ -4,16 +4,19 @@
 
 Each building requires following assets:
 
--   Town animation file (1 animation file)
--   Selection highlight (1 image)
--   Selection area (1 image)
--   Town hall icon (1 image)
+- Town animation file (1 animation file)
+- Selection highlight (1 image)
+- Selection area (1 image)
+- Town hall icon (1 image)
 
 ## Examples
+
 These are just a couple of examples of what can be done in VCMI. See vcmi configuration files to check how buildings from Heroes III are implemented or other mods for more examples
+
 ####
 
-##### Order of Fire from Inferno:
+##### Order of Fire from Inferno
+
 ```jsonc
 "special4": {
 	"requires" : [ "mageGuild1" ],
@@ -34,9 +37,10 @@ These are just a couple of examples of what can be done in VCMI. See vcmi config
 		]
 	}
 }
-``` 
+```
 
 ##### Mana Vortex from Dungeon
+
 ```jsonc
 "special2": {
 	"requires" : [ "mageGuild1" ],
@@ -65,6 +69,7 @@ These are just a couple of examples of what can be done in VCMI. See vcmi config
 ```
 
 #### Resource Silo with custom production
+
 ```jsonc
 "resourceSilo": {
 	"name" : "Wood Resource Silo",
@@ -80,6 +85,7 @@ These are just a couple of examples of what can be done in VCMI. See vcmi config
 ```
 
 #### Brotherhood of Sword - bonuses in siege
+
 ```jsonc
 "special3": {
 	// replaces +1 Morale bonus from Tavern
@@ -96,6 +102,7 @@ These are just a couple of examples of what can be done in VCMI. See vcmi config
 ```
 
 #### Lighthouse - bonus to all heroes under player control
+
 ```jsonc
 "special1":       { 
 	"bonuses": [
@@ -228,10 +235,13 @@ Building requirements can be described using logical expressions:
 	]
 ]
 ```
+
 ### List of unique town buildings
 
 #### Buildings from Heroes III
+
 Following Heroes III buildings can be used as unique buildings for a town. Their functionality should be identical to a corresponding H3 building. H3 buildings that are not present in this list contain no hardcoded functionality. See vcmi json configuration to see how such buildings can be implemented in a mod.
+
 - `mysticPond`
 - `artifactMerchant`
 - `freelancersGuild`
@@ -244,12 +254,14 @@ Following Heroes III buildings can be used as unique buildings for a town. Their
 - `treasury`
 
 #### Buildings from other Heroes III mods
+
 Following HotA buildings can be used as unique building for a town. Functionality should match corresponding HotA building:
+
 - `bank`
 
 #### Custom buildings
-In addition to above, it is possible to use same format as [Rewardable](../Map_Objects/Rewardable.md) map objects for town buildings. In order to do that, configuration of a rewardable object must be placed into `configuration` json node in building config.
 
+In addition to above, it is possible to use same format as [Rewardable](../Map_Objects/Rewardable.md) map objects for town buildings. In order to do that, configuration of a rewardable object must be placed into `configuration` json node in building config.
 
 ### Town Structure node
 
@@ -281,16 +293,18 @@ In addition to above, it is possible to use same format as [Rewardable](../Map_O
 }
 ```
 
-
 #### Markets in towns
+
 Market buildings require list of available [modes](../Map_Objects/Market.md)
 
 ##### Marketplace
+
 ```jsonc
 	"marketplace":    { "marketModes" : ["resource-resource", "resource-player"] },
 ```
 
 ##### Artifact merchant
+
 ```jsonc
 	"special1":       { "type" : "artifactMerchant", "requires" : [ "marketplace" ], "marketModes" : ["resource-artifact", "artifact-resource"] },
-```
+```

docs/modders/File_Formats.md

@@ -1,12 +1,13 @@
 # File Formats
 
-This page describes which file formats are supported by vcmi. 
+This page describes which file formats are supported by vcmi.
 
 In most cases, VCMI supports formats that were supported by Heroes III, with addition of new formats that are more convenient to use without specialized tools. See categories below for more details on specific formats
 
 ### Images
 
 For images VCMI supports:
+
 - png. Recommended for usage in mods
 - bmp. While this format is supported, bmp images have no compressions leading to large file sizes
 - pcx (h3 version). Note that this is format that is specific to Heroes III and has nothing in common with widely known .pcx format. Files in this format generally can only be found inside of .lod archive of Heroes III and are usually extracted as .bmp files
@@ -26,6 +27,7 @@ For animations VCMI supports .def format from Heroes III as well as alternative
 ### Sounds
 
 For sounds VCMI currently supports:
+
 - .ogg/vorbis format - preferred for mods. Unlike wav, vorbis uses compression which may cause some data loss, however even 128kbit is generally undistinguishable from lossless formats
 - .wav format. This is format used by H3. It is supported by vcmi, but it may result in large file sizes (and as result - large mods)
 
@@ -36,6 +38,7 @@ Support for additional formats, such as ogg/opus or flac may be added in future
 ### Music
 
 For music VCMI currently supports:
+
 - .ogg/vorbis format - preferred for mods. Generally offers better quality and lower sizes compared to mp3
 - .mp3 format. This is format used by H3
 
@@ -51,6 +54,7 @@ Starting from VCMI 1.6, following video container formats are supported by VCMI:
 - .webm - modern, free format that is recommended for modding.
 
 Supported video codecs:
+
 - bink and smacker - formats used by Heroes III, should be used only to avoid re-encoding
 - theora - used by Heroes III: HD Edition
 - vp8 - modern format with way better compression compared to formats used by Heroes III
@@ -59,6 +63,7 @@ Supported video codecs:
 Support for av1 video codec is likely to be added in future.
 
 Supported audio codecs:
+
 - binkaudio and smackaud - formats used by Heroes III
 - vorbis - modern format with good compression level
 - opus - recommended, improvement over vorbis. Any bitrate is supported, with 128 kbit probably being the best option

docs/modders/Game_Identifiers.md

@@ -493,7 +493,7 @@ This is a list of all game identifiers available to modders. Note that only iden
 - hero.thorgrim
 - hero.thunar
 - hero.tiva
-- hero.torosar 
+- hero.torosar
 - hero.tyraxor
 - hero.tyris
 - hero.ufretin

docs/modders/HD_Graphics.md

@@ -13,6 +13,7 @@ If user for example selects 3x resolution and only 2x exists in mod then the 2x
 ## Mod
 
 For upscaled images you have to use following folders (next to `sprites` and `data` folders):
+
 - `sprites2x`, `sprites3x`, `sprites4x` for sprites
 - `data2x`, `data3x`, `data4x` for images
 
@@ -24,11 +25,13 @@ It's also possible (but not necessary) to add high-definition shadows: Just plac
 In future, such shadows will likely become required to correctly exclude shadow from effects such as Clone spell.
 
 Shadow images are used only for animations of following objects:
+
 - All adventure map objects
 - All creature animations in combat
 
 Same for overlays with `-overlay`. But overlays are **necessary** for some animation graphics. They will be colorized by VCMI.
 
 Currently needed for:
+
 - Flaggable adventure map objects. Overlay must contain a transparent image with white flags on it and will be used to colorize flags to owning player
 - Creature battle animations, idle and mouse hover group. Overlay must contain a transparent image with white outline of creature for highlighting on mouse hover)

docs/modders/Map_Editor.md

@@ -38,7 +38,7 @@ Templates are dynamically filtered depending on parameters you choose.
 
 To load the map, press open and select map file from the browser.
 
-You can load both *.h3m and *.vmap formats but for saving *.vmap is allowed only.
+You can load both *.h3m and*.vmap formats but for saving *.vmap is allowed only.
 
 ## Views
 
@@ -60,7 +60,7 @@ There are 3 buttons switching views <img width="131" alt="Снимок экра
 
 <img width="190" src="https://user-images.githubusercontent.com/9308612/188778010-a1d45d59-7333-4432-b83f-57190fbe09f4.png">
 
-# Setup terrain
+## Setup terrain
 
 1. Select brush you want
 <img width="124" src="https://user-images.githubusercontent.com/9308612/188776299-fd688696-a98d-4f89-8bef-e81c90d3724b.png">
@@ -77,7 +77,7 @@ There are 3 buttons switching views <img width="131" alt="Снимок экра
 
 #### Drawing roads and rivers
 
-Actually, the process to draw rivers or roads is exactly the same as for terrains. You need to select tiles and then choose road/river type from the panel. 
+Actually, the process to draw rivers or roads is exactly the same as for terrains. You need to select tiles and then choose road/river type from the panel.
 
 <img width="232" src="https://user-images.githubusercontent.com/9308612/189968965-7adbd76c-9ffc-46e5-aeb7-9a79214cc506.png">
 
@@ -85,9 +85,10 @@ To erase roads or rivers, you need to select tiles to be cleaned and press empty
 
 <img width="130" src="https://user-images.githubusercontent.com/9308612/189969309-87ff7818-2915-4b38-b9db-ec4a616d18e7.png">
 
-_Erasing works either for roads or for rivers, e.g. empty button from the roads tab erases roads only, but not rivers. You also can safely select bigger area, because it won't erase anything on tiles without roads/rivers accordingly_
+*Erasing works either for roads or for rivers, e.g. empty button from the roads tab erases roads only, but not rivers. You also can safely select bigger area, because it won't erase anything on tiles without roads/rivers accordingly*
 
 ### About brushes
+
 * Buttons "1", "2", "4" - 1x1, 2x2, 4x4 brush sizes accordingly
 * Button "[]" - non-additive rectangle selection
 * Button "O" - lasso brush (not implemented yet)
@@ -171,7 +172,7 @@ You can modify general properties of the map
 
 ## Player settings
 
-Open **Map** menu on the top and select **Player settings" 
+Open **Map** menu on the top and select **Player settings"
 
 <img width="141" src="https://user-images.githubusercontent.com/9308612/188781357-4a6091cf-f175-4649-a000-620f306d2c46.png">
 
@@ -208,6 +209,7 @@ vcmieditor loads set of mods using exactly same mechanism as game uses and mod m
 The mods mechanism used in map editor is the same as in game.
 
 To enable or disable mods
+
 * Start launcher, activate or deactivate mods you want
 * Close launcher
 * Run map editor
@@ -233,4 +235,4 @@ You also may have other mods being activated in addition to what was used during
 
 #### Mod versions
 
-In the future, the will be support of mods versioning so map will contain information about mods used and game can automatically search and activate required mods or let user know which are required. However, it's not implemented yet
+In the future, the will be support of mods versioning so map will contain information about mods used and game can automatically search and activate required mods or let user know which are required. However, it's not implemented yet

docs/modders/Map_Object_Format.md

@@ -4,11 +4,11 @@
 
 Full object consists from 3 parts:
 
--   Object group - set of objects that have similar behavior and share
+- Object group - set of objects that have similar behavior and share
     same identifier in H3 (towns, heroes, mines, etc)
--   Object type - object with fixed behavior but without fixed
+- Object type - object with fixed behavior but without fixed
     appearance. Multiple objects types may share same group
--   Object template - defines appearance of an object - image used to
+- Object template - defines appearance of an object - image used to
     display it, its size & blockmap. These entries only describe
     templates that will be used when object is placed via map editor or
     generated by the game. When new object is created its starting
@@ -16,7 +16,7 @@ Full object consists from 3 parts:
 
 ## Object group format
 
-``` javascript
+``` jsonc
 
 {
 	"myCoolObjectGroup":
@@ -42,6 +42,7 @@ Full object consists from 3 parts:
 ## Object types
 
 ### Moddable types
+
 These are object types that are available for modding and have configurable properties
 
 - `configurable` - see [Rewardable](Map_Objects/Rewardable.md). Visitable object which grants all kinds of rewards (gold, experience, Bonuses etc...)
@@ -55,6 +56,7 @@ These are object types that are available for modding and have configurable prop
 - `terrain` - Defines terrain overlays such as magic grounds. TODO: documentation. See config files in vcmi installation for reference
 
 ### Common types
+
 These are types that don't have configurable properties, however it is possible to add additional map templates for this objects, for use in editor or in random maps generator
 
 - `static` - Defines unpassable static map obstacles that can be used by RMG
@@ -79,6 +81,7 @@ These are types that don't have configurable properties, however it is possible
 - `monolith`
 
 ### Internal types
+
 These are internal types that are generally not available for modding and are handled by vcmi internally.
 
 - `hero`
@@ -96,7 +99,7 @@ These are internal types that are generally not available for modding and are ha
 
 ## Object type format
 
-``` javascript
+``` jsonc
 {
 	"myCoolObject":
 	{
@@ -150,7 +153,7 @@ These are internal types that are generally not available for modding and are ha
 
 ## Object template format
 
-``` javascript
+``` jsonc
 {
 	"myCoolObjectTemplate" : 
 	{

docs/modders/Map_Objects/Boat.md

@@ -1,6 +1,6 @@
 # Boat
 
-``` javascript
+``` jsonc
 {
 	// Layer on which this boat moves. Possible values:
 	// "land" - same rules as movement of hero on land
@@ -27,4 +27,4 @@
 	// List of bonuses that will be granted to hero located in the boat
 	"bonuses" : { BONUS_FORMAT }
 }
-```
+```

docs/modders/Map_Objects/Creature_Bank.md

@@ -6,8 +6,10 @@ Format of rewards is same as in [Rewardable Objects](Rewardable.md)
 Deprecated in 1.6. Please use [Rewardable Objects](Rewardable.md) instead. See Conversion from 1.5 format section below for help with migration
 
 ### Example
+
 This example defines a rewardable object with functionality similar of H3 creature bank.
 See [Rewardable Objects](Rewardable.md) for detailed documentation of these properties.
+
 ```jsonc
 {
 	"name" : "Cyclops Stockpile",
@@ -93,6 +95,7 @@ See [Rewardable Objects](Rewardable.md) for detailed documentation of these prop
 ```
 
 ### Conversion from 1.5 format
+
 This is a list of changes that needs to be done to bank config to migrate it to 1.6 system. See [Rewardable Objects](Rewardable.md) documentation for description of new fields
 
 - If your object type has defined `handler`, change its value from `bank` to `configurable`

docs/modders/Map_Objects/Dwelling.md

@@ -1,6 +1,6 @@
 # Dwelling
 
-``` javascript
+``` jsonc
 {
 	/// List of creatures in this bank. Each list represents one "level" of bank
 	/// Creatures on the same level will have shared growth and available number (similar to towns)
@@ -19,4 +19,4 @@
 		{ "amount" : 12, "type" : "earthElemental" }
 	]
 }
-```
+```

docs/modders/Map_Objects/Flaggable.md

@@ -3,6 +3,7 @@
 Flaggable object are those that can be captured by a visiting hero. H3 examples are mines, dwellings, or lighthouse.
 
 Currently, it is possible to make flaggable objects that provide player with:
+
 - Any [Bonus](Bonus_Format.md) supported by bonus system
 - Daily resources income (wood, ore, gold, etc)
 

docs/modders/Map_Objects/Market.md

@@ -34,6 +34,7 @@ Here is schema describing such object
 
 Mode parameter defines a way to exchange different entities. Multiple modes can be specified to support several types of exchange.
 Following options are supported:
+
 * `"resource-resource"` - regular resource exchange, like trading post
 * `"resource-player"` - allows to send resources to another player
 * `"creature-resource"` - acts like freelance guild
@@ -49,6 +50,7 @@ Following options are supported:
 ### Trading post
 
 Trading post allows to exchange resources and send resources to another player, so it shall be configured this way:
+
 ```json
 "modes" : ["resource-resource", "resource-player"]
 ```
@@ -98,4 +100,4 @@ See [Secondary skills](Rewardable.md#secondary-skills) description for more deta
     { "noneOf" : ["necromancy"] },
     { "noneOf" : ["necromancy"] }
 ]
-```
+```

docs/modders/Map_Objects/Rewardable.md

@@ -1,7 +1,9 @@
 # Rewardable
 
 ## Base object definition
+
 Rewardable object is defined similarly to other objects, with key difference being `handler`. This field must be set to `"handler" : "configurable"` in order for vcmi to use this mode.
+
 ```jsonc
 {
   "baseObjectName" : {
@@ -34,6 +36,7 @@ Rewardable object is defined similarly to other objects, with key difference bei
 ```
 
 ## Configurable object definition
+
 ```jsonc
 // List of potential rewards
 "rewards" : [
@@ -173,6 +176,7 @@ This property allows defining "variables" that are shared between all rewards an
 Variables are randomized only once, so you can use them multiple times for example, to give skill only if hero does not have this skill (e.g. Witch Hut).
 
 Example of creation of a variable named "gainedSkill" of type "secondarySkill":
+
 ```json
 "variables" : {
 	"secondarySkill" : {
@@ -187,6 +191,7 @@ Example of creation of a variable named "gainedSkill" of type "secondarySkill":
 ```
 
 Possible variable types:
+
 - number: can be used in any place that expects a number
 - artifact
 - spell
@@ -194,6 +199,7 @@ Possible variable types:
 - secondarySkill
 
 To reference variable in limiter prepend variable name with '@' symbol:
+
 ```json
 "secondary" : {
     "@gainedSkill" : 1
@@ -201,7 +207,9 @@ To reference variable in limiter prepend variable name with '@' symbol:
 ```
 
 ## Reset Parameters definition
+
 This property describes how object state should be reset. Objects without this field will never reset its state.
+
 - Period describes interval between object resets in day. Periods are counted from game start and not from hero visit, so reset duration of 7 will always reset object on new week & duration of 28 will always reset on new month.
 - If `visitors` is set to true, game will reset list of visitors (heroes and players) on start of new period, allowing revisits of objects with `visitMode` set to `once`, `hero`, or `player`. Objects with visit mode set to `bonus` are not affected. In order to allow revisit such objects use appropriate bonus duration (e.g. `ONE_DAY` or `ONE_WEEK`) instead.
 - If `rewards` is set to true, object will re-randomize its provided rewards, similar to such H3 objects as "Fountain of Fortune" or "Windmill"
@@ -215,9 +223,11 @@ This property describes how object state should be reset. Objects without this f
 ```
 
 ## Appear Chance definition
+
 This property describes chance for reward to be selected.
 When object is initialized on map load, game will roll a "dice" - random number in range 0-99, and pick all awards that have appear chance within selected number.
 Note that object that uses appearChance MUST have continuous range for every value in 0-99 range. For example, object with 3 different rewards may want to define them as
+
 - `"min" :  0, "max" : 33`
 - `"min" : 33, "max" : 66`
 - `"min" : 66, "max" : 100`
@@ -240,16 +250,19 @@ In other words, min chance of second reward must be equal to max chance of previ
 ```
 
 ## Configurable Properties
+
 Unless stated othervice, all numbers in this section can be replaced with random values, e.g.
+
 ```jsonc
 "minLevel" : { "min" : 5, "max" : 10 } // select random number between 5-10, including both 5 & 10
 "minLevel" : [ 2, 4, 6, 8, 10] // (VCMI 1.2) select random number out of provided list, with equal chance for each
 ```
 
-In this case, actual value for minLevel will be picked randomly. 
+In this case, actual value for minLevel will be picked randomly.
 Keep in mind, that all randomization is performed on map load and on object reset (if `rewards` field in `resetParameter` was set).
 
 ### Current Day
+
 - Can only be used as limiter. To pass, current day of week should be equal to this value. 1 = first day of the week, 7 = last day
 
 ```jsonc
@@ -263,6 +276,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Resource
+
 - Can be used as limiter. To pass, player needs to have specified resources. Note that limiter will NOT take resources.
 - Can be used as reward to grant resources to player
 - If negative value is used as reward, it will be used as cost and take resources from player
@@ -273,6 +287,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
     "gold" : -1000,
 }, 
 ```
+
 - Alternative format that allows random selection of a resource type
 
 ```jsonc
@@ -289,6 +304,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Experience
+
 - Can be used as limiter
 - Can be used as reward to grant experience to hero
 
@@ -297,6 +313,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Hero Level
+
 - Can be used as limiter. Hero requires to have at least specified level
 - Can be used as reward, will grant hero experience amount equal to the difference between the hero's next level and current level (Tree of Knowledge)
 
@@ -305,6 +322,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Mana Points
+
 - Can be used as limiter. Hero must have at least specific mana amount
 - Can be used as reward, to give mana points to hero. Mana points may go above mana pool limit.
 - If negative value is used as reward, it will be used as cost and take mana from player
@@ -320,6 +338,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Mana Percentage
+
 - Can be used as limiter. Hero must have at least specific mana percentage
 - Can be used to set hero mana level to specified percentage value, not restricted to mana pool limit (Magic Well, Mana Spring)
 
@@ -328,14 +347,16 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Movement Points
+
 - Can NOT be used as limiter
 - Can be used as reward, to give movement points to hero. Movement points may go above mana pool limit.
 
 ```jsonc
 "movePoints": 200,
 ```
-    
+
 ### Movement Percentage
+
 - Can NOT be used as limiter
 - Can be used to set hero movement points level to specified percentage value. Value of 0 will take away any remaining movement points
 
@@ -344,6 +365,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Primary Skills
+
 - Can be used as limiter, hero must have primary skill at least at specified level
 - Can be used as reward, to increase hero primary skills by selected value
 - If reward value is negative, value will be used as cost, decreasing primary skill
@@ -376,12 +398,14 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Secondary Skills
+
 - Can be used as limiter, hero must have secondary skill at least at specified level
 - Can be used as reward, to grant secondary skills to hero
 - If hero already has specified skill, the skills will be leveled up specified number of times
 - If hero does not have selected skill and have free skill slots, he will receive skill at specified level
 - Possible values: 1 (basic), 2 (advanced), 3 (expert)
 - Each secondary skill can be explicitly specified or randomly selected
+
 ```jsonc
 "secondary": [
     {
@@ -416,6 +440,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Bonus System
+
 - Can be used as reward, to grant bonus to player
 - if present, MORALE and LUCK bonus will add corresponding image component to UI.
 - Note that unlike most values, parameter of bonuses can NOT be randomized
@@ -433,6 +458,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Artifacts
+
 - Can be used as limiter, hero must have artifact either equipped or in backpack
 - Can be used as reward, to give new artifact to a hero
 - Artifacts added as reward will be used for text substitution. First `%s` in text string will be replaced with name of an artifact
@@ -458,6 +484,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Spells
+
 - Can be used as limiter
 - Can be used as reward, to give new spell to a hero
 - Spells added as reward will be used for text substitution. First `%s` in text string will be replaced with spell name
@@ -485,7 +512,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 - Can be used as limiter. Hero must be able to learn spell to pass the limiter
 - Hero is considered to not able to learn the spell if:
 - - he already has specified spell
-- - he does not have a spellbook 
+- - he does not have a spellbook
 - - he does not have sufficient Wisdom level for this spell
 
 ```json
@@ -495,10 +522,12 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Creatures
+
 - Can be used as limiter
 - Can be used as reward, to give new creatures to a hero
 - If hero does not have enough free slots, game will show selection dialog to pick troops to keep
 - It is possible to specify probability to receive upgraded creature
+
 ```jsonc
 "creatures" : [
     {
@@ -510,12 +539,14 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Guards
+
 - When used in a reward, these creatures will be added to guards of the objects
 - Hero must defeat all guards before being able to receive rewards
 - Guards are only reset when object rewards are reset
 - Requires `guardsLayout` property to be set in main part of object configuration
 - It is possible to add up to 7 slots of creatures
 - Guards of the same creature type will never merge or rearrange their stacks
+
 ```jsonc
 "guards" : [
     { "type" : "archer", "amount" : 20 },
@@ -525,6 +556,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Creatures Change
+
 - Can NOT be used as limiter
 - Can be used as reward, to replace creatures in hero army. It is possible to use this parameter both for upgrades of creatures as well as for changing them into completely unrelated creature, e.g. similar to Skeleton Transformer
 - This parameter will not change creatures given by `creatures` parameter on the same visit
@@ -536,6 +568,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Spell cast
+
 - Can NOT be used as limiter
 - As reward, instantly casts adventure map spell for visiting hero. All checks for spell book, wisdom or presence of mana will be ignored. It's possible to specify school level at which spell will be casted. If it's necessary to reduce player's mana or do some checks, they shall be introduced as limiters and other rewards
 - School level possible values: 1 (basic), 2 (advanced), 3 (expert)
@@ -567,6 +600,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Player color
+
 - Can be used as limiter
 - Can NOT be used as reward
 - Only players with specific color can pass the limiter
@@ -576,6 +610,7 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Hero types
+
 - Can be used as limiter
 - Can NOT be used as reward
 - Only specific heroes can pass the limiter
@@ -585,10 +620,11 @@ Keep in mind, that all randomization is performed on map load and on object rese
 ```
 
 ### Hero classes
+
 - Can be used as limiter
 - Can NOT be used as reward
 - Only heroes belonging to specific classes can pass the limiter
 
 ```jsonc
 "heroClasses" : [ "battlemage" ]
-```
+```

docs/modders/Mod_File_Format.md

@@ -2,7 +2,7 @@
 
 ## Fields with description of mod
 
-``` javascript
+``` jsonc
 {
 	// Name of your mod. While it does not have hard length limit
 	// it should not be longer than ~30 symbols to fit into allowed space
@@ -91,7 +91,7 @@
 
 These are fields that are present only in local mod.json file
 
-``` javascript
+``` jsonc
  
 {
 	// Following section describes configuration files with content added by mod
@@ -228,4 +228,4 @@ These are fields that are present only in remote repository and are generally no
 For mod description it is possible to use certain subset of HTML as
 described here:
 
-<http://qt-project.org/doc/qt-5.0/qtgui/richtext-html-subset.html>
+<http://qt-project.org/doc/qt-5.0/qtgui/richtext-html-subset.html>

docs/modders/Random_Map_Template.md

@@ -2,7 +2,7 @@
 
 ## Template format
 
-``` javascript
+``` jsonc
 /// Unique template name
 "Triangle" : 
 {
@@ -56,7 +56,7 @@
 
 ## Zone format
 
-``` javascript
+``` jsonc
 {
 	// Type of this zone. Possible values are:
 	// "playerStart", "cpuStart", "treasure", "junction"
@@ -157,4 +157,4 @@
 		]
 	}
 }
-```
+```

docs/modders/Readme.md

@@ -21,8 +21,8 @@ Example of how directory structure of your mod may look like:
                 sprites/ - animation, image sets (H3 .def files or VCMI .json files)
                 video/   - video files, .bik, .smk, .ogv .webm
 ```
-See [File Formats](File_Formats.md) page for more information on which formats are supported or recommended for vcmi
 
+See [File Formats](File_Formats.md) page for more information on which formats are supported or recommended for vcmi
 
 ## Creating mod file
 
@@ -30,7 +30,7 @@ All VCMI configuration files use [JSON format](http://en.wikipedia.org/wiki/Json
 Mod.json is main file in your mod and must be present in any mod. This file contains basic description of your mod, dependencies or conflicting mods (if present), list of new content and so on.
 Minimalistic version of this file:
 
-``` javascript
+``` jsonc
 {
     "name" : "My test mod",
     "description" : "My test mod that add a lot of useless stuff into the game",
@@ -45,6 +45,7 @@ See [Mod file Format](Mod_File_Format.md) for its full description.
 ## Creation of new objects
 
 In order to create new object use following steps:
+
 1. Create json file with definition of new object. See list of supported object types below.
 2. Add any resources needed for this object, such as images, animations or sounds.
 2. Add reference to new object in corresponding section of mod.json file
@@ -52,9 +53,11 @@ In order to create new object use following steps:
 ### List of supported new object types
 
 Random Map Generator:
+
 - [Random Map Template](Random_Map_Template.md)
 
 Game Entities:
+
 - [Artifact](Entities_Format/Artifact_Format.md)
 - [Creature Requirement](Entities_Format/Creature_Format.md)
 - [Creature Help](Entities_Format/Creature_Help.md)
@@ -66,6 +69,7 @@ Game Entities:
 - [Secondary Skill](Entities_Format/Secondary_Skill_Format.md)
 
 Map objects:
+
 - [Map Objects](Map_Object_Format.md)
 - - [Rewardable](Map_Objects/Rewardable.md)
 - - [Creature Bank](Map_Objects/Creature_Bank.md)
@@ -74,6 +78,7 @@ Map objects:
 - - [Boat](Map_Objects/Boat.md)
 
 Other:
+
 - [Terrain](Entities_Format/Terrain_Format.md)
 - [River](Entities_Format/River_Format.md)
 - [Road](Entities_Format/Road_Format.md)
@@ -96,7 +101,8 @@ VCMI uses strings to reference objects. Examples:
 ### Modifying existing objects
 
 Alternatively to creating new objects, you can edit existing objects. Normally, when creating new objects you specify object name as:
-``` javascript
+
+``` jsonc
 "newCreature" : {
     // creature parameters
 }
@@ -104,7 +110,7 @@ Alternatively to creating new objects, you can edit existing objects. Normally,
 
 In order to access and modify existing object you need to specify mod that you wish to edit:
 
-``` javascript
+``` jsonc
 /// "core" specifier refers to objects that exist in H3
 "core:archer" : {
 	/// This will set health of Archer to 10
@@ -123,6 +129,7 @@ In order to access and modify existing object you need to specify mod that you w
 	"speed" : 10
 },
 ```
+
 Note that modification of existing objects does not requires a dependency on edited mod. Such definitions will only be used by game if corresponding mod is installed and active.
 
 This allows using objects editing not just for rebalancing mods but also to provide compatibility between two different mods or to add interaction between two mods.
@@ -132,6 +139,7 @@ This allows using objects editing not just for rebalancing mods but also to prov
 Any graphical replacer mods fall under this category. In VCMI directory **<mod name>/Content** acts as mod-specific game root directory. So for example file **<mod name>/Content/Data/AISHIELD.PNG** will replace file with same name from **H3Bitmap.lod** game archive.
 Any other files can be replaced in exactly same way.
 Note that replacing files from archives requires placing them into specific location:
+
 - H3Bitmap.lod -> Data
 - H3Sprite.lod -> Sprites
 - Heroes3.snd  -> Sounds
@@ -145,12 +153,13 @@ This includes archives added by expansions (e.g. **H3ab_bmp.lod** uses same rule
 
 Heroes III uses custom format for storing animation: def files. These files are used to store all in-game animations as well as for some GUI elements like buttons and for icon sets.
 These files can be replaced by another def file but in some cases original format can't be used. This includes but not limited to:
--   Replacing one (or several) icons in set
--   Replacing animation with fully-colored 32-bit images
+
+- Replacing one (or several) icons in set
+- Replacing animation with fully-colored 32-bit images
 In VCMI these animation files can also be replaced by json description of their content. See [Animation Format](Animation_Format.md) for full description of this format.
 Example: replacing single icon
 
-``` javascript
+``` jsonc
 {
 	// List of replaced images
 	"images" :
@@ -191,7 +200,7 @@ Same way we can also create special stable branch for every mod under "vcmi-mods
 ### Getting into vcmi-mods organization
 
 Before your mod can be accepted into official mod list you need to get it into repository under "vcmi-mods" organization umbrella. To do this contact one of mod repository maintainers. If needed you can get own team within "vcmi-mods" organization.
-Link to our mod will looks like that: https://github.com/vcmi-mods/adventure-ai-trace
+Link to our mod will looks like that: <https://github.com/vcmi-mods/adventure-ai-trace>
 
 ## Rules of repository
 
@@ -199,8 +208,8 @@ Link to our mod will looks like that: https://github.com/vcmi-mods/adventure-ai-
 
 For sanity reasons mod identifier must only contain lower-case English characters, numbers and hyphens.
 
-    my-mod-name
-    2000-new-maps
+`my-mod-name`
+`2000-new-maps`
 
 Sub-mods can be named as you like, but we strongly encourage everyone to use proper identifiers for them as well.
 

docs/players/Bug_Reporting_Guidelines.md

@@ -23,9 +23,9 @@ First of all, if you encounter a crash, don't re-run VCMI immediately to see if
 
 By default, log files are written to:
 
--   Windows: Documents\My Games\vcmi\\
--   Linux: ~/.cache/vcmi/
--   Android: Android/data/is.xyz.vcmi/files/vcmi-data/cache/
+- Windows: Documents\My Games\vcmi\\
+- Linux: ~/.cache/vcmi/
+- Android: Android/data/is.xyz.vcmi/files/vcmi-data/cache/
 
 Now you should try to reproduce encountered issue. It's best when you write how to reproduce the issue by starting a new game and taking some steps (e.g. start Arrogance map as red player and attack monster Y with hero X). If you have troubles with reproducing it this way but you can do it from a savegame - that's good too. Finally, when you are not able to reproduce the issue at all, just upload the files mentioned above. To sum up, this is a list of what's the most desired for a developer:
 

docs/players/Cheat_Codes.md

@@ -70,13 +70,15 @@ Alternative usage: `vcmiexp <amount>` - gives selected hero specified amount of
 `nwcbluepill` or `vcmimelkor` or `vcmilose` - player loses
 
 ### Misc
+
 `nwctheone` or `vcmigod` - reveals the whole map, gives 5 archangels in each empty slot, unlimited movement points and permanent flight
 
 ## Using cheat codes on other players
+
 By default, all cheat codes apply to current player. Alternatively, it is possible to specify player that you want to target:
 
 - Specific players: `red`/`blue`/`green`...
-- Only AI players: `ai` 
+- Only AI players: `ai`
 - All players: `all`
 
 ### Examples
@@ -89,12 +91,14 @@ By default, all cheat codes apply to current player. Alternatively, it is possib
 ## Multiplayer chat commands
 
 Following commands can be used in multiplayer only by host player to control the session:
+
 - `!exit` - finish the game  
 - `!save <filename>` - save the game into the specified file  
 - `!kick red/blue/tan/green/orange/purple/teal/pink` - kick player of specified color from the game  
-- `!kick 0/1/2/3/4/5/6/7/8` - kick player of specified ID from the game (_zero indexed!_) (`0: red, 1: blue, tan: 2, green: 3, orange: 4, purple: 5, teal: 6, pink: 7`)  
+- `!kick 0/1/2/3/4/5/6/7/8` - kick player of specified ID from the game (*zero indexed!*) (`0: red, 1: blue, tan: 2, green: 3, orange: 4, purple: 5, teal: 6, pink: 7`)  
 
 Following commands can be used by any player in multiplayer:
+
 - `!help` - displays in-game list of available commands
 - `!cheaters` - lists players that have entered cheat at any point of the game
 - `!vote` - initiates voting to change one of the possible options:
@@ -114,12 +118,14 @@ Windows builds of VCMI run separate console window by default, on other platform
 Below a list of supported commands, with their arguments wrapped in `<>`
 
 #### Game Commands
+
 `die, fool` - quits game  
 `save <filename>` - saves game in given file (at the moment doesn't work)  
 `mp` - on adventure map with a hero selected, shows heroes current movement points, max movement points on land and on water  
 `bonuses` - shows bonuses of currently selected adventure map object
 
 #### Extract commands
+
 `translate` - save game texts into json files
 `translate missing` - save untranslated game texts into json files
 `translate maps` - save map and campaign texts into json files
@@ -131,15 +137,17 @@ Below a list of supported commands, with their arguments wrapped in `<>`
 `generate assets` - generate all assets at once
 
 #### AI commands
+
 `setBattleAI <ai name>` - change battle AI used by neutral creatures to the one specified, persists through game quit  
 `gosolo` - AI takes over until the end of turn (unlike original H3 currently causes AI to take over until typed again)  
 `controlai <[red][blue][tan][green][orange][purple][teal][pink]>` - gives you control over specified AI player. If none is specified gives you control over all AI players  
 `autoskip` - Toggles autoskip mode on and off. In this mode, player turns are automatically skipped and only AI moves. However, GUI is still present and allows to observe AI moves. After this option is activated, you need to end first turn manually. Press `[Shift]` before your turn starts to not skip it  
 
 #### Settings
+
 `set <command> <on/off>` - sets special temporary settings that reset on game quit. Below some of the most notable commands:  
 -`autoskip` - identical to `autoskip` option  
--`onlyAI` - run without human player, all players will be _default AI_  
+-`onlyAI` - run without human player, all players will be *default AI*  
 -`headless` - run without GUI, implies `onlyAI` is set  
 -`showGrid` - display a square grid overlay on top of adventure map  
 -`showBlocked` - show blocked tiles on map  
@@ -147,6 +155,7 @@ Below a list of supported commands, with their arguments wrapped in `<>`
 -`hideSystemMessages` - suppress server messages in chat  
 
 #### Developer Commands
+
 `crash` - force a game crash. It is sometimes useful to generate memory dump file in certain situations, for example game freeze  
 `gui` - displays tree view of currently present VCMI common GUI elements  
 `activate <0/1/2>` - activate game windows (no current use, apparently broken long ago)  

docs/players/Game_Mechanics.md

@@ -58,7 +58,7 @@ These bugs were present in original Shadow of Death game, however the team decid
 Some of H3 mechanics can't be straight considered as bug, but default VCMI behaviour is different:
 
 - Pathfinding. Hero can't grab artifact while flying when all tiles around it are guarded without triggering attack from guard.
-- Battles. Hero that won battle, but only have temporary summoned creatures alive going to appear in tavern like if he retreated. 
+- Battles. Hero that won battle, but only have temporary summoned creatures alive going to appear in tavern like if he retreated.
 - Battles. Spells from artifacts like AOTD are autocasted on beginning of the battle, not beginning of turn.
 
 ## Adventure map features
@@ -106,7 +106,7 @@ In combat, some creatures, such as Dragon or Cerberi, may attack enemies on mult
 - [LCtrl] + LClick – splits a single unit from the selected stack into an empty slot.
 - [LCtrl] + [LShift] + LClick – split single units from the selected stack into all empty hero/garrison slots
 - [Alt] + LClick – merge all split single units into one stack
-- [Alt] + [LCtrl] + LClick - move all units of selected stack to the city's garrison or to the met hero 
+- [Alt] + [LCtrl] + LClick - move all units of selected stack to the city's garrison or to the met hero
 - [Alt] + [LShift] + LClick - dismiss selected stack`
 - Directly type numbers in the Split Stack window to split them in any way you wish
 
@@ -174,6 +174,7 @@ TODO
 Simultaneous turns allow multiple players to act at the same time, speeding up early game phase in multiplayer games. During this phase if different players (allies or not) attempt to interact with each other, such as capture objects owned by other players (mines, dwellings, towns) or attack their heroes, game will block such actions. Interaction with same map objects at the same time, such as attacking same wandering monster is also blocked.
 
 Following options can be used to configure simultaneous turns:
+
 - Minimal duration (at least for): this is duration during which simultaneous turns will run unconditionally. Until specified number of days have passed, simultaneous turns will never break and game will not attempt to detect contacts.
 - Maximal duration (at most for): this is duration after which simultaneous turns will end unconditionally, even if players still have not contacted each other. However if contact detection discovers contact between two players, simultaneous turns between them might end before specified duration.
 - Simultaneous turns for AI: If this option is on, AI can act at the same time as human players. Note that AI shares settings for simultaneous turns with human players - if no simultaneous turns have been set up this option has no effect.
@@ -185,6 +186,7 @@ Players are considered to be "in contact" if movement range of their heroes at t
 Once detected, contact can never be "lost". If game detected contact between two players, this contact will remain active till the end of the game, even if their heroes move far enough from each other.
 
 Game performs contact detection once per turn, at the very start of each in-game day. Once contact detection has been performed, players that are not in contact with each other can start making turn. For example, in game with 4 players: red, blue, brown and green. If game detected contact between red and blue following will happen:
+
 - red, brown and green will all instantly start turn
 - once red ends his turn, blue will be able to start his own turn (even if brown or green are still making turn)
 
@@ -197,4 +199,4 @@ Differences compared to HD Mod version:
 
 ## Manuals and guides
 
-- https://heroes.thelazy.net/index.php/Main_Page Wiki that aims to be a complete reference to Heroes of Might and Magic III. 
+- <https://heroes.thelazy.net/index.php/Main_Page> Wiki that aims to be a complete reference to Heroes of Might and Magic III.

docs/players/Installation_Linux.md

@@ -9,6 +9,7 @@ VCMI requires data from original Heroes 3: Shadow of Death or Complete editions.
 Up-to-date releases can be found in our PPA here: <https://launchpad.net/~vcmi/+archive/ubuntu/ppa>
 
 To install VCMI from PPA use:
+
 ```
     sudo apt-add-repository ppa:vcmi/ppa
     sudo apt update
@@ -20,25 +21,30 @@ To install VCMI from PPA use:
 We also provide latest, unstable builds mostly suitable for testing here: <https://launchpad.net/~vcmi/+archive/ubuntu/vcmi-latest>
 
 In order to install from this PPA use:
+
 ```
     sudo add-apt-repository ppa:vcmi/vcmi-latest
     sudo apt update
     sudo apt install vcmi
 ```
+
 ### Ubuntu - From Ubuntu repository
 
 VCMI stable builds available in "multiverse" repository. Learn how to enable it in [Ubuntu wiki](https://help.ubuntu.com/community/Repositories/Ubuntu).
 Once enabled, you can install VCMI using Ubuntu Store or in terminal using following commands:
+
 ```
     sudo apt update
     sudo apt install vcmi
 ```
+
 Note that version available in Ubuntu is outdated. Install via PPA is preferred.
 
 ### Debian
 
 Stable VCMI version is available in "contrib" repository. Learn how to enable it in [Debian wiki](https://wiki.debian.org/SourcesList).
 To install VCMI from repository:
+
 ```
     sudo apt-get update
     sudo apt-get install vcmi
@@ -52,6 +58,7 @@ Stable VCMI version is available in RPM Fusion repository. Learn how to enable i
     sudo dnf update
     sudo dnf install vcmi
 ```
+
 ### Flatpak (distribution-agnostic)
 
 Latest public release build can be installed via Flatpak.
@@ -63,8 +70,8 @@ Once you have flatpak, you can install VCMI package which can be found here: <ht
 
 For other distributions, VCMI can be installed from 3rd-party repositories listed below. Note that these repositories are not supported by vcmi team and may not be up to date.
 
--   Archlinux [vcmi](https://aur.archlinux.org/packages/vcmi/) [vcmi-git](https://aur.archlinux.org/packages/vcmi-git/)
--   openSUSE [1 Click Install](https://software.opensuse.org/download.html?project=games&package=vcmi)
+- Archlinux [vcmi](https://aur.archlinux.org/packages/vcmi/) [vcmi-git](https://aur.archlinux.org/packages/vcmi-git/)
+- openSUSE [1 Click Install](https://software.opensuse.org/download.html?project=games&package=vcmi)
 
 If you are interested in providing builds for other distributions, please let us know.
 
@@ -83,15 +90,17 @@ Recommended for non-Flatpak installs.
 To install Heroes 3 data using automated script you need any of:
 
 - Offline Installer downloaded from gog.com (both .exe and .bin files are required)
-- Directory with preinstalled game 
+- Directory with preinstalled game
 - One or two CD's or CD images
 
 Run the script using options appropriate to your input files:
+
 ```
 vcmibuilder --cd1 /path/to/iso/or/cd --cd2 /path/to/second/cd
 vcmibuilder --gog /path/to/gog.com/installer.exe
 vcmibuilder --data /path/to/h3/data
 ```
+
 You should use only one of these commands.
 
 On flatpak install, it's also possible to run the script, but any path seems to be interpreted from within the Flatpak sandbox:
@@ -107,9 +116,11 @@ Download both files for the "offline backup game installers" and extract them us
 You can select both downloaded files in launcher to extract automatically.
 
 Alternatively you can use the classic way:
+
 ```
 innoextract --output-dir=~/Downloads/HoMM3 "setup_heroes_of_might_and_magic_3_complete_4.0_(28740).exe"
 ```
+
 (note that installer file name might be different)
 
 Once innoextract completes, start VCMI Launcher and choose to place existing files. Select the ~/Downloads/HoMM3 directory. Once placing is complete, you can delete both offline installer files as well as ~/Downloads/HoMM3.

docs/players/Installation_Windows.md

@@ -8,20 +8,20 @@ As of VCMI 1.2 and newer Windows 10 or newer is required since our automated sys
 
 Install one of following into new folder, same as when installing new game:
 
--   Latest release (recommended): <https://github.com/vcmi/vcmi/releases/latest>
--   Daily builds (unstable): <https://builds.vcmi.download/branch/develop/Windows/>
--   Please report about problems on GitHub: [Bug Tracker](https://github.com/vcmi/vcmi/issues)
+- Latest release (recommended): <https://github.com/vcmi/vcmi/releases/latest>
+- Daily builds (unstable): <https://builds.vcmi.download/branch/develop/Windows/>
+- Please report about problems on GitHub: [Bug Tracker](https://github.com/vcmi/vcmi/issues)
 
 ## Step 2: Installing Heroes III data files
 
 **Since VCMI 1.2 you can skip this step, just run VCMI launcher and it will help you with importing H3 data. For older releases you can follow this step.**
 
--   Install Heroes III from disk or using GOG installer.
--   Place "Data", "Maps" and "Mp3" from Heroes III to: `Documents\My Games\vcmi\`
+- Install Heroes III from disk or using GOG installer.
+- Place "Data", "Maps" and "Mp3" from Heroes III to: `Documents\My Games\vcmi\`
 
 Create this folder if it doesnt exist yet
 
 ## Step 3: connect to the mod repository
 
 - If that's your first installation, connection to the mod repository will be configured automatically, you'll see mods available to install from VCMI launcher -
-- We recommend you to install VCMI extras to support various helpful UI tweaks 
+- We recommend you to install VCMI extras to support various helpful UI tweaks

docs/players/Installation_iOS.md

@@ -6,7 +6,7 @@ You can run VCMI on iOS 12.0 and later, all devices are supported. If you wish t
 
 The easiest and recommended way to install on a non-jailbroken device is to install the [AltStore Classic](https://altstore.io/) or [Sideloadly](https://sideloadly.io/). We will use AltStore as an example below. Using this method means the VCMI certificate is auto-signed automatically.
 
-i) Use [AltStore Windows](https://faq.altstore.io/altstore-classic/how-to-install-altstore-windows) or [AltStore macOS](https://faq.altstore.io/altstore-classic/how-to-install-altstore-macos) instructions to install the store depending on the operating system you are using. 
+i) Use [AltStore Windows](https://faq.altstore.io/altstore-classic/how-to-install-altstore-windows) or [AltStore macOS](https://faq.altstore.io/altstore-classic/how-to-install-altstore-macos) instructions to install the store depending on the operating system you are using.
 
 If you're having trouble enabling "sync with this iOS device over Wi-Fi" press on the rectangular shape below "Account". Windows example from iTunes shown below:
 
@@ -19,15 +19,14 @@ iii) To install the .ipa file on your device do one of the following:
 - In AltStore go to >My Apps > press + in the top left corner. Select VCMI-iOS.ipa to install,
 - or drag and drop the .ipa file into your iOS device in iTunes
 
-
 ## Step 2: Installing Heroes III data files
 
-If you bought HoMM3 on [GOG](https://www.gog.com/de/game/heroes_of_might_and_magic_3_complete_edition), you can download the files directly from the browser in the device. 
-
-Launch VCMI app on the device and the launcher will prompt two files to complete the installation. Select the **.bin** file first, then the **.exe** file. This may take a few seconds. Please be patient. 
+If you bought HoMM3 on [GOG](https://www.gog.com/de/game/heroes_of_might_and_magic_3_complete_edition), you can download the files directly from the browser in the device.
 
+Launch VCMI app on the device and the launcher will prompt two files to complete the installation. Select the **.bin** file first, then the **.exe** file. This may take a few seconds. Please be patient.
 
 ## Step 3: Configuration settings
+
 Once you have installed VCMI and have the launcher opened, select Settings on the left bar. The following Video settings are recommended:
 
 - Lower reserved screen area to zero.
@@ -42,7 +41,7 @@ Together, the two options should eliminate black bars and enable full screen VCM
 
 To run on a non-jailbroken device you need to sign the IPA file, you have the following aternative options:
 
-- if you're on iOS 14.0-15.4.1, you can try <https://github.com/opa334/TrollStore>. 
+- if you're on iOS 14.0-15.4.1, you can try <https://github.com/opa334/TrollStore>.
 - Get signer tool [here](https://dantheman827.github.io/ios-app-signer/) and a guide [here](https://forum.kodi.tv/showthread.php?tid=245978) (it's for Kodi, but the logic is the same). Signing with this app can only be done on macOS.
 - [Create signing assets on macOS from terminal](https://github.com/kambala-decapitator/xcode-auto-signing-assets). In the command replace `your.bundle.id` with something like `com.MY-NAME.vcmi`. After that use the above signer tool.
 - [Sign from any OS (Rust)](https://github.com/indygreg/PyOxidizer/tree/main/tugger-code-signing) / [alternative project (C++)](https://github.com/zhlynn/zsign). You'd still need to find a way to create signing assets (private key and provisioning profile) though.
@@ -54,7 +53,7 @@ The easiest way to install the ipa on your device is to do one of the following:
 
 Alternatively, to install the signed ipa on your device, you can use Xcode or Apple Configurator (available on the Mac App Store for free). The latter also allows installing ipa from the command line, here's an example that assumes you have only 1 device connected to your Mac and the signed ipa is on your desktop:
 
-    /Applications/Apple\ Configurator.app/Contents/MacOS/cfgutil install-app ~/Desktop/vcmi.ipa
+`/Applications/Apple\ Configurator.app/Contents/MacOS/cfgutil install-app ~/Desktop/vcmi.ipa`
 
 ## Alternative Step 2: Installing Heroes III data files
 
@@ -79,7 +78,7 @@ You can also upload files with Xcode. You need to prepare "container" for that.
 3. Open Devices and Simulators window: Cmd+Shift+2 or Menu - Window - Devices and Simulators
 4. Select your device
 5. Select VCMI
-6. In the bottom find "three dots" or "cogwheel" button (it should be next to + - buttons) - click it - select Download Container... 
+6. In the bottom find "three dots" or "cogwheel" button (it should be next to + - buttons) - click it - select Download Container...
 7. Place the game directories inside the downloaded container - AppData - Documents
 8. Click the "three dots" / "cogwheel" button in Xcode again - Replace Container... - select the downloaded container
 9. Wait until Xcode finishes copying, progress is visible (although it might be "indefinite")

docs/players/Installation_macOS.md

@@ -5,7 +5,7 @@
 - The latest release (recommended):
   - manually: <https://github.com/vcmi/vcmi/releases/latest>
   - via Homebrew: `brew install --cask --no-quarantine vcmi/vcmi/vcmi`
-- Daily builds (might be unstable) 
+- Daily builds (might be unstable)
   - Intel (x86_64) builds: <https://builds.vcmi.download/branch/develop/macOS/intel>
   - Apple Silicon (arm64) builds: <https://builds.vcmi.download/branch/develop/macOS/arm>
 
@@ -21,5 +21,5 @@ If you bought HoMM3 on [GOG](https://www.gog.com/de/game/heroes_of_might_and_mag
 
 ### Step 2.b: Installing by the classic way
 
-1.  Find a way to unpack Windows Heroes III or GOG installer. For example, use `vcmibuilder` script inside app bundle or install the game with [CrossOver](https://www.codeweavers.com/crossover) or [Kegworks](https://github.com/Kegworks-App/Kegworks).
-2.  Place or symlink **Data**, **Maps** and **Mp3** directories from Heroes III to:`~/Library/Application\ Support/vcmi/`
+1. Find a way to unpack Windows Heroes III or GOG installer. For example, use `vcmibuilder` script inside app bundle or install the game with [CrossOver](https://www.codeweavers.com/crossover) or [Kegworks](https://github.com/Kegworks-App/Kegworks).
+2. Place or symlink **Data**, **Maps** and **Mp3** directories from Heroes III to:`~/Library/Application\ Support/vcmi/`

docs/players/Privacy_Policy.md

@@ -13,4 +13,4 @@ VCMI team does not collect any data produced by VCMI app. All game files, logs,
 
 ## Multiplayer
 
-If you decide to play with other users via Internet there are two roles. The host is the one who provides the game server. The clients are the other players who connect to the host. The host provides to the client its IP address in order to establish connections. The clients and the host during the gameplay exchange their usernames, messages and other game activity. All this data is collected and stored by the host. VCMI team does not collect and store any multiplayer data.
+If you decide to play with other users via Internet there are two roles. The host is the one who provides the game server. The clients are the other players who connect to the host. The host provides to the client its IP address in order to establish connections. The clients and the host during the gameplay exchange their usernames, messages and other game activity. All this data is collected and stored by the host. VCMI team does not collect and store any multiplayer data.

docs/translators/Translations.md

@@ -23,6 +23,7 @@ This is list of all languages that are currently supported by VCMI. If your lang
 - Vietnamese
 
 ## Progress of the translations
+
 You can see the current progress of the different translations here:
 [Translation progress](https://github.com/vcmi/vcmi-translation-status)
 
@@ -32,17 +33,18 @@ The page will be automatically updated once a week.
 
 VCMI allows translating game data into languages other than English. In order to translate Heroes III in your language easiest approach is to:
 
-- Copy existing translation, such as English translation from here: https://github.com/vcmi-mods/h3-for-vcmi-englisation (delete sound and video folders)
-- Copy text-free images from here: https://github.com/vcmi-mods/empty-translation
+- Copy existing translation, such as English translation from here: <https://github.com/vcmi-mods/h3-for-vcmi-englisation> (delete sound and video folders)
+- Copy text-free images from here: <https://github.com/vcmi-mods/empty-translation>
 - Rename mod to indicate your language, preferred form is "(language)-translation"
 - Update mod.json to match your mod
 - Translate all texts strings from `game.json`, `campaigns.json` and `maps.json`
 - Replace images in data and sprites with translated ones (or delete it if you don't want to translate them)
-- If unicode characters needed for language: Create a submod with a free font like here: https://github.com/vcmi-mods/vietnamese-translation/tree/vcmi-1.4/vietnamese-translation/mods/VietnameseTrueTypeFonts
+- If unicode characters needed for language: Create a submod with a free font like here: <https://github.com/vcmi-mods/vietnamese-translation/tree/vcmi-1.4/vietnamese-translation/mods/VietnameseTrueTypeFonts>
 
 If you can't produce some content on your own (like the images or the sounds):
+
 - Create a `README.md` file at the root of the mod
-- Write into the file the translations and the <ins>detailled</ins> location
+- Write into the file the translations and the **detailled** location
 
 This way, a contributor that is not a native speaker can do it for you in the future.
 
@@ -57,8 +59,10 @@ This will export all strings from game into `Documents/My Games/VCMI/extracted/t
 To export maps and campaigns, use '/translate maps' command instead.
 
 ### Video subtitles
+
 It's possible to add video subtitles. Create a JSON file in `video` folder of translation mod with the name of the video (e.g. `H3Intro.json`):
-```
+
+```jsonc
 [
     {
         "timeStart" : 5.640, // start time, seconds
@@ -84,6 +88,7 @@ Before you start, make sure that you have copy of VCMI source code. If you are n
 ### Translation of in-game data
 
 In order to translate in-game data you need:
+
 - Add section with your language to `<VCMI>/Mods/VCMI/mod.json`, similar to other languages
 - Copy English translation file in `<VCMI>/Mods/VCMI/config/vcmi/english.json` and rename it to name of your language. Note that while you can copy any language other than English, other files might not be up to date and may have missing strings.
 - Translate copied file to your language.
@@ -94,7 +99,7 @@ After this, you can set language in Launcher to your language and start game. Al
 
 VCMI Launcher and Map Editor use translation system provided by Qt framework so it requires slightly different approach than in-game translations:
 
-- Install Qt Linguist. You can find find standalone version here: https://download.qt.io/linguist_releases/
+- Install Qt Linguist. You can find find standalone version here: <https://download.qt.io/linguist_releases/>
 - Open `<VCMI Sources>/launcher/translation/` directory, copy `english.ts` file and rename it to your language
 - Open `<VCMI Sources>/launcher/CMakeLists.txt` file with a text editor. In there you need to find list of existing translation files and add new file to the list.
 - Launch Qt Linguist, select Open and navigate to your copied file
@@ -112,23 +117,27 @@ TODO: how to test translation locally
 The [AppStream](https://freedesktop.org/software/appstream/docs/chap-Metadata.html) [metainfo file](https://github.com/vcmi/vcmi/blob/develop/launcher/eu.vcmi.VCMI.metainfo.xml) is used for Linux software centers.
 
 It can be translated using a text editor or using [jdAppStreamEdit](https://flathub.org/apps/page.codeberg.JakobDev.jdAppStreamEdit):
+
 - Install jdAppStreamEdit
 - Open `<VCMI>/launcher/eu.vcmi.VCMI.metainfo.xml`
 - Translate and save the file
   
 ##### Desktop file
+
 - Edit `<VCMI>/launcher/vcmilauncher.desktop` and `<VCMI>/launcher/vcmieditor.desktop`
 - Add `GenericName[xyz]` and `Comment[xyz]` with your language code and translation
 
 ##### Translation of Android Launcher
+
 - Copy `<VCMI>/android/vcmi-app/src/main/res/values/strings.xml` to `<VCMI>/android/vcmi-app/src/main/res/values-xyz/strings.xml` (`xyz` is your language code)
 - Translate this file
 
-See also here: https://developer.android.com/guide/topics/resources/localization
+See also here: <https://developer.android.com/guide/topics/resources/localization>
 
 ### Submitting changes
 
 Once you have finished with translation you need to submit these changes to vcmi team using git or Github Desktop
+
 - Commit all your changed files
 - Push changes to your forked repository
 - Create pull request in VCMI repository with your changes
@@ -152,8 +161,10 @@ If your mod also contains maps or campaigns that you want to translate, then use
 If you want to update existing translation, you can use '/translate missing' command that will export only strings that were not translated
 
 ### Translating mod information
+
 In order to display information in Launcher in language selected by user add following block into your `mod.json`:
-```
+
+```jsonc
 	"<language>" : {
 		"name" : "<translated name>",
 		"description" : "<translated description>",
@@ -163,6 +174,7 @@ In order to display information in Launcher in language selected by user add fol
 		]
 	},
 ```
+
 However, normally you don't need to use block for English. Instead, English text should remain in root section of your `mod.json` file, to be used when game can not find translated version.
 
 ### Translating in-game strings
@@ -174,7 +186,9 @@ Use any text editor (Notepad++ is recommended for Windows) and translate all str
 ## Developers documentation
 
 ### Adding new languages
+
 In order to add new language it needs to be added in multiple locations in source code:
+
 - Generate new .ts files for launcher and map editor, either by running `lupdate` with name of new .ts or by copying `english.ts` and editing language tag in the header.
 - Add new language into `lib/Languages.h` entry. This will trigger static_assert's in places that needs an update in code
 - Add new language into json schemas validation list - settings schema and mod schema
@@ -187,7 +201,8 @@ Also, make full search for a name of an existing language to ensure that there a
 At the moment, build system will generate binary translation files (`.qs`) that can be opened by Qt.
 However, any new or changed lines will not be added into existing .ts files.
 In order to update `.ts` files manually, open command line shell in `mapeditor` or `launcher` source directories and execute command
-```
+
+```sh
 lupdate -no-obsolete * -ts translation/*.ts
 ```
 
@@ -197,5 +212,6 @@ There *may* be a way to do the same via QtCreator UI or via CMake, if you find o
 ### Updating translation of Launcher and Map Editor using new .ts file from translators
 
 Generally, this should be as simple as overwriting old files. Things that may be necessary if translation update is not visible in executable:
+
 - Rebuild subproject (map editor/launcher).
 - Regenerate translations via `lupdate -no-obsolete * -ts translation/*.ts`