[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12,"_13":14},"actionData","errors","root",{"_226":227,"_228":-7,"_229":230,"_25":231},"c/Community",{"_66":210,"_25":211},"p/packageListing",{"_66":67,"_68":69,"_70":-7,"_71":72,"_57":-7,"_73":20,"_74":22,"_75":24,"_25":76},"wikiLayout",{"_15":56,"_19":20,"_21":22,"_23":24,"_40":-7,"_57":-7,"_25":58},"p/tabs/Wiki/WikiFirstPage",{"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26},"wiki",{"_37":48,"_35":49,"_40":50,"_42":51,"_44":52,"_53":54},"firstPage",{"_37":38,"_35":39,"_40":41,"_42":43,"_44":45,"_46":47},"communityId","riskofrain2","namespaceId","Goorakh","packageId","Quality","seo",{"_27":28},"descriptors",[29,30],{"_35":36},{"_31":32,"_33":34},"name","description","content","Wiki page for Goorakh-Quality","title","Mod Compatibility - Goorakh-Quality | Thunderstore","id","4649","Mod Compatibility","slug","4649-mod-compatibility","datetime_created","2026-01-24T16:11:42.923278Z","datetime_updated","2026-01-24T16:11:42.923297Z","markdown_content","# Adding Quality for modded items or equipment\n\n## Important types\n\nBefore we can get into adding items, you should know about a few types commonly used by Quality.\n\n### [QualityTier](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ItemQualities/Assets/ItemQualities/Scripts/QualityTier.cs)\nAn enum for all the quality tiers added by the mod, frequently used for interfacing with the [QualityCatalog](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ItemQualities/Assets/ItemQualities/Scripts/QualityCatalog.cs).\n\n### [ItemQualityGroup](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ItemQualities/Assets/ItemQualities/Scripts/ItemQualityGroup.cs)\nContains all quality versions of an item for easy access, typically consisting of a base item reference and 4 auto-generated ItemDefs. You can think of it like an `ItemDef` that represents every quality version of an item simultaneously. Also has an `ItemIndex` equivalent of [ItemQualityGroupIndex](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ItemQualities/Assets/ItemQualities/Scripts/ItemQualityGroupIndex.cs).\n\n### [ItemQualityCounts](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ItemQualities/Assets/ItemQualities/Scripts/ItemQualityCounts.cs)\nThis helper struct contains an item count for every item in a quality group, used in place of an `int` item count for things like the `GetItemCountsEffective` extension method for `Inventory`.\n\n### [QualityCatalog](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ItemQualities/Assets/ItemQualities/Scripts/QualityCatalog.cs)\nThis is the main catalog for the mod, it contains all quality groups and mappings of items/equipment to `QualityTier`s.\n\nA common use-case is using it to convert a `ItemIndex`/`PickupIndex` into a specific `QualityTier`. This is done via the `GetItemIndexOfQuality`/`GetPickupIndexOfQuality` methods respectively, these return either the given item or pickup index as a certain quality, *or* the base item/pickup index if that quality isn't registered for it. It will *not* return an invalid index (assuming a valid index was given to begin with).\n\n## Language tokens\n\nAnother important thing you should be aware of is how languages tokens are handled by Quality. Tokens are mostly auto-generated in the format: `ITEM/EQUIP_[ItemName]_[QualityTier]_NAME/DESC/PICKUP`. So for example the description token for Rare Backup Magazine is `ITEM_SECONDARYSKILLMAGAZINE_RARE_DESC`.\n\nFor pickup and description tokens, you can use `{0}` to insert the base description or pickup string, if you only need to add some more text to the start or end of a description/pickup string to describe your quality effect:\n```\n\"ITEM_SECONDARYSKILLMAGAZINE_RARE_PICKUP\": \"{0}\\n Chance to immediately recharge your Secondary skill.\",\n\"ITEM_SECONDARYSKILLMAGAZINE_RARE_DESC\": \"{0}\\nActivating your Secondary skill has a 25% (+25% per stack) chance to immediately recharge it.\",\n```\n\n### Sprites\n\nQuality adds a couple inline sprites you can use in most text displayed in the game.\n\n| Sprite | Usage |\n| ------ | ----- |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityDiamond.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityUncommon.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityRare.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityEpic.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityLegendary.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityUncommonConsumed.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityRareConsumed.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityEpicConsumed.png?raw=true) | |\n| ![](https://github.com/Goorakh/RoR2_ItemQualities/blob/main/ThunderstoreContent/QualityLegendaryConsumed.png?raw=true) | |\n\n## Adding Quality Items\n\nAdding Quality versions of your own modded items is done via the `QualityContentManager` class. To register your mod in the initialization, subscribe to the `QualityContentManager.LoadContentAsync` event.\n\n```\ninternal static class QualityCompat\n{\n static ItemQualityGroup ExampleItemGroup;\n\n [MethodImpl(MethodImplOptions.NoInlining | MethodImplOptions.NoOptimization)]\n public static void Init()\n {\n QualityContentManager.LoadContentAsync += loadContent_Basic;\n\n RecalculateStatsAPI.GetStatCoefficients += RecalculateStatsAPI_GetStatCoefficients;\n }\n\n private static IEnumerator loadContent_Basic(QualityContentLoadArgs args)\n {\n ExampleItemGroup = args.CreateItemQualityGroup(QualityCompatTesterPlugin.Instance.ExampleItem);\n yield break;\n }\n\n private static void RecalculateStatsAPI_GetStatCoefficients(CharacterBody sender, RecalculateStatsAPI.StatHookEventArgs args)\n {\n if (sender.inventory)\n {\n ItemQualityCounts exampleItem = sender.inventory.GetItemCountsEffective(ExampleItemGroup);\n\n args.armorAdd += (10 * exampleItem.UncommonCount) +\n (30 * exampleItem.RareCount) +\n (50 * exampleItem.EpicCount) +\n (100 * exampleItem.LegendaryCount);\n }\n }\n}\n```\n\nIn this example the base ItemDef is created through code in Awake, but these coroutines are run during `LoadStaticContentAsync`, so you can yield wait until your asset bundle is loaded before creating your item group(s).\n\nQuality will automatically generate all assets needed for your item to have quality variants. But you can also assign the individual quality `ItemDefs` by using the `SetItemDef` method on the `ItemQualityGroup` if you need more control over how the `ItemDef` is created, but note that this means Quality will hand every part of initialization off to you, meaning you will have to populate the item yourself and also add it to a content pack.\n\nVoid item relationships are automatically handled if given an item that is part of a void corruption pair.\n\n### **IMPORTANT:**\nIf you're using a class like above, with fields that use types in the Quality assembly, you need to take a few extra steps in order to have soft compatibility. The big rule you must follow is that no method that contains any reference to your type(s) with these fields can be executed before you have confirmed Quality is present in the current domain.\n\nSo for example this:\n```\nvoid Awake()\n{\n if (BepInEx.Bootstrap.Chainloader.PluginInfos.ContainsKey(ItemQualities.ItemQualitiesPlugin.PluginGUID))\n {\n QualityCompat.Init();\n }\n}\n```\nWill *not* work because the type is scanned by the runtime regardless of if the `Init` method its actually executed or not. Instead, you must do something like this:\n```\nvoid Awake()\n{\n if (BepInEx.Bootstrap.Chainloader.PluginInfos.ContainsKey(ItemQualities.ItemQualitiesPlugin.PluginGUID))\n {\n qualityCompatInit();\n }\n}\n\n[MethodImpl(MethodImplOptions.NoInlining | MethodImplOptions.NoOptimization)]\nstatic void qualityCompatInit()\n{\n QualityCompat.Init();\n}\n```\nThis prevents the runtime from trying to initialize your type unless its absolutely okay to do so. This pattern has to be used anywhere you reference your Compat type (assuming it has the Quality typed fields).\n\n## Adding Quality Equipment\n\nNot yet.\n\n# Contact\nIf you think something here is not covered well or at all, please contact me at `gorakh` (Gorakh#0821) on Discord.","2507","Goorakh/Quality Wiki","2507-goorakhquality-wiki","2026-01-24T16:11:42.915920Z","2026-01-24T16:11:42.924796Z","pages",[55],{"_37":38,"_35":39,"_40":41,"_42":43,"_44":45},{"_37":48,"_35":49,"_40":50,"_42":51,"_44":52,"_53":64},"permissions",{"_27":59},[60,61],{"_35":63},{"_31":32,"_33":62},"Wiki for Goorakh-Quality","Goorakh-Quality Wiki | Thunderstore",[65],{"_37":38,"_35":39,"_40":41,"_42":43,"_44":45},"community",{"_31":129,"_105":20,"_192":193,"_32":194,"_195":196,"_197":198,"_42":199,"_200":201,"_202":203,"_112":-5,"_204":205,"_206":207,"_208":209},"listing",{"_108":109,"_73":20,"_32":97,"_110":111,"_112":95,"_113":114,"_115":114,"_116":114,"_31":24,"_117":22,"_118":119,"_120":121,"_122":123,"_124":125,"_126":127,"_128":129,"_130":131,"_132":133,"_134":135,"_136":137,"_138":139,"_71":140,"_141":142,"_143":144,"_145":146},"listingStatus","team",{"_105":106,"_31":22,"_107":-5},"community_identifier","namespace_id","package_id",{"_27":77},[78,79,80,81,82,83,84,85,86,87],{"_35":104},{"_31":32,"_33":97},{"_88":102,"_33":103},{"_88":100,"_33":101},{"_88":98,"_33":99},{"_88":96,"_33":97},{"_88":94,"_33":95},{"_88":93,"_33":92},{"_88":91,"_33":92},{"_88":89,"_33":90},"property","og:site_name","Thunderstore","og:image:height","256","og:image:width","og:image","https://gcdn.thunderstore.io/live/repository/icons/Goorakh-Quality-0.8.1.png","og:description","Boss Items update! Adds quality variants of items. Open Beta Release.","og:title","Quality by Goorakh","og:url","https://thunderstore.io/c/riskofrain2/p/Goorakh/Quality/wiki","og:type","website","Quality by Goorakh | Risk of Rain 2 | Thunderstore","identifier",4334,"donation_link","categories",[172,173,174,175,176],"download_count",219083,"icon_url","is_deprecated",false,"is_nsfw","is_pinned","namespace","rating_count",26,"size",9261579,"latest_version_number","0.8.1","install_url","ror2mm://v1/install/thunderstore.io/Goorakh/Quality/0.8.1/","download_url","https://thunderstore.io/package/download/Goorakh/Quality/0.8.1/","community_name","Risk of Rain 2","dependant_count",10,"dependencies",[149,150,151,152],"dependency_count",14,"full_version_name","Goorakh-Quality-0.8.1","has_changelog",true,{"_31":22,"_147":148},"website_url","https://github.com/Goorakh/RoR2_ItemQualities","package_created","2025-12-23T00:35:09.856810Z","version_created","2026-08-29T23:28:41.866502Z","members",[],{"_73":20,"_32":168,"_112":169,"_155":139,"_31":170,"_117":157,"_158":171},{"_73":20,"_32":164,"_112":165,"_155":139,"_31":166,"_117":157,"_158":167},{"_73":20,"_32":160,"_112":161,"_155":139,"_31":162,"_117":157,"_158":163},{"_73":20,"_32":153,"_112":154,"_155":139,"_31":156,"_117":157,"_158":159},"API for adding custom deployables","https://gcdn.thunderstore.io/live/repository/icons/RiskofThunder-R2API_Deployable-1.0.1.png","is_active","R2API_Deployable","RiskofThunder","version_number","1.0.1","API for registering damage types","https://gcdn.thunderstore.io/live/repository/icons/RiskofThunder-R2API_DamageType-1.1.7.png","R2API_DamageType","1.1.7","Core R2API module","https://gcdn.thunderstore.io/live/repository/icons/RiskofThunder-R2API_Core-5.3.0.png","R2API_Core","5.3.0","API for registering Colors to the game","https://gcdn.thunderstore.io/live/repository/icons/RiskofThunder-R2API_Colors-1.0.3.png","R2API_Colors","1.0.3",{"_31":189,"_40":190,"_37":191},{"_31":186,"_40":187,"_37":188},{"_31":183,"_40":184,"_37":185},{"_31":180,"_40":181,"_37":182},{"_31":177,"_40":178,"_37":179},"Alloyed Collective","alloyed-collective","1766","Seekers of the Storm Update","seekers-of-the-storm","947","Survivors of the Void","survivors-of-the-void","185","Items","items","9","Mods","mods","1","short_description","Escape a chaotic alien planet by fighting through hordes of frenzied monsters – with your friends, or on your own. Combine loot in surprising ways and master each character until you become the havoc you feared upon your first crash landing.","Thunderstore is a mod database and API for downloading Risk of Rain 2 mods","wiki_url","https://github.com/risk-of-thunder/R2Wiki/wiki","discord_url","https://discord.gg/5MbXZvd","2020-12-11T19:02:12.263542Z","hero_image_url","https://gcdn.thunderstore.io/assets/riskofrain2/riskofrain2-bg-1920x620.webp","cover_image_url","https://gcdn.thunderstore.io/assets/riskofrain2/riskofrain2-cover-360x480.webp","community_icon_url","https://gcdn.thunderstore.io/assets/riskofrain2/riskofrain2-icon-192x192.webp","total_download_count",495120433,"total_package_count",7509,{"_31":129,"_105":20,"_192":193,"_32":194,"_195":196,"_197":198,"_42":199,"_200":201,"_202":203,"_112":-5,"_204":205,"_206":207,"_208":209},{"_27":212},[213,214,215,216,217,218,219,220,221,222],{"_35":224},{"_31":32,"_33":225},{"_88":102,"_33":103},{"_88":100,"_33":101},{"_88":98,"_33":224},{"_88":96,"_33":194},{"_88":94,"_33":205},{"_88":93,"_33":223},{"_88":91,"_33":223},{"_88":89,"_33":90},"88","The Risk of Rain 2 Mod Database","Mods for Risk of Rain 2","publicEnvVariables",{"_250":248,"_251":248,"_252":248,"_253":254,"_255":256,"_257":248,"_258":259,"_260":261,"_262":263},"currentUser","config",{"_247":248,"_249":-7},{"_27":232},[233,234,235,236,237,238],{"_35":90},{"_31":32,"_33":246},{"_31":245,"_33":244},{"_31":243,"_33":244},{"_241":242},{"_31":239,"_33":240},"viewport","width=device-width, initial-scale=1","charSet","utf-8","theme-color","#29295b","msapplication-TileColor","An ecosystem for sharing mods for games!","apiHost","https://thunderstore.io","sessionId","VITE_SITE_URL","VITE_BETA_SITE_URL","VITE_API_URL","VITE_COOKIE_DOMAIN",".thunderstore.io","VITE_AUTH_BASE_URL","https://auth.thunderstore.io","VITE_AUTH_RETURN_URL","VITE_CLIENT_SENTRY_DSN","https://0dde07a3b02487bf768e90666ab8a83f@o578525.ingest.us.sentry.io/4509966833352704","VITE_RYBBIT_SITE_ID","00e7a81e15fc","VITE_RYBBIT_ANALYTICS_HOST","https://rybbit.thunderstore.io/api"]

Details

Categories

Mod Compatibility