[*] Улучшена стабильность работы !!PO, исправлены ошибки.
[*] ExecErmCmd позволяет передавать строки со множеством команд, разделённых «;» и не завершать последнюю команду точкой с запятой.
[*] Больше кода использует патчер от бараторча.
[+] Изменение MF:F корректно отображается в журнале боя (включая урон рва, башен, огненного щита и др.)
[+] Добавлена возможность глобального и локального перенаправления MP3 мелодий. Просто укажите имя файла с расширением mp3 в качестве ресурса или маску *.mp3 для перенаправления всех композиций.
[+] Добавлена возможность глобального перенаправления ресурсов через конфигурационные файлы JSON.
Data\Redirections\*.json

Формат:
{
  "старый ресурс": "новый ресурс",
  "старый ресурс": "новый ресурс"...
}

Папка Data\Redirections\Missing\*.json.
Работает схожим образом, но перенаправления работают для отсутствующих ресурсов.
Например, можно удалить из Вога новые z*-картинки и перенаправить их на оригинальные с названиями без префиксов. Или предусмотреть безопасную альтернативу используемым ресурсам, если ваш мод зависит от кого-либо графического мода.

[+] Добавлены события OnGameEnter (77015) и OnGameLeave (77016). Первое возникает, когда игра начата или загружена и пользователь получает управление курсором. Второе возникает, когда пользователь выходит из текущей игры в главное меню или завершает игру вообще.

Эту пару удобно использовать, чтобы устанавливать UN:C хаки, специфичные для карты или мода, и убирать их при выходе.

[+] Functions can now have names. Any time you use (something) inside commands, the engine looks for appropriate SN:W-var. If it finds it, the integer value of variable will replace (something) in source code. If nothing is find, W-var is created on-the-fly and the number is automatically assigned from 95000+ range.

Example: !!FU(OnHenchmanHire); call function which maybe does not exist, but script users will be able to handle the event.
Example: !?FU(Phoenix.FindFreeSlot);

Please, don't forget that names are global. Prefix function names with mod abbreviation: (BattleLib.RessurectStack).

[+] Added labels support. Label is command ordinal number inside current trigger starting from 0. [:LabelName] defines local label. [LabelName] means replace label with command number. Labels are used with SN:G command to implement loops and conditions.

Example:
!?CM2; archangel in every slot
!!VRy1:S0;
[:loop]
!!HE-1:C0/y1/13/1;
!!VRy1:+1;
!!SN&y1<=6:G[loop];

[*] Ported igrik's code to fix SN:D in heroes meeting screen.

!?CM0;
!!CM:R0 P?y1/?y2/?y3;
!!VRv2:Cy1/y2/y3;
!!SN:O?y1/?y2/?y3;
!!IF:M^%V2 %V3 %V4 => %Y1 %Y2 %Y3^;

[+] Added "LoadImageAsPcx16" to era.dll export and SDK. Function allows to load png/jpg/bmp image with
    optional scaling as pcx16 game resource, suitable for replacing native resources or displaying in dialogs.
    All HD Mod modes are supported.
[+] Improved syntax of language json files (Mod\Lang\*.json, UTF-8 encoding). Nested objects are supported.
    {
      "wogrev": {
        "no_gold_message": "The is no more gold, @name@!",
        "no_mercy":        "There will be no mercy!"
      }
    }

    The above mentioned document is treated the same as:
    {
      "wogrev.no_gold_message": "The is no more gold, @name@!",
      "wogrev.no_mercy":        "There will be no mercy!"
    }

    but allows to skip duplicating "messages." prefix.

    ERM example: !!SN:T^wogrev.no_gold_message^/?z2/^name^/^Geralt^; !!IF:M^%Z2^;
[+] Hints from Mod\Data\Buttons\*.btn files are now automatically translated. No need to include *.btn files in localizations.
[+] Added translation support for plugins. SDK function "tr", accepting complex key and vector of named parameters.
    Example: ShowMessage(tr('mymod.greetings', { "hero_name", "Orrin", "age", IntToStr(70) }).c_str());
[+] Added state-less re-enterable thread-safe functions for splicing and hooking: "Splice" and "HookCode".
[+] Added function NotifyError, that shows Windows dialog with error, but does not terminate
    application, unless AbortOnError ini option is set to 1.
