• 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

Utility Overseer 3.59

Download now:  Join us with Level 2 access or earn your way in with  RedCents.
Server Type
🏢 Live

2022 ESA Winner
Overseer offers an automated mechanism for running and managing one or all characters' Overseer experience.


Migration
When launched, Overseer 3.0 will either create default configurations, or migrate existing (previous *.mac or *.Lua) files.
These exist in the "[config]/overseer/" folder


User Interface
By default, the UI will display. This may be modified by either:
  • [Hide This Window] button
  • Command-line "/mqoverseer [show/hide]"
Main
  • State
    • Indicates the current state, which includes:
      • Idle - no actions being taken
      • Running complete cycle - Full Overseer cycle in process
      • Counting Agents: Statistic agent counting process occurring
      • Paused. Waiting for In Game: Logged to character select screen
      • Paused. Waiting for [Character]: Different character is logged in that initiated the script
        • See [Settings]/[On Character Change] for details
      • Paused. Character must be level 85 to utilize Overseer: Character logged in is less than 85 and may not utilize overseer

General


1682785646208.png


  • Configuration: Global or Character
    • Specified by the base file: "overseer/Overseer.Lua"
    • "[General] useCharacterConfigurations=0/1"
    • This is currently not able to change via the UI
    • Hovering over the text will display the actual Lua file being utilized
  • Next Quest Completion
    • Specifies time until the next quest completes
    • If auto-restart not specified and quests have completed, will so indicate
      • 1677184773385.png
    • Also indicates if no quests are current pending
      • 1677184942566.png
  • Next Rotation
    • Specifies time until the next Overseer quest rotation
    • If auto-restart is specified, a full cycle will initiate at this time
  • [ ] Automatically Restart
    • If checked, a full Overseer cycle will initiate whenever the next Quest or Rotation timers expire
  • 1682785702954.png
    [Run Full Cycle Now]
    • At any point, clicking this will kick off a full Overseer cycle
    • Whenever running, the operation may be canceled by clicking the cancel button
  • 1682785719048.png
    [Open/Close Overseer Window]
    • Short-cut to opening or closing the EQ Overseer window
  • 1682785734391.png
    [Hide This Window]
    • Hides the MQ Overseer UI above.
    • To re-display, execute the command "/mqoverseer [show]"
  • 1682785770806.png
    [Stop This Script]
    • Stops the script ("/lua stop overseer")
  • Overseer Claims (Inventory)
    • Displays current inventory list of Overseer Tetradrachms and any Overseer-related clickables
Settings

General

1682786160786.png
1682786174158.png

General
  • [ ] Run Full Cycle on Startup
    • When checked, launching MQ Overseer will kick off a full Overseer cycle
  • [ ] Automatically Restart
    • This is a duplicate of the option on the main [General] page
    • If checked, a full Overseer cycle will initiate whenever the next Quest or Rotation timers expire
  • [ ] Pause On Character Change
    • If checked, script pauses when on a character different than the one initiating the script
    • Not Fully Implemented Yet
Claim Settings
  • [ ] Claim Rewards
    • When checked, the script will automatically claim rewards based on [Active Rewards] configuration below
  • [ ] Claim Collection Fragments
    • When checked and 4+ Overseer Collection Item Dispenser Fragments in inventory, will click to create an Overseer Collection Item Dispenser
    • Due to variety of options, there is no automated clicking of Collection Item Dispensers
  • [ ] Claim Agent Packs
    • When checked, any Overseer Agent Packs in inventory will be claimed
  • [ ] Claim Tetradrachm Packs
    • When checked, any Overseer Tetradrachm Packs in inventory will be claimed
  • [ ] Claim Elite Agent Echos
    • When checked, any Elite Agent Echos in inventory will be claimed
    • Associated combo box allows automatic collection of the resulting reward.
    • 'None' prevents the system from selecting any reward (leaving it to be manually chosen)
Ignore Specific Quests
  • [ ] Ignore Recruitment Quests
    • When checked, recruitment quests are not executed
  • [ ] Ignore Conversion Quests
    • When checked, conversion quests are not executed
  • [ ] Count Agents Between Cycles
    • When checked, runs a full agent statistics count
    • See [Stats] tab for more details
Agents Required Before Conversion
  • [ ] Convert Elite Agents
    • When checked, will automatically convert Elite Agents having more than the specified number
    • Automatic Conversion Not Yet Activated. Manually initiating this process available on [Stats] and [Actions] tabs
  • [#] Common/Uncommon/Rare
    • Runs the respective Conversion quests, ensuring to not go below the specified number of each agent
  • [#] Elite
    • Retires any elite agent that has more than the specified number of duplicates
Reward Claim
  • Level Cap for Claiming Exp in Rewards
    • [#] Max Level Claim exp
    • [#] Max Exp Level Claim Exp
    • These two options allow the 'Character Experience' option to be claimed or skipped based on current Level of the character
    • If At Or Above the Specified Level and % Into Level,
      • Char Experience is skipped, else Char Experience is selected
    • Example: Specify 120 & 95.
      • Character at level 119 will select Char Experience
      • Character at level 120, 50% into level - will select Char Experience
      • Character at level 120, 96% into level - will SKIP Char Experience
  • [#] Minimum Success %
    • Will skip any quest with a success % less than specified amount
      • Select 0 to run any applicable quest
Logging
  • [v] Log Level
    • Specifies level of logging to appear in the default MQ output window.
Display
  • [ ] Show Additional UI Details
    • Adds some extra text and details to the UI, if desired
  • [ ] Enter Test Mode
    • Adds an additional [Test] tab to aid in troubleshooting script
    • Not supported officially.

Rewards
1682788310880.png

  • Active Rewards
    • Allows specifying and prioritizing which rewards to claim for this character
    • Active rewards (left box) may be raised or lowered in priority by selecting a reward and clicking the up or down buttons
      • 1682788385129.png
    • Active rewards may be added to by selecting an reward from the top box and selecting the [Add]
      1682788356983.png
      button
    • Available rewards may be removed by selecting a reward from the top box and selecting the [Remove]
      1682788374842.png
      button.
Specific

Track Overseer Achievements

This replaces most of the core concept of "Specific Quests" to run achievement quests when available. Makes things much simpler to track.

NOTE: The TLO Achievement system does not report reliably - so we need to maintain a specific file identifying tasks. Will be maintained until an alternative is figured out.

View attachment 53775

By default, maintains existing functionality to run any achievement quests - even if completed.
Unchecking "Run Completed Achievements" will only run the achievement tasks not yet run.
View attachment 53776


Specific Quests
1678038287747.png

"Specific Quests" allows identifying one or more quests to explicitly run whenever they are available, in the order specified.
The primary use case is for seasonal quest lines and achievements.

Actions
1678033199808.png

These will run focused functionalities on-demand:

  • Claim Completed Missions: Claim quest (but not reward) for any completed active quests
  • Run Conversion Quests: Attempt to run all conversion quests
  • Run Recruit Quests: Attempt to run any recruit quests
  • Run General Quests: Attempts to run any non-conversion, non-recruit quests
  • Preview General Quest Cycle: Does not actually run any quests. Determines what quests would be run and in which order for current list and INI configuration

Stats
1677185830674.png

Statistics is a counting of each agent by type and duplicate status.
  • [Collect Statistics]
    • Clicking initiates a counting of the agents. This can take some time based on how many agents are currently owned.
    • The operation may be canceled at any time by clicking [Cancel]
      • 1677185907059.png

To Do's
  • Run Tutorial option
    • When on an initial account, add button to initiate the [Run Tutorial] functionality
    • Until then running the previous *.MACro option "/mac Overseer runTutorial" will suffice
  • Switch Characters
    • Honor the [Follow] character option to automatically, or on-demand, switch context to the currently logged in character
  • Quest priority configurations
    • Allow full configuration of which quests to run when/how
  • Specific Quests
    • Holiday Quests may be run by specifying them in the INI file.
    • A UI does not currently exist and may be justified
  • "Max Quests"
    • Request to allow specification of how many quests to have running at a time. Default 5 (max), with option to reduce and leave slots open for manual manipulation


----------------------------
Previous Documentation. Pending clean-up or removal
----------------------------


Lua Port of the Overseer Automation macro:

Notes:
  • Configuration: As of this version, the INI file is same format as previous and shared with Overseer.mac. Both may be run alternating.
  • MQ2Rewards: Reward system updated to use MQ2Rewards. Much more robust

-----
Script has the option of running with GLOBAL or Character settings. By default it runs for all characters. Overseer_[CharName].ini

If Overseer.ini has the following flag specified as 0 (FALSE)

INI:
[General]
useCharacterConfigurations=0


Then all characters will use the configurations in the central Overseer.ini.

Sample INI
Default INI is generated if one does not exist.

INI:
[General]
claimRewards=1
agentCountForConversion=2
repeatTimeMinutes=-1
requireMercToClaimExpRewards = 0
minimumSuccessPercent=82
minimumSuccessPercent_Elite=0
minimumSuccessPercent_Rare=60
minimumSuccessPercent_Uncommon=0
minimumSuccessPercent_Common=95
useQuestPriorities=1
maxLevelForClaimingExpReward=120
maxLevelPctForClaimingExpReward=95

[QuestPriority]
Priorities=Levels|Durations|Rarities|Types
Durations=6h|12h
Rarities=Elite|Rare|Uncommon|Common
Types=Any
Levels=5|4|3|2|1

[QuestPriority_Unsubscribed]
Priorities=Levels|Durations|Rarities|Types
Durations=6h|12h
Rarities=Elite|Rare|Uncommon|Common
Types=Any
Levels=5|4|3|2|1

[Rewards]
index=3
1=Overseer Tetradrachm
2=Character Experience
3=Mercenary Experience



Details

  • General:
    • claimRewards: if 0, will leave pending Ctrl+Rewards. If 1, will try to claim per [Rewards] section below.
    • repeatTimeInMinutes: If 0, will not restart. If -1, will restart when next quest is ready. If > 0, will just repeat every specified amount of minutes
    • minimumSuccessPercent: If 0 (default), no restrictions exist. If > 0, only quests with success % greater than or equal to this value will be allowed to run.
      • Level-specific may be specified (minimumSuccessPercent_Elite) which, if exists, will override the general amount.
      • "Recruit Xxxx" quests are excluded from this minimum success check
    • agentCountForConversion: Minimum number to consider before adding an agent to conversion quests. Minimum allowed ever is 2.
    • maxLevelForClaimingExpReward: Will skip Exp rewards if character is above this level
    • maxLevelPctForClaimingExpReward: Will skip Exp rewards if character is at specified level (above) and above percent specified
  • QuestPriority: Specifies order to run quests, based on Level and Time Duration. Will attempt to run them in the order specified
  • QuestPriority_Unsubscribed: Same as QuestPriority above but used when the account is not Gold.
Quest Priorities
Using this example:

INI:
[QuestPriority]
Priorities=Levels|Durations|Rarities|Types
Durations=6h|12h
Rarities=Elite|Rare
Types=Military|Stealth
Levels=5|4|3|2|1

  1. Level 5 6h Elite Military
  2. Level 5 6h Elite Stealth
  3. Level 5 6h Rare Military
  4. Level 5 6h Rare Stealth
  5. Level 5 12h Elite Military
  6. ...
However this can be reordered by changing Priorities or other. For example

INI:
[QuestPriority]
Priorities=Types|Rarities|Durations|Levels
Durations=6h|12h
Rarities=Elite|Rare
Types=Military|Stealth
Levels=5|4

  1. 6h Elite Military Level 5
  2. 6h Elite Military Level 4
  3. 12h Elite Military Level 5
  4. 12h Elite Military Level 4
  5. ...
Indicating "Any" or "0" for Levels removes it from prioritization

The quest TYPE dictates which rewards are available:
  • Exploration - Collection Item Dispenser
  • Diplomacy - Collection Item Dispenser
  • Trade - Collection Item Dispenser
  • Plunder - Mercenary Experience
  • Military - Mercenary Experience & Ornamentation Dispenser
  • Stealth - Mercenary Experience & Ornamentation Dispenser
  • Research - Tradeskill items
  • Crafting - Tradeskill items
  • Harvesting - Tradeskill items
Experience Claiming and Skipping
New configuration keys, generated automatically on first run, with these defaults:
INI:
maxLevelForClaimingExpReward=120
maxLevelPctForClaimingExpReward=95

  • maxLevelForClaimingExpReward: Will skip Exp rewards if character is above this level
  • maxLevelPctForClaimingExpReward: Will skip Exp rewards if character is at specified level (above) and above percent specified

Examples using above defaults:

Exp rewards will be skipped if:
  • Character is level 121 (hypothetical)
  • Character is level 120 and 97% into level
Exp rewards will not be skipped if:
  • Character is level 119
  • Character is level 120 and 94% into level
Agent Conversion Counts
agentCountForConversion may be optionally extended per-priority (common, uncommon, rare). Unspecified values use that configured for next lowest priority.

[General] agentCountForConversion=Common|Uncommon|Rare

Sample Values:

  • (default) 2
    • Common: 2
    • Uncommon: 2
    • Rare: 2
  • 2|9
    • Common: 2
    • Uncommon: 9
    • Rare: 9
  • 2|9|8
    • Common: 3
    • Uncommon: 9
    • Rare: 8
Specify a large value to essentially "disable" conversions for a priority.
Specify "0" to indicate all agents for a priority should be converted.

  • 0|0|999
    • Common: 0 (ALL common will be converted)
    • Uncommon: 0 (ALL uncommon will be converted)
    • Rare: 999 (Only convert agents that have 1,000 or more)

To view details about experience and stats on each type go here : Overseer Rewards Tracker Chart

Reward types:

  • Character Experience
    • Regular exp (varies but avg around 0.5%) and Merc AA exp if a merc is active when claimed
  • Mercenary Experience
    • Average 0.25% merc AA. Merc does not need to be active when claimed. Always seems less than Character Experience gives.
  • Overseer Tetradrachm
    • Overseer currency. Buys things from 'a mysterious presence' in PoK (use Ctrl+Find to find)
  • Collection Item Dispenser
    • Gives item with 25% chance at collection item. Can combine 4 for 100% chance.
  • Ornamentation Dispenser
    • Gives item that can award ornamentations (haven't used, don't have much detail)
  • Tradeskill Items
    • Various tradeskill items claimable by expansion from Seeds of Destruction to The Burning Lands


Mercenaries
Per recent (past year) changes to EQ, mercenaries will receive experience whether suspended or not.


Parameters
Usage: /lua run overseer [param]
example: /lua run overseer countAgents

  • countAgents - determines how many of each agent type you currently have and outputs
  • runTutorial - Runs a character through the Overseer tutorial
  • generalList - Does Not Run Quests. Determines order and success% of quests that would run. Due to agent selection, can take some time (several minutes).
  • generalListFast - Does Not Run Quests. Determines order of quests that would run. No agent selection attempted, success assumed.

TODO List
  • Allow specification of different QuestOrder section to easily toggle between "Choose fast first" or "Choose long first" situations.
  • Flag to allow waiting if Quest List is rotating in near future (i.e. < 1 hour)
  • Do not initiate a cycle if actively rotating ("Rotate in: Rotating Current Quests...") or < X min (default 10?) to next rotation. Rotate during cycle can be problematic.
  • Add support for 'Easy' quests. (Will require plug-in support to access details not available to the macro)
  • 1677184396190.png
    1677184396190.png
    110.6 KB · Views: 9
  • 1677185298105.png
    1677185298105.png
    7.4 KB · Views: 7
  • 1677185595385.png
    1677185595385.png
    90.2 KB · Views: 6
  • 1677185749581.png
    1677185749581.png
    1.1 KB · Views: 19
  • 1677185784343.png
    1677185784343.png
    444 bytes · Views: 11
  • 1677185808825.png
    1677185808825.png
    565 bytes · Views: 15
  • 1678033114805.png
    1678033114805.png
    87.8 KB · Views: 10
  • 1678033157511.png
    1678033157511.png
    138 KB · Views: 11
  • 1678033173063.png
    1678033173063.png
    132.9 KB · Views: 19
  • 1678038264147.png
    1678038264147.png
    97.7 KB · Views: 5
  • 1682785729041.png
    1682785729041.png
    715 bytes · Views: 5
  • 1682785731376.png
    1682785731376.png
    715 bytes · Views: 4
  • 1682785772908.png
    1682785772908.png
    1.2 KB · Views: 3
  • 1682786134003.png
    1682786134003.png
    61.5 KB · Views: 6
Author
GoldenFrog
First release
Last update
Rating
4.88 star(s) 8 ratings

More resources from GoldenFrog

Share this resource

Latest updates

  1. 3.59: Corrected Left-Over Reward, Handle Bad Item Claiming

    Should no longer occasionally leave a reward unclaimed If item claiming (i.e. tetradrachm...
  2. 3.58 Internal Cleanup: No functional change

    This release will have no impact on your execution. Corrected a handful of stray nil values...
  3. 3.57: Correct Issue with Logging (Hopefully)

    Hopefully addresses errors being reported Hadn't seen nor was able to reproduce error directly

Latest reviews

Man this sure is GREAT!!! this frees up my time to play eq vs playing side games
Absolute S tier resource indeed, highly recommend, well done!
Really wonderful time saver!
"S" class resource, I use it on three accounts, 1 is leveling up guys, 1 is farming trade skill items, and the last is gathering collection "crystals"(?) on my gold account to finish up the collections that are nearly done; it's gotten me hundreds of AA and bags, etc. I am also leveling up 3 more accounts mainly to use Overseers.
Another excellent resource. Been using the macro without any complaints. Tried the lua in the early days and thought why change what I'm using if it isn't broken. Well with some of the lua scripts I use started interfering with the macro, I decided to give it another go. Totally surprised me with the GUI. Very nicely written and well laid out. Love being able to edit the ini files right from the gui. All of the extra options easily accessible are a huge bonus. Keep up the great work. Thank you for sharing.
GoldenFrog! Thank you so much for this! I love it and huge time saver!
GoldenFrog's Overseer scripts have saved me so much time! 5 stars!
We're almost there! Missing some functionality of the macro, but runs a lot faster. <3
Back
Top