Path of Exile modding tool and mods

[manutdrule]

nvm

/10chars

[Nagax9]

Manage to find the name of the spark skill : electrical_surge, but i didn't succeed in having the FULL microtransaction effect , it looks like a little spider without the spark and the leg doesn't move.
can someone help me pls .

[koyasha]

Does anyone know how to replace Ancestral Warchief totem? I've been trying to do something like this:

title "Void Ancestral Warchief DOES NOT WORK"
# search pattern /Metadata/Monsters/Totems/ancestor_totem/.*ao[c]?$
restriction "/Metadata/Monsters/Totems/ancestor_totem/Ancestor\.ao$"
replacewith "/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/VoidAncestorTotem\.ao$"
restriction "/Metadata/Monsters/Totems/ancestor_totem/Ancestor\.aoc$"
replacewith "/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/VoidAncestorTotem\.aoc$"

restriction "/Metadata/Monsters/Totems/ancestor_totem/AncestorTotem\.ao$"
replacewith "/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/VoidAncestorTotem\.ao$"
restriction "/Metadata/Monsters/Totems/ancestor_totem/AncestorTotem\.aoc$"
replacewith "/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/VoidAncestorTotem\.aoc$"

But the game crashes on loading screen. I also tried replacing below ones, but no luck

/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/KaomAncestorTotem.ao
/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/KaomAncestorTotem.aoc

/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/KaomAncestor.ao
/Metadata/Monsters/Totems/ancestor_totem/KaomAncestor/KaomAncestor.aoc

[Huaojozu]

For anyone wondering, the Tabula file doesn't work due to the Tabula model. I tried replacing a Carcass Jack model and that worked perfectly.

Now I'm wondering. Is there a way to replace let's say all boots with a single boot mtx model, to ensure I always have them equipped?

[koyasha]

Step by step for those who are not familiar with Python and/or those who opened the modding tool and thought 'what the actual F'.

