Skip to content

v0.1.1

Choose a tag to compare

@Whaileee Whaileee released this 05 Nov 10:00
519db55

H7ModEngine v0.1.1

This release adds an in-game debug console for mod makers, a few new API functions, and puts the project under the Apache License 2.0.

Installation

Same as before: download dinput8.dll below and put it in <Game>\Binaries\Win64\ (replace the old one). The new DLL updates the Mods menu and installs the DebugConsole mod on the next start; your mods, settings and saved data stay as they are.

Example mods (optional): H7ModEngine-examples.zip, unzipped into the game folder (the folder that contains Binaries).

What's new

Debug console

A Lua console drawn over the game, for writing and testing mods without leaving it. It is a mod, DebugConsole, off by default: turn it on in the Mods menu (category Developer), then press ~ (the key left of 1). The key can be changed in H7ModEngine.ini:

[Console]
Key=Tilde
  • Shows the engine log live; runs Lua (an expression prints its value) or game console commands (/Stat FPS).
  • One-time scripts: type or paste (Ctrl+V) several lines. Enter on an unfinished block (for i = 1, 3 do) starts a new, indented line; the script runs once it is complete.
  • Suggestions as you type, each with its kind, signature and declaring class: game commands (only the ones this build accepts), Lua globals, table fields, and the properties and methods of game objects, also after lookups such as h7.first("H7AdventureHero"):Get.
  • Parameter hints while typing arguments, with the current argument underlined:
    find_all(class: string | Class, include_templates?: bool) -> Object[]
  • History is saved between sessions; the game doesn't receive the keyboard while the console is open.

For modders

  • h7.log_lines([after]): the recent log lines (for in-game viewers).
  • h7.config(section, key [, default]): read values from H7ModEngine.ini.
  • h7.clipboard([text]): read or set the clipboard text.
  • h7.properties entries have a new type_name field with the UnrealScript type (Vector, array<H7Creature>).
  • The API reference now shows typed signatures: https://whaileee.github.io/H7ModEngine/

License

H7ModEngine is now licensed under the Apache License 2.0 (see LICENSE). Lua is MIT-licensed. Might & Magic Heroes VII and its content belong to Ubisoft.

Requirements

  • Might & Magic Heroes VII v2.2.1, 64-bit, Windows (the Ubisoft Connect version).
  • Single player only; multiplayer isn't supported.

Full changelog: v0.1.0...v0.1.1