We recommend using the Thunderstore Mod Manager or an alternative for installing mods
You can contact me in the RoR2 modding discord as @Phedg1 Please note: I do not accept friend requests unless we have a mutual server. If you are a fan of my work and would like to support me, I now have a DONATION LINK. The SOURCE CODE for this project is now available.
My mods would not be possible without the amazing core developers who made and maintian BepInEx and R2API. The tools they have created, as well as their forthcoming support in the modding discord, made all the difference in the world. If you have chosen to donate to me, I would ask that you also consider donating to them. None of this would be possible without them.
This mod will allow players to use a GUI to select which items will be given to them at the start of a run. There are 4 modes: Free, Earnt Persistent, Earnt Consumable and Random. Works in both singleplayer and multiplayer (if the host and the client have the mod installed, enabled and are using the same mode. NOTE: Each client has to select their own items).
This mod was inspired by features in other roguelike games such as Undermine, Dungreed and Dead Cells. The goal was to give a returning player a sense of progression, to give them a boost to make them more formidable the more they play.
The main menu will have a new button labelled "Starting Items". Clicking it will open up the shop interface. Every item and piece of equipment that has been unlocked (completed the requisite achievement) and discovered (been picked up at least once) will be listed here, alongside how many times it has been purchased. To purchase an item or piece of equipment, left click it. The same item can be purchased multiple times. To sell an item or piece of equipment, right click it. Four buttons, labelled "Earnt Consumable", "Earnt Persistent", "Free" and "Random" are displayed on the top left of the interface. Clicking these will allow the player to change the mods mode. The differences of these four modes are detailed below. Another three buttons, labelled "Profile: 1", "Profile: 2" and "Profile: 3", are displayed in the top right of the interface. Clicking these will allow the player to change the current item loadout. Buying an item in one profile does not affect the others, this is so a player could configure each profile differently to easily switch between them between games. Each of the 3 profiles is unique to each mod mode. This mod can be enabled and disabled from this menu, should the player wish to play normally again. When a game begins the items from the currently selected mod mode and profile will be spawned into the players inventory.
** EARNT CONSUMABLE MODE ** Items in the shop interface will have a price associated with them. Buying an item will cost credits, selling an item will refund the full amount of credits. When a game is played while this mode is active the credits that were spent on items will be used up and consumed. The current profile will also have its items removed, they will have to be purchased again with the players remaining credits if they want to be spawned again in subsequent games.
** EARNT PERSISTENT MODE ** Items in the shop interface will have a price associated with them. Buying an item will cost credits, selling an item will refund the full amount of credits. When a game is played while this mode is active the credits that were spent on items will NOT be used up and consumed. The purchases will persist between games, as a kind of permanent upgrade to the players character.
** FREE MODE ** Items in the shop interface will have no price, they can be purchased as many times as the player wishes. The purchases will persist between games and will not be reset.
** RANDOM MODE ** Items in the shop interface will have a price associated with them and an arbitrary number of credits are allocated in this mode. When a game is played, all the credits will be spent on a random assortment of items. Every game will have different items.
Credits will be earnt regardless of the current mode of the mod.
** BOSS MODE ** Players will earn credits for defeating endgame bosses. The amount of credits awarded per boss kill will vary based on the game's difficulty. Supported bosses in this mode are the: Lunar Scavanger and Mithrix.
** STAGE MODE ** Players will earn credits for every stage they have cleared. The amount of credits awarded per stage cleared will vary based on the game's difficulty and how it ended (win, loss, obliteration, limbo).
** ENDING MODE ** Players will earn credits for finishing games. The amount of credits cleared will vary based on the game's difficulty and how it ended (win, loss, obliteration, limbo).
After a player has opened the item shop interface for the first time a number of configuration files will be created. These can be found at "<RISK OF RAIN 2 INSTALL LOCATION>/Risk of Rain 2/BepInEx/config/" and "<RISK OF RAIN 2 INSTALL LOCATION>/Risk of Rain 2/BepInEx/config/Starting Items GUI/". If you desire to alter the configuration of the mod it must be done by editing these files. The intention is that this would only be necessary once, with the rest of the player's interactions being done through the shop interface inside the game itself.
** com.Phedg1Studios.StartingItemsGUI.cfg ** This file contains all of the settings which persist between profiles. It stores the whether the mod is currently enabled or disabled, the mode the mod is currently using and whether all items (including items which have not been unlocked) should be listed. Prices for all 8 tiers of items (common, uncommon, rare, boss, lunar, equipment, lunar equipment and elite equipment) are read from this file. The amount of credits awarded for killing boss monsters are here. The 7 credit reward multipliers for the Earnt Persistent mode (default, win, loss, obliteration, easy, normal and hard) are here also, as well as the 6 credit reward multipliers for the Earnt Consumable mode (win, loss, obliteration, easy, normal and hard).
** <PROFILE ID>.txt ** This is the record of what items and equipment the player has chosen to use in the different modes and profiles, as well as any currency that has been earned and a few internal varialbes to improve the user experience, so that they can persist after the game has been closed.
To prevent half finished and buggy items from the base game from appearing in the Starting Items menu, every item that has either no tier, no icon or the defualt purple exclamation mark icon are filtered out. If custom items have a proper icon but are still not showing up, feel free to contact me in discord.
** Icon Design ** Ben C.
** Education ** Ebkr, Harb, iDeathHD
** Supporters ** G1bble
** Support, Suggestions, Beta Testing and Bug Reports ** blazingdrummer Argent, Beaker, Borst, breadguy, Cookiefox, dfauci, DoctorPepper, ffrig, Galxy, Goldair1, Gridalien, hugglesthemerciless, Hypro, IB, KingEnderBrine, Kinggrinyov, McFow1er, Nathanel, NetherCrowCSOLYOO, Nik, themostinternet, Zarko
** v1.2.4 **
** v1.2.3 **
** v1.2.2 **
** v1.2.1 **
** v1.2.0 **
** v1.1.13 **
** v1.1.12 **
** v1.1.11 **
** v1.1.10 **
** v1.1.9 **
** v1.1.8 **
** v1.1.7 **
** v1.1.6 **
** v1.1.5 **
** v1.1.4 **
** v1.1.3 **
** v1.1.2 **
** v1.1.1 **
** v1.1.0 **
** v1.0.0 **
Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.
|Upload date||Version number||Downloads||Download link|