PREPARATIONS
1. Download and install Python 3.6+. Latest version available here: Download Python | Python.org
2. Let's say you installed Python to D:\Apps\Python37. Navigate to that folder, shift+r-click on empty space inside it and choose the 'Open command window here' option.
3. In the cmd window, type the following to get the pip package updated to the latest version (kind of optional, but wouldn't hurt): python -m pip install --upgrade pip
4. In the same cmd window, install brotli library with this command: pip install brotli
5. Download the modding tool from Github (green 'Clone or Download' button > Download ZIP): GitHub - poemods/Path-of-Exile-modding-tool: Path of Exile mods
6. Extract the archive contents to any folder of your preference. Let's say it's D:\Apps\PoEmodding. Make a mental note about these guys inside:

a. The __init__.py file. It's the main executable file of the program and it has a simple yet functional GUI on top of it, so you can just double-click to launch it as a usual Win program.

b. The '/extracted' folder. The assets you are going to change will be saved to this folder for the program to work on them (insert/restore).

c. The 'automods' folder. This is where you are going to store your scripts that will automatically change stuff. Script options can be viewed and enabled/disabled in GUI. Some sample scripts should already be in the folder.

GUI OVERVIEW
- Upon first launch you need to specify the path to your PoE client Content.ggpk file in the topmost textbox. Normally the file resides in the game folder root. E.g. D:\GAMES\Grinding Gear Games\Path of Exile\Content.ggpk. Just copy-&-paste the full path and the program will start scanning the file. It can take up to several minutes, so be patient.
- Green area to the left determines what words/expressions to include into search. Red area to the right is a 'what to exclude from search' filter.
- Central frame displays search results: game files with various extensions that can be edited to our benefit.
- Lowermost area returns the contents of a chosen file.
- 'Automods' button on the right pane lets you choose your script files and apply/remove different parts of their code on the fly. 'Modify' and 'Restore' buttons serve to that purpose.

FILE EXTENSIONS OVERVIEW
.sm - skinned mesh data. Basically a static item model/appearance.
.ao - attached animated object. Basically a dynamic visual effect. Can be added to the .epk file to stack effects.
.pet - particle effect. Can be added to the .epk file.
.epk - effect package. A stack of different effects.
.dds - textures
.mat - materials

---

REPLACING ITEM SKINS
Let's say you own a Tabula and want to replace its skin with Gothic armour (Gothic Armour Pack - Official Path of Exile Wiki).
1. Create a dummy .txt file in the 'automods' folder with the following text:

name "Armour to replace Tabula"

#Gothic
title "Gothic"
restriction "filename1"
replacewith "filename2"

First line is the mod name the way you will see it in the 'Automods' dropdown in GUI. Pound sign on the next line denotes a comment. 'Title' is a name of each section of your script that you want to see as a separate checkbox in the mod options in the GUI. 'Restriction' parameter is a path to the file(item, effect) that you want replaced, while 'replacewith' parameter is a path to the file(item, effect) that you want to see on your character eventually.

2. Now that we have a dummy file, we need to find the actual filenames in the Content.ggpk file. In most cases, names and locations of the items are clear and fairly easy to find, in other cases it's guesswork.
In the GUI's green area, try searching for 'gothic'. Wow, that's a whole lot of hits. For now we only need the MTX armour's .sm skin mesh file. So let's use a bit of Regex to narrow down the search. Try this:

armour.*gothic.*sm$

FYI .* means zero or more characters between the words, whatever they may be. $ indicates end of line.
Note how the armour is called in the files: Gothic Horror Armour.

OK, so that restriction leaves us with much less noise in the list. Let's narrow it down even more.

gothichorrorarmourbody.*sm$

That leaves us with only seven hits. As you may have guessed, stat type combination at the end of each file (StrInt, Dex, Int) refers to each PoE class, Witch being pure Int, Ranger - pure Dex, Templar - StrInt, and so on.
Let's say you play as a Witch. In that case, you are going to need the .sm file specifically for her character model. So out of the seven files you need this: /Art/Models/Items/Armours/BodyArmours/Microtransactions/GothicHorrorArmour/GothicHorrorArmourBodyInt.sm.

Searching for the right Tabula file may be tricky as there were several versions of this armour throughout the years. I'll save you the trouble, the file you need is: /Art/Models/Items/Armours/BodyArmours/Unique/TabulaRasa/TabulaRasa2Int.sm

3. Now you need to save both files locally so that the program can work with them independently. Just copy each armour's file path to the restriction filter to get a single hit and hit 'Extract'. A corresponding status will appear.

4. Files saved, next you need to edit the dummy automod file. Just replace the filename placeholders with corresponding file paths, like this:

name "Armour to replace Tabula"

#Gothic
title "Gothic"
restriction "/Art/Models/Items/Armours/BodyArmours/Unique/TabulaRasa/TabulaRasa2Int.sm$"
replacewith "/Art/Models/Items/Armours/BodyArmours/Microtransactions/GothicHorrorArmour/GothicHorrorArmourBodyInt.sm$"

Note the $ at the end of each line. You need it there to eliminate possible multiple hits. We need a single instance replaced with a single instance.
Don't forget to save the updated file.

4. Magic time!
Note: for any changes to take effect you need to close the game client prior to modding.
In the GUI, click on the 'Automods' dropdown on the right pane and select your mod called 'Armour to replace Tabula'. You will see a checkbox underneath titled 'Gothic'. Check it and then hit 'Modify'. Ta-da!
If you search for the Tabula file again in the GUI and click on it, the lowermost area will show the original file vs the changed file. This is how you know that the changes were applied.
Open the game and don your Tabula. You should now be sporting a Gothic armour piece instead.

Same process applies to .ao files. For instance, the following code replaces the original Herald of Ice effect with a wicked-looking Celestial one (Celestial Herald Effect - Official Path of Exile Wiki)

name "Celestial Herald of Ice"

title "Celestial  Herald of Ice"
restriction "/Metadata/Effects/Spells/herald/ice/iceherald_explode.ao$"
replacewith "/Metadata/Effects/Microtransactions/Spells/heralds/celestial/ice_explode.ao$"

restriction "/Metadata/Effects/Spells/herald/ice/iceherald_explode.aoc$"
replacewith "/Metadata/Effects/Microtransactions/Spells/heralds/celestial/ice_explode.aoc$"

Note that both .ao and .aoc files need to be replaced in order for the effect to work correctly.

---

ADDING NEW EFFECTS TO YOUR CHARACTER
Let's say you want to add the Celestial aura effect to your character (Celestial Aura Effect - Official Path of Exile Wiki). How do you go about it?

First, you need to take a look at your equipped gear. If you own an item that has any kind of animated effect on it, chances are it has an .epk (effect package) file stored as a resource that you can edit.
An .epk file serves as a container for several animations created specifically for a certain item or spell. Thing is, you can stack a bunch of various animations to a single item in the same file regardless of whether they are interrelated. For instance, you can attach an aura, wings and a halo to the Herald of Ice spell activation effect, which is stored as an .epk file. And every time you trigger the herald, all those goodies will appear along with its effect.

Not all wearable items, however, have .epk files for their animations. If you own an item that has any kind of animated effect, try looking for an associated .epk file in the modding tool GUI. If you found it - just use it going forward. If not - well, then we have to stick with the Herald animation .epk.

Let's say you didn't find any relevant .epk's.
1. Look for Metadata/Effects/Spells/herald/ice/ice_herald_epk.epk instead. Export it. It will be saved into the '/exported' folder under the same path.
2. Navigate to the folder and open the file in Notepad. You will see the following text:

ParticleEffect "Larmfx" "Metadata/Particles/herald/ice/arm_effect.pet"
ParticleEffect "Rarmfx" "Metadata/Particles/herald/ice/arm_effect.pet"
AttachedObject "finger1_r" "Metadata/Effects/Spells/herald/ice/ice_herald.ao"
AttachedObject "finger1_l" "Metadata/Effects/Spells/herald/ice/ice_herald.ao"

These are animations that are currently attached to a standard Herald of Ice.

3. Find the Celestial aura animation in the GUI. You are looking for an .ao file, not .epk, as we need just a single animation effect.
Full path to the aura: /Metadata/Effects/Microtransactions/Spells/auras/celestial/CelestialAura.ao
Export the file.

4. Now copy the file path and add a line to the Ice Herald .epk file: AttachedObject "*" "Metadata/Effects/Microtransactions/Spells/auras/celestial/CelestialAura.ao"

ParticleEffect "Larmfx" "Metadata/Particles/herald/ice/arm_effect.pet"
ParticleEffect "Rarmfx" "Metadata/Particles/herald/ice/arm_effect.pet"
AttachedObject "finger1_r" "Metadata/Effects/Spells/herald/ice/ice_herald.ao"
AttachedObject "finger1_l" "Metadata/Effects/Spells/herald/ice/ice_herald.ao"
AttachedObject "*" "Metadata/Effects/Microtransactions/Spells/auras/celestial/CelestialAura.ao"

Other examples of attached effects:

AttachedObject "Head" "Metadata/Effects/Microtransactions/head/arcanehalo.ao"
AttachedObject "Back" "Metadata/Items/Armours/Capes/GothicCapeHeld.ao"

Note that auras are not attached to any specific part of the body, hence the "*".

5. When you're satisfied with your changes, save the file. Then locate it in the GUI by its full path and hit 'Insert' to make the program replace the original file with your copy.
Btw, you can always restore any modified file by clicking 'Restore'.

Thats's it. Open the game and behold the absolute splendor of MTX skins and animations that some of us good folks have laid out hundreds of bucks for : )

P.S. I think somebody's mentioned before that MTX 'obtained' this way are visible only to you on your PC. Other players will still see you in your old rags, so don't expect any fame boost, haha : )

