From Brotato Wiki

(give Mobile Mods their own section, as there are 2 now)
(45 intermediate revisions by 7 users not shown)
Line 1: Line 1:
'''This page is work in progress.'''
<metadesc>Brotato Wiki Modding Guide to Mods, Mod list, How to mod Brotato, Mod installation</metadesc>
==Warning==
==Warning==
'''All modding is currently unofficial, use at your own risk. Anyone can put any code they want in the files shared (including malicious code to hack you) so be careful with what you're downloading and don't download anything that looks suspicious.'''
'''All modding is currently unofficial, use at your own risk. Anyone can put any code they want in the files shared (including malicious code to hack you) so be careful with what you're downloading and don't download anything that looks suspicious.'''


Download links are moved to individual mod pages as those pages can only be edited by mod developers. While this does not guarantee safety, it ensures that the download link has not been altered by malicious parties.
Download links are moved to individual mod pages as those pages can only be edited by mod developers. While this does not guarantee safety, it ensures that the download link has not been altered by malicious parties.
{{LinkButton|name=Modding#Mod_List|text=Jump to Mod List}}


==Save File==
==Save File==
Line 15: Line 18:
=== Separate Save Files ===
=== Separate Save Files ===
If you launch a mod through Steam, you can keep using your Steam cloud save and all its unlocks. However, if you launch a mod outside of Steam (eg. by running an EXE directly), a separate save file will be used instead. You can view both at <code>%appdata%\Brotato</code>. The folder with the long numbers contains your Steam save. If you have a folder named "user", that's the folder that gets used if you run the EXE directly. You can copy and paste save data between them if you need to (''just be very careful if you do this'', as doing this could accidentally overwrite your proper save file, so it's best to keep your main save backed up in a totally separate folder just in case).
If you launch a mod through Steam, you can keep using your Steam cloud save and all its unlocks. However, if you launch a mod outside of Steam (eg. by running an EXE directly), a separate save file will be used instead. You can view both at <code>%appdata%\Brotato</code>. The folder with the long numbers contains your Steam save. If you have a folder named "user", that's the folder that gets used if you run the EXE directly. You can copy and paste save data between them if you need to (''just be very careful if you do this'', as doing this could accidentally overwrite your proper save file, so it's best to keep your main save backed up in a totally separate folder just in case).
== FAQs ==
See [[Modding FAQs]] for general questions. See [[Modding Notes]] for info specific to modders.


==Mod Installation==
==Mod Installation==
There is no official '''Multiple Mod Support''' at the moment. '''None''' of these methods allows '''running multiple mods''' in the same game.
There is no official '''Multiple Mod Support''' at the moment. '''None''' of these methods allows '''running multiple mods''' in the same game.
'''Video guide:'''
{{#ev:youtube|https://www.youtube.com/watch?v=8c0uUhi39T8|800px}}


=== Downloading Mods & Setup ===
=== Downloading Mods & Setup ===
Line 36: Line 46:


=== Method 1: Replace Vanilla PCK ===
=== Method 1: Replace Vanilla PCK ===
''This is the simplest method.''
''This is the simplest method. {{Color|color=pastelgreen|text=Uses Steam, so you keep your saves and can unlock achievements.}}''
#In the game folder, delete the original {{Color|color=cream|text=Brotato.pck}} ''(after making a backup, as above)''
#In the game folder, delete the original {{Color|color=cream|text=Brotato.pck}} ''(after making a backup, as above)''
#Move the mod's {{Color|color=cream|text=.pck}} file into the game's folder, and rename it {{Color|color=cream|text=Brotato.pck}}
#Move the mod's {{Color|color=cream|text=.pck}} file into the game's folder, and rename it {{Color|color=cream|text=Brotato.pck}}
Line 42: Line 52:


===Method 2: Using Steam Launch Option===
===Method 2: Using Steam Launch Option===
''This method allows for fast mod switching.''
''This method allows for fast mod switching. {{Color|color=pastelgreen|text=Uses Steam.}}''
#In Steam: Right click on Brotato > Properties > Launch Options
#In Steam: Right click on Brotato > Properties > Launch Options
#Add <code>--main-pack modpackname.pck</code>
#Add <code>--main-pack modpackname.pck</code>
Line 55: Line 65:


===Method 3: Multiple EXE Files===
===Method 3: Multiple EXE Files===
''This method {{Color|pastelred|doesn't allow steam cloud saves}} (see ''[[Modding#Separate Save Files|Saves]]'' above), but lets you run any number of mods quickly.''
''Lets you run any number of mods quickly.'' ''{{Color|pastelred|Doesn't use Steam}} (so no cloud saves/achievements)''
#In the game's folder, duplicate {{Color|color=cream|text=Brotato.exe}} (ie. with copy & paste).
#In the game's folder, duplicate {{Color|color=cream|text=Brotato.exe}} (ie. with copy & paste).
#Rename the copy to match the mod's {{Color|color=cream|text=.pck}} file.
#Rename the copy to match the mod's {{Color|color=cream|text=.pck}} file.
Line 66: Line 76:


===Method 4: Use [[Mod:Mod Selector]] Mod===
===Method 4: Use [[Mod:Mod Selector]] Mod===
You can run one script to choose your mod pack easily.
You can run one script to choose your mod pack easily. ''{{Color|color=pastelgreen|text=Uses Steam.}}''


[[Mod:Mod Selector|Learn more here]]
[[Mod:Mod Selector|Learn more here]]


===Method 5: Steam Shortcuts===
===Method 5: Steam Shortcuts===
''This is very technical, but if you know what you're doing it's fast and flexible.''
''This is very technical, but once you know what you're doing it's fast and flexible. {{Color|color=pastelgreen|text=Uses Steam.}}''
 
The explanation here is long so it's been hidden behind this toggle button:
 
{{ToggleStart|btn=Toggle Instructions|id=method5}}
# A variation on method 3 above is to create (potentially multiple) '''shortcuts''' with different launch options, rather than setting a single launch option in Steam.
# A variation on method 3 above is to create (potentially multiple) '''shortcuts''' with different launch options, rather than setting a single launch option in Steam.
# First, remove any custom launch options currently set in Steam for Brotato.
# First, remove any custom launch options currently set in Steam for Brotato.
Line 91: Line 105:
## This is shorter than using the full path to Steam, but Steam will show a warning prompt every time to try to run the shortcut.
## This is shorter than using the full path to Steam, but Steam will show a warning prompt every time to try to run the shortcut.
## It also only seems to work correctly with relative paths.
## It also only seems to work correctly with relative paths.
{{ToggleEnd}}


==Mod List==  
==Mod List==  
Line 107: Line 122:
</tr>
</tr>
<tr>
<tr>
<td> [[File:Duct Tape.png|100px|link=Mod:Modtato]]<br>'''[[Mod:Modtato|Modtato]] '''</td>
<td> [[File:Duct Tape.png|96px|link=Mod:Modtato]]<br>'''[[Mod:Modtato|Modtato]] '''</td>
<td> MRCL </td>
<td> MRCL </td>
<td style="text-align:left;">Combination of [[Mod:Assassin|Assassin]], [[Mod:Starwars|Starwars]], [[Mod:Extatonion|Extatonion]], [[Mod:SIFD's Mod - Rainbow Chest|SIFD's Mod]], and [[Mod:Multiple Resolutions Mod|Multiple Resolutions Mod]]</td>
<td style="text-align:left;">Combination of [[Mod:Assassin|Assassin]], [[Mod:Starwars|Starwars]], [[Mod:Extatonion|Extatonion]], [[Mod:SIFD's Mod - Rainbow Chest|SIFD's Mod]], and [[Mod:Multiple Resolutions Mod|Multiple Resolutions Mod]]</td>
Line 116: Line 131:
</table>
</table>
=== Content Mods ===
=== Content Mods ===
''These mods are expansion's, adding new items, weapons, mechanics and characters to the game.''
''These mods are expansions, adding new items, weapons, mechanics and characters to the game.''
 
''{{Color|color=cream|text=Tip: Click "Game Version" twice to sort mods by the latest version. Click "Last Update" twice to see which have been updated recently.}}''


<table class="wikitable sortable jquery-tablesorter" style="width:90%;color:#eee; background:transparent; text-align:center; vertical-align:middle;">
<table class="wikitable sortable jquery-tablesorter" style="width:90%;color:#eee; background:transparent; text-align:center; vertical-align:middle;">
Line 128: Line 145:
</tr>
</tr>
         <tr>
         <tr>
             <td> [[File:Assassin.png|300px]]<br>'''[[Mod:Assassin|Assassin]] '''</td>
             <td> [[File:Assassin.png|300px|link=Mod:Assassin]]<br>'''[[Mod:Assassin|Assassin]] '''</td>
<td> JuneFurrs </td>
<td> JuneFurrs </td>
<td style="text-align:left;">Adds some new content with a dark backstory... new characters, weapons, items and even challenges</td>
<td style="text-align:left;">Adds some new content with a dark backstory... new characters, weapons, items and even challenges</td>
<td>  {{Version|version=0.6.0.7}} </td>
<td>  {{Version|version=0.6.1.6}} </td>
<td> 2022-11-29 </td>
<td> 2022-12-29 </td>
<td> [[Mod:Assassin]] </td>
<td> [[Mod:Assassin]] </td>
</tr>
</tr>
Line 139: Line 156:
<td> dami </td>
<td> dami </td>
<td style="text-align:left;"> Super upgrades - Legendaries - Burn Overhaul - Atk speed - QoL </td>
<td style="text-align:left;"> Super upgrades - Legendaries - Burn Overhaul - Atk speed - QoL </td>
<td>  {{Version|version=Demo}} </td>
<td>  {{Version|version=0.1.1 (Demo)}} </td>
<td> 2022-09-18 </td>
<td> 2022-09-18 </td>
<td> [[Mod:dami's Overhaul Mod]] </td>
<td> [[Mod:dami's Overhaul Mod]] </td>
</tr>
</tr>
<tr>
<tr>
<td> [[File:mod-damisarsenal-kunai.png|100px|link=Mod:dami's Arsenal]]<br>'''[[Mod:dami's Arsenal|dami's Arsenal]] '''</td>
<td> [[File:mod-damisarsenal-kunai.png|96px|link=Mod:dami's Arsenal]]<br>'''[[Mod:dami's Arsenal|dami's Arsenal]] '''</td>
<td> dami </td>
<td> dami </td>
<td style="text-align:left;"> Adds 4 weapons </td>
<td style="text-align:left;"> Adds 4 weapons </td>
Line 154: Line 171:
<td> [[File:Extatonion.png|150px|link=Mod:Extatonion]]<br>'''[[Mod:Extatonion|Extatonion]] '''</td>
<td> [[File:Extatonion.png|150px|link=Mod:Extatonion]]<br>'''[[Mod:Extatonion|Extatonion]] '''</td>
<td> Psina </td>
<td> Psina </td>
<td style="text-align:left;">34 new items<br>33 new weapons<br>6 new weapon classes<br>4 new characters with their own unlocks<br>7 new upgrades</td>
<td style="text-align:left;">43 new items<br>39 new weapons<br>6 new weapon classes<br>6 new characters with their own unlocks<br>7 new upgrades</td>
<td> {{Version|version=0.6.0.7}} </td>
<td>   {{Version|version=0.6.1.6}} </td>
<td> 2022-12-04 </td>
<td> 2023-01-07 </td>
<td> [[Mod:Extatonion]] </td>
<td> [[Mod:Extatonion]] </td>
</tr>
</tr>
Line 163: Line 180:
<td> Anti + DireYoshi </td>
<td> Anti + DireYoshi </td>
<td style="text-align:left;"> 3 Characters, 4 ITems, 9 Items, Modifiers </td>
<td style="text-align:left;"> 3 Characters, 4 ITems, 9 Items, Modifiers </td>
<td>  {{Version|Demo}} </td>
<td>  {{Version|0.1.1 (Demo)}} </td>
<td> 2022-08-02 </td>
<td> 2022-08-02 </td>
<td> [[Mod:Gemini]] </td>
<td> [[Mod:Gemini]] </td>
</tr>
        <tr>
<td> [[File:HalfBakedLogo.png|200px|link=Mod:HalfBaked]]<br>'''[[Mod:HalfBaked|Half Baked]] '''</td>
<td> Zombero </td>
<td style="text-align:left;">12 New Characters</td>
<td>  {{Version|version=0.6.1.6}} </td>
<td> 2023-1-21 </td>
<td> [[Mod:HalfBaked]] </td>
</tr>
<tr>
<td> [[File:Mod-Invasion_Logo.png|100px|link=Mod:Invasion]]<br>'''[[Mod:Invasion|Invasion]] '''</td>
<td> Darkly77 </td>
<td style="text-align:left;">New content from Space Gladiators: <br>116 items, 3 weapons, lots more planned</td>
<td>  {{Version|version=0.6.1.6}} </td>
<td> 2022-12-23 </td>
<td> [[Mod:Invasion]] </td>
</tr>
</tr>
<tr>
<tr>
<td> [[File:Mod-Isaac-sacred_heart.png|100px|link=Mod:Isaac_Characters_Mod]]<br>'''[[Mod:Isaac_Characters_Mod|Isaac Characters Mod]] '''</td>
<td> [[File:Mod-Isaac-sacred_heart.png|99px|link=Mod:Isaac_Characters_Mod]]<br>'''[[Mod:Isaac_Characters_Mod|Isaac Characters Mod]] '''</td>
<td> Psina </td>
<td> Psina </td>
<td style="text-align:left;">Adds new content based on The Binding Of Isaac:<br>6 new characters, 7 new weapons, 13 new items</td>
<td style="text-align:left;">Adds new content based on The Binding Of Isaac:<br>6 new characters, 7 new weapons, 13 new items</td>
Line 184: Line 217:
</tr>
</tr>
<tr>
<tr>
<td>[[File:Cog.png|100px|link=Mod:Randomizer + Expansion + Hardcore + Babies]]<br>[[Mod:Randomizer + Expansion + Hardcore + Babies|'''Randomizer + Expansion''']]<br>[[Mod:Randomizer + Expansion + Hardcore + Babies|'''+ Hardcore + Babies''']] </td>
<td>[[File:Cog.png|96px|link=Mod:Randomizer + Expansion + Hardcore + Babies]]<br>[[Mod:Randomizer + Expansion + Hardcore + Babies|'''Randomizer + Expansion''']]<br>[[Mod:Randomizer + Expansion + Hardcore + Babies|'''+ Hardcore + Babies''']] </td>
<td>Resinated</td>
<td>Resinated</td>
<td style="text-align:left;">Randomizer + Expansion + Hardcore + Babies</td>
<td style="text-align:left;">Randomizer + Expansion + Hardcore + Babies</td>
<td>{{Version|version=Demo}}</td>
<td>{{Version|version=0.1.1 (Demo)}}</td>
<td> 2022-08-22 </td>
<td> 2022-08-22 </td>
<td>[[Mod:Randomizer + Expansion + Hardcore + Babies|Mod:Randomizer + Expansion]] [[Mod:Randomizer + Expansion + Hardcore + Babies|+ Hardcore + Babies]]</td>
<td>[[Mod:Randomizer + Expansion + Hardcore + Babies|Mod:Randomizer + Expansion]] [[Mod:Randomizer + Expansion + Hardcore + Babies|+ Hardcore + Babies]]</td>
</tr>
</tr>
         <tr>
         <tr>
<td> [[File:Starwars.png|100px|link=Mod:Starwars]]<br>'''[[Mod:Starwars|Star Wars Mod]] '''</td>
<td> [[File:Starwars.png|96px|link=Mod:Starwars]]<br>'''[[Mod:Starwars|Star Wars Mod]] '''</td>
<td> Bioinvasion </td>
<td> Bioinvasion </td>
<td style="text-align:left;">Adds Star Wars themed weapons, characters, and items.</td>
<td style="text-align:left;">Adds Star Wars themed weapons, characters, and items.</td>
<td> {{Version|0.6.0.7}} /<br>{{Version|Demo}} </td>
<td> {{Version|0.6.0.7}} </td>
<td> 2022-11-26 </td>
<td> 2022-11-26 </td>
<td> [[Mod:Starwars]] </td>
<td> [[Mod:Starwars]] </td>
Line 222: Line 255:
</tr>
</tr>
<tr>
<tr>
<td> [[File:Mod-All_Starting_Weapons.png|100px|link=Mod:All_Starting_Weapons]]<br>'''[[Mod:All_Starting_Weapons|All Starting Weapons]] '''</td>
<td> [[File:Mod-All_Starting_Weapons.png|96px|link=Mod:All_Starting_Weapons]]<br>'''[[Mod:All_Starting_Weapons|All Starting Weapons]] '''</td>
<td> Zucker_Schock </td>
<td> Zucker_Schock </td>
<td style="text-align:left;">Adds all available starting weapons to all characters. Random weapon button gives a random weapon from the full selection. Character specific perks taken into account. </td>
<td style="text-align:left;">Adds all available starting weapons to all characters. Random weapon button gives a random weapon from the full selection. Character specific perks taken into account. </td>
Line 230: Line 263:
</tr>
</tr>
  <tr>
  <tr>
<td> [[File:Mod-Attract Materials.png|100px|link=Mod:Attraction/Pickup_Mods]]<br>'''[[Mod:Attraction/Pickup_Mods|Attraction/Pickup Mods]] '''</td>
<td> [[File:Mod-Attract Materials.png|72px|link=Mod:Attraction/Pickup_Mods]]<br>'''[[Mod:Attraction/Pickup_Mods|Attraction/Pickup Mods]] '''</td>
<td> Zucker_Schock </td>
<td> Zucker_Schock </td>
<td style="text-align:left;">Several Mods aimed at instant pickup and or attraction of materials and or consumables (food+chests).</td>
<td style="text-align:left;">Several Mods aimed at instant pickup and or attraction of materials and or consumables (food+chests).</td>
Line 238: Line 271:
</tr>
</tr>
<tr>
<tr>
<td> [[File:Cog.png|100px|link=Mod:Cheat Mod]]<br>'''[[Mod:Cheat Mod|Cheat Mod]] '''</td>
<td> [[File:Cog.png|96px|link=Mod:Cheat Mod]]<br>'''[[Mod:Cheat Mod|Cheat Mod]] '''</td>
<td> Aequitas, Dex </td>
<td> Aequitas, Dex </td>
<td style="text-align:left;"> Adds Cheat Menu that can give any item and any weapon</td>
<td style="text-align:left;"> Adds Cheat Menu that can give any item and any weapon</td>
Line 254: Line 287:
</tr>
</tr>
<tr>
<tr>
<td> [[File:Coupon.png|100px|link=Mod:Shoptato]]<br>'''[[Mod:Shoptato|Shoptato]] '''</td>
<td> [[File:Coupon.png|96px|link=Mod:Shoptato]]<br>'''[[Mod:Shoptato|Shoptato]] '''</td>
<td> MRCL </td>
<td> MRCL </td>
<td style="text-align:left;">All items are buyable in the shop, no need to roll! </td>
<td style="text-align:left;">All items are buyable in the shop, no need to roll! </td>
Line 262: Line 295:
</tr>
</tr>
<tr>
<tr>
<td>  [[File:Sifd's_Relic.png|100px|link= Mod:SIFD's Mod - Rainbow Chest]]<br>'''[[Mod:SIFD's Mod - Rainbow Chest|SIFD's Mod - Rainbow Chest]] ''' </td>
<td>  [[File:Sifd's_Relic.png|96px|link= Mod:SIFD's Mod - Rainbow Chest]]<br>'''[[Mod:SIFD's Mod - Rainbow Chest|SIFD's Mod - Rainbow Chest]] ''' </td>
<td> DireYoshi </td>
<td> DireYoshi  
<td style="text-align:left;"> Adds options for reroll prices, inflation, luck scaling <br> Adds Rainbox chest that allows you to choose the item you want </td>
JpMitri
<td>  {{Version|version=0.6.0.7}} </td>
</td>
<td> 2022-11-16 </td>
<td style="text-align:left;"> Rainbow Chest - Let you choose any item you want.
Game Busters - Advanced Benchmarking software for Potato PCs.
</td>
<td>  {{Version|version=0.8.0.3}} </td>
<td> 2023-02-22 </td>
<td> [[Mod:SIFD's Mod - Rainbow Chest]] </td>
<td> [[Mod:SIFD's Mod - Rainbow Chest]] </td>
</tr>
</tr>
<tr>
<tr>
<td>  [[File:Tyler.png|100px|link=Mod:Tylers_Only_Mod]]<br>'''[[Mod:Tylers_Only_Mod|Tylers Only Mod]] ''' </td>
<td>  [[File:Tyler.png|96px|link=Mod:Tylers_Only_Mod]]<br>'''[[Mod:Tylers_Only_Mod|Tylers Only Mod]] ''' </td>
<td> Psina </td>
<td> Psina </td>
<td style="text-align:left;"> Only Tylers appear in the store. Can you beat the game with only Tylers? </td>
<td style="text-align:left;"> Only Tylers appear in the store. Can you beat the game with only Tylers? </td>
Line 292: Line 329:
</tr>
</tr>
<tr>
<tr>
<td> [[File:Wandering Bot.png|link=Mod:Brotato Mobile|100px]]<br>'''[[Mod:Brotato Mobile|Brotato Mobile]]''' </td>
<td> [[File:Wrench.png|96px|link=Mod:Mod Selector]]<br>'''[[Mod:Mod Selector|Mod Selector]] '''</td>
<td> Maximal08 </td>
<td style="text-align:left;"> Mobile version of Brotato for Android. </td>
<td>  {{Version|version=0.5.11}} </td>
<td> 2022-11-06 </td>
<td> [[Mod:Brotato Mobile]] </td>
</tr>
<tr>
<td> [[File:Wrench.png|96x96px|link=Mod:Mod Selector]]<br>'''[[Mod:Mod Selector|Mod Selector]] '''</td>
<td> YourB3stNightmare </td>
<td> YourB3stNightmare </td>
<td style="text-align: left;">Script that lets you choose any Brotato .pck file to run the game with. </td>
<td style="text-align: left;">Script that lets you choose any Brotato .pck file to run the game with. </td>
<td>{{Version|version=0.6.0.7}}</td>
<td>{{Color|pastelgreen|Any}}</td>
<td> 2022-11-25 </td>
<td> 2022-11-25 </td>
<td> [[Mod:Mod Selector|Mod Selector]] </td>
<td> [[Mod:Mod Selector|Mod Selector]] </td>
</tr>
</tr>
<tr>
<tr>
<td> [[File:Night Goggles.png|100px|link=Mod:Multiple Resolutions Mod]]<br>'''[[Mod:Multiple Resolutions Mod|Multiple Resolutions Mod]] '''</td>
<td> [[File:Night Goggles.png|96px|link=Mod:Multiple Resolutions Mod]]<br>'''[[Mod:Multiple Resolutions Mod|Multiple Resolutions Mod]] '''</td>
<td> KANA </td>
<td> KANA </td>
<td style="text-align:left;"> Enables resolutions higher than 1080p, such as 3440x1440 and 2560x1440 </td>
<td style="text-align:left;"> Enables resolutions higher than 1080p, such as 3440x1440 and 2560x1440 </td>
Line 330: Line 359:
</tr>
</tr>
<tr>
<tr>
<td> [[File:Mod-DebugLoader_Icon.png|100px|link=Mod:DebugLoader]]<br>'''[[Mod:DebugLoader|DebugLoader]] '''</td>
<td> [[File:Mod-DebugLoader_Icon.png|96px|link=Mod:DebugLoader]]<br>'''[[Mod:DebugLoader|DebugLoader]] '''</td>
<td> Darkly77 </td>
<td> Darkly77 </td>
<td style="text-align:left;">Edit a JSON file to set debug options (starting weapons, items, materials etc).<br>Can be used to share custom challenges</td>
<td style="text-align:left;">Edit a JSON file to set debug options (starting weapons, items, materials etc).<br>Can be used to share custom challenges</td>
<td>  {{Version|version=0.6.0.7}} </td>
<td>  {{Version|version=0.6.1.6}} </td>
<td> 2022-11-22 </td>
<td> 2022-12-23 </td>
<td> [[Mod:DebugLoader]] </td>
<td> [[Mod:DebugLoader]] </td>
</tr>
</tr>
Line 347: Line 376:
</table>
</table>


==Vanilla Files List==  
=== Mobile Mods ===
 
''APKs for Brotato on Android.''
 
<table class="wikitable sortable jquery-tablesorter" style="width:90%;color:#eee; background:transparent; text-align:center; vertical-align:middle;">
<tr>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); text-align:center; vertical-align:middle; width:15%" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending">Name</th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); text-align:center; vertical-align:middle; width:5%" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending">Author</th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); text-align:center; vertical-align:middle; width:35%" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending">Description</th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); text-align:center; vertical-align:middle; width:5%" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending">Game Version</th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); text-align:center; vertical-align:middle; width:10%" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending">Last Update<br>YYYY/MM/DD</th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); text-align:center; vertical-align:middle; width:10%" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending">Download</th>
</tr>
<tr>
<td> [[File:Wandering Bot.png|link=Mod:Brotato Mobile|96px]]<br>'''[[Mod:Brotato Mobile|Brotato Mobile]]''' </td>
<td> Maximal08 </td>
<td style="text-align:left;"> Mobile version of Brotato for Android. </td>
<td>  {{Version|version=0.5.11}} </td>
<td> 2022-11-06 </td>
<td> [[Mod:Brotato Mobile]] </td>
</tr>
<tr>
<td>[[File:My mod icon.png|96x96px]]<br>'''[[Mod:Brotato Mobile by ZBEP|Brotato Mobile by ZBEP]]'''</td>
<td>ZBEP</td>
<td style="text-align:left;"> Mobile version of Brotato for Android with support for Steam mods.</td>
<td>{{Version|version=0.8.0.3}}</td>
<td>2023-02-24</td>
<td>[[Mod:Brotato Mobile by ZBEP|Brotato Mobile by ZBEP]]</td>
</tr>
</table>
 
== Restoring Vanilla ==
If you accidently remove your original {{Color|color=cream|text=Brotato.pck}} file:
If you accidently remove your original {{Color|color=cream|text=Brotato.pck}} file:
 
*Go to Steam > Library > right click on Brotato > Properties > Local Files > '''Verify integrity of game files...'''
*Go to Steam > Library > right click on Brotato > Properties > Local Files > Verify integrity of game files...


This will fix your game and bring it back to vanilla.
This will fix your game and bring it back to vanilla.


[[File:Modding-restore-vanilla-1.png]] [[File:Modding-restore-vanilla-2.png]]


For older {{Color|color=cream|text=Brotato.pck}} files, you can download them here.
==Vanilla Files List==
You can download older {{Color|color=cream|text=Brotato.pck}} files here.


<table class="wikitable sortable jquery-tablesorter" style="max-width:900px; color:#eee; background:transparent; vertical-align:middle;">
<table class="wikitable sortable jquery-tablesorter" style="max-width:900px; color:#eee; background:transparent; vertical-align:middle;">
Line 361: Line 422:
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); vertical-align:middle;" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending"> Game Version </th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); vertical-align:middle;" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending"> Game Version </th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); vertical-align:middle;" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending"> Download </th>
<th style="font-weight:bold; color:#eee; background-color: rgb(220,220,220,0.2); vertical-align:middle;" class="headerSort" tabindex="0" role="columnheader button" title="Sort ascending"> Download </th>
</tr>
<tr>
<td> [[Patch 0.6.1.6|0.6.1.6]] </td>
<td> [[Mod:Patch 0.6.1.6]] </td>
</tr>
</tr>
<tr>
<tr>
Line 379: Line 444:
{| class="wikitable"
{| class="wikitable"
!Link
!Link
!Type
!Info
!Info
|-
|-
|[https://discord.gg/qes3RmZXKK Brotato Discord Server]  
|[https://discord.gg/qes3RmZXKK Brotato Discord Server]  
|Discord
|See the ''#modding'' channel
|See the ''#modding'' channel
|-
|-
|[https://github.com/bruvzg/gdsdecomp GDRE Tools]  
|[https://www.youtube.com/watch?v=hsMA6h7Rd4I Modding Tutorial]
|Guide
|YouTube tutorial video by Jonus. Covers all the basics.
|-
|[https://discord.com/channels/630060181086142487/999568046052098109/1000910462986227814 Translations Guide]
|Guide
|Discord message by Aequitas explaining how to do translations.
|-
|[https://github.com/bruvzg/gdsdecomp GDRE Tools]
|Tool
|Godot Decompiler. Required for modding. Has either a GUI or CLI.
|Godot Decompiler. Required for modding. Has either a GUI or CLI.
|-
|[https://www.youtube.com/watch?v=hsMA6h7Rd4I Modding Tutorial]
|YouTube tutorial video by Jonus. Covers all the basics.
|-
|-
|[https://github.com/Gramps/GodotSteam GodotSteam]
|[https://github.com/Gramps/GodotSteam GodotSteam]
|Tool
|A version of the Godot editor with Steam support built into it.
|A version of the Godot editor with Steam support built into it.
Lets you run Brotato within the editor without getting a ton of Steam-related errors.  
Lets you run Brotato within the editor without getting a ton of Steam-related errors.  
Make sure you read the docs on exporting, [https://gramps.github.io/GodotSteam/tutorials-exporting-shipping.html here].
Make sure you read the docs on exporting, [https://gramps.github.io/GodotSteam/tutorials-exporting-shipping.html here].
|-
|-
|[https://discord.com/channels/630060181086142487/999568046052098109/1000910462986227814 Translations]
|[https://brotato.codemuffin.com/ Attack Speed Calculator]
|Discord message by Aequitas explaining how to do translations.
|Tool
|Enter weapon stats to see the cooldown, as shown in-game.
|-
|[https://github.com/BrotatoMods/Brotato-Wiki-Tools Wiki Tools]
|Tool
|Load into your project to output an items page (eg [[Mod:Extatonion/Items|Extatonion/Items]]). Will be made into a full ''Mod:'' page later.
|-
|[https://docs.godotengine.org/en/stable/ Godot Documentation]
|Info
|Docs for Godot 3.5 (Brotato's version)
|-
|[https://docs.godotengine.org/en/stable/tutorials/ui/bbcode_in_richtextlabel.html Godot bbcode]
|Info
|Docs for using bbcode with Godot (eg. in item descriptions)
|-
|[[Modding Effects|Modding > Effects]]
|Info
|Lists vanilla effects, which can be applied to modded content
|}
|}
{{NavBoxModding}}
<comments />
<comments />

Revision as of 20:51, 28 February 2023

Warning

All modding is currently unofficial, use at your own risk. Anyone can put any code they want in the files shared (including malicious code to hack you) so be careful with what you're downloading and don't download anything that looks suspicious.

Download links are moved to individual mod pages as those pages can only be edited by mod developers. While this does not guarantee safety, it ensures that the download link has not been altered by malicious parties.


Jump to Mod List

Save File

Backups

Before modding your game, make a copy of your save files as it might get corrupted.

  • Go to %appdata%
  • Make copy of "Brotato" folder

Separate Save Files

If you launch a mod through Steam, you can keep using your Steam cloud save and all its unlocks. However, if you launch a mod outside of Steam (eg. by running an EXE directly), a separate save file will be used instead. You can view both at %appdata%\Brotato. The folder with the long numbers contains your Steam save. If you have a folder named "user", that's the folder that gets used if you run the EXE directly. You can copy and paste save data between them if you need to (just be very careful if you do this, as doing this could accidentally overwrite your proper save file, so it's best to keep your main save backed up in a totally separate folder just in case).

FAQs

See Modding FAQs for general questions. See Modding Notes for info specific to modders.

Mod Installation

There is no official Multiple Mod Support at the moment. None of these methods allows running multiple mods in the same game.

Video guide:

Downloading Mods & Setup

  • Make sure to backup your save files.
    • This is an important safety measure, in case a mod unintentionally corrupts your save.
  • Download mods via Mods List table below.
    • The download links are on the individual mod pages.
    • The mod file will have the extension .pck, eg. BrotatoMod.pck.
    • If it's in a ZIP file, you'll need to extract it from the zip first.
  • Open the game's folder.
    • In Steam: Library > Right click on Brotato > Manage > Browse Local Files
  • Make a backup of the vanilla Brotato.pck.
    • Ie. copy and paste it, then rename the copy to Brotato-Vanilla-Copy.pck.
  • Now you're ready to use one of the methods below.

Steam-Browse-Local-Files.png Mod-installation-3-Alt.png

Method 1: Replace Vanilla PCK

This is the simplest method. Uses Steam, so you keep your saves and can unlock achievements.

  1. In the game folder, delete the original Brotato.pck (after making a backup, as above)
  2. Move the mod's .pck file into the game's folder, and rename it Brotato.pck
  3. Run the game from Steam

Method 2: Using Steam Launch Option

This method allows for fast mod switching. Uses Steam.

  1. In Steam: Right click on Brotato > Properties > Launch Options
  2. Add --main-pack modpackname.pck
    • Change modpackname.pck to match the name of any mod's .pck file
  3. Run the game from Steam

Example:

Mod-installation-6.png Mod-installation-1.png Mod-installation-5.png

Method 3: Multiple EXE Files

Lets you run any number of mods quickly. Doesn't use Steam (so no cloud saves/achievements)

  1. In the game's folder, duplicate Brotato.exe (ie. with copy & paste).
  2. Rename the copy to match the mod's .pck file.
    1. You might need to rename the .pck file first, it it already has the name Brotato.pck.
  3. Move the mod's .pck where .exe is
  4. Open the copied .exe.
  5. This way don't have to rename files every time you want to change mods or play vanilla.

Mod-installation-4.png

Method 4: Use Mod:Mod Selector Mod

You can run one script to choose your mod pack easily. Uses Steam.

Learn more here

Method 5: Steam Shortcuts

This is very technical, but once you know what you're doing it's fast and flexible. Uses Steam.

The explanation here is long so it's been hidden behind this toggle button:

Toggle Instructions

  1. A variation on method 3 above is to create (potentially multiple) shortcuts with different launch options, rather than setting a single launch option in Steam.
  2. First, remove any custom launch options currently set in Steam for Brotato.
  3. Get your paths ready:
    1. STEAM_PATH = The absolute path to your Steam EXE (eg: "C:\Program Files (x86)\Steam\steam.exe").
    2. PCK_PATH = The path to (and including) the PCK file.
      • It's easiest to have it in the same folder as Brotato.exe, as this lets you use a relative path.
      • But it can be in a subfolder, or you can use an absolute path. As long as the path is valid, it'll work.
  4. Create a new shortcut (right click > New > Shortcut)
  5. In the location field, enter: STEAM_PATH -applaunch 1942280 --main-pack PCK_PATH (then click Next and name your shortcut)
    1. This means: In Steam, run the game with the ID of 1942280 (which is Brotato), and launch it with the PCK file at the PCK_PATH location.
    2. Examples for the full shortcut path might be:
    3. "C:\Program Files (x86)\Steam\steam.exe" -applaunch 1942280 --main-pack BrotatoSIFD.pck -- if BrotatoSIFD.pck is in the same folder as Brotato.exe
    4. "C:\Program Files (x86)\Steam\steam.exe" -applaunch 1942280 --main-pack MyMods\BrotatoSIFD.pck -- if BrotatoSIFD.pck is in a subfolder called "MyMods"
    5. "C:\Program Files (x86)\Steam\steam.exe" -applaunch 1942280 --main-pack "C:\BrotatoMods\BrotatoSIFD.pck" -- if BrotatoSIFD.pck is in a separate absolute location
  6. If done correctly, this is basically an alternative to method 3 but without having to keep changing the launch options in Steam.
  7. Documentation for Steam's applaunch command line option is here.
  8. Alternatively, you can use the Steam browser protocol and create a new shortcut that targets steam://run/1942280//--main-pack PCK_PATH.
    1. This is shorter than using the full path to Steam, but Steam will show a warning prompt every time to try to run the shortcut.
    2. It also only seems to work correctly with relative paths.

Mod List

The best place to discuss mods is the official Brotato discord's modding channel.

Multi Mods

These mods are combinations of other mods.

Name Author Description Game Version Last Update
YYYY/MM/DD
Download
Duct Tape.png
Modtato
MRCL Combination of Assassin, Starwars, Extatonion, SIFD's Mod, and Multiple Resolutions Mod 0.6.0.7 2022-11-28 Mod:Modtato

Content Mods

These mods are expansions, adding new items, weapons, mechanics and characters to the game.

Tip: Click "Game Version" twice to sort mods by the latest version. Click "Last Update" twice to see which have been updated recently.

Name Author Description Game Version Last Update
YYYY/MM/DD
Download
Assassin.png
Assassin
JuneFurrs Adds some new content with a dark backstory... new characters, weapons, items and even challenges 0.6.1.6 2022-12-29 Mod:Assassin
Dami's mod.png
dami's Overhaul Mod
dami Super upgrades - Legendaries - Burn Overhaul - Atk speed - QoL 0.1.1 (Demo) 2022-09-18 Mod:dami's Overhaul Mod
Mod-damisarsenal-kunai.png
dami's Arsenal
dami Adds 4 weapons 0.6.0.7 2022-10-18 Mod:dami's Arsenal
Extatonion.png
Extatonion
Psina 43 new items
39 new weapons
6 new weapon classes
6 new characters with their own unlocks
7 new upgrades
0.6.1.6 2023-01-07 Mod:Extatonion
Mod-Gemini-logo.png
Gemini
Anti + DireYoshi 3 Characters, 4 ITems, 9 Items, Modifiers 0.1.1 (Demo) 2022-08-02 Mod:Gemini
HalfBakedLogo.png
Half Baked
Zombero 12 New Characters 0.6.1.6 2023-1-21 Mod:HalfBaked
Mod-Invasion Logo.png
Invasion
Darkly77 New content from Space Gladiators:
116 items, 3 weapons, lots more planned
0.6.1.6 2022-12-23 Mod:Invasion
Mod-Isaac-sacred heart.png
Isaac Characters Mod
Psina Adds new content based on The Binding Of Isaac:
6 new characters, 7 new weapons, 13 new items
0.6.0.7 2022-11-28 Mod:Isaac_Characters_Mod
Kaoticmod.png
Kaotic
Resinated Crazy - More Waves - Custom modes 0.5.3c 2022-10-12 Mod:Kaotic
Cog.png
Randomizer + Expansion
+ Hardcore + Babies
Resinated Randomizer + Expansion + Hardcore + Babies 0.1.1 (Demo) 2022-08-22 Mod:Randomizer + Expansion + Hardcore + Babies
Starwars.png
Star Wars Mod
Bioinvasion Adds Star Wars themed weapons, characters, and items. 0.6.0.7 2022-11-26 Mod:Starwars

Balance Overhaul Mods

These mods are balance tweaks, buffing or nerfing some aspects of vanilla game, or adding new ways to affects its balance.

Name Author Description Game Version Last Update
YYYY/MM/DD
Download
Mod-Ahegao.png
Ahegao's Random Spooky Stuff
Spooky Scary Ahegao Wanna play OP version's of Brotato Characters? 0.6.0.7 2022-11-13 Mod:Ahegao's Random Spooky Stuff
Mod-All Starting Weapons.png
All Starting Weapons
Zucker_Schock Adds all available starting weapons to all characters. Random weapon button gives a random weapon from the full selection. Character specific perks taken into account. 0.6.0.7 2022-11-20 Mod:All_Starting_Weapons
Mod-Attract Materials.png
Attraction/Pickup Mods
Zucker_Schock Several Mods aimed at instant pickup and or attraction of materials and or consumables (food+chests). 0.6.0.7 2022-12-03 Mod:Attraction/Pickup_Mods
Cog.png
Cheat Mod
Aequitas, Dex Adds Cheat Menu that can give any item and any weapon 0.6.0.7 2022-11-08 Mod:Cheat Mod
Golden Box.png
Golden Box
D. Adds special Golden boxes that allows you to choose the item you want 0.5.11c 2022-10-27 Mod:Golden Box
Coupon.png
Shoptato
MRCL All items are buyable in the shop, no need to roll! 0.6.0.7 2022-11-07 Mod:Shoptato
Sifd's Relic.png
SIFD's Mod - Rainbow Chest
DireYoshi

JpMitri

Rainbow Chest - Let you choose any item you want.

Game Busters - Advanced Benchmarking software for Potato PCs.

0.8.0.3 2023-02-22 Mod:SIFD's Mod - Rainbow Chest
Tyler.png
Tylers Only Mod
Psina Only Tylers appear in the store. Can you beat the game with only Tylers? 0.6.0.7 2022-11-30 Mod:Tylers Only Mod

Utility Mods

These mods are tools that add new utilities for Brotato client but not to the game itself.

Name Author Description Game Version Last Update
YYYY/MM/DD
Download
Wrench.png
Mod Selector
YourB3stNightmare Script that lets you choose any Brotato .pck file to run the game with. Any 2022-11-25 Mod Selector
Night Goggles.png
Multiple Resolutions Mod
KANA Enables resolutions higher than 1080p, such as 3440x1440 and 2560x1440 0.6.0.7 2022-11-10 Mod:Multiple Resolutions Mod

Modding Tools

These mods are extra resources for modders, or players who want to easily mod in new content.

Name Author Description Game Version Last Update
YYYY/MM/DD
Download
Mod-DebugLoader Icon.png
DebugLoader
Darkly77 Edit a JSON file to set debug options (starting weapons, items, materials etc).
Can be used to share custom challenges
0.6.1.6 2022-12-23 Mod:DebugLoader
Herbloader.png
HerbLoader
Anotic Create custom characters with a JSON file and PNGs.
No custom code needed.
0.6.0.7 2022-11-11 Mod:Herbloader

Mobile Mods

APKs for Brotato on Android.

Name Author Description Game Version Last Update
YYYY/MM/DD
Download
Wandering Bot.png
Brotato Mobile
Maximal08 Mobile version of Brotato for Android. 0.5.11 2022-11-06 Mod:Brotato Mobile
My mod icon.png
Brotato Mobile by ZBEP
ZBEP Mobile version of Brotato for Android with support for Steam mods. 0.8.0.3 2023-02-24 Brotato Mobile by ZBEP

Restoring Vanilla

If you accidently remove your original Brotato.pck file:

  • Go to Steam > Library > right click on Brotato > Properties > Local Files > Verify integrity of game files...

This will fix your game and bring it back to vanilla.

Modding-restore-vanilla-1.png Modding-restore-vanilla-2.png

Vanilla Files List

You can download older Brotato.pck files here.

Game Version Download
0.6.1.6 Mod:Patch 0.6.1.6
0.6.0.7 Mod:Patch 0.6.0.7
0.5.11c Mod:Patch 0.5.11c
0.1.1 (Demo) Mod:Demo 0.1.1

Links & Resources

Link Type Info
Brotato Discord Server Discord See the #modding channel
Modding Tutorial Guide YouTube tutorial video by Jonus. Covers all the basics.
Translations Guide Guide Discord message by Aequitas explaining how to do translations.
GDRE Tools Tool Godot Decompiler. Required for modding. Has either a GUI or CLI.
GodotSteam Tool A version of the Godot editor with Steam support built into it.

Lets you run Brotato within the editor without getting a ton of Steam-related errors.

Make sure you read the docs on exporting, here.

Attack Speed Calculator Tool Enter weapon stats to see the cooldown, as shown in-game.
Wiki Tools Tool Load into your project to output an items page (eg Extatonion/Items). Will be made into a full Mod: page later.
Godot Documentation Info Docs for Godot 3.5 (Brotato's version)
Godot bbcode Info Docs for using bbcode with Godot (eg. in item descriptions)
Modding > Effects Info Lists vanilla effects, which can be applied to modded content
Modding [T]
Wiki Modding  •  Notes  •  Effects  •  Vanilla Items
Godot Download  •  Docs  •  GDRETools  •  GodotSteam  •  Jonus' Tutorial
Misc BrotatoMods  •  Cooldown Calculator
Loading comments...