Utility Overseer 3.77

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

• 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
    • 
  • Also indicates if no quests are current pending
    • 
• 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
• 
  [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
• 
  [Open/Close Overseer Window]
  • Short-cut to opening or closing the EQ Overseer window
• 
  [Hide This Window]
  • Hides the MQ Overseer UI above.
  • To re-display, execute the command "/mqoverseer [show]"
• 
  [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

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

• 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
    • 
  • Active rewards may be added to by selecting an reward from the top box and selecting the [Add]
    
    button
  • Available rewards may be removed by selecting a reward from the top box and selecting the [Remove]
    
    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

"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

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

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]
    • 

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)



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

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




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:

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

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:

• 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)