KyleTheScientist-Custom_Characters_Mod icon

Custom Characters Mod

EtG mod that allows you to create and share custom characters with friends!

Last updated 2 weeks ago
Total downloads 44130
Total rating 10 
Categories Mods Gungeoneers
Dependency string KyleTheScientist-Custom_Characters_Mod-2.2.6
Dependants 84 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_EtG-5.4.2101 icon

BepInEx pack for Enter the Gungeon. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2101
MtG_API-Mod_the_Gungeon_API-1.7.2 icon

Adds the good parts of Mod the Gungeon to BepInEx.

Preferred version: 1.7.2


Custom Characters Mod

Create and share custom characters with friends!

Also adds Franseis, an NPC who randomizes your loadout and stats, and a character randomizer shrine to the breach.

How to Port your Custom Character to BepInEx

  1. Make a folder for your custom character.
  2. Inside that folder, make another folder named plugins.
  3. Put all of the files for your custom character into the plugins folder.
  4. Inside of your custom character folders (not plugins) make the following files:
    • manifest.json: This file contains the main information about your mod - the name, short description, dependencies and version. A more detailed guide on the manifest.json (plus an example manifest) can be found here. You can see if your manifest is valid or not here.
    • This file contains the description for your mod that users will see on your mod page (for example, this guide is written in the mod's The readme can be previewed here.
    • icon.png: The thumbnail for your mod users will see while browsing mods. Must be 256x256 pixels.
    • (optional): This file contains the changelog for your mod. Unlike the rest of the files, this one isn't required, but it's still good to have a changelog. Just like the readme, you can preview your changelog here.
  5. Make a zip of all the files in your custom character folder (NOT a zip of the folder itself) and upload it here.

An example of how the custom character folder should look like:

An example of how the plugins folder should look like:


  • KyleTheScientist - original mod for Mod the Gungeon.
  • An3s - original port to BepInEx.
  • SpecialAPI - minor bug fixes and updates.
  • Captain Pretzel - making characters load on Linux and Mac
  • Neighborino - idea for the random character shrine and help with making it.
  • Nevernamed - making a video feature of this mod! (slightly outdated though, as it's for Mod the Gungeon)