[+] Added "no high level prisons on random maps.bin.off" patch. It disables generation of prisons with 2+ level heroes on random maps. Credits: igrik.
[+] Updated "WoG Native Dialogs" integrated mod. Commander screen visual improvements applied. Credits: igrik.
[*] Updated "Quick Savings" mod. Language json file now uses improved syntax.
[*] Updated "Secondary Skills Scrolling" mod. Moved button hints to language json file.
[*] Updated era.h, removed garbage and not supported signatures.
[*] *.ert/*.txt translations are DEPRECATED. New Lua/ERM scripts should not use it, unless there is a substantional necessity.
    Use SN:T for ERM, Era::tr for C++ Plugins instead.
[*] Updated vfs.dll to v1.0.4.
[*] *.era and *.dll plugins loading mechanism was improved. *.dll and *.era plugins are treated the
    same way, except that "*.dll"s are loaded right before "OnAfterWoG" event. and "*.era"s are loaded right
    before "OnBeforeWoG" event. Zero size files are skipped. In both cases v1 variable is set to era.dll
    handle for compatibility reasons only (this behavior is DEPRECATED). If plugin with the same name,
    but different extension is present (say, 'x.dll' and 'x.era'), an error is reported.
[*] Fixed crash in buttons.dll by MoP. Invalid counter initialization caused crash if only single button was registered.
    Added .dbgmap file for updated dll. Updated code to install hooks in OnAfterWoG event and renamed plugin to buttons.era
[-] Unsafe SN:C and SN:R commands were removed and are not supported anymore.
[-] Removed outdated or unsafe functions from angel.dll exports.
[-] The following Mods are not installed automatically and may be removed from main package any time: Yona, Fast Battle Animation, Quick Savings, Secondary Skills Scrolling.
[-] Era does not apply *.bin patches from EraPlugins directory anymore. Patches from EraPlugins/BeforeWoG and EraPlugins/AfterWoG directories are still applied.
[-] Fixed bug, introduced in v2.8.2: dll plugins with double extensions were ignored.

[+] Greatly improved WoG code performance by removing functions prolog and epilog code, that was added by ZVS in debug purposes.

[+] Improved ERM errors reporting: valid file name, line and positions are displayed, as long as appropriate context. Errors reporting now
    works correctly during ERM compilation. No more double/tripple error messages. The whole receiver is skipped in case of error.

[+] Rewritten scripts loading/saving/exporting engine. Removed restriction on 100 unique ERM scripts. Previously Era used to join 99+ scripts
    into single one. A few bugs of not unloading previous map scripts were fixed. Loading saved game with the same scripts set as current one
    is now really fast and does not require ERM recompilation. It means that loading game is much faster now.

[+] ERM memory limit is extended to 128 MB. Memory is now allocated gradually as needed, saving system resources.

[+] All maps are always treated as WoG format.

[+] Scripts from map global events are now managed by Era: they are preprocessed (named functions and labels support) and can be extracted via F11
    and reapllied on F12. They are loaded before scripts from map separate directory.

[+] Each map can have its own directory in Maps. For "Arrogance.h3m" it's Maps/Arrogance. For campaign Zc2.h3c (the first map) it's Maps\Zc2_1.
    The last number is map zone index in campaign. 1 for Zone A, 2 for Zone B, etc. Custom map scripts can be put inside map directory under Data/s subpath.
    Script names can have any names, they are loaded first and do not depend on global script names. If Maps/[MapName]/Data/s/load only these scripts.txt is present,
    only those global scripts, which are written there (one name per line), will be loaded from global Data/s directory. Anyway, all map scripts will
    be loaded in the first place. Map scripts are stored in saved game, can be reloaded, extracted, can use named functions and labels.

[+] All language Lang/*.json files are loaded from map directory (ex. Maps/Arrogance/Lang/arrogance.json), stored in saved games are applied. Thus
    maps can be supplied with translatable language data.

[+] WoG Option 5 (Wogify) meaning was changed for both map start or scripts reloading via F12:
    - 0: don't load any global ERM scripts (previously - load global ERM scripts for maps with 'RANDOM MAP' like name);
    - 1, 2: always load global ERM scripts, unless map forces other value;
    - 3: load global ERM scripts, but if map has its own scripts and does not force fixed set of global scripts,
      ask user, whether to skip global scripts loading or not.

    If there exists "Maps/[MapName]/Data/s/load only these scripts.txt" file, then global scripts specified in the file are loaded without confirmation
    and WoG Option 5 is set to "2".
    If user choses to skip or load global scripts in confirmation dialog, WoG Option 5 is changed to either 0 or 2.

    Summary:
    - Backward compatibility with existing maps/scripted campaigns is preserved. They usually set !!UN:P905/0 (disable wogification), which
      disables global ERM scripts loading.
    - Because all maps are now treated as WoG Format, option 1 is the same as option 2.
    - Scripts reloading via F12 always honor the option.

[+] Scripts from WoG Campaigns were fixed and extracted to separate directories. Bug fixes applied.
New service for scripts extraction was published: https://tools.bsoft.parkingby.icu/scripts-extractor/

[+] UN:J3 command was improved. Specify ':clear:' option instead of file name to turn off all WoG Options and set Map Rules to "use selected below".

[+] Added UN:J13 command. It resets commanders, according to current WoG Options 3 and 6.

[+] Added missing descriptions for old Era events:
  !?FU77012 = !?FU(OnStackToStackDamage). Occurs when damage dealt by one stack to another stack is calculated.
  SN:X parameters:

  ATTACKER            = 0; (attacker stack)
  DEFENDER            = 1; (defender stack)
  FINAL_DAMAGE_CONST  = 2; Do not change
  FINAL_DAMAGE        = 3;
  BASIC_DAMAGE        = 4; Normal basic damage
  DAMAGE_BONUS        = 5; Damage bonus (caused by attack-defense difference, cavalry bonus or any custom bonus)
  IS_DISTANT          = 6; (0 for melee, 1 for distant)
  DISTANCE_ARG        = 7;
  IS_THEORETICAL      = 8; (0 for real damage, 1 for estimated damage)

  !?FU77013 = !?FU(OnAICalcStackAttackEffect). Occured when AI calculates the effect of attacking stack
  SN:X parameters:

  ATTACKER            = 0; (attacker stack)
  DEFENDER            = 1; (defender stack)
  EFFECT_VALUE        = 2; (final effect)
  EFFECT_VALUE_CONST  = 3; Do not change

[+] Added "fix wog exp screen.bin" memory patch by igrik. It fixes column headers display in creature experience screen.
[+] Splice and HookCode API was improved. Added support for custom extra argument and multiple calling conventions.
[*] Savegames format was changed and is not compatible with previous Era versions.
[-] Disabled "Failed to create Debug\Era\log.txt" message if several game instances are running.
[-] Fixed UN:P3 command. Enabling/disabling commanders now enables/disables commander chests too.
[-] Mapname.erm and Mapname.cmd are not loaded anymore.

[+] Added new function and event name 'OnRemoteEvent', generating !?FU(OnRemoteEvent) on remote sides with x1..x16 arguments.
    x1 is event type, values 0..9999 are reserved by Era. ERM users may use !!FU(any func):D instead with the same functionality.

[+] Added new event 'OnEveryDay', same as !?TM[xx], but occuring every day for every player/AI without any settings and before
    all other !?TM triggers.
    Example: !?FU(OnEveryDay)&-1000; every day for any AI

[+] Added new ERM command SN:R^old resource name^/^new resource name^, redirecting lod/pac/mp3 resources to other names.
    The command is a thin wrapper over RedirectFile exported function. Pass empty name as new resource name to remove
    redirection. All applied redirections are local, stored in saved game and reverted on map exit.
    '*.mp3' redirection works on all mp3 files at once.
    
    Example:
    !#SN:R^crgrif.def^/^croc.def^; let Royal Griffins look like Rocs (portraits are not changed)

    Game unloads not used resources, thus many resources can be dynamically redirected during playing.
    If resource is used in Hero Screen, perform redirection before Hero Screen is shown (and resource is cached).

    Custom interface skins may also be implemented, allowing user to switch themes right in the game (saved game
    loading may be necessary for visual update).

[+] MP trigger and receivers were fully remade. Old documentation is not applicable now. New implementation is fully
    thread-safe. From now heroes3.ini setting "UseOnlyOneCpuCore" is 0 by default, allowing running HD mod in CPU-heavy modes.

    Documentation:

    !?MP; Trigger occurs whenever game or ERM/Lua calls ChangeMp3Theme function.
   ; Here function parameters may be changed via !!MP:S, function default reaction enabled/disabled via !!MP:R

    !!MP:C?z[xx]; Get name of current theme without mp3 extension in lower case.
   ; Receiver may be called any time. Example result: 'dirt'.

    !!MP:P[theme name]/[Don't track position = 0/1]/[Loop = 0/1]; Calls ChangedMp3Theme function and generates !?MP event.
   ; Theme name is mp3 file name without extension.
   ; If 'Don't track position' is true (1), track playing is begun from start after resuming from pause.
   ; Otherwise position is remembered and restored on resume.
   ; 'Loop' controls automatical theme replay after end. 'Don't track position' must be set to 0 in order for looping to work.
   ; ---------------------
   ; Please, note, that final parameters are fully ignored if theme with the same name is being played currently.
   ; You may need to pause current theme before starting another one to force playing from start or without loops.
    Example: !!MP:P^cstletown^/0/1; start playing looped Castle theme

    !!MP:P0/[0 - pause, 1 - resume]; Pauses or resumes current theme
    Example:
    !!MP:P0/0; Silence, please, important event will occur now

    !!MP:S[theme name]/[Don't track position = 0/1]/[Loop = 0/1]; Get/change parameters for !?MP trigger.
    Examples:
    !?MP;
    !!MP:S?z2/d/0; Make all themes non-looped

    !?MP;
    !!MP:S^mainmenu^/0/1; Play SoD main menu theme during the whole gameplay process

    !!MP:R[get/set: Enable default reaction = 0/1]; Command allows to disable theme changing at all
   ; Can be used to disallow music changing for some time
    Example:
    !?MP;
    !!MP:R0; Don't switch current theme at all

[+] Added 4 new battle events as solution to !?BR and v997 mess with full backward compatibility:
    Event: 'OnBeforeBattlefieldVisible'.
    Occurs when battlefield and stacks are ready, but not visible. Right before !?BR&v997=-1.
    WoG applies spells to stacks in this phase and inits shoot/melee/attack-n-return settings.

    Event: 'OnAfterTacticsPhase'.
    Occurs right after tactics phase or after 'OnBeforeBattlefieldVisible' event if no tactics phase takes place.
    WoG summons Santa's guardians in this phase (because now stacks are in their final positions).

    Event: 'OnBattlefieldVisible'.
    Occurs when battlefield becomes visible. Game changes theme to combat right after this phase.
    
    Event: 'OnCombatRound'. A drop-in replacement for !?BR aka 'OnBattleRound'. Occurs only for visible real rounds.
    v997 is round number. For tactics phase it starts from -1000000000. For normal phase, counting starts from 0.
    Each round v997 is increased by one, thus it can serve as always increasing unique round ID.
    Note: v997 value in other triggers may be different!

    Example:
    !?FU(OnCombatRound)&v997=0; on first non-tactics visible real round
   ; apply spells, play music, change creature attributes, etc.

[-] Fixed bug: pressing Enter/Esc in ERM error dialog showed error dialog twice.

[+] Added command for changing monster names/specialty text as !!UN:G1 zvar-free replacement.
    SN:H^monname^/monster ID/(0 - singular, 1 - plural, 2 - description)/text.
    Note: get syntax works with all SN:H commands, allowing to obtain actual hint/text.

    Example:
    !?FU(OnOpenHeroScreen);
    !!SN:H^monname^/0/0/^Bug^; rename pikeman to Bug
    !!SN:H^monname^/0/1/^Bugs^; pikemen to Bugs
    !!SN:H^monname^/0/2/^Screws the game process^; change pikeman special abilities description
    !!SN:H^monname^/13/2/?z2; get archangel special abilities text
    !!IF:M^Don't hire bugs. Better higher archangel. Pros: %Z2^; display archangel advertisement

[+] Added plugin event 'OnAfterStructRelocations', occured after 'OnAfterWoG'. All game/WoG/Era structure relocations
    must be performed before it with calling corresponding RedirectMemoryBlock (OldAddr: pointer; BlockSize: integer; NewAddr: pointer)
    function. At 'OnAfterStructRelocations' event final addresses of game structures must be obtained via GetRealAddr.
    UN:C command always uses GetRealAddr and is thus safe to use default WoG/SoD addresses.

    Era uses GetRealAddr to get hero specialties, secondary skills, monster names and descriptions from now and
    will support more relocated structures in the future.

[-] Fixed MR:N bug: if dead stacks were present in position of alive stack, dead stack number could be returned.
[-] Fixed Era bug with invalid address of secondary skills descriptions table, leading to wrong SN:H behavior. Credits: gamemaster.

[+] Added possibility to query function arguments count for functions, called via FU:P, FU:D, DO:P.
    New command !!FU:A?$ returns number of x-arguments (not including x16 for DO:P), received by function.
    This mechanism allows to write functions with optional parameters (parameters with default values) and
    functions with variadic arguments number.

    Example 1:
    !?FU(KillHero);
   ; Kills specified hero. Demonstration of optional parameters.
   ; [x1] - hero ID. Optional. -1 by default
    !!FU:A?k;       get number of function arguments
    !!VRx1&k=0:S-1; set x1 to -1, if no arguments passed
    !!HEx1:K;       killed hero

    !?CM0;
    !!FU(KillHero):P; kill current hero
    !!FU(KillHero):P155; kill Xeron

    Example 2:
    !?FU(sum);
   ; Calculates sum of all passed arguments.
   ; x1..x[n] - arguments to sum
   ; x[n+1] - result
    !!FU:A?k;  count function arguments
    !!VRxk:S0; set result to 0

    !!VRi:S0;
    !!SN&i>=k:G[end-for]; repeat k times
    [:for]
    !!VRxk:+xi; add next argument value to result
    !!VRi:+1;
    !!SN:G[for];
    [:end-for]

    !?CM0;
    !!FU(sum):P100/200/300/400/?s; get 100 + 200 + 300 + 400 into "s" quickvar
    !!IF:M^%Vs^; displays "1000"

[+] VR:C now supports v, y, x and w-variables.
[+] Improved MR:N and OnBattleRegeneratePhase:x1. Now stack ID is returned more accuratly. Thanks to Heromant.
[+] Small improvements of ERM Editor. Better 'for'-loop snippet, syntax fixes, 'iff' for !!IF, etc.

[*] Map resources, like ERM or Lua scripts were previously located in Maps/[MapName] directories. In order
    to support HD-mod maps grouping into folders, the location was changed to Maps/Resources/[MapName].

[-] Fixed wrong/unstable round, used by WoG for creature autosummoning via creature experience system.
[-] Fixed bug: w-variables in SN/MP/RD were always related to current hero.
[-] VR:R will no more crash on invalid value.

[+] Introduced high-level fastest loops in ERM via new receivers: !!re, !!br, !!co.
    
    !!re $1[/#2/#3/#4].
      ...
    !!en:;

    $1 - loop counter var like 'i' or 'y6'.
    #2 - counter start value. Optional. Default: initial value of loop counter var.
    #3 - counter stop value.  Optional. Default: initial value of loop counter var.
    #4 - step.                Optional. Default: 1, if stop value is set, 0 otherwise.
    
    Repeats block of code. Only the first argument is obligatory.
    At first loop counter variable is initialized.
    Counter stop and step values are remembered for the whole loop and won't be evaluated on each iteration.
    Step determines, what value must be added to counter variable after each iteration. It also determines type of iteration stop condition.
    Positive step checks if counter > stop value. Negative step checks if counter < stop value.
    
    On !!re it's checked, if counter reached stop-value or exceeds it. If true, execution is passed to corresponding !!en block.
    On !!en counter is increased by step and if stop condition is not met, next receiver after closest !!re will be executed.
    If stop condition is not met, execution goes to the next receiver after closest !!re.

    !!br (BREAK) with optional condition immediately jumps after loop !!en receiver.
    !!co (CONTINUE) with optional condition immediately jumps to loop !!en receiver, which will be executed as usual.

    Examples:

   ; Endless loop of annoying messages:
    !!re i:;
      !!IF:M^Donate, please!^;
    !!en:;

   ; Clear current hero army
    !!re i/0/6:;
      !!HE-1:C0/i/-1/0;
    !!en:;

   ; Display 10, 8, 6, 4, 2 (1 will not be displayed, same as 0)
    !!re i/10/1/-2:;
      !!IF:M^%Vi^;
    !!en:;

   ; Display number of the first hero empty slot, if it's found
    !!re i/0/6:;
      !!HE-1:C0/i/?t/?k;
      
      !!if|t=-1/k=0:;
        !!IF:M^Free slot number is %Vi^;
        !!br:;
      !!en:;
    !!en:;

    !!IF&i>6:M^No free slot was found^;

[+] Added possibility to query syntax, that was used for particular function parameter.
    !!FU:S#1/?$2;
    #1  - argument index
    ?$2 - syntax type (0 - get, 1 - set, 2 - add)
    Add syntax is applied via 'd' prefix like FU:Pd200.

    Using this receiver scriptmakers can write functions which act the same as normal ERM commands.
    For instance, one function to get/set/add dwelling population amount.

[+] Rewritten ZvsCheckFlags routine. Now e-variables can be compared to integer variables and constants.
    All logical operations are supported for strings. Variable indexes were not checked at all, but are
    checked now.

[+] Adapted wonderful PA and QU receivers by gamecreator with Pandora and Seer Hut Quests API.
    From now these receivers are officially part of Era. See Help\Erm Help directory for details.
    Be sure to delete "pandora's api.era", "receiver pa.era", "receiver qu.era" from old mod packages.

[+] WoG scripts were extractd to a separate mod "WoG Scripts". Some fixes by igrik/Algor were applied.
[+] Included updated TxtEdit and MMArchive by GrayFace.
[*] Replaced 'for' snippet in ERM editor with 're' snippet, other syntax file corrections.
[*] Maximum 16 nested IF/RE blocks are allowed.
[-] Fixed crash caused by invalid RD:M second parameter handling.