MacroHandler Block Plugins
Download the plugin file / Eklenti dosyasını indirin
Choose a .mhblock package from the links below. GitHub’s Download raw file button on a guide downloads the .md/README guide, not the plugin. Do not rename it to .mhblock. Extract ZIP bundles before selecting an individual package in Add block → Import.
Türkçe: Aşağıdaki bağlantılardan .mhblock dosyasını indirin. GitHub’ın kılavuz sayfasındaki indirme düğmesi .md/README belgesini kaydeder; bu dosya eklenti olarak içe aktarılamaz. ZIP indirdiyseniz önce çıkarın. Uygulamada Blok ekle → İçe aktar bölümünden .mhblock dosyasını seçin.
Official optional block packages for Macro Handler, the Android automation and macro development app.
These small .mhblock files add optional entries to the app's Plugins library. They open the complete existing native block editors in the Visual and Logic workspaces. The engines remain inside the installed Android app; importing a file does not download executable native code or start a macro.
Navigation V2 — mini-map tracking preview
Draw a route on a full-map reference and follow it with the full map closed, using
the live mini-map for position and heading. The existing full-map mode is retained.
Download Navigation V2 2.0.1
· English setup guide
· Türkçe kurulum rehberi
Requires the updated Navigation native API 2 app, including the October 22
route management, joystick sway, group selection and diagnostic-panel updates. Version 1.0.52 alone does not establish compatibility; this
plugin release does not update the Android app or Google Play. V1 remains available
unchanged below. V2 has its own folder, manifest, checksums and release tag.
Local AI Visual Decision — multi-model 1.2.0 preview
Read the English guide before
downloading the separate plugin.
Choose SmolVLM-256M, SmolVLM-500M, LFM2.5-VL-450M or Qwen3-VL-2B per block.
Decision, bounded Number/Text and model-free Arithmetic OCR tasks share the existing
answer variable and True/False/Unknown/Error actions. Model weights remain separate;
the compatible app provides the reviewed CPU runtime. The exact 1.0.52 multitask
host commit in the manifest is required; Play 1.0.51 and earlier 1.0.52 builds are
not automatically compatible.
Model execution and answer accuracy are separate. Generative arithmetic failed even
on simple expressions; explicit Arithmetic OCR passed four controlled Samsung cases.
Qwen read the owned positive message but was slower, and was tested on LDPlayer, not
the low-memory physical Samsung. No universal 1–3 second, single-pixel, game or
24-hour guarantee. LFM has its own conditional license. See
expected/actual evidence and
the preview release.
The October 13 performance and stability follow-up
records additional owned-scene, arithmetic, timeout and recovery tests, plus a bounded
same-frame optimization in the updated host. It includes slower observations and
remaining limitations. The plugin descriptor stays at 1.2.0; the optimization needs
the newer Android host identified in that report.
The subsequent preparation and cancellation fix
removes duplicate verification after import/download, preserves integrity checks
and rejects late answers. Its final build passed 54 JVM tests and 16 device methods.
Packages
Download all four packages as a ZIP, then extract it to import the individual .mhblock files. Downloads are hosted by GitHub; setup guides are on the Macro Handler website.
Navigation lets you configure the existing route and joystick controls. Create your own macro-local profile, map, route and feedback, and test a short route first. It does not include a universal route for arbitrary games.
Navigation Stop adds the existing NAVIGATION_STOP block independently. It stops only the active navigation owned by the current macro and checks that the joystick was released. If release cannot be confirmed, execution reports NAVIGATION_RELEASE_UNCONFIRMED. It is not the application's global Stop control.
Agent Detect uses the existing region and taught-target detection controls. Teach and review your own targets, narrow the search region and verify detection on your screen. No pretrained target, recognition guarantee or permission is bundled.
Agent Routine opens the existing full Agent editor. Teach, review and approve the routine before running. This is a workflow within the Agent block, not a separate AGENT_ROUTINE engine. Ownership, approved-plan and run-consent checks remain enforced by the app.
Requirements for the four V1 packages
- A Macro Handler build with native block packages schema 2 / API 1 support and the four-entry catalog introduced for package release 1.1.0. The release target is 1.0.51, but earlier 1.0.51 builds do not support every descriptor. Version text alone is not a compatibility check.
- Android permissions and any membership or consent requirements for the actions you configure.
- Your own route, references and reviewed Agent routine where required. These files do not provide those user assets.
The default add-block palette omits these optional entries. Existing macros with the native blocks remain editable and executable under their existing permissions even if you have not imported the corresponding library file.
Import and use
- Download the desired individual
.mhblock file to the Android device. If you download the bundle ZIP, extract it first; the app imports individual .mhblock files.
- Open your macro in the Visual or Logic workspace.
- In the Add Block palette, choose Import block (.mhblock).
- Review the package name, ID and version, then confirm the import.
- Open Plugins, select the imported entry and add it to your macro. Import Navigation Stop separately if your macro needs it.
- Configure the real block card and test in a controlled setup before running a full macro.
Imported entries can be searched and favorited. Removing a library version does not delete blocks already added to a macro. The macro stores the descriptor and native settings; a compatible receiving app does not need a separate library import to open the block. Engine behavior follows the installed app version.
V1 package format and integrity
V1 package version: 1.1.0. Format: UTF-8 JSON, format: "macrohandler.block", schemaVersion: 2, empty code, empty inputs, and a native descriptor with apiVersion: 1. The separate Navigation V2 manifest specifies version 2.0.0, schema 2, native API 2 and the updated host requirement.
Only the following entry/ID pairs are supported:
| Entry | Package ID |
|---|
navigation | com.macrohandler.navigation |
navigation_stop | com.macrohandler.navigation_stop |
agent_detect | com.macrohandler.agent_detect |
agent_routine | com.macrohandler.agent_routine |
local_visual_decision (1.0.52 preview) | com.macrohandler.local_visual_decision |
There is no APK, DEX, JAR, shared library, model download, arbitrary native class or executable payload in these four packages. The author and source fields are descriptive metadata, not a cryptographic publisher signature. Download from the publisher's verified release and compare the file digest with SHA256SUMS if needed. The checksum is public integrity information, not a secret or access credential.
Updates and older versions
Each release has its own GitHub tag, immutable download URLs, manifest and SHA-256 checksums. Browse all releases to download a specific version. Updating the library never silently rewrites blocks already stored in a macro; add or replace a block explicitly when you want a new package descriptor.
Version 1.0.0 remains available. Its Navigation package includes the original Stop helper, and the updated app preserves that exact legacy behavior. In 1.1.0, Navigation and Navigation Stop are separate imports. Versions can coexist in the library; the same package ID and version cannot be overwritten with different content. Package versions describe library entries; the installed app supplies the actual engine and its compatibility and permission checks.
Community and support
The corresponding plugin detail page on macrohandler.com/plugins provides setup information and an inline comments and reactions section. Likes, dislikes and comments stay on the plugin page; there is no need to open a separate forum page. Participation requires sign-in, an active Community Badge and acceptance of the current community rules. Reporting, blocking and moderation remain available.
Website community features require the reviewed website/backend rollout and official plugin bindings; publishing these files alone does not enable them. The package download links above are independent of that rollout. Do not include account tokens, credentials or private screenshots in issue reports.
License
The package descriptors and documentation in this distribution are MIT licensed; see LICENSE. This license does not grant rights to Macro Handler's Android application, native engines, user data, game assets or third-party content. It does not change the application's terms or membership requirements.
Create and distribute your own blocks
The public Block Authoring SDK supports Lua packages with typed editable properties, native form groups, help/units and semantic icons for both No-Code and Logic workspaces. Read the English guides before downloading the versioned assets:
SDK releases use separate sdk-v... tags. The four official native packages keep their existing v... release line. Schema-3 Lua authoring requires a reader build supporting it; arbitrary HTML/DEX/native widget loading is not a plugin capability. The SDK is MIT licensed under its included scope and does not distribute the application runtime.
Individual plugin guides
Each guide explains the purpose, requirements and import steps, and includes the versioned file download.
Custom block design SDK 1.1.0
The English authoring guide explains how to build and distribute your own Lua block, choose an embedded offline PNG icon, organize typed properties into native tabs, and add atomic settings presets/reset. Review the versioned SDK release before downloading. Requires the updated schema-4 reader; this does not change the four native plugin packages or claim Play publication.
