Bugfixes/Improvements

• [Scripting] Fixed a problem with nuget packages in scripts - they were stripped by rewriters under some circumstances

Bugfixes/Improvements

• [Scripting] Console.WriteLine now prints output to EventLog. Done this to improve usability of ChatGPT-generated scripts.
• [UI] Changed how internal app channels are handled - should prevent one rare type of crashes

Major changes in authentication - preps for offline usage

Almost fully reworked part of the program which is responsible for pulling authentication data from the server. The intent is to eventually allow users to use the program without connection to the server. This is a multi-phase effort with internals rework being the first phase.

Window Selector improvements - added filter-properties

Window Selector is that control which allows you to pick/specify Target Window. For many years, it has been filtering-out all windows, which were under EA control. This is now an optional feature, which could be disabled by adding [ownedBy=any] to the expression, e.g. My Window [ownedBy=any] will filter out and scan through ALL windows, which are present in the system, even if they were created by EyeAuras.

Another filter of a similar type which was added allows to capture so-called Tool windows, e.g. Overlays usually have this type. By default, such windows are ignored and can add them as potential candidates by appending [type=any] at the end of match expression, e.g. My Overlay [ownedBy=any][type=any] would capture any window/overlay which has title My Overlay.

Bugfixes/Improvements

• [Capture] Fixed a problem where WGCS tried to capture the image before window is visible (Argument out of range)
• [Scripting] CodeEditor improvements - changed how errors are highlighter plus added single-file Razor template + updated the template itself
• [UI] Fixed effects counter #EA-753 Effects counter v7668 by Headway9016
• [UI] Fixed a problem with Export/Activation on the server-side

Behavior Tree Editor internals rework - ALPHA!

Pretty please - do not use this version for packs until proven stable

In this version I've reworked internals of BehaviorTree editor. Long-term, this will allow to do many optimizations in how quickly BTs are loaded/rendered/etc. Short-term it may lead to a whole bunch of different bugs and problems which I will be closely monitoring and working on asap. In that regard, please, do not use this version to publish packs of auras, use it by yourself - that way in case something will explode - like some random BT will vanish - this won't have avalanche effect and will affect only few users. Alphas are intended to be used for testing-purposes only.

Things that should be noticeable - larger (50+ nodes) trees should load a bit quicker (10-20%) and, most importantly, the bug, which made nodes dissapear when quickly switched between multiple large BTs, should be fixed. This was the driver behind this rework and the new approach should protect from similar problems in the future.

Bugfixes/Improvements

• [Capture] Fixed crash which occurred if FramesPerSecond value was set to something very small like 1e-10
• [UI] Fixed crash which happened when Offset Width + Position/ContentAnchor were set in Overlays
• [Scripting] Fixed a problem in error highlighting in the text editor - now it should properly underline erroneous lines as it was pre-Razor changes
• [Web] Changed "Download pack" to "Download portable pack" - hopefully this will make more users click on that button rather than downloading the program + importing manually

New feature - Version History

Added a Version History feature, allowing users to view and manage configuration snapshots saved over time. Users can now perform a Soft Reset to restore file states without altering history or a Hard Reset to fully revert to a specific commit, removing all changes made afterward.

p.s. RU version of the doc is availabel here

Bugfixes/Improvements

• [Sync] Fixed error in auras merge mechanism v7612 #EA-735 by Steamy Index is equal to or greater than Count
• [Scripting] Fixed crash which happened due to BehaviorSubject disposal
• [Scripting] Fixed problem in Loop rewriter - nested classes were not properly handled
• [Bindings] Fixed problem in Bindings Editor - in some cases bindings were created to previously selected item rather than current one

C# Scripting Engine V3 - added Blazor/Razor support

Major upgrade in the scripting engine - it can now compile Razor components. Blazor (Razor components are part of Blazor infrastructure) is one of the best (my opinion - for desktop apps just the best) UI technology which allows to have full power of C# and at the same time great performance/convenience of Web (HTML/CSS/JS) world.

EyeAuras is also using it under the hood since 2023 and is gradually being rewritten from WPF to Blazor. At some point in the future is expected to become full Blazor-driven app. Parts which are using it - BT editor, Macro editor, EventLog, Bindings, AuraTree. If some part of the program feels snappy you can bet it is using Blazor.

Previously, if you wanted to develop your own user interface for your bot, the only viable option was to use WebUI Overlay which at this point is using very dated text editor and, more importantly, uses older version of the scripting engine (V2) back from April 2023(!). Of course, you could load up the project in your IDE of choice (like Visual Studio or Rider), but that was definitely not very convenient and took some extra steps.

At the same time, BTs, Macros and C# Action/Trigger have been using the newer iteration of scripting engine since Jan 2024, but they newer really had Razor support as it was technically challenging task to add it there without preparing some other systems first. And, finally, today we're getting the first prototype. This is not just new feature - allowing users to create windows straight from the code makes it possible to develop full-blown standalone bots.

What it already can do:

• you can create custom UI components right there in that same text editor
• full auto-completion for C# part of Razor component and partial - for Razor part
• API which allows to create windows and manage with your components right from your code
• thread-safety - in contrast with WPF/WinForms and even official MS Blazor integration, EA API is thread-safe, meaning you can update properties of the window from any thread and it is expected to be able to properly process those. No longer you have to worry about deadlocks and UI marshalling using Invoke/BeginInvoke.
• API mimics native WPF API to make it easier to code something using ChatGPT

What it cannot do (yet):

• custom CSS/JS - in November
• No integration with IDE like in V2 - in December
• no hot-reload like in WebUI - there will be a next iteration of WebUI which will be using this new script engine somewhere in Dec/Jan or maybe even earlier

Bugfixes/Improvements

• [SendInput] Improved performance of Windows Message API in multi-window scenarios
• [UI] Fixed crash which happened when Offset+Anchor were used at the same time
• [UI] Added SendText node, available in both BTs and Macros
• [Scripting] Improved Log.Info/Debug/Warn formatting - now UI properly renders line breakes
• [SendInput] Improved how keypresses/mousemove logs look like

Some UI examples which are created in EA

New Alternative to Auras / Behavior Trees - Macros

Welcome a new tool, which you can use to create automation - Macros. Before jumping into the details of macros, let’s do a brief overview of the existing tools.

1) Auras

Initially, there were only auras, which consist of Triggers and Actions. The idea is simple: when a trigger activates, your actions are executed.

This is still a good solution for simple event-action situations like sending notifications to Telegram or automating HP/MP potions. However, for anything more complex, this approach quickly becomes difficult to maintain, as you have to think about all possible events and reactions that may happen simultaneously.

2) C# scripts

To solve that problem, I’ve added scripts, which give you 100% control over your bot and its actions. The only real drawback is that it requires users to know C# and be able to code. Also, for some cases, writing the code may not be the best solution. For example, developing a bot that performs rotations in plain C# can be quite complex, as you have to track cooldowns, assess priorities, etc. We needed better tools for such cases.

3) Behavior Trees

BTs offer another approach to modeling logic and have proven themselves in game engines, where they are used to model NPC logic. BTs also solve the problem of handling multiple events simultaneously by running every action sequentially, allowing users to prioritize actions based on a set of conditions. In some cases, like building rotation logic, BTs offer the best experience. The main issue with BTs, however, is their steep learning curve, which, when combined with the learning curve of EyeAuras, made them inaccessible to many users, especially non-programmers. These users were left with the option of using auras, despite their limitations.

Solution - Macros

Introducing a new fourth option, which aims to become the default starting point for automation. The concept is simple: you have a series of commands that run sequentially. These commands can check the state of other auras, press buttons, run scripts, etc. They also allow you to have loops, conditions, and everything you would expect.

Macros are not reactive by default, meaning they won’t run on their own, unlike Auras, which always do something. To run a macro, you need to either bind it to a hotkey or configure another Enabling Condition. When the condition is met, the macro will either run once or periodically.

The real power of this approach lies in the ability to combine all three logic-building methods. For example, you can have auras tracking images/colors or performing neural network inference, check the state of those auras using IfThenElse, and if the conditions are met, pass control to a Behavior Tree or run a script.

For example, suppose you want your character to farm mobs in a specific spot. If it dies, you resurrect, restock resources in a town, and return to the farming spot. If you attempt to build that entire logic using BTs, you’ll encounter some complexities, such as constantly tracking whether you’re in town or at the farming spot. However, with macros, you can have one large cycle that runs while the bot is activated. Within that cycle, you can easily check if you’re in a town to handle restocking or, if you’re at the farming spot, start running a farming behavior tree. This allows you to break the bot’s logic into smaller, manageable parts without always needing to account for all possible conditions.

Learn more...

All kinds of macros are supported, from building simple sequences of keypresses (like Send Sequence action, but much more flexible)

to building complex sequences of actions combinging scripts, behavior trees and auras together

Portable version

A new button has been added to the main webpage, allowing users to download an archive with the most recent version. It is fully portable, with configuration separate from the main app. This mechanism has been tested for a few months in Packs and should work without major issues.

Yolo 10 support

Test support for machine-learning models based on Yolo 10 has been implemented. Yolo 10 is cutting-edge technology for real-time object detection.

SubTree-as-a-node

New functionality in Behavior Trees allows you to mark sub-trees as shared. This enables you to create nodes pointing to a specific sub-tree directly from the toolbar.

New node - Mouse Move

This node is now available in Macros and BTs. There are two variants of the node: one for absolute mouse movement and one for relative movement (which takes the current cursor position into consideration).

As in Send Sequence, you can now bind X and Y, link auras, and control where exactly to click on the found image or object. There are two editing modes: simple and advanced.

Advanced mode looks like this (yes, it's a bit overloaded with controls):

KeyPress node now supports mouse clicks/wheel scrolling

The KeyPress node now also supports sending mouse-related inputs. At this point, I’m not 100% sure that having multiple input nodes will improve the UX, but we’ll see how it goes.

C# scripting - implemented automatic code improvements

One of the major features of EyeAuras is its C# script engine, which allows you to compile, load, and execute your code in real-time. It is used in actions, triggers, and behavior trees. Since there are virtually no restrictions on the code you can write, it’s not uncommon to make mistakes that lead to crashes, deadlocks, and other common programming issues. I’ve already discussed this in the 7060 changelog.

In this version, I’ve introduced a mechanism that extends your code to mitigate some common mistakes, such as not catching Task exceptions, using Thread.Sleep instead of EyeAuras’ Sleep method (which offers much greater accuracy and is cancellable), or using infinite loops like while(true){} instead of while(!cancellationToken.IsCancellationRequested){}.

Although this mechanism will only catch some errors, the primary responsibility is still on the script developer to write functional code. Nonetheless, this system should help make life a bit easier.

Please report anything unusual you encounter!

You can use macros to simply send sequences of keypresses:

Or build full-blown rebuff/target/farm logic using conditions, loops, and scripts:

In contrast to BTs, this tool is much simpler and easier to understand. Essentially, you are building a program using small blocks, making it more accessible to new users looking to create their own automations.

Folder Defaults - added Input Smoother selection

The input smoother selection has been added to folder properties. The Input Smoother controls how the mouse moves from point A to point B and in how many steps.

As with other settings, this one is propagated to all items in that folder – nodes, actions, triggers, etc.

New links editor

A new version of the links editor is being released. It appears whenever you link something (e.g., AuraIsActive or Enabling Conditions).

The new editor is much more flexible, making changes easier. Once this version stabilizes, I’ll add “Recent,” “Favourites,” and other improvements I have in mind. Please report any issues or suggested improvements – the initial implementation might have bugs, but hopefully, it will quickly surpass the old variant.

Sleep() rework

Waiting for something is a critical part of automation. EyeAuras constantly does this – timeouts between keypresses, ensuring that capture FPS is consistent, user-driven timeouts in scripts. The default methods provided by the operating system (e.g., Thread.Sleep, Task.Delay) aren’t accurate enough, so I implemented a combination of methods that ensured better accuracy.

This mechanism allowed sub-millisecond waits and worked well for 5-6 months. However, accuracy comes with a cost, and for most operations, it wasn’t needed.

That’s why, for the next few months, we’ll be trying a third version of Sleep(), which is expected to find a middle ground between accuracy and performance. On average, it should reach accuracy between 0.5 - 5ms.

This means that if you set EA to wait for 1ms, the effective wait time will range from 1 - 1.5ms, which is more than enough for most use cases. For larger timeouts, such as 100ms, the range will be 100 - 105ms.

To balance the loss of accuracy, you’ll gain better performance. We’ll see how it performs in real-world scenarios.

Variables editor rework

• The editor is now the same for Blackboard and Variables.
• It’s now possible to edit values directly (though only primitive types for now).
• You can now add new variables, making setup easier.
• I’ve prepared a mechanism that will generate boilerplate code for C# scripts and automatically generate Properties to get/set values. This will be published later.

Two new image effects

Binary Threshold

This effect is very useful for analysis, as it splits an image into black and white, making further checks much simpler. For example, instead of dealing with a red HP bar with various shades, you can convert it to black and white, where white represents the filled part of the bar.

Color Quantization

Another image simplification technique, Color Quantization reduces the total number of colors in an image. While not very useful by itself, it can help when combined with other effects.

C# scripting - TextSearch improvements - added segmentation

The TextSearch trigger now exposes text segments and their locations. This feature is currently usable only via C# scripts and allows you to click on specific words.

You can find an example here: https://wiki.eyeauras.net/scripting/examples/basic/click-on-text

In the future, similar functionality will be available through the UI as well.

ImageSearch improvement - added "Include All Matches"

A new option, "Include All Matches," has been added for some corner-case scripting purposes. By default, image search finds the best possible match and tracks its movement, avoiding scanning the whole image every frame. This new option disables these optimizations, so the image is fully scanned on every tick. On the positive side, this gives you access to multiple candidates and their similarities. On the negative side, it significantly affects performance.

To access all found objects, use TemplateMatches, which is returned as part of the ImageSearchTrigger.Refresh result:

public interface IImageSearchDetectionResult : ICaptureTriggerDetectionResult
{
    ...

    /// <summary>
    /// Contains an array of all successful template matches and their bounds/similarity.
    /// Will contain more than one element only if Include All Matches is enabled in ImageSearchTrigger.
    /// </summary>
    public ImmutableArray<TemplateMatchResult> TemplateMatches { get; init; }

    ...
}

This is extremely CPU-heavy task. On 1920x1080 you'll probably have at most 2-3 FPS to do a full scan. This is a huge contrast to ML search, which on the same resolution for the same task can give you up to 60 FPS, so if you really need to detect multiple instances of some object, I would highly recommend to look into training Yolo model and using it instead.

Bugfixes/Improvements

• [AuraTree] Items are no longer being selected automatically when you click on load/unload/remove
• [MLSearch] If model has invalid format - meaningful error will be shown
• [ImageSearch] Made it so Load from preview pane avoids copying debug data
• [EventLog] Made it so event log scrollbar will stick to the bottom even after you clear the log
• [Capture] Fixed a problem with FPS showing incorrect values sometimes
• [TetherScript] Added support for true relative mouse movement. Previous version of the driver was not supporting real mouse movement and quieried cursor position, which did not work at all for some cases, e.g. when a game "snaps" cursor positions at the center of the screen.
• [UI] Sublicenses are now displayed in UI. For now, instead of pack name only Id is shown
• [UI] Fixed crash which occurred when EA could not parse hotkey modifier (happened in non-latin cultures)
• [UI] Fixed crash which happened when the program is started without unpacking via WinRAR #EA-585 CreateFile WinRAR v7406
• [UI] Fixed crash that occurred on Windows 10 Home(and N) due to missing OpenCL libraries
• [UI] Fixed bug which could sometimes crashed webview during load (split-container related)
• [UI] Fixed crash System.InvalidCastException: Unable to cast object of type 'MS.Internal.NamedObject' to type 'System.Windows.FrameworkTemplate' by Mintrok #EA-655
• [UI] Improved Import/Export dialogs error handling - errors should be more meaningful now and shown in a more presentable way
• [UI] Added badge which shows how many auras are there in Archived state. This is god-forbidden functionality which allows to Archive(aka unload and hide) auras which you currently do not use - this speeds up app load process quite a lot.
• [UI] Improvements in Bindings - added support for conversions from T to Nullable of T (e.g. int to int?) #EA-660 v7569 by Gwyn
• [UI] Fixed bug with cloning and links not being cloned properly
• [UI] Fixed bug with new folders not always being shown in Links editor
• [UI] Minor performance improvements - removed some old garbage which increased load time
• [UI] Implemented Install service which allows to instruct EA to install multiple packs on first launch - will provide more details later on this
• [UI] Improved security measures a bit - last activities cleanup should be more reliable now plus it will also cleanup anything related to parent folder from which EyeAuras is started
• [UI] If Check for Updates is disabled, app will not do it during startup anymore
• [UI] Few minor bugfixes which were in the new aura selector
• [UI] Fixed a problem with copy-paste not working in root folder #EA-591 v7458 by oddessax
• [UI] Fixed problem with UI not loading if the program is not able to retrieve list of logical drives #EA-588 WMI Logical drives v7349
• [UI] Fixed problem with login - username was case-sensitive
• [UI] A lot of changes in Import/Export code - may break something, but now EA can have as many different item types (behavior trees, auras, macroses, folders, etc) as needed
• [UI] EyeAuras license agreemenet popup window will now be automatically activated upon startup. This won't affect those who already accepted it at some point
• [UI] Reworked import/export mechanism - should fix problems with behavior trees replacement and few other things
• [Packs] Improved packing - packs are now include resources such as images/models/etc as a part of zip-archive
• [Packs] By default, compatibility will be set to Current version rather than Latest
• [Scripting] Added Listen() to ScriptVariable - you can now use it instead of WatchCurrentValue
• [Scripting] Fixed a problem with folders not being found via relative path in some cases
• [Scripting] Fixed a problem with code rewriter in some cases generating uncompilable code
• [Scripting] Added TargetWindow to ISendInputUnstableScriptingApi - this allows to use Windows Message API and send inputs to background windows.
• [Scripting] Fixed a bug in CancellableMethodStatementRewriter which made it so some scripts would not compile
• [Scripting] Fixed a problem with code rewriters not handling some combinations of method calls.
• [BehaviorTrees] ExecuteScript node now remembers whether it was Maximized or not
• [BehaviorTrees] Fixed a problem with selection not being reset correctly in some cases #EA-589 v7464 by dutiful6005
• [BehaviorTrees] Fixed a problem with node editor content not being updated properly in some cases
• [BehaviorTrees] When you're manually running node (from editor) execution will be automatically cancelled when main window is brough to foreground - just like with auras
• [BehaviorTrees] Fixed a problem with focus being lost when switching between BTs - this prevented Paste operation from working properly #EA-592 v7458 by oddessax
• [BehaviorTrees] Optimized how BTs work with deep nested structures a bit, increased max depth size from 64 to 1024 #EA-578 Nested tree v7444 by oddessax
• [BehaviorTrees] Fixed a problem with C# scripts not being editable
• [BehaviorTrees] Fixed a problem with extra link being added in some cases
• [BehaviorTrees] Fixed a problem with BTs ticking once when enabling conditions are met even if program window is active
• [BehaviorTrees] Fixed a problem with BTs - they were not respecting Enabling Conditions of a folder in which they reside
• [BehaviorTrees] UI changes - reshuffled controls a bit, changed styles, etc. Let's see how the updated version will feel
• [BehaviorTrees] Added errors visualization - if some node encounters an error it will now be shown in UI just like errors in auras
• [BehaviorTrees] Fixed problem with BTs renaming

Yolo 11 support

YOLO11 is the latest iteration in the Ultralytics YOLO series of real-time object detectors.

Bugfixes/Improvements

• [UI] Fixed crash "Cannot access a disposed object." #EA-687 v7598 by ganya
• [UI] Fixed crash in Replay functinality #EA-679 v7527 by linqse

Server-side improvements

Worked on stability - should solve those problems which crashed server under peak load. Now it should just slow down :D Thanks everyone who became part of that pleasant problem, welcome aboard :)

Portable version

Added new button to main web page which allow to download archive with the most recent version. It will be fully portable with a config that is separate from the main app. This mechanism has already been tested for a few months in Packs, so should work without major issues.

p.s. Please note that portable version is not available for Stable yet, it will be available right after I will push alpha to stable in the next few days.

Bugfixes/Improvements

• [Scripting] Added TargetWindow to ISendInputUnstableScriptingApi - this allows to use Windows Message API and send inputs to background windows.
• [UI] Improved Import/Export dialogs error handling - errors should be more meaningful now and shown in a more presentable way
• [UI] Added badge which shows how many auras are there in Archived state. This is god-forbidden functionality which allows to Archive(aka unload and hide) auras which you currently do not use - this speeds up app load process quite a lot.