INTELLIPATCH

Dynamic Reactive A* Pathfinding + Goal System

Godot-style navigation for RPG Maker MZ — patches, composable goals, stuck policies, expert API

---

IntelliPatch is a complete navigation engine for RPG Maker MZ — the same way Godot's NavigationServer + NavigationPolygon works for 3D games. Programmable navigation patches, composable multi-target goals, six stuck policies, path smoothing, portal loop guard, and a debug overlay that actually shows you what's happening.

Every other RMMZ pathfinder stops at "walk from A to B". IntelliPatch gives you the building blocks for real AI: cost zones, blockers, portals, currents, conditional gates, AND/OR/SEQ goal composition, barrier sync across multiple events, and a register* API that lets experts extend everything without touching the source.

Four Killer Features

The pieces no other RMMZ pathfinder has — available in IntelliPatch Pro.

Lite vs Pro — Choose Your Edition

Same engine file. One flag. Pro unlocks the Goal System, 3 extra patch types, 4 advanced stuck policies, 13 more commands, and 12 expert script hooks.

The Goal System — Real AI Logic

Replace {x, y} with a declarative goal tree. Recurse, combine, interrupt, sync. Pro only.

Operators, Interrupts, Waits

• Recursive composition — a goal can nest goals. Build arbitrary AND/OR/SEQ/NOT trees.
• Soft avoid lists — mark tiles as "never stand here", resolver skips them safely.
• Interrupt rules — swap the whole goal mid-flight when a condition fires (priority-ordered, 15-frame cooldown).
• Wait conditions — pause at any waypoint until frames elapse, a switch flips, a signal arrives, the player comes near, or a custom function returns true.
• Loop & bounce — infinite patrols without reissuing commands.
• Timeout — fail gracefully after N frames when the goal is unachievable.

Example — Two Levers Puzzle

// Two guards must press two levers at the SAME frame.
// If one arrives early, it waits up to 30 frames for the other.
IntelliPatch.moveToGoal($gameMap.event(5), {
  mode: "simultaneous",
  points: [ { x: 3, y: 7 }, { x: 12, y: 7 } ],
  tolerance: 30,
  onGoalComplete: function() {
    $gameSwitches.setValue(42, true);   // opens the door
    $gameMessage.add("The levers click in unison!");
  },
  onGoalFailed: function(reason) { $gameMessage.add("Too slow..."); }
});

A puzzle that used to need 200 event commands + a parallel process → 10 lines of code (Pro only).

Navigation Patches — Programmable Environment

Five patch types, priority-ordered, rect or predicate, revision-invalidated. Add, toggle, remove — the cache updates lazily on the next search. Pro only.

Example — Mud + Door + Portal

// Mud slows 5x5 area
IntelliPatch.addPatch({ id: "mud", type: "cost",
  area: { x: 3, y: 3, w: 5, h: 5 }, data: { multiplier: 5 } });
// Door opens only with switch 5 ON
IntelliPatch.addPatch({ id: "door", type: "block",
  area: { x: 12, y: 8, w: 1, h: 1 },
  condition: function(){ return !$gameSwitches.value(5); } });
// Portal from (2,2) to (18,15)
IntelliPatch.addPatch({ id: "stairs", type: "portal",
  area: { x: 2, y: 2, w: 1, h: 1 }, data: { toX: 18, toY: 15 } });

Stuck Policies — Never Freeze, Never Surprise

Every pathfinder eventually hits a wall (literally). IntelliPatch always tries an alternative road first (up to blockedRetries times, with live cache validation). Only when every recalc fails does the chosen stuck policy run. Lite only has recalc + giveup.

Expert Script API — Extend Everything

Twelve register* hooks. All validated, warn-and-false on misuse, idempotent, never throw. Extend the plugin without editing a single line. Pro only.

