M2TWEOP - Engine Overhaul Project

How to install and use the Medieval II - Engine Overhaul project in any mod - https://youneuoy.github.io/M2TWEOP-library/

What is M2TWEOP?

M2TW Engine Overhaul Project is designed to expand the capabilities of the game Medieval 2: Total War.

EOP uses C++ and Assembly to modify the game's code in-memory and exposes this to the end user via a Lua API and the EOP Lua Plugin[youneuoy.github.io]

As a user, you can install EOP and use it to enhance your game.
As a modder, you can add EOP to your mod and utilize it's various features to enhance your mod.

Some of the features include

• Hugely expanded Lua scripting system that integrates seamlessly with existing campaign_script scripts, hot-reload, new custom console, debugger and much more
  
• Breaks the EDU limit allowing or more than 500 units in a mod
  
• Place .fbx models anywhere on the strategy or battle map with full animation and texture support
  
• Render .cas models for characters, settlements, forts, or anywhere on the map based on any kind of condition you can imagine
  
• Play custom sounds or music with support for WAV, OGG/Vorbis and FLAC
  
• Unlocks all vanilla console commands
  
• Rome: Total War style tactical map viewer
  
• Create your own GUIs and overlays using the popular ImGUI
  
• New custom EDU system that allows the creation and modification of new and existing units without the need to restart the game
  
• Play out Hotseat battles online and transfer the results back to the campaign map
  
• Set your own limits for the number of religions, ancillaries, bodyguard units, building chains, max unit size
  
• Set the boundaries of the number of soldiers in units
  
• Fixed many engine bugs, crashes and oversights (e.g crashes when using berserkers in battle)
  
• Edit the .worldpkgdesc for any settlement on the fly without the need to restart the game
  
• Custom keybinding support
  
• DIscord Rich Presence support for a variety of mods
  
• Added ability to write your own add-ons in C++. The library exports many different functions.
  
• Utilize the packaged M2TWEOP GUI launcher with full customization support as well as the included EOP Health Checker or just allow your mod to be launched directly
  
• Many, many more!

Mods that Support EOP's Discord Rich Presence

Download/Install

Where can I download M2TWEOP?

The latest version of M2TWEOP is located on the "Releases" tab of the M2TWEOP github, here: https://github.com/youneuoy/M2TWEOP-library/releases. You need to download the archive with the word "M2TWEOP" in the title and the extension '.zip' (e.g M2TWEOP-beta-2.14.zip)

How do I install M2TWEOP?
Just unpack the downloaded archive into the folder with your modification (i.e Divide_and_Conquer, Stainless_Steel etc. (NOT THE MEDIEVAL 2 FOLDER).

How do I start a mod with M2TWEOP Enabled?
Double click M2TWEOP GUI.exe, configure your settings and hit Run mod.

Configuration

You can enable various features of the Engine Overhaul Project either via the launcher or via it's Lua scripting capability.

To edit the default Lua script, open the file youneouyData/plugins/lua/luaPluginScript.lua.

Here's an example. Here we unlock all the games previously locked console commands, set the max ancillary limit for any character to 16 and allow bodyguard units to replenish automatically back to their proper max unit size.

function onPluginLoad()
M2TWEOP.unlockGameConsoleCommands();
M2TWEOP.setAncillariesLimit(16);
-- Note that this value "100" is multiplied by the unit_size setting
-- i.e on "Huge" size, the multiplier is 2.5 so the actual bodyguard max will be 100 * 2.5 = 250
M2TWEOP.setMaxBgSize(100);
end

Community/Support

You can find us on our Discord server here: https://discord.gg/EkJNxyrBNf
You can also find us on our website: https://youneuoy.github.io/M2TWEOP-library/

[Witch ~]

holy shit this engine upgrade makes the game actually playable now. Are there addons to make the camera usable like modern TWs?

[randomschizo3699]

Can't see a good reason for installing this just yet. I'll be waiting to see mods being updated to make use of bigger unit sizes and the full functionality of the EOP.

[nygren319]

How do you remove the multiplier? So in descr_script I have giants set to "soldier number 1" for one giant but the latest version of your tool multiplies this to 3 on huge, 3 hon large, 2 on normal and only on small unit size is it 1 like it should be.

On the 2020 version it was still 1 on huge size - so something is overriding the descr_script cause it's supposed to force the unit to be 1.

[TargaryenWarCrimes]

Is it true that this can cause frequent game crashes?