LTOWFruitSaloonMod

Howdy, Pardner

Ain't any o' y'all gettin' thirsty?

In that case, I would recommend to you Wormtown's very fine Fruit Saloon. Ya can find it at the far end o' town, can't miss it, and it's got a big ol' juice press inside that can press Cactus Fruits into a filled bottle of Fruit Juice. That stuff's not only delicious, but also extraordinarily healthy, I tell ya.

Now, heh, that brings back memories... We used to throw birthday parties, hootenannies, and even a wedding every few years, right in that there saloon. Luckily it's a spacious building, sturdy too, so I trust you'll feel quite safe in there. Just make sure you don't become like a mouse in a trap, and hightail it outta' there if a worm starts poundin' on the walls.

Now hurry, ya got a train to catch...
- Gilbert

The Mod

Introduction:

Are you ready for Wormtown to get an extra building? Well, this mod adds a brand-new Saloon to Wormtown's- uh... town!

The saloon is a bigger and stronger building that lets pardners hide inside and gather resources like other buildings, but most importantly lets them bring in Cactus Fruits, jam them into the juice press, and get a bottle of Fruit Juice for their efforts. This juice is strong stuff that will heal more HP than all necessary fruits could have combined, and it can even increase your total health and stamina!

So whaddaya waiting for? Git out there 'n wrangle up some fruits, cuz that juice ain't gonna press itself!

Customization:

Want to push through even greater risks for even greater rewards? Or want to carry your selected settings over between play sessions?
A handful of configurable options allows you to change the functionality of the Fruit Saloon and Fruit Juice to whatever you want!

9 options are included:

• [Spawn Saloon]
  • Whether to spawn a Fruit Saloon in the next match at all.
• [Fruit Required Difficulty]
  • How big a percentage of spawned Cactus Fruits are necessary to press one bottle of Fruit Juice.
• [Custom Fruit Required]
  • If config [Fruit Required Difficulty] is set to Custom, set specifically how many Cactus Fruits are necessary to press one bottle of Fruit Juice.
• [Juice Heal Amount]
  • How much HP one bottle of Fruit Juice will heal to the pardner who drinks it.
• [Juice Digestion Penalties]
  • How much longer it takes for the Heart Jar to spawn of eaten players who drank Fruit Juice, using the vanilla Digestion Per Fruit match setting.
• [Juice Overhealing]
  • Whether or not a bottle of Fruit Juice can heal a pardner past their maximum HP, and if it can be drank at all while at full HP.
• [Enable Settings Panel]
  • Whether the in-game Match Settings menu in the lobby will get an extra panel to let you customize the above settings from within the lobby.
• [Save Selected Settings]
  • Whether your custom settings from config [Enable Settings Panel]'s menu will be saved to your Thunderstore configs, to immediately load them next time you play.

Creation:

• This is intended as my first big proper mod for this game, partially because I wanted to move to bigger things, partially because I made it as a college project.
  • In the beginning, I intended this mod to be an Objective mod (like fueling the train or finding the train key), but as the idea started to take shape, it became clear that converting resources to get something new didn't really fit an objective, where you would only be spending resources without anything in return as a reward.
  • But! Having a place on the map where you can get a special resource, being silly-cowboy themed, and it being a building at all, made it a very logical idea as a utility building that could spawn on the map, in the same manner as the church and quarry. So, from there on out, I made this as an extension to the rules established by those other two buildings.
• Something that was a bigger challenge, however, was balancing the Fruit Juice's risk versus reward, or input versus output.
  • I'd heard that Cactus Fruits were already overpowered in the past, so a better version of them would only be even more tilted in the pardners' favor. I think I landed on a fine balance right now, but just in case...
  • This is where the customizable settings came into existence, starting with the amount of fruit required to create one bottle of juice. Once I figured out how to hook the selected setting up to changes in-game, I made almost all other variables customizable settings too, so that any combination of settings could hopefully fit any group of players.
  • And I wanted to keep this as diegetic as possible within the game, which is why I made/recreated a Match Settings panel. One, because I already had some experience with adding menu settings from the Objective-prototype. Two, because it would hopefully make editing the settings feel natural and encourage people to experiment. Three, because I could then just hook them up to BepInEx's config files and have the two be interchangeable. And four because it just looks so hecking satisfying heheheh...

Credits:

• I didn't get any direct help per se, but the shift from an objective to a utility building was done at the suggestion and feedback of people from the Wormtown modding Discord server, so thank you to them for helping shape this mod into what I now think was the better direction to move in.
• But I do want extend a thanks to the Get(Color) Games devs, as just looking at this game's code and components in decompilers helped me learn about Unity's UI and NetworkVariables, which will undoubtedly (read: "hopefully") be great tools to have under my belt too, so their work helped me learn more programming than my college still has over the past years.
• And thank you for checking out or even downloading this mod!

v1.0.0

• Release