New Features

Actionbar

• Added EEex_Actionbar_AddButtonsUpdatedListener(listener: function).

  • Registers listener, which is called after the engine has built its internal button data when switching to a new actionbar state.

  • Signature of listener – function() -> boolean.

  • Returning true suppresses the execution of any remaining listeners.

AIBase

• The LastSummonerOf scripting object is now persisted across reloads.

• Added EEex_AIBase_AddScriptingObjectUpdatedListener(listener: function).

  • Registers listener, which is called after the engine has updated a scripting object for a script runner, (e.g. LastSummonerOf on the summon).

  • Signature of listener – function(aiBase: CGameAIBase, scriptingObject: EEex_ScriptingObject).

  • Valid EEex_ScriptingObject values:

    Name
    ATTACKER
    ORDERED_BY
    HITTER
    HELP
    TRIGGER
    SEEN
    TALKED_TO
    HEARD
    SUMMONED_BY
    KILLED

Logging

• Added the InfinityLoader.ini -> [General].LogFile option.

  • Causes all console output to be automatically mirrored to the specified log file.

Object

• Added the EEex_LuaDecode() scripting object.

  • This object calls its string parameter as a Lua chunk and uses the return value (should be derived from CGameAIBase) as the resulting target. The primary purpose of this object is its ability to resolve to a new target every time it is decoded by the engine.

  • The Lua global EEex_LuaDecode_Object is set to the script runner before the Lua chunk is executed.

Resource

• EEex_Resource_Demand() can now demand PRO and EFF files.

  • EFF files are exposed as CGameEffectBase instances.

  • PRO files are exposed as either CProjectileFileFormat, CProjectileBAMFileFormat, or CProjectileAreaFileFormat instances depending on the file header.

• Added EEex_Resource_FreeScript(script: CAIScript).

  • Frees the memory associated with script.

  • Don't use this on an object that the engine holds a reference to!

• Added EEex_Resource_LoadScript(resref: string, bPlayerScript: boolean) -> CAIScript.

  • Returns a CAIScript instance that represents the .BCS / .BS with resref.

  • If bPlayerScript is true, signifies that resref has the extension .BS instead of .BCS.

    Note: Due to the enhanced edition’s use of script caching, the engine has trouble differentiating between .BS and .BCS files with the same name. If a script with the given resref has already been loaded by the engine, that script will be returned, regardless of bPlayerScript.

Sprite

• Added EEex_Sprite_AddAlterBaseWeaponDamageListener(listener: function).

  • Registers listener, which is called after the engine has built the base op12 (damage) effect for a weapon hit.

  • Signature of listener – function(context: table).

  • context has the following fields:

    Name	Type
    ability	Item_ability_st
    attacker	CGameSprite
    effect	CGameEffect
    isCritical	boolean
    isLeftHand	boolean
    launcher	CItem
    target	CGameSprite
    weapon	CItem

• Added EEex_Sprite_AddBlockWeaponHitListener(listener: function).

  • Registers listener, which is called before a sprite's swing hits its target.

  • Signature of listener – function(context: table) -> boolean.

  • context has the following fields:

    Name	Type
    attackingSprite	CGameSprite
    targetSprite	CGameSprite
    weapon	CItem
    weaponAbility	Item_ability_st

  • Returning true blocks the hit.

• Added EEex_Sprite_AddLoadedListener(listener: function).

  • Registers listener, which is called when a sprite is first created in a game session, after its effect list has been loaded (but not processed).

  • Signature of listener – function(sprite: CGameSprite).

• Added EEex_Sprite_GetFromUUID(uuid: number) -> CGameSprite.

  • Returns the sprite in the current game session with the given uuid.

  • If the sprite with the given uuid is currently unloaded, returns nil.

• Added EEex_Sprite_GetUUID(sprite: CGameSprite) -> number.

  • Returns the uuid of the given sprite.

• Added EEex_Sprite_LoadedWithUUIDCallback(sourceSprite: CGameSprite, uuid: number, callback: function).

  • Registers callback, which is called once after a sprite with uuid is loaded into the current game session.

  • Signature of callback – function(sourceSprite: CGameSprite, loadedSprite: CGameSprite).