Modules - aa2g/AA2Unlimited GitHub Wiki

Modules are bundles of triggers that work as custom character traits. They don't merely modify the game's Ai, they add to it things that were previously not possible.

Download & Modules list

Get the latest modules from here. That link has both a download to all modules, and descriptions of all existing modules.

Modules FAQ

What are the requirements I have to meet to be able to use modules?

  • Ensure your game is up to date and that the game works well without the modules.
  • You need AAUnlimited to use modules. Read the installation guide https://github.com/aa2g/AA2Unlimited/wiki/Installation.
  • A lot of modules require you to have homosex enabled. Your game will crash if you don't. In AAU launcher, go to scripts tab and open up the settings of "unlocks". There, tick "Enable homosex" and press okay to save your settings. Like this:

How do I install modules?

  • Download the zip from this link, and then unzip it in your 'data/override/module' folder. Create the folder if you don't have it. After this, you can add them to cards in AA2Edit in the AAU modules tab.

How do I apply modules to cards?

  • Open the card you want to apply the modules to in AA2Edit. Select the modules tab. In the left column is the list of available modules. Select the one you want and click on the arrow button "-->" and it will move to the right column, labeled "In Use". Save the card and that's it. To remove modules, select one in the right column and click on the arrow button "<--".

How do I update modules?

  • The modules zip has date in its name, so you'll know when modules were last updated. Just download the zip again and override the previous ones. Modules load automatically from disk so you don't have to resave your card for it to be using the latest modules. Just extract the latest modules into your module folder and you're ready to go, your card will be using the modules that you have there. Always ensure that you have the latest modules downloaded.

AA2Edit is crashing as soon as I try to save a card with some modules applied to it.

  • Always ensure that you have the latest version of AAUnimited downloaded. To update your AAU, just extract it in your existing AAU folder and override everything (don't run the install.bat multiple times).

What do the tags in the brackets mean after the module description?

  • In brackets after the module description is specified which characters the module will work on: PC only, NPC only, or both. So if you, for example, play as a card that has NPC Only modules applied to it the modules will do nothing, unless you switch PC or turn on AutoPC. You can still apply modules to any card, it's just that they won't be active unless that card satisfies the conditions in the brackets.

The module descriptions are too vague, what does some module do?

  • Some modules were intentionally given obscure descriptions when the creator thought that knowing exactly what they do would take away from the magic. Usually descriptions are concise, but sometimes they go into great detail if using the module requires some form of in-game user input.

My game is crashing and I suspect it might be due to some module.

  • In AAU launcher options disable triggers and modules and see if your crashes persist. If so, follow this guide on how to report a crash and get it resolved: https://github.com/aa2g/AA2Unlimited/wiki/How-To-Report-a-Crash. Upload the files and post them in the AAU tech support discord, or in /aa2g/.
  • Make sure to update your modules and AAUnlimited to latest versions and see if the problem persists.

My game crashes randomly as soon as some conversations end. What is causing this?

  • A lot of modules require you to have homosex enabled. Your game will crash if you don't. In AAU launcher, go to scripts tab and open up the settings of "unlocks". There, tick "Enable homosex" and press okay to save your settings.

Will there be a button to randomly assign modules to cards?

  • No. It is a very bad idea to not think about the combination of modules that you are assigning. Some modules specifically do opposite things, and while assigning them together most likely wouldn't cause a crash, it would make it so that both of them malfunction and create weird behavior. Read module descriptions and think about what would make a good combination of traits.

Can I use other AI changing mods if I am using modules?

  • You can.

Can I apply a module "globally", so everyone in my class has it?

  • No, you can't. You have to apply it to each card you want to have it.

Where can I find cards that use modules?

How many modules should I be putting on a card?

  • As many as you want, really, just think about what you want to achieve by that combination of traits. But if you've added like 20 modules to your card, wtf are you doing?

What happens if I put two of the same module on one card?

  • Both of the modules would try to work separately. Don't do this.

The module is telling me to create a style. What is that?

  • By making a style you give your card alternate appearance. Your card can switch between these two appearances in-game. For example, Pregnancy module asks you to assign pregnancy clothes with bulged belly on the pregnancy style which the girl would change to when she becomes pregnant. As to how to add/remove/edit styles, follow this guide.

How do I know which modules combine well and which don't?

  • You should be reading the module descriptions to figure out which modules DON'T combine well. For example, you shouldn't make your girl both Loyal and Cheating. Or give her Breast Envy but make her a Cowtits Lover. Try to think about what a module does and whether it would conflict with what other modules do. H-Style changes style during sex, and Fashionable changes style into one defined within a range every day. No conflict. But if you apply Fashionable and say Sunday Fashion, come Sunday both modules will try to change style at the same time.
  • Use the same principle to figure out which modules make for great combinations. A Christian girl will not allow vaginal sex before marriage, so it combines well with the Marriage module. Forceful combines well with Brute because Forceful will attempt to rape characters if they refuse to have sex, and Brute makes it so that if rape attempts are denied the Brute will fight them to force success. Kidnapper can trick exploitable characters into "lending" them their lovers, while Blackmailer can make characters exploitable only for the Blackmailer if he is in possession of their personal sex item. Meanwhile a Thief can steal items, so these three modules make a great combination. Run your imagination.

I have an idea for a module. Can you make it for me?

  • Maybe. Post it in the AAU tech support discord or in /aa2g/.

I want to make modules. Where do I start?

  • Start by reading this guide. Then read code of easier modules to understand them, and try to make a variation of that module. A great example of this is the module "Cupid" which makes people fall in love by spreading good rumors. An anon edited it into a great module "Eris", which spreads hate through bad rumors. Making these kinds of edits is encouraged and it can result in an even greater variety of modules.

Do you take commissions?

  • You can commission modules. The price will depend on the complexity. Ask about it in the AAU discord.