Enter the Gungeon

Enter the Gungeon

224 ratings
Mod the Gungeon - A modding guide
By NiceStickman
This guide has been rewritten for the latest version of EtG (Farewell to Arms).

Hello and welcome to "ammo"dding guide for Enter the Gungeon! ᶦ'ᵐ ˢᵒʳʳʸ

In this guide I will show you how to install Mod the Gungeon. Perhaps you want to make the game harder as it already is, experiment with some things or just make it easier... who knows.
8
   
Award
Favorite
Favorited
Unfavorite
Installing ETGMod
Before you get some mods in the first place you need Mod the Gungeon, which is an open-source mod loader for Enter the Gungeon. It even is a mod itself!

You can download the EtGMod installer here.[modthegungeon.eu]
It's also available on GitHub,[github.com]just make sure to download the latest release!

The installer runs on Windows¹, Mac² and Linux² and works with EtG version 1.0.10+.

¹: Requires .NET Framework 4.5+.
²: Use Mono, not Wine

For Windows users:

Download the latest version of the EtGMod installer and open it. You should see this on your screen:



Step 1: Select EtG.exe

If you use Windows (32bit) you'll find it here:

C:\Program Files\Steam\steamapps\common\Enter the Gungeon

If you use Windows (64bit) you'll find it here:

C:\Program Files (x86)\Steam\steamapps\common\Enter the Gungeon

Step 2: Choose your backends

Right now you can only choose "Base" which installs the latest version of Mod the Gungeon

Step 3: Install EtGMod

Now click on Install EtGMod and it will automatically install MtG for you. If everything went fine, you should see this:



But if something went inevitably wrong and you get an error instead, click on Show log, copy paste everything on a .txt file and please redirect your questions to the Enter the Gungeon Discord server[discord.gg] on channel #modding as I only wrote the guide. Make sure to read their rules first!

For macOS users:

Soon...

For Linux users:

To install ETGMod on Linux, we need Mono first.

Step 1: Installing Mono

Mono is an open source implementation of Microsoft's .NET Framework. Basically, we can run .exe files on other operating systems like macOS and Linux.

Here's the official download page for Linux[www.mono-project.com].

If you added the Mono repository to your system make sure to install mono-complete, as it should cover most cases of "assembly not found" errors.

sudo apt install mono-complete

After the installation, you can now open .exe files with the Terminal.

Step 2: Open ETGMod.Installer.exe

Download the latest version of the ETGMod Installer.
Go to the folder that your installer is currently in and Right click > Open in Terminal. Now open the .exe file with this command:

mono ETGMod.Installer.exe

Make sure not to close the Terminal as it will kill the process. You should see this:



Step 3: Select ETG.x86(_64)

You can find both ETG.x86 and x86_64 in here:

/home/"your name"/.local/share/Steam/steamapps/common/Enter the Gungeon

Step 3: Choose your backends

Right now you can only choose "Base" which installs the latest version of Mod the Gungeon

Step 4: Install ETGMod

Now click on Install EtGMod and it will automatically install MtG for you. If everything went fine, you should see this:



But if something went inevitably wrong and you get an error instead, click on Show log, copy paste everything on a .txt file and please redirect your questions to the Enter the Gungeon Discord server[discord.gg] on channel #modding as I only wrote the guide. Make sure to read their rules first!
ETGMod installed correctly?
Now that EtGMod is installed, we need to check if it was installed correctly.

Start the game. If you see Dog Roll in the intro:



And have been greeted by the title screen saying Mod the Gungeon:



Then you've installed EtGMod correctly!
Installing mods
Now we get to the main part of having EtGMod installed, mods! Go to your game's directory first.

For Windows users:

If you use Windows (32bit) you'll find it here:

C:\Program Files\Steam\steamapps\common\Enter the Gungeon

If you use Windows (64bit) you'll find it here:

C:\Program Files (x86)\Steam\steamapps\common\Enter the Gungeon

For macOS users:

Soon...

For Linux users:

You'll find it here:

/home/"your name"/.local/share/Steam/steamapps/common/Enter the Gungeon

You'll find a folder called Mods in there. If not, just create one.

Where do I get mods from?

Go to this site called Mod Workshop[modworkshop.net]. There are tons of mods for EtG and other games. Make sure to read the descriptions for each mod for instructions if it has any.

After you downloaded some mods, put the .zip files inside the Mods folder in your game's directory. It should look like this:

Windows:


Linux:


Delete the mods.txt file and start the game. It will create another mods.txt file with everything auto-filled to make the mods work.
Mods installed correctly?
Now that we installed some mods, we need to check if they were installed correctly.

Start the game and press F1. You should see this:



If all mods are enabled, then they should work. Note that not every mod is compatible with the latest version of EtG (currently Farewell to Arms) so you need to test them out for yourself and check if they're working.
Installing backends
This page is not finished yet.
Writing your own mods
This page is not finished yet.
Writing backends
This page is not finished yet.
Closing Remarks
Thanks for reading this guide.

If you liked it, please rate it and favorite it.




Got any questions? Write them in the comments below!
< >
90 Comments
SwaggyBadger Sep 8 @ 7:38pm 
it didn't take me long to find the guy looking for a way to unlock achievements without actually being good/lucky
cultist Jul 25 @ 6:26pm 
you gotta remove the txt file in the mod folder every time you load a mod
Ada_the invada Jul 17 @ 2:29pm 
anyway to make it work? i got the latest version and no matter what i try eithr the game crashes on start, or the mods always show as "disabled"
fire_ofthecat Jun 26 @ 1:28pm 
how to enable mods?
NiceStickman  [author] Jun 20 @ 1:48pm 
Apparently someone rewrote the EtGMod installer which also works on MacOS. I will test it out and update the guide soon.

But here's the link: https://gitlab.com/scionofmemory/etgmod-installer-reloaded/-/releases/v0.9.9
Make sure to download the installer, not the source code!
markismo Jun 20 @ 1:14pm 
so... is it not possible to use mods for this game on MacOS?
Peco Jun 14 @ 8:43am 
nvm, I reinstalled it with some option on and it worked
Peco Jun 14 @ 8:38am 
the installation went fine with me but when i start the game it doesn't load the Mod the gungeon logo. I'm on linux btw
NiceStickman  [author] May 28 @ 11:05am 
No, MtG doesn't work on the Microsoft Store version.
taczki2 May 28 @ 9:56am 
Is there any way to install it on Microsoft Store version?