Dragonyck-Synergies icon

Synergies

A highly configurable item Synergy mod. V2 with new SynergyAPI.

Last updated 2 years ago
Total downloads 64815
Total rating 10 
Categories Mods Player Characters Items
Dependency string Dragonyck-Synergies-2.0.3
Dependants 30 other packages depend on this package

This mod requires the following mods to function

tristanmcpherson-R2API-4.0.11 icon
tristanmcpherson-R2API

A modding API for Risk of Rain 2

Preferred version: 4.0.11
bbepis-BepInExPack-5.4.1902 icon
bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.1902

README

Preview

Preview1 Preview2 Preview3

Info

This mod adds new expansion, custom UI elements, interactable, inventory, survivors and items.

  • The expansion allows players to easily disable and enable the mod with no hassle. It'll be in the character selection, under the Expansions tab.
  • The Synergy Cube spawns after you defeat the stage boss. It is the only way to acquire the synergies. Once interacted with it will grant all players the available synergies.
  • The exclusive item inventory was created to prevent cluttering the original, so that only the Synergy items show up on it.
    • It'll only show up if you have a Synergy item.
    • By default it shows up at all times, but there's a config for enabling it only when you have the scoreboard up.
  • The synergies have two required items, with the exception of two unique synergies.
    • You can set which items are used for the synergy and also the amount of items required for the synergy.
  • Survivors added by the items can be selected on character select by enabling it in the respective item's config entry.
  • There two new commands that can be used. I added them to help me debug things faster, but you can cheat if you want. Can also be useful if something goes wrong and the interactable doesn't spawn.
    • Commands: spawn_synergy, give_synergy_all
  • Synergies V2 has a streamlined process for Synergy addon creation. Check the section below.
    • New commands have been added to help with this process.
    • Commands: synergy_list, synergy_addon_list

Synergies

Synergy List

Icon Name blankSynergy blank​​​​​blank​​​​​blank Effect
syn1 Golden Horseshoe item1plusitem2 Dash forward every 3 seconds while sprinting.
syn2 Power Cell item3plusitem4 Add +1 charge of your Special Skill.
syn3 Reinvigorating Spore item5plusitem6 While standing still for 1 second, gain +40 armor.
syn4 Iridescent Pearl item7plusitem8 All skill cooldowns are reduced by 20%.
syn5 Famished Fangs item9plusitem10 Dealing damage heals you for 5% of the damage dealt.
syn6 Peace Flag item11plusitem12 Leaving combat heals you for 25 health.
syn7 Fungal Pigments item6plusitem13 Healing past full grants you a temporary barrier for up to 25% of your max health.
syn8 Adrenaline Shot item1plusitem14 3% chance to gain Adrenaline for 3 seconds on hit. Adrenaline: Dodge attacks while sprinting.
syn9 Serrated Dirk item15plusitem16 Bleeds have their full damage applied instantly with an additional 50% damage.
syn10 Soul of a Sacrificed Remnant item17plusitem18 Kills reset equipment cooldown.
syn11 Corrupted Perforator item19plusitem20 Every 30 seconds, summon a Malachite Magma Worm with bonus 300% damage, 100% health and 50% size.
syn12 KDR-V1 item1plusitem12 Sprinting out of combat grants Charge. Charge: ram an enemy to deal 200% damage. Damage scales with movement speed.
syn13 Blazing Boots item1plusitem21 Sprinting leaves a trail of fire that deals 10% DOT. Damage scales with movement speed.
syn14 Spiked Shield item22plusitem23 Taking damage while you have a barrier, retaliate for 100% of the damage received. Scales with total barrier percentage.
syn15 Molotov item24plusitem21 5% chance on hit to burn for 10% damage for 5 seconds.
syn16 Observer's Relic item25plusitem26 All healing received recharges regenerating shields.
syn17 Crystalized Mycelium item27plusitem6 After standing still for 1 second, create a DOT zone on your location for 12 seconds that deals 50% damage.
syn18 Lost Tibbers item28plusitem29 10% chance to resurrect on fatal death.
syn19 Arc Reactor item30plusitem21 When a shield breaks, detonate for 150% damage. Enemies hit have their shields broken.
syn20 Omar's Wallet item31plusitem32 Dealing damage to enemies that are marked for death, grants gold for up to 10% of the damage dealt.
syn21 Pridwen's Shard item27plusitem22 Gain a temporary barrier for each nearby enemy every 1.5 seconds.
syn22 War Plans item33plusitem34 Activating your equipment resets all skill cooldowns.
syn23 Moon Jellie item17plusitem35 Activating your equipment spawns a Moon Jellie with a random aspect.
syn24 M.O.A.B. item36plusitem37 While under the effects of a Warbanner, blast attacks gain +10 radius.
syn25 Eye of the Beholder item38plusitem39 Become a Tyrant.
syn26 Faded Crown blank​​​​​item40 Become King of Nothing.

Synergy Addon Creation

Synergies V2 now has a streamlined Synergy item creation process, allowing you to easily add your very own Synergy.

I've named custom Synergy items, Synergy Addons. They can be easily created with a simple method: SynergyItemBase.CreateSynergyAddon().

This method creates a SynergyDef, which contains information on your Synergy item and required items. The SynergyDef is then used to check if the player inventory has the required items and then give the Synergy item.

But all you have to do is:

  • Set Synergies as a BepIn HardDependency and obviously add a reference to the Synergies dll in your project.

  • Use the method for Synergy creation:

new SynergyItemBase()
{
    ItemName = "My Item Name",
    ItemLangTokenName = "DRAGON_ITEMTEST", // Make sure you create a very unique token name to avoid conflicts with other addons.
    ItemFullDesc = "My Item is good because my item is great.",
    //useCustomDesc = true, // Add this line if you wanna add your custom description. By default it's set to false, and the mod automatically creates the description.
    RequiredItems = new List<Tuple<string, int>>// Here you can add as many items as you need. Use only their code names, also works with modded items.
    {// Tuple.Create("ItemCodeName", RequiredStacks)
        Tuple.Create("AlienHead", 1),
        Tuple.Create("ArmorPlate", 1),
        Tuple.Create("ArmorReductionOnHit", 1),
    }
}.CreateSynergyAddon();

*Created items will have the prefix "ITEM_SY_ADDON_" on all language tokens.

  • After that you gotta code your item function. *Please don't ping me on this, I'll not help you work out your item. Ask for help in #item-creation instead.

  • The SynergyCatalog class has methods to help find SynergyDefs.

    • SynergyCatalog.GetSynergyDefList(), SynergyCatalog.GetSynergyDefByName(), SynergyCatalog.GetSynergyDefBySynergy()

Installation

R2modman is recommended.

Manual:

1 - Download and install BepInExPack and R2API

2 - Extract the "Synergies" dll to your plugins folder

3 - Have fun!

Support Me

If you like my mods and would like to support my work, consider buying me a coffee:

kofilogo

Special Thanks

  • Voidmaster
  • FongkeLYJ
  • MuugiBoy
  • FATisAcrime
  • LucaTheSammich
  • IAmTheChezz
  • EnderGrimm

A lot of these cool item ideas are thanks to them.

Would like to contribute? Check out the Thread Synergies in #item-creation

Changelog

2.0.3

  • R2API Update fixes.

2.0.2

  • RoR2 Update fixes.

2.0.1

  • Updated to the latest update updated update.

  • Fixed Power Cell.

  • Improved Void Item check.

  • Greatly reduced Beholder Primary proc coefficient.

  • Improved Beholder Utility hitbox.

2.0.0

  • Complete rewrite of the Synergy system.

  • Moon Jellies now have a configurable duration.

  • Synergy cube no longer plays the effect or sends a message if you didn't receive a Synergy.

1.1.1

  • Added a buff timer to inform when Golden Horseshoe is on CD.

  • Golden Horseshoe now activates by pressing a configurable button.

  • Fixed Synergy Cube spawning in Bazaar even if the expansion is off.

1.1.0

  • Added an instant synergy after a Boss wave ends on Simulacrum.

  • Added a Synergy Cube in Bazaar for the cost of 5 coins.

  • Synergy Cube now spawns after killing Mithrix.

  • Fixed synergy cube idle sound playing after reentering the stage.

1.0.3

  • Fixed M.O.A.B.

  • Fixed false positive errors while transforming.

  • Possible fixes for Cube failing to find nodes to spawn on.

  • Fixes for Beholder transform.

  • Synergy Cube no longer spawns after killing Alloy Worship Unit.

  • Fixed Synergy Cube not spawning sometimes. Now it'll spawn right on top of the teleporter to prevent it not finding a node to spawn on.

1.0.2

  • Temporarily disabled M.O.A.B. while I fix some issues.

1.0.1

  • Fixed missing R2API submodule dependency.

1.0.0

  • Release