NHF – new heroes for Heroes V 3.1.

Dyrman, which functions from 3.1 are used in NHF? Perhaps some of them can be replaced to make the mod compatible with 3.0 and EE (which, strictly speaking, is also 3.0).

+ Added an additional parameter to the SetObjectPosition() function, it only works for heroes; fx specifies the teleportation effect number (-1 = default, 0 - disabled, 1 - warp, 2 - teleport, 3 - dimension door, 4 - town portal)
+ Added an additional parameter to the AddHeroCreatures(), RemoveHeroCreatures(), AddObjectCreatures(), RemoveObjectCreatures() functions, specifying the slot number for which the action should be performed (if possible)
+ Added new triggers for heroes: HERO_ADD_SKILL_TRIGGER, HERO_REMOVE_SKILL_TRIGGER, passed parameters: heroName, skill, mastery
+ Added a new trigger for heroes: HERO_TOUCH_TRIGGER (only for heroes that are disabled by the SetObjectEnabled() function)

New script functions:

+ floor(n) - returns the nearest lower integer value for n (example: floor(1.75) returns 1, floor(-3.7) returns -3)
+ ceil(n) - returns the nearest upper integer value for n (example: ceil(2.25) returns 3, ceil(-7.1) returns -8)
+ intg(n) - rounds n to the nearest integer (example: intg(4.5) returns 5)
+ frac(n) - returns the fractional part of a number (example: frac(1.23) returns 0.23)
+ round(n) - returns the integer part of a number (example: round(1.23) returns 1)

+ GetPlayerRace( playerId ) - returns the race of the player by his number
+ IsAIPlayer( playerId ) - returns 1 if the player is AI, 0 if human
+ GetPlayerTeam( playerId ) - returns the player's team number
+ GetPlayerNecroEnergy( playerId ) - returns the amount of dark energy for the player (for necromancers)

+ GetObjectArmySlotCreature( objName, slotIndex ) - returns the type and number of creatures in the slot slotIndex of the object objName
+ GetTownRace( townName ) - returns the race of the town
+ GiveHeroBattleBonus( heroName, bonusType, amount ) - gives the hero heroName a bonus for the next battle of type bonusType, in the amount of amount (see advmap-startup.lua for bonus types)

+ WarpToMap( mapdbid, playerId = -1 ) - starts another map, where the player will play as player playerId (only for single player)
+ WarpHeroExp( heroName, exp ) - sets the amount of experience (experience) of the hero (and therefore his level), does not affect skills, etc.

+ TalkBoxForPlayers( playersFilter, iconRef, iconTooltipRef, textRef, addTextRef, callback, mode, titleTextRef, selectTextRef, defaultOption, optionTextRef [, optionTextRef, ...] )
- opens a dialog with several answer options (from 1 to 5) for the selected players (playersFilter)
- the function does not issue error messages because if the parameters are incorrect, the default values are used
- iconRef - link to the texture of the icon
- iconTooltipRef - path to the text of the icon tooltip
- textRef - path to the text of the dialog
- addTextRef - path to the text of the dialog (additional)
- callback - string with the name of the lua function, through the first parameter of which the player's answer is reported (number: 0 - cancel, -1 - closed by the game, 1.. - the number of the answer chosen by the player)
- mode - mode: 0 - with an OK button, 1 - OK/Close
- titleTextRef - path to the text of the window title
- selectTextRef - path to the text of the title before the selection options
- defaultOption - the number of the answer that is highlighted by default (number: 0 - no, 1.. - the number of the answer)
- optionTextRef - path to the text of answer #1
- ... - path to the text of answer # ...