• You've discovered RedGuides 📕 an EverQuest multi-boxing community 🛡️🧙🗡️. We want you to play several EQ characters at once, come join us and say hello! 👋
  • IS THIS SITE UGLY? Change the look. To dismiss this notice, click the X --->
Resource icon

MAUI (MuleAssist UI) 02/11/2024

Download now:  Join us with Level 2 access or earn your way in with  RedCents.
Other Authors
Lemons
Software Requirements
MacroQuest - Live, MQ2Lua, MuleAssist
Server Type
🏢 Live TLP Test
Installing and starting:

Option 1:
Click "watch" at the top right of this page, and install MAUI from the Lua tab of the RedGuides Launcher.
Option 2: Click "download" at the top right of this page, and unzip the downloaded zip file into your MQ Lua folder.

The resulting folder content should look like this:
INI:
lua/
└── maui
   ├── addons
   │   └── ma.lua
   ├── lib
   │   └── Cache.lua
   │   └── ImGuiFileDialog.lua
   │   └── LIP.lua
   ├── schemas
   │   └── ma.lua
   ├── globals.lua
   ├── init.lua
   └── utils.lua

Make sure the Lua plugin is loaded with: /plugin lua load
Start the script with: /lua run maui

NOTE: If the script errors loading lfs.dll, refer to the FAQ.

Starting MAUI automatically at login

To load MAUI on startup for ALL characters:

  1. Right click your MQ tray icon in the taskbar and select Open Folder > Config
  2. Create a new file ingame.cfg, or open it if you already have one.
  3. Add the line /lua run maui
  4. Save and close the file.
  5. Test in game by running /loadcfg ingame.cfg or by logging in a character.
To load MAUI on startup for a SPECIFIC character:
  1. Right click your MQ tray icon in the taskbar and select Open Folder > Config
  2. Create a new file server_Character.cfg, or open it if you already have one, where server is replaced with your EQ server short name, and Character is replaced with your character name. For example, rizlona_Dudebro.cfg.
  3. Add the line /lua run maui
  4. Save and close the file.
  5. Test in game by running /loadcfg server_Character.cfg or log in the character.
NOTE: If you created ingame.cfg or server_Character.cfg using Notepad, like by right clicking in your config folder and selecting New > Text Document, then the file was probably saved with the wrong file extension, like ingame.cfg.txt. You will need to remove the .txt file extension before it will work.

Overview


MAUI is a replacement for the mq2mule plugin so that MA users on MQ (next) can continue to have a UI to make INI updates.
It doesn't do everything which the old one did, but it should look pretty familiar.

dpstab.png


NOTE: Before using, backup your INI. There may (I'm not aware of any at this time) be bugs that would write values in a wrong format that the macro doesn't expect (0/1 instead of TRUE/FALSE, stuff like that)

It will look for several name variations of the INI for the character running it:
  1. MuleAssist_server_name.ini
  2. MuleAssist_server_name_lvl.ini (current level)
  3. MuleAssist_server_name_lvl.ini (your level - 1,2,3...10)
If no INI file without a level is found, and no INI with your current level is found, but an INI for a previous level is found, then it will automatically copy the previous level INI to a current level INI.

All configuration items documented in the MuleAssist Guide should be included in the UI. If anything is missing, you should still be able to edit them in the raw INI tab.

The spell upgrades feature is there, though maybe a little bit different. When selecting an individual spell or ability in a list, such as Buffs or DPS, an upgrade button will appear if you have an upgraded version of the spell available:

spellupgrade.png


No changes made in the UI will be persisted until you have clicked the Save INI button.

For key/values with multiple parts to them, like Buffs1=Wand of Frozen Modulation|Summon|Wand of Restless Modulation|1|ME, the UI breaks this up into 3 entries:

1630715691061.png


The first line, Name, is only the part up until the |, which should just be the ability name.
The Options value should include everything which comes after the first |.
The Conditions value should be whatever would go into the condition value like for key BuffsCond1.

Right clicking an icon in something like DPS or Buffs list will give a menu of available spells, AAs, discs to choose from:

spellpicker.png


Raw INI Editor:
Note the separate refresh and save buttons for the raw INI. the Save INI button at the top saves the content of the regular configuration tabs. It does not save edits made to the raw INI tab. To save edits made in the raw INI tab, click Save Raw INI.

rawINItab.png


Importing KA INI Files:

MAUI can import KA INI files and convert them to MA INI files. This has only been tested with a limited number of KA12 INI files, so YMMV. It works like so:
  1. The KA INI to import must be in your next/config folder
  2. On the Import KA INI section, enter the file name (no file explorer, it must be typed manually/pasted in)
  3. Click Import
  4. All keys which are common to both KA and MA will be copied over to the resulting MA INI. Any keys which are KA or MA specific will not be set.
  5. Any lines which include a condition, like DPS1=burst of flame|cond1 will be converted to what MA expects, with the content of cond1 from KConditions being set into DPSCond1.
Source Repository
https://github.com/aquietone/maui
[git] Automation options?
Yes
Author
aquietone
First release
Last update
Rating
5.00 star(s) 5 ratings

More resources from aquietone

Share this resource

Latest updates

  1. 02/11/2024

    0.11.0 - Update to use CursorAttachment for dragging in spell gems.. thought i pushed this already..
  2. 20230706

    0.10.0 - Rename folder to maui and use init.lua
  3. 20230107

    0.9.11 - Fix nil ImGui.Text input

Latest reviews

Wow, I've been away for a while. Shockingly easy transition from Mq2mule and from the first fight, it's just smoother.
This was actually a joy to load up and use. Thank you!
Even better than the original! Great work!
Great for my bard.
Great utility. Great support. Always getting better. If you're not using this on Next, you should be.
Top