Example — Custom Heuristic (Enemies Prefer the Player's Facing)

IntelliPatch.registerHeuristic("biased", function(x0, y0, x1, y1) {
  var base = Math.abs(x0 - x1) + Math.abs(y0 - y1);
  if ($gamePlayer.direction() === 6 && x1 > x0) base *= 0.7;
  if ($gamePlayer.direction() === 4 && x1 < x0) base *= 0.7;
  return base;
});
IntelliPatch.setGlobalConfig("defaultHeuristic", "biased");

Example — Custom Goal Mode (Spread Formation)

IntelliPatch.registerGoalMode("spread", {
  resolve: function(goal, nav) {
    var ch = nav.character;
    var best = null, bestScore = -Infinity;
    for (var r = 1; r <= 8; r++) {
      var cands = [[ch.x+r,ch.y], [ch.x-r,ch.y], [ch.x,ch.y+r], [ch.x,ch.y-r]];
      for (var i = 0; i < cands.length; i++) {
        var d = minDistanceToOtherEvents(cands[i][0], cands[i][1], ch);
        if (d > bestScore) { bestScore = d; best = cands[i]; }
      }
    }
    return { target: best ? { x: best[0], y: best[1] } : null, done: false };
  }
});

Example — Bridge to PolyTrigger2D (Area2D as Goal)

// Wait until the player enters a PolyTrigger2D area before continuing
IntelliPatch.registerWaitCondition("inArea", function(areaId, nav) {
  var id = nav.character.eventId ? nav.character.eventId() : 0;
  return PolyTrigger2D.isInside(areaId, id);
});
IntelliPatch.moveToGoal(this, {
  mode: "sequence",
  points: [
    { x: 5, y: 5, wait: { inArea: 3 } },   // wait until player enters area 3
    { x: 20, y: 15, wait: { frames: 120 } } // then pause 2 seconds
  ],
  onGoalComplete: function() { $gameSwitches.setValue(99, true); }
});

Debug Overlay — See Everything

Turn on DebugMode and see the entire decision-making process in real time.

Plus per-navigator labels: len=N rec=N state=... stuck=N fb=0 pol=...:N goal=mode:idx/total, click-to-inspect any tile in-game (logs every patch modifier applied), and console dumps:

Lite stamps a LITE watermark in the corner of the overlay.

Quick Start

1. Copy IntelliPatch.js into js/plugins/
2. Enable in Plugin Manager, load order: VisuStella → IntelliPatch → CharacterBase overriders
3. From an event Script call: IntelliPatch.moveTo(this, 15, 20);
4. Or use Plugin Commands (MoveTo, FollowTarget, MoveToGoal, Simultaneous, ...)
5. Enable DebugMode to watch paths (green), patches (yellow), goals (purple), targets (cyan)

Plugin Commands (23 total)

Movement (Lite: MoveTo, FollowTarget, DebugToggle)

Goal System (Pro only)

Patches (Pro only)

Debug (Lite: DebugToggle)

The Complete RMMZ Plugin Stack

IntelliPatch integrates natively with the other Rpx & Just Dev plugins.

When all three are installed: PolyTrigger2D detects via shapes → StateMachine2D reacts via states → IntelliPatch navigates via goals. NPCs that see you, chase you with A*, flee through dynamic obstacles, sync arrivals for puzzles, phase through cutscene doors — all without a single parallel process.

What It Doesn't Do

• Does not modify player movement (events only by default; player works when explicitly targeted).
• Tile-based only — no 3D, no continuous navmesh, works on the 48×48 grid.
• Does not replace VisuStella Events and Movement Core — it coexists with it.
• Does not guarantee perfect paths on maps with no passable tiles defined (check tileset passability first).
• Lite edition only: 3-event session cap, no patches, no goals, no hooks, watermark on overlay.

Compatibility

• ✅RPG Maker MZ 1.0+ — PixiJS 5.x, alias-only, no core files modified
• ✅VisuStella Events and Movement Core — detected via Imported.VisuMZ_*, no double ticks (Pro; Lite uses base-class hook only)
• ✅Altimit / QMovement — pixel-movement safe
• ✅Any canPass override — respects character.canPass, falls back to $gameMap.isPassable
• ✅PolyTrigger2D / StateMachine2D — native bridge, area signals become FSM signals (Pro)
• ✅Save / Load safe — navigators cancelled on map setup, no functions serialized
• ✅Steam & Web builds — no Node.js required

Choose Your Edition

License

• ✅Commercial Use Allowed — sell your game, keep 100% of revenue
• ✅Modification Allowed — adapt it to your needs
• ❌Redistribution NOT Allowed — cannot be sold or distributed standalone
• ➖Credit Not Required — though it's appreciated
• ⚠️Keep the Copyright Notice — the license header must remain intact
• ❌No Warranty — provided "as is". Test before shipping.

Same codebase, one flag, all features unlocked. Upgrade any time.

Made with ❤️ by Rpx & Just Dev — itch.io · GitHub · rpxgames.win