Difference between revisions of "MQ2Nav" - MMOBugs Wiki

 
(24 intermediate revisions by 4 users not shown)
Line 11: Line 11:
  
 
<font class="highlight">MQ2Nav</font> is a navigation mesh plugin for MacroQuest2. This is based on the origin MQ2Navigation plugin, but has been heavily rewritten to take advantage of newer libraries that are available. The plugin also includes a 3d overlay to display navigation meshes as well as a debugging UI.
 
<font class="highlight">MQ2Nav</font> is a navigation mesh plugin for MacroQuest2. This is based on the origin MQ2Navigation plugin, but has been heavily rewritten to take advantage of newer libraries that are available. The plugin also includes a 3d overlay to display navigation meshes as well as a debugging UI.
 +
  
 
This project consists of two parts: The MQ2 Plugin (MQ2Nav.dll), and the Mesh Generator (MeshGenerator.exe)
 
This project consists of two parts: The MQ2 Plugin (MQ2Nav.dll), and the Mesh Generator (MeshGenerator.exe)
 +
 +
 +
You can download mesh paths for almost all zones at [https://mqmesh.com MQMesh]
 +
 +
 +
The default folder mesh storage is the Resources/MQ2Nav in your MacroQuest folder.
  
 
==Commands==
 
==Commands==
Line 20: Line 27:
 
* <span class="highlight2">/navigate Recordwaypoint <waypoint name> <waypoint tag></span> create a waypoint.
 
* <span class="highlight2">/navigate Recordwaypoint <waypoint name> <waypoint tag></span> create a waypoint.
 
* <span class="highlight2">/navigate Target</span> Navigate to target.
 
* <span class="highlight2">/navigate Target</span> Navigate to target.
* <span class="highlight2">/navigate X Y Z</span> Navigate to coordinates.
+
* <span class="highlight2">/navigate loc X Y Z</span> Navigate to coordinates.
 
* <span class="highlight2">/navigate Item [click] [once]</span> Navigate to item (and click it)
 
* <span class="highlight2">/navigate Item [click] [once]</span> Navigate to item (and click it)
 
* <span class="highlight2">/navigate Door</span> Navigate to door/option (and click it)
 
* <span class="highlight2">/navigate Door</span> Navigate to door/option (and click it)
Line 26: Line 33:
 
* <span class="highlight2">/navigate Stop</span> Stop navigation.
 
* <span class="highlight2">/navigate Stop</span> Stop navigation.
 
* <span class="highlight2">/navigate Pause</span> Pause navigation.
 
* <span class="highlight2">/navigate Pause</span> Pause navigation.
 +
* <span class="highlight2">/navigate ui</span> toggle displaying the in-game user interface
  
 +
==MacroData==
 +
 +
Data Types - Navigation
 +
 +
* <span class="highlight2">${Navigation.Active} :Boolean</span> Returns true if navigation is currently active
 +
* <span class="highlight2">${Navigation.Paused} :Boolean</span> Returns true if navigation is currently paused
 +
* <span class="highlight2">${Navigation.MeshLoaded} : Boolean</span> Returns true if a mesh is loaded in the zone
 +
* <span class="highlight2">${Navigation.PathExists[navigation parameters]} :Boolean</span> Returns true if the specified navigation parameters results in a navigatable path. Navigation parameters are the same parameters that would be passed to /nav
 +
* <span class="highlight2">${Navigation.PathLength[navigation parameters} :Float</span> Similar to PathExists, but returns the length of the path if one is found
 +
* <span class="highlight2">${Navigation.Setting[ini file setting]} :String</span> Returns the value for the specified setting from your ini file
 +
* <span class="highlight2">${Navigation.Velocity} :Int</span> Returns your current velocity
 +
 +
==Video==
 +
<center><b>Mesh Generator Tutorial</b><br>
 +
{{#ev:youtube|rm48CHCGtSM}}</center>
  
 
==Screenshots==
 
==Screenshots==
 
  
 
==Availability==
 
==Availability==
  
 
This plugin is included with the MMOBugs Compile.
 
This plugin is included with the MMOBugs Compile.

Latest revision as of 19:30, 20 November 2022

Plugin Info
Name MQ2Nav
Author Brainiac
Link None
Commands /navigate
Source Available Yes
Uses INI File Yes

Description

MQ2Nav is a navigation mesh plugin for MacroQuest2. This is based on the origin MQ2Navigation plugin, but has been heavily rewritten to take advantage of newer libraries that are available. The plugin also includes a 3d overlay to display navigation meshes as well as a debugging UI.


This project consists of two parts: The MQ2 Plugin (MQ2Nav.dll), and the Mesh Generator (MeshGenerator.exe)


You can download mesh paths for almost all zones at MQMesh


The default folder mesh storage is the Resources/MQ2Nav in your MacroQuest folder.

Commands

  • /navigate [save | load] Save/Load settings.
  • /navigate Reload Reload Navmesh.
  • /navigate Recordwaypoint <waypoint name> <waypoint tag> create a waypoint.
  • /navigate Target Navigate to target.
  • /navigate loc X Y Z Navigate to coordinates.
  • /navigate Item [click] [once] Navigate to item (and click it)
  • /navigate Door Navigate to door/option (and click it)
  • /navigate Waypoint Navigate to waypoint.
  • /navigate Stop Stop navigation.
  • /navigate Pause Pause navigation.
  • /navigate ui toggle displaying the in-game user interface

MacroData

Data Types - Navigation

  • ${Navigation.Active} :Boolean Returns true if navigation is currently active
  • ${Navigation.Paused} :Boolean Returns true if navigation is currently paused
  • ${Navigation.MeshLoaded} : Boolean Returns true if a mesh is loaded in the zone
  • ${Navigation.PathExists[navigation parameters]} :Boolean Returns true if the specified navigation parameters results in a navigatable path. Navigation parameters are the same parameters that would be passed to /nav
  • ${Navigation.PathLength[navigation parameters} :Float Similar to PathExists, but returns the length of the path if one is found
  • ${Navigation.Setting[ini file setting]} :String Returns the value for the specified setting from your ini file
  • ${Navigation.Velocity} :Int Returns your current velocity

Video

Mesh Generator Tutorial

Screenshots

Availability

This plugin is included with the MMOBugs Compile.