mod ANALYTICALENGINE | Custom UIs, Mapmodes, Event Scripting, Modded Multiplayer, and Tooltips

[11:59 Development Team 233]

AOC3, Open Sourced.

Take a sledgehammer to those modding restrictions.

---

AnalyticalEngine (Project Orion) is a game engine that opens up the core binary code of AOC3 and removes hardcoded features and mechanics by allowing for full NashornJS scripting in mods, as well as providing an API for Event Conditions, Effects, Game Scopes, modded Multiplayer (MP) support, and custom mapmodes and UIs. This allows for full hybrid Java and JavaScript modding support.

To get started with modding in AnalyticalEngine, simply add .ds/.js files in your mod folder. These will be automatically detected by the game engine and executed in-game. Consider also reading the attached Documentation or asking for support from our Discord server.

Installation: GitHub | Steam

1. Install Java SDK 23.
2. Download the current src/AOC3-Source.jar, and drop it into any basegame AOC3 directory.
3. You may now either run it normally as a Java binary or via the command line in the extracted folder if you wish to access AnalyticalEngine's console: java -jar src/AOC3-Source.jar

-

Documentation:

Note: Documentation is currently a work-in-progress and may not necessarily be complete.

• Custom Mapmodes
• Deepscript (Event Conditions, Effects, Loops, Scopes, Variables)
• Map Data Scripting Information
• Nashorn Scripting

Features:

Current Feature List.

• Added Singleplayer support for the Multiplayer build of the game.
• Custom Event support.
• Custom Mapmode support.
• Custom UI support.
• Fixed various localisation glitches.
• Fixed various map glitches.
• Full NashornJS compatibility and scripting.
• Modded Multiplayer support.
• Overhauled Editor UIs:
  • Civilisations can now be directly edited by right clicking on a Civilisation in the Scenario Editor.
  • Province Names can be edited directly from in-game editors.
  • Resource Editor overhaul.
  • Scenario Editor overhaul.
  • Terrain Editor overhaul.
• Overhauled tooltips now allow for inline coloured text changes and images in Events.
• Reworked Conditions (Triggers) and Scopes.

-

Edited Tuesday at 03:33 AM by 11:59 Development Team
Fixed previous alignment issues.

[bun_dha4 394]

holy moly aoh3 is playable ffs

holy moly modders are going to have a field day with this. literally the coolest thing in the modding scene so far.

[RostislavMerte 99]

This better not be abandoned, This is peak.

[11:59 Development Team 233]

 

DEV UPDATE #1 - Regions And Hours.

Since the last update, AnalyticalEngine has added in several new changes, including a revamped in-game Regions Editor, better Event limit optimisation, as well as adding back hours to the MP version of the game. Alongside other Map editors, the Regions Editor allows you to edit Regions from the game without messing with .json files, and allows for adding new regions more easily. It can be seen below:

The new Regions Editor in action.

There are several missing features between the Singleplayer (SP) and Multiplayer (MP) versions of the game, and we're working currently to bridge the gap. We still haven't really been able to properly confirm MP compatibility with these new changes, so they may be breaking in that regard. Additionally, we plan to wait until Lukasz settles down and much of the MP/SP gap is addressed before updating to newer versions.

In this regard, we have also readded vanilla event parsing to Multiplayer games. Normally, MP Events are completely disabled - we have re-enabled them.

We have also been working on further Deepscript Effects and laying the groundwork for Deepscript Variables. Once done, Variables will allow you to bind JS variables to specific scopes (i.e. Provinces/Civilisations), where they can be kept track of and displayed in-game. To this end, current Scope OnActions allow you to track players' in-game interactions and hook them to an Event, Custom UI, or even Mapmode. Various event handlers are also available to detect in-game page changes, for instance. Full Deepscript compatibility as outlinedd in documentation should be complete by March.

Steam Installation.

There has also been some confusion as to how you can download this from Steam. Simply put, you open your game's file folder, go to mods/AnalyticalEngine/, and drag out AOC3-Source.jar into your game folder before running it. Make sure JDK 23 is installed before you do. This is similar to how the Map Editor is installed.

 

Anyway, that'll be it. Hopefully these changes are of use. We do not plan to immediately revamp the Continents editor in the same way since there are less Continents fpr this system to be useful, but we will also be considering it at a later date.

[TheAngryProgressive 26]

10 hours ago, 11:59 Development Team said:

 

DEV UPDATE #1 - Regions And Hours.

Since the last update, AnalyticalEngine has added in several new changes, including a revamped in-game Regions Editor, better Event limit optimisation, as well as adding back hours to the MP version of the game. Alongside other Map editors, the Regions Editor allows you to edit Regions from the game without messing with .json files, and allows for adding new regions more easily. It can be seen below:

The new Regions Editor in action.

There are several missing features between the Singleplayer (SP) and Multiplayer (MP) versions of the game, and we're working currently to bridge the gap. We still haven't really been able to properly confirm MP compatibility with these new changes, so they may be breaking in that regard. Additionally, we plan to wait until Lukasz settles down and much of the MP/SP gap is addressed before updating to newer versions.

In this regard, we have also readded vanilla event parsing to Multiplayer games. Normally, MP Events are completely disabled - we have re-enabled them.

We have also been working on further Deepscript Effects and laying the groundwork for Deepscript Variables. Once done, Variables will allow you to bind JS variables to specific scopes (i.e. Provinces/Civilisations), where they can be kept track of and displayed in-game. To this end, current Scope OnActions allow you to track players' in-game interactions and hook them to an Event, Custom UI, or even Mapmode. Various event handlers are also available to detect in-game page changes, for instance. Full Deepscript compatibility as outlinedd in documentation should be complete by March.

Steam Installation.

There has also been some confusion as to how you can download this from Steam. Simply put, you open your game's file folder, go to mods/AnalyticalEngine/, and drag out AOC3-Source.jar into your game folder before running it. Make sure JDK 23 is installed before you do. This is similar to how the Map Editor is installed.

 

Anyway, that'll be it. Hopefully these changes are of use. We do not plan to immediately revamp the Continents editor in the same way since there are less Continents fpr this system to be useful, but we will also be considering it at a later date.

Yes