Item Rarity

Item Rarity Mod

 

Add excitement and variety to your Vintage Story experience with the Item Rarity Mod! This mod introduces a  rarity system** for tools, affecting their stats and adding special effects. Every time you craft or find a tool, it has a chance to receive a rarity making each item feel unique and powerful!

---

Features

Stat Modifiers

Each rarity level modifies core tool stats, making tools stronger or more efficient based on their rarity.

Affected stats:

• Durability - Increase or decrease items durability.
• Mining Speed - Increase or decrease mining speed.
• Attack Power - Increase or decrease damage dealt.
• Attack Range - Increase or decrease the reach of melee weapons.
• Piercing Power - Increase or decrease damage dealt by piercing attacks (thrown spears, arrows, etc.).
• Armor Flat Damage Reduction - Increase or decrease flat damage reduction on armor.
• Shield Protection - Increase or decrease the effectiveness of shields.
  
  

---

Magical Effects

Rarities can also grant magical effects. These effects can add dramatic new abilities to your tools.

Available effects:

• Thor – When hitting a target with a piercing weapon, strikes lightning and sets the target on fire.
  
  

---

Commands

⚠️ All commands require operator (admin) permissions.

<table> <thead> <tr> <th>Command</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>/rarity set <rarity></td> <td>Assigns the specified rarity to the item currently held.</td> </tr> <tr class="intellij-row-even"> <td>/rarity reload</td> <td>Reloads the configuration without restarting the game/server.</td> </tr> <tr> <td>/rarity roll <times></td> <td>Simulates multiple rarity rolls and displays results with probabilities.</td> </tr> </tbody> </table>

---

Configuration

Customize rarities to match your server's balance or your personal gameplay style.&nbsp;Each rarity level supports detailed&nbsp;customization.&nbsp;You can create as many rarities as you want and adjust their stats to balance gameplay your way.

Multipliers supports fixed number e.g&nbsp;1.5&nbsp;or range e.g&nbsp;[0.2, 0.9].&nbsp;When using a range,&nbsp;the multiplier is chosen randomly within the range.

Example Configuration

<pre class="code-fence">"my-super-rarity": { "Key": "my-super-rarity", "Name": "Super Rarity", "Level": 4, "Color": "#606060", "Weight": 8.0, "DurabilityMultiplier": [0.2, 0.9], "MiningSpeedMultiplier": 1.5, "AttackPowerMultiplier": 1.5, "AttackRangeMultiplier": 1.5, "PiercingPowerMultiplier": 1.5, "ArmorFlatDamageReductionMultiplier": 1.5, "ArmorPerTierFlatDamageProtectionLossMultiplier": 1.5, "ShieldProtectionMultiplier": 2, "CustomAttributes": {}, "Effects": ["Thor"], "IgnoreTranslation": false }</pre>
<table> <thead> <tr> <th>Field</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>Key</td> <td>Key used by the mod to identify rarities.&nbsp;BE CAREFUL CHANGING THIS CAN CAUSE PROBLEMS</td> </tr> <tr class="intellij-row-even"> <td>Name</td> <td>Display name of the rarity (can be localized).</td> </tr> <tr> <td>Level</td> <td>Numerical rarity level (It is a numerical representation of the rarity).</td> </tr> <tr class="intellij-row-even"> <td>Color</td> <td>Hex color code shown in item display.</td> </tr> <tr> <td>Weight</td> <td>Used for selection. Higher = more common.&nbsp;(See "How Rarity Works" below)</td> </tr> <tr class="intellij-row-even"> <td>DurabilityMultiplier</td> <td>Affects durability.</td> </tr> <tr> <td>MiningSpeedMultiplier</td> <td>Affects mining speed.</td> </tr> <tr class="intellij-row-even"> <td>AttackPowerMultiplier</td> <td>Affects melee damage.</td> </tr> <tr> <td>AttackRangeMultiplier</td> <td>Affects weapon reach.</td> </tr> <tr class="intellij-row-even"> <td>PiercingPowerMultiplier</td> <td>Affects piercing damage.</td> </tr> <tr> <td>ArmorFlatDamageReductionMultiplier</td> <td>Affects armor flat damage reduction.</td> </tr> <tr class="intellij-row-even">