[gangebob]

Anyone found data for Essence drain?Also want to figure out how to change rare items.
P.S. Thx for guide

[Devastateor]

When i try to open __init__.py it launches a cmd but immediatly closes without letting me see anything else please help i want to get gloom heard of ice effect please help, anyone here who was able to edit mtx pls made a video and post here?

Im getting this error message when i open __init__.py pls help

Traceback (most recent call last):
File "C:\Users\ThisPC\Downloads\poemod\poemodtool\__init__.py", line 14, in <module>
import poemods_threads
File "C:\Users\ThisPC\Downloads\poemod\poemodtool\poemods_threads.py", line 14, in <module>
import brotli
ModuleNotFoundError: No module named 'brotli'

[koala1234]

Anyone found data for Essence drain?Also want to figure out how to change rare items.
P.S. Thx for guide

title "Celestial ED"
restriction "./Metadata/Effects/Spells/siphon/projectile/rig.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile.ao"
restriction "./Metadata/Effects/Spells/siphon/projectile/rig.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile.aoc"
restriction "./Metadata/Effects/Spells/siphon/projectile_aoe_impact/projectile_aoe_impact.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile_aoe_impact.ao"
restriction "./Metadata/Effects/Spells/siphon/projectile_aoe_impact/projectile_aoe_impact.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile_aoe_impact.aoc"
restriction "./Metadata/Effects/Spells/siphon/buff.epk"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/drain.epk"
restriction "./Metadata/Effects/Spells/siphon/buff_large.epk"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/drain_large.epk"

[SegoItCh]

Sense of your program if you can't even did .exe file with user friendly interface?
Nobody need that shit, search for each file and effect for mtx.
Just do good program with ads, that's deal.

[koyasha]

Also want to figure out how to change rare items.

Makes the two of us, gangebob. My attempts have been fruitless so far.

And no, I wasn't able to find a replaceable Essence drain file either : (

[koyasha]

When i try to open __init__.py it launches a cmd but immediatly closes without letting me see anything else please help i want to get gloom heard of ice effect please help, anyone here who was able to edit mtx pls made a video and post here?

Im getting this error message when i open __init__.py pls help

Traceback (most recent call last):
File "C:\Users\ThisPC\Downloads\poemod\poemodtool\__init__.py", line 14, in <module>
import poemods_threads
File "C:\Users\ThisPC\Downloads\poemod\poemodtool\poemods_threads.py", line 14, in <module>
import brotli
ModuleNotFoundError: No module named 'brotli'

Python tells you what's wrong here: ModuleNotFoundError: No module named 'brotli' - you need to install brotli lib
Locate Scripts folder under the folder where you have python installed, open cmd/powershell in this folder and type: pip3 install brotli

[Devastateor]

Someone please make a video tutorial on how to use this so I can have some free MTX's? i tried opening __init__ and it dosent even open even after installing python

EDIT : __init__ opens after installing python and its libraries thanks koyasha for answering

[Devastateor]

Python tells you what's wrong here: ModuleNotFoundError: No module named 'brotli' - you need to install brotli lib
Locate Scripts folder under the folder where you have python installed, open cmd/powershell in this folder and type: pip3 install brotli

thanks soo much brother ill install and if i have any doubt i will ask

Has anyone here found where is whirling blades mtx's im not able to find them

[Huaojozu]

title "Celestial ED"
restriction "./Metadata/Effects/Spells/siphon/projectile/rig.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile.ao"
restriction "./Metadata/Effects/Spells/siphon/projectile/rig.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile.aoc"
restriction "./Metadata/Effects/Spells/siphon/projectile_aoe_impact/projectile_aoe_impact.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile_aoe_impact.ao"
restriction "./Metadata/Effects/Spells/siphon/projectile_aoe_impact/projectile_aoe_impact.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/projectile_aoe_impact.aoc"
restriction "./Metadata/Effects/Spells/siphon/buff.epk"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/drain.epk"
restriction "./Metadata/Effects/Spells/siphon/buff_large.epk"
replacewith "./Metadata/Effects/Microtransactions/Spells/siphon_celestial/drain_large.epk"

Do you happen to have a working Contagion one? I tried the below, but getting errors:
restriction "./Metadata/Effects/Spells/contagion/contagion_buff.epk"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/affected.epk"
restriction "./Metadata/Effects/Spells/contagion/contagion_main.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_main.ao
restriction "./Metadata/Effects/Spells/contagion/contagion_main.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_main.aoc"
restriction "./Metadata/Effects/Spells/contagion/contagion_sml.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_small.ao"
restriction "./Metadata/Effects/Spells/contagion/contagion_sml.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_small.aoc"

Also, is it possible to have both wings and a cape at the same time?

[koyasha]

Do you happen to have a working Contagion one? I tried the below, but getting errors:
restriction "./Metadata/Effects/Spells/contagion/contagion_buff.epk"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/affected.epk"
restriction "./Metadata/Effects/Spells/contagion/contagion_main.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_main.ao
restriction "./Metadata/Effects/Spells/contagion/contagion_main.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_main.aoc"
restriction "./Metadata/Effects/Spells/contagion/contagion_sml.ao"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_small.ao"
restriction "./Metadata/Effects/Spells/contagion/contagion_sml.aoc"
replacewith "./Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_small.aoc"

Also, is it possible to have both wings and a cape at the same time?

title "Celestial Contagion"

restriction "/Metadata/Effects/Spells/contagion/contagion_main\.ao$"
replacewith "/Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_main\.ao$"
restriction "/Metadata/Effects/Spells/contagion/contagion_main\.aoc$"
replacewith "/Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_main\.aoc$"
restriction "/Metadata/Effects/Spells/contagion/contagion_sml\.ao$"
replacewith "/Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_small\.ao$"
restriction "/Metadata/Effects/Spells/contagion/contagion_sml\.aoc$"
replacewith "/Metadata/Effects/Microtransactions/Spells/contagion_celestial/aoe_small\.aoc$"
restriction "/Metadata/Effects/Spells/contagion/contagion_buff\.epk$"
replacewith "/Metadata/Effects/Microtransactions/Spells/contagion_celestial/affected\.epk$"

It's possible to have as many effects as you like - just edit an .epk file you're using and insert in it effects from other epk/ao files.