[New Town Mod] Refugee


I’m working again on this project since last week and I’ve made a lot of progress. I will soon release the v0.2 with a detailed changelog and announce what I’ll be working on for the v0.3. The update should come within the next days!

If there’s any new suggestions/feedbacks about my mod, please tell me so I can work on them for the upcoming release.


It would be great if you will release both night and day town versions.


See the changelog below to know more about the upcoming release (v0.2) and the following release (v0.3). Changelog is also available in a .txt file within the mod. Have fun!

Download link: Refugee Town (v0.2)

Refugee Town - changelog (v0.2):

  1. Town:
  • NEW TOWN SCREEN ! (Cathedral’s town screen replaced with original town screen).
  • Edited buildings’ ressources costs, unlocking tree & names (Cathedral -> Refugee).
  • Renamed buildings’ names (Cathedral -> Refugee).

  • Remastered town’s theme.
  • Edited Creatures portraits & background to fit the new Town screen.
  • Edited in-game Mage Guild background to fit the new Town screen.

  • Edited various game icons to fit the new Town screen.
  • New buildings: Grail, Special1.
  • Animated building: Grail, LVL6Upg., LVL7, LVL7Upg.
  1. New spells :
  • Namburbi : Summon Gold golems (expert = Diamond golems).
  • Gottesbriefe : Reduce LUCK & MORALE of targeted enemy (expert = all enemy units).
  1. Heroes:
  • Replaced Keyvan’s specialty with a new one (Skill = Resistance).
  • Replaced Shayan’s specialty with a new one (Skill = New spell Namburbi).
  1. Units :
  • LVL7 Unit will no longer have the ability to cast Sorrow & Misfortune after attack (with 50% chance each). Instead, it will now have the ability to cast Gottesbriefe after attack (with 30% chance).

Also, it will now have the ability to cast Curse before attack (with 10% chance). Stats change (Nrm/Upg): Nerfed attack (-5ATK), Buffed defense (+4/3DEF) and Damage changed from 30-40 to 25-45.

  • LVL3 Unit : removed “Ranged retaliation” and “No wall” abilities. The ability “no melee penalty” will no longer apply to unupgraded units. Reduced speed (7 -> 5).
  1. Misc. :
  • Fixed .JSON files syntax errors and optimized their codes.
  • Improved heroes’ specialties and other icons.


  • Townscreen animation: Fix GRAIL animation artefacts, import Dwelling 5 animation & improve Dwelling 7 animation.
  • Puzzle section (visuals are not created yet).
  • Siege section (visuals are not created yet).
  • Heroes battle & map models.

  • More new spells? Add new artefacts?
  • Add/make those buildings work: SPECIAL2, SPECIAL3, HORDE1, HORDE2 (features unsupported with VCMI right now).
  • Heroes specialty tooltips (Areman, Mahyar, Mithra, Keyvan & Shayan). I don’t know how it works though.
1 Like

@Macron1 I’ll save this idea for later. The actual town screen might change over the futures releases and I will work on an alternate version once it will be in its final phase.

Also, someone on HeroesCommunity forum told me his game crash whenever he’s using the new spell “Namburbi”. Do you guys encounter the same issue?

By the way, I recommend using these mods in addition to my mod:

  • Unlucky Ones: Negative luck mod, enables this option and makes game more suited for this feature. This new mechanic will work well with the new spell “Gottesbriefe”.

  • VCMI essential files (v1.01): Updating your VCMI essential files will add several missing abilities’ graphics (just delete and replace the “vcmi” folder with this one in the “mods” folder).

Hordes are supported


@Macron1 I didn’t knew that, thanks for the info. They don’t seems to work with my VCMI build (21/07/2019). Gonna update right now


Buildings super composition shit, you can rebuild and the castle will become more interesting this is purely my opinion


At me, casting Namburbi spell also crashes the game. And I don’t know why :frowning:


@misiokles Could you provide TXT logs and what VCMI version you using?

@zerg What do you mean?


About horde growth:
in file faction.json instead of: "horde" : [ 2, 5 ] type "horde" : [ 1, 4 ],
I know, it’s little illogical, but with those parametres all work as intended.


I did and it now works. I’m curious to know why “[1, 4],” works. Do you have any explanation lol?

Here’s the edited .json to make the horde working.
faction.json (5,3 Ko)

Also, if you replace the rfgSummon.json with this file, does it fix the crash issue? File to replace is in content/config/refugee/spells
rfgSummon.json (2,4 Ko)


I guess lvl1 is 0, lvl7 is 6.


Seems logic and coherent now that you mention it. Buildings’ index usually begins with “0”.


logs.zip (118.2 KB)
Still crashes. It’s strange because I wrote earlier some summon spells and other summon spells are working, but yours - not :frowning:


It crashed because I deleted the “power” value at root. I’ll need your crash-log for the original file from the v0.2 release (you can download it below).

rfgSummon.json (2,4 Ko)


Ok, I’ve found the cause.
This line: "id": "refugeetown:rfgGoldGolem", - it means that main folder of your mod must have name refugeetown. But you’ve packed your mod tht after unpacking there’s no refugeetown folder by default.


take the chaos as the basis of the composition and look from a different angle


@misiokles Good job for finding the issue, thanks! I will create a new repack right now !


Three notices:

  1. There’s unwritten rule. Non upgraded units in adventure map/map editor look in right direction, upgraded - in left.
  2. Starting army has also some rules. In 98% cases, starting army is:
  • lvl1: min 10 - max 20 units
  • lvl2: min 4 - max 7 units
  • lvl3: min 2 - max 3 units
    That’s why Refugee heroes have weak starting army :slight_smile:
  1. advAmount min and max values are easy to proper set. Open standard SoD or HotA map editor, place any unit on map and then right-click on it and choose ‘what is’ option.
    quantinty is advAmount min and max value :slight_smile:

@misiokles Yeah you’re probably right, I will change the amount of starting units. I put less lvl 1 units because they are upgraded lvl1 instead of normal but I guess I will remove peasants from the town and replace them with a new variation of rogues. I will create an alternate version of rogue tonight.

Right now I’ll follow your advice about the advAmount and then I will edits map models for units. Thanks for your help !

Edit: For some reasons I can’t use the “What’s this?” function in my H3 editor. It shows this error message and do none.