Random Loot Mod Wiki

Random Loot Mod transforms the standard Minecraft progression by replacing static tool tiers with a dynamic, RPG-style loot system. Instead of simply crafting a diamond sword, players obtain Loot Cases through combat or exploration. These cases contain randomized equipment—swords, pickaxes, axes, and shovels—each featuring unique names, varying base stats, and special traits.

As players use these tools, they gain experience and level up, further enhancing their attributes. The mod also features a scaling system where the quality of loot improves the more cases a player opens, rewarding long-term survival and battle-hardened explorers.

Loot Cases are the primary method of obtaining gear in this mod. They act as consumable containers that, when right-clicked, generate a random piece of equipment and are consumed in the process.

Acquisition

Loot Cases can be found in two primary ways:

1. Structure Loot: There is a 25% chance for a Loot Case to appear in any naturally generated chest within structures such as Dungeons, Mineshafts, Desert Temples, Nether Fortresses, and End Cities.
2. Mob Drops: Killing hostile mobs and bosses has a chance to drop a Loot Case. Bosses like the Wither or Ender Dragon have significantly higher drop rates compared to standard mobs like Zombies or Creepers.

Automation

Loot Cases can be placed inside a Dispenser. When the dispenser is activated, it will "open" the case and drop the resulting tool into the world. However, tools opened via dispensers do not contribute to the player's global progress and will always generate with the lowest possible base stats (Level 0).

Every item generated from a Loot Case is unique. The mod uses a procedural naming system and a randomized stat generator to ensure no two tools are exactly alike.

Tool Types

Currently, the mod supports the following tool types:

• Swords: Focused on Attack Damage and Attack Speed.
• Pickaxes: Focused on Mining Speed and Reach.
• Axes: High damage but slower attack speed; efficient at wood breaking.
• Shovels: High efficiency for soft blocks.

Rarity Tiers

Tools are assigned a rarity tier upon generation, which determines the multiplier for their base stats and the number of traits they can possess.

Tool Attributes

Tools can roll with bonuses to the following player attributes:

• Attack Damage: Increases the raw damage dealt per hit.
• Attack Speed: Increases how quickly the tool can be swung.
• Reach Distance: Increases the distance from which you can hit mobs or break blocks.
• Max Health: Grants extra heart containers while the tool is held.
• Movement Speed: Increases the player's walking/running speed while the tool is held.
• Armor & Toughness: Provides defensive bonuses similar to wearing armor pieces.

Traits are special enchant-like abilities that provide unique utility or combat effects. These are separate from standard Minecraft enchantments and can be viewed by holding Control while hovering over the item.

Common Traits

• Living: The tool is "alive" and will slowly repair its own durability over time.
• Lifesteal: A portion of the damage dealt to enemies is returned to the player as health.
• Fire: Sets the target on fire for a duration upon hit.
• Unbreakable: The tool has infinite durability and can never be destroyed.
• Phasing: Attacks ignore a percentage of the target's armor or can strike through certain obstacles.
• Enlightened: Increases the amount of experience the player gains from all sources while held.
• Hacker: Significantly boosts attack speed at the cost of some base damage.

Biome-Specific Traits

Certain traits only have a chance to appear if the Loot Case is opened within a specific biome. For example, tools opened in the Nether may roll with fire-resistance-related traits, while those opened in the Deep Dark may have stealth-based modifiers.

Unlike standard gear, Random Loot items are modified using Trait Templates and the Smithing Table.

Trait Templates

There are two types of templates found in dungeon chests:

1. Trait Addition Template: Used to add a specific trait to a tool.
2. Trait Subtraction Template: Used to remove an unwanted trait. You can convert an Addition Template into a Subtraction Template by right-clicking with it in your hand.

Smithing Table Recipes

To modify a tool, place the following into a Smithing Table:

• Slot 1: Trait Template (Addition or Subtraction).
• Slot 2: The Random Tool you wish to modify.
• Slot 3: The Catalyst Item (e.g., Blaze Powder for Fire, Diamond for Durability, etc.).

This allows players to customize their Legendary gear to fit their specific playstyle.

The mod features a Global Progress system. Every time a player opens a Loot Case, the mod tracks it. As the total number of opened cases increases, the "Level" of future generated tools also increases. This ensures that the loot found in the late game is significantly more powerful than the loot found on day one.

Tool Leveling

Each tool has its own internal XP bar. By using the tool for its intended purpose (attacking for swords, mining for pickaxes), the tool will level up.

• Level Up Bonus: Upon leveling up, a tool will randomly increase one of its base attributes (e.g., +0.5 Attack Damage).
• Shift View: Hold Shift while hovering over a tool to see its current XP progress, level, and a detailed breakdown of its current stats.

Server administrators and modpack creators can fine-tune the experience via the randomloot-server.toml configuration file.

Adjustable settings include:

• Drop Chances: Modify the 25% base chance for cases to appear in chests.
• Mob Drop Rates: Enable or disable cases dropping from specific mob categories.
• Rarity Weights: Change how often Legendary items appear compared to Common ones.
• Trait Blacklist: Disable specific traits (like Unbreakable) if they are considered too powerful for a specific modpack environment.