Vaexil Simple Mod Framework

A custom, standalone build of Simple Mod Framework for HITMAN World of Assassination, focused on improving deploy visibility and diagnostics.

This project is maintained separately from the official Simple Mod Framework repository. It is intended for local/custom development and should not be treated as an official SMF release.

Project Status

This fork is detached from the official repository for framework releases and desktop identity:

• Git remote: https://github.com/jmars319/vaexil-simple-mod-framework
• Mod Manager product name: Vaexil Mod Manager
• Desktop app id: com.jmars319.vaexil-simple-mod-framework.mod-manager
• Custom protocol: vaexil-simple-mod-framework://
• Framework self-update checks: jmars319/vaexil-simple-mod-framework
• Diagnostics: kept local unless the user copies them

The mod updater is intentionally still compatible with existing mod-provided update URLs. That is the one place this fork should continue to follow the wider SMF mod ecosystem.

Build And Run

Use npm from the repository root and from Mod Manager/.

npm ci
npm run check

cd "Mod Manager"
npm ci
npm run build:svelte
npm run build

Common development commands:

cd "Mod Manager"
npm run dev
npm run dev:mock-deploy

npm run dev:mock-deploy opens the Mod Manager with mock deploy scenarios available. The visual test surface is also reachable from the app navigation as Deploy Test Bench.

The GitHub Actions workflow builds the Windows release artifact as Release.zip. The ZIP is assembled with:

• Deploy.exe
• Vaexil Mod Manager/
• Vaexil Mod Manager.cmd
• Third-Party/
• Info/
• API/

Deploy Visibility Changes

This fork adds structured deploy status events alongside the existing deploy log stream. The Mod Manager now has enough state to show:

• Current deploy stage and current mod
• Last deploy log line and how long it has been stale
• Active external commands such as rpkg-cli and HMLanguageTools
• Child process start, exit, and alive snapshots
• Heartbeat/activity indicators for slow work
• Long-running step warnings, especially localisation rebuilds
• Staging/temp file counts and sizes when available
• Warning/error summaries
• Copyable deploy diagnostics

The deploy UI test bench can replay localisation, failure, and stale-heartbeat scenarios without touching installed SMF, HITMAN files, or mods.

Credits

This project is derived from Simple Mod Framework, created and maintained by Atampy26 / atampy25. The original project's architecture, deploy pipeline, Mod Manager UI, documentation, and much of the code in this repository come from that work.

Custom deploy visibility and diagnostics changes in this fork are maintained by jmars319.

SMF also bundles and integrates third-party tools and libraries. Their original authors retain their respective copyrights and licenses; see the files in Third-Party/, COPYING, and COPYING.LESSER for license details.

HITMAN and HITMAN World of Assassination are the property of IO Interactive. This project is community-made and is not affiliated with or endorsed by IO Interactive.

License

This project preserves the original Simple Mod Framework LGPL-3.0-only licensing. See COPYING and COPYING.LESSER.