ItemStringParser

ItemStringParser This mod is a library for parsing ItemStrings. See bottom on the developer manual. User Manual ItemStrings are a way to describe a droptable using plain text. They let you describe what items should appear and how many in a simple, readable line. ItemStrings can include instructions for repeating items, choosing items randomly, or excluding certain items. ItemString Operators ItemString operators are symbols that help you decide which items to give, repeat, or exclude in a list. They make it easy to write rules like "give this item", "skip that one", or "choose one randomly" using short codes. Each entry in the ItemString roughly follows the format: <repeat>x<itemkey>!<itemname>*<multiplier>: <weight> Entries can be separated by & or | . Entries can be grouped with { and } . ! (Not-Operator) Purpose: Blacklist items from tiers or droptables. Placement: Directly after the name of the droptable or tier. Example: Tier1!Hoof - White item but not a Hoof dtChest1!Bear!Crowbar - Content of a Small Chest but neither Tougher Times nor Crowbar. & (And-Operator) Purpose: Every item separated by & will be selected. Example: Hoof & Boss - The player receives both a Hoof and a random Boss item. | (Or-Operator) Purpose: Only one of the items separated by | will be chosen at random. Weights: You can specify selection weights using a colon : after the item (e.g., Tier1: 0.5 | Tier2: 0.5 ). Example: Tier1 | Tier2 - The player gets either a Tier1 or a Tier2 item (equal chance unless weighted). : (Weight Separator) Purpose: Assigns probability weights to options with the Or-Operator ( | ). Default: If omitted, the default weight 1 is used. Example: Tier1: 0.6 | Tier2: 0.4 - Tier1 has a 60% chance, Tier2 a 40% chance. Tier1: 3.0 | Tier2 - Tier1 has a 75% chance, Tier2 a 25% chance. x (Repeat-Operator) Purpose: Repeats the immediately following item or group a fixed number of times. Placement: Directly before a group or item. Example: 5xHoof - The player gets 5 Hoof items. 3x{ Tier1 | Tier2 } - The player gets 3 times a randomly selected item from Tier1 or Tier2. * (Multiplier-Operator) Purpose: Multiplies the amount of items of a group. Placement: Directly after a group or item. Example: Hoof*5 - The player gets 5 Hoof items. { Tier1 | Tier2 }*3 - The player gets 3 copies of a single type of item from either Tier1 or Tier2. { and } (Grouping Symbols) Purpose: Group items and operators together. Can use & and | within a group, but they cannot be mixed. Operator precedence: Use { } to explicitly control grouping and order of operations, especially when combining repeat, and, or multiply. Nested groups: You can nest { } for more complex item generation logic. Example: { 2xdtChest1 | dtChest2 } - Represents a choice between "2x small chest" and "1 large chest" as a single entity; useful with other operators. Summary Table Operator Symbol Description Example Not ! Blacklists the item from the group A!B And & All items, together A & B Or | Only one item, random (optional weight via : ) A | B:0.7 | C:0.3 Weight : Specifies probability weight for options when using | A: 0.6 | B: 0.4 Repeat x Repeats the following item/group N times 5xA or 3x{A | B} Multiply * Multiplies the amount of items in the group by N {A & B}*4 Grouping {} Groups items/expressions {A & 2xB} Examples A random lunar item, except for Light Flux Pauldron and Stone Flux Pauldron: ItemList = Lunar!HalfSpeedDoubleHealth!HalfAttackSpeedHalfCooldowns 5 Hooves: ItemList = 5xHoof Also 5 Hooves: ItemList = Hoof*5 5 random whites: ItemList = 5xTier1 5 copies of the same white: ItemList = Tier1*5 5 Hooves and 2 Armor Plates: ItemList = 5xHoof & 2xArmorPlate Either 5 Hooves or 2 Armor Plates: ItemList = 5xHoof | 2xArmorPlate Either 5 Hooves with 30% chance or 2 Armor Plates with 70% chance: ItemList = 5xHoof: 0.3 | 2xArmorPlate: 0.7 Infusion and either 5 Hooves with 30% chance or 2 Armor Plates with 70% chance: ItemList = Infusion & { 5xHoof: 0.3 | 2xArmorPlate: 0.7 } Either Infusion or Feather and either 5 Hooves with 30% chance or 2 Armor Plates with 70% chance: ItemList = { Infusion | Feather } & { 5xHoof: 0.3 | 2xArmorPlate: 0.7 } 75% chance: Infusion and feather, 25% chance: 5 hoves and 5 Armor Plates ItemList = { Infusion & Feather }: 0.75 | { Hoof & ArmorPlate }*5: 0.25 Either 5 whites or 3 greens or 1 red: ItemList = 5xTier1 | 3xTier2 | Tier3 Between 1 and 5 whites. ItemList = 1xTier1 | 2xTier1 | 3xTier1 | 4xTier1 | 5xTier1 10 random items which consist of around 50% whites, around 35% greens and around 15% red: ItemList = 10x{ Tier1: 0.5 | Tier2: 0.35 | Tier3: 0.15 } 5 times one of the following: Either the contents of 2 small chests (except for Tougher Times) or the content of 1 large chest ItemList = 5x{ 2xdtChest1!Bear | dtChest2 } Preon Accumulator and 10 Gesture of the Drowned or Ifrit's Distinction and 1 Ignition Tank { BFG & 10xAutoCastEquipment } | { EliteFireEquipment & StrengthenBurn } Item Keywords You can use: Internal item names (see R2Wiki - Items-and-Equipments-Data ). Item Tier names : Tier1 , Tier2 , Tier3 , Lunar , Boss , VoidTier1 , VoidTier2 , VoidTier3 , VoidBoss , FoodTier Droptable names : e.g. dtChest1 , dtLunarChest , dtVoidChest . See below. Droptable Names Here is a list of supported droptables: Drop Table Name tier1 tier2 tier3 boss lunarEquipment lunarItem lunarCombined equipment voidTier1 voidTier2 voidTier3 voidBoss foodTier powerShapes canDropBeReplaced requiredItemTags bannedItemTags dtCasinoChest 0.7 0.3 0.01 0 0 0 0 0.1 0 0 0 0 0 0 True dtSmallChestDamage 0.8 0.2 0.01 0 0 0 0 0 0 0 0 0 0 0 True Damage dtSmallChestHealing 0.8 0.2 0.01 0 0 0 0 0 0 0 0 0 0 0 True Healing dtSmallChestUtility 0.8 0.2 0.01 0 0 0 0 0 0 0 0 0 0 0 True Utility dtChest1 0.8 0.2 0.01 0 0 0 0 0 0 0 0 0 0 0 True dtChest2 0 0.8 0.2 0 0 0 0 0 0 0 0 0 0 0 True dtAISafeTier1Item 1 0 0 0 0 0 0 0 0 0 0 0 0 0 True AIBlacklist, SprintRelated dtAISafeTier2Item 0 1 0 0 0 0 0 0 0 0 0 0 0 0 True AIBlacklist, SprintRelated dtAISafeTier3Item 0 0 1 0 0 0 0 0 0 0 0 0 0 0 True AIBlacklist, SprintRelated dtEquipment 0 0 0 0 0 0 0 1 0 0 0 0 0 0 True dtTier1Item 1 0 0 0 0 0 0 0 0 0 0 0 0 0 True dtTier2Item 0 1 0 0 0 0 0 0 0 0 0 0 0 0 True dtTier3Item 0 0 1 0 0 0 0 0 0 0 0 0 0 0 True dtVoidChest 0 0 0 0 0 0 0 0 6 3 1 0 0 0 True dtDuplicatorTier1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 True CannotDuplicate dtDuplicatorTier2 0 1 0 0 0 0 0 0 0 0 0 0 0 0 True CannotDuplicate dtDuplicatorTier3 0 0 1 0 0 0 0 0 0 0 0 0 0 0 True CannotDuplicate dtDuplicatorWild 0 0 0 1 0 0 0 0 0 0 0 0 0 0 True WorldUnique dtGoldChest 0 0 1 0 0 0 0 0 0 0 0 0 0 0 True dtLunarChest 0 0 0 0 0 0 1 0 0 0 0 0 0 0 True dtMonsterTeamTier1Item 1 0 0 0 0 0 0 0 0 0 0 0 0 0 True AIBlacklist, OnKillEffect, EquipmentRelated, SprintRelated dtMonsterTeamTier2Item 0 1 0 0 0 0 0 0 0 0 0 0 0 0 True AIBlacklist, OnKillEffect, EquipmentRelated, SprintRelated dtMonsterTeamTier3Item 0 0 1 0 0 0 0 0 0 0 0 0 0 0 True AIBlacklist, OnKillEffect, EquipmentRelated, SprintRelated dtSacrificeArtifact 0.7 0.3 0.01 0 0 0 0 0.1 0 0 0 0 0 0 True SacrificeBlacklist dtShrineChance 8 2 0.2 0 0 0 0 2 0 0 0 0 0 0 True dtLockbox 0 4 1 0 0 0 0 0 0 0 0 0 0 0 True dtCommandChest 0.2 0.2 0.05 0.05 0 0 0 0.2 0.1 0.1 0.05 0.05 0 0 True Any, Any, Any, Any, Any dtCategoryChest2Damage 0 0.8 0.2 0 0 0 0 0 0 0 0 0 0 0 True Damage dtCategoryChest2Healing 0 0.8 0.2 0 0 0 0 0 0 0 0 0 0 0 True Healing dtCategoryChest2Utility 0 0.8 0.2 0 0 0 0 0 0 0 0 0 0 0 True Utility dtITBossWave 0 80 7.5 7.5 0 0 0 0 0 0 0 0 0 0 True dtITDefaultWave 80 10 0.25 0.25 0 0 0 0 0 0 0 0 0 0 True dtITLunar 0 0 0 0 0 0 100 0 0 0 0 0 0 0 True dtITSpecialBossWave 0 0 80 20 0 0 0 0 0 0 0 0 0 0 True dtITVoid 0 0 0 0 0 0 0 0 80 20 1 0 0 0 True dtVoidLockbox 0 0 0 0 0 0 0 0 5 5 2 0 0 0 True dtVoidCamp 40 40 10 3 0 0 0 0 5.714286 5.714286 1.25 0 0 0 True dtVoidTriple 0.8 0.2 0.01 0 0 0 0 0 0 0 0 0 0 0 True AurelioniteHeartPickupDropTable 0 0 0.4 0.6 0 0 0 0 0 0 0 0 0 0 True dtShrineHalcyoniteTier1 0.65 0.3 0.05 0 0 0 0 0 0 0 0 0 0