From Brotato Wiki

(add section: Characters with Negative Stats)
(Translations: Add mini guide from Discord)
Line 128: Line 128:
==Translations==
==Translations==


The Discord user Aequitas explains how to do translations [https://discord.com/channels/630060181086142487/999568046052098109/1000910462986227814 here].
Mini guide by Aequitas ([https://discord.com/channels/630060181086142487/999568046052098109/1000910462986227814 source on Discord]):
 
# Create your CSV translation file
# Drag it into your project's file system
# Select the Import tab and click ''reimport'' -- the ''.en.translation'' files should be created
# Go to Project > Project Settings > Localization (tab)
# Click add, and add your ''custom.en.translation'' file


== Multi Mod ==
== Multi Mod ==

Revision as of 01:58, 23 December 2022

< Back to Modding


This page has notes that modders may find useful.


Apps

Decompile

To decompile Brotato for modding, use GDRETools, which can be downloaded here.

Godot

You'll need to download Godot to edit the decompiled project. Jonus has an excellent video here that covers the basics of modding, and will show you how to customise weapons and characters, and change item appearances. You can also read the documentation for Godot here.

Steam Errors

The standard version of Godot will have lots of errors related to the Steam API when you try to run it via Godot, due to it lacking inbuilt support for Steam's SDK. Instead, you can use an alternate version of Godot that has been compiled to include Steam support, called GodotSteam. Make sure you read GodotSteam's docs on exporting, because there are some limitations and caveats (eg. you can't use the "Export with Debug" option, and you need to set up your export templates manually).

Balancing

When balancing new items, the vanilla Items list is a great point of reference for their costs and effect strength. Sorting by tier can also be very helpful, as it shows where there might be gaps in vanilla's base items.

Characters with Negative Stats

If you're creating an effect that converts one negative stat to a different positive one (like Retromation's Hoodie.png Retromation's Hoodie), keep in mind that many Characters start with huge decreases to certain stats:

Negative stat characters
Character Negative Stats Value
Brawler Range -50
Ranged Damage -50
Crazy Dodge -30%
Mage Ranged Damage -100
Melee Damage -100
Engineering -50
Chunky Life Steal -100
Lucky Attack Speed -60%
Mutant Items Price -50%
Loud Harvesting -95% (-3 per wave)
Pacifist Damage -100%
Engineering -100
Saver Items Price -50%
Sick HP Regeneration -100
Ghost Armor -100
Speedy Armor while standing still -100
Artificer Damage -100%
Masochist Damage -100%

Item Costs

Item costs for each tier in vanilla are as follows:

Tier Min Max
Tier 1 12 30
Tier 2 48 65
Tier 3 65 85
Tier 4 80 120

Effects

See Modding Effects for a list of all the effects available in vanilla.

Translations

Mini guide by Aequitas (source on Discord):

  1. Create your CSV translation file
  2. Drag it into your project's file system
  3. Select the Import tab and click reimport -- the .en.translation files should be created
  4. Go to Project > Project Settings > Localization (tab)
  5. Click add, and add your custom.en.translation file

Multi Mod

If you're building a mod, creating it to work with dami's Multi Mod might be worth considering. It lets you add your mod pack to any compatible mod (eg. Invasion/dami's Arsenal). It lets you create custom characters, weapons, and items, and release your mod as a small standalone file (usually <3mb).

The only caveat is that you can't touch vanilla code, and can't currently add new weapon classes or challenges.

Weapon Cooldowns

Calculating the displayed cooldown text is tricky. The formula for Ranged weapons is easy to calculate, but the Melee formula is complex and takes many things into consideration. For this reason, Darkly77 made an cooldown text calculator, here:

Cooldown Calculator

GitHub

There's a GitHub organisation for Brotato repos here. It is maintained by Darkly77, KANA, and dami, who are all active on the Space Potatoes Discord.

It's not recommended to host a full Brotato project on GitHub, because you'd be making all of Brotato's source code public. But you can host just your modded files (eg Darkly77's Invasion), or even just host the downloads for your mod (eg. KANA's mod releases)

Hosting your downloads on GitHub has a few advantages:

  • You can create versioned README and CHANGELOG files to track your mod's changes.
  • You can create separate releases, which track the release date.
  • You can view download stats with this tool.
Modding [T]
Wiki Modding  •  Notes  •  Effects  •  Vanilla Items
Godot Download  •  Docs  •  GDRETools  •  GodotSteam  •  Jonus' Tutorial
Misc BrotatoMods  •  Cooldown Calculator