Discord server: https://discord.gg/RWAqYcV
Public Scripts Library: https://easyLoU.boards.net/
Documentation: Wiki
EasyLoU is a totally free tool inspired by EasyUO, the popular premiere macroing tool for Ultima Online.
- Read the Instructions below in order to learn how to launch EasyLoU and connect it to Aria
- Take a look at the scripts provided with the Examples/ folder which is extracted from the zipped release archive
- Learn some Lua
- Use the available Commands and Variables
- Enjoy!
- From the Releases tab here on GitHub, download the archive containing the latest build and extract it
- Place the extracted file EasyLoU.exe wherever you prefer (it can be on your Desktop, in your Downloads foler, or in any other folder - doesn't really matter)
- Launch EasyLoU.exe
- Launch your Legends of Aria Client
- Wait for your Legends of Aria Client login page to show up
- On EasyLoU click on the Connect To Client Icon
; the mouse cursor should turn into a beautiful UO hand
- Click on the Legends of Aria Client you want to connect to
- When asked, click OK to inject
- Load a script
- Enjoy!
Note 1: On Windows 10, upon launcing EasyLoU.exe you might get a "Microsoft Defender SmartScreen prevented an unrecognised app from starting." error message. If you know what you're doing then open the properties menu of EasyLoU.exe, check the "Unblock" box, click apply, click OK, and relaunch EasyLoU.exe.
Note 2: EasyLoU requires Administrative Privileges in order to be able to inject into the Legends of Aria Client running process.
For two reasons:
- The name EasyLoA was already taken by https://github.com/MythikGN/EasyLoA :)
- As a tribute to the Legends of Ultima community server.
With EasyLoU you can write Lua 5.2 scripts that will make your Legends of Ultima character perform pretty much anything you want them to.
The community server Legends of Ultima is the reason why this tool exists: we enjoy this community server and have decided to write this tool and name EasyLoU after it.
As of today, EasyLoU has only been tested with the Legends of Ultima Community Server.
EasyLoU may or may not work with official Legends of Aria servers run by Citadel Studios.
Some Legends of Aria client updates may break the compatibility with EasyLoU.
When you download the latest EasyLoU release archive, double check the release notes: there is usually an indication of which version of Legends of Aria client the release is compatible with.
Upon the release of a new Legends of Aria Client, it may take some time before we update EasyLoU to be compatible with the latest Legends of Aria client.
Volunteers are always welcome :)
EasyLoU.exe injects LoU.dll into the Legends of Aria client process, using a well known technique for injecting assemblies into Mono embedded applications, commonly Unity Engine based games.
EasyLoU.exe acts as the GUI while LoU.dll acts as the commands engine, and they communicate via two shared memory maps:
- A ClientCommand memory map, where EasyLoU.exe queues all the commands that have to be processed and executed by the LoA Client
- A ClientStatus memory map, where LoU.dll updates the status of the LoA Client and the answers to various commands by populating a bunch of variables
Credits for various components and implementations can be found at the bottom of this page.
Yes, but it has not been extensively tested yet.
Yes.
You need to open one instance of EasyLoU, lunch a client, and connect EasyLoU to it.
Then you can open another instance of EasyLoU, lunch another client, and connect EasyLoU to it.
Rinse, and repeat.
EasyLoU has been compiled for x64 architevture with Visual Studio Community 2017 and .NETFramework Version v4.7.2.
In order to build it, you need to own a copy of the Legends of Aria client, and you need to copy into the LoU\libs\ folder the following libraries which you can take from the C:\Program Files\Legends of Aria Launcher\Legends of Aria\Legends of Aria_Data\Managed folder (or whatever path you have installed your client into):
Assembly-CSharp-firstpass.dll
Assembly-CSharp.dll
CoreUtil.dll
MessageCore.dll
protobuf-net.dll
UnityEngine.CoreModule.dll
UnityEngine.InputLegacyModule.dll
UnityEngine.InputModule.dll
UnityEngine.PhysicsModule.dll
UnityEngine.UI.dll
Please Star this repository, Fork it, and engage.
If you are a developer, GitHub Issues and GitHub PRs are always welcome.
If you have scripts you want to share with the community, please feel free to reach out, or just create a GitHub Issue and attach the script to it.
We are hoping to create a new community around this tool, so any form of contribution is more than welcome!
By using EasyLoU you may be breaching the Terms and Conditions of Citadel Studios, Legends of Aria, Legends of Ultima, or whatever community server you are playing on or service you are using.
USE AT YOUR OWN RISK
ONLY download EasyLoU from its official repository: NEVER accept a copy of EasyLoU from other people.
ONLY run scripts that you can understand: NEVER accept scripts from people you do not know and trust.
Keep in mind, there is always a possibility that a malicious version of EasyLoU or a malicious script will steal your LoU/LOA or Steam credentials or cause other damage. You assume the risk and full responsibility for all of your actions.
Also: don't be evil.
USE AT YOUR OWN RISK
Ultima Online is copyright of Electronic Arts Inc.
Legends of Aria is copyright of Citadel Studios.
Legends of Ultima is copyright of Legends of Ultima.
Lady Binary is a tribute to Lord Binary, who was very active in the UO hacking scene (see for example UO_RICE).
EasyLoU is of course inspired by the great EasyUO.
The LoU part of EasyLoU is a tribute to Legends Of Ultima, whose passionate staff have dedicated so much effort in putting together a wonderful product based off of Legends of Aria.
The Lua engine is based on MoonSharp, commit 4e748a7 plus minor enhancements.
The Text editor is based on ICSharpCode.TextEditorEx, commit 1934da7 plus minor enhancements.
The Mono Injection code is based on SharpMonoInjector, commit 73566c1.
You can contact me at [email protected], or you can also find me on the EasyLoU discord server https://discord.gg/RWAqYcV
This project is licensed under a 3-clause BSD license, which can be found in the LICENSE file.