Looty
ChangelogBack to Editor

BetterLoot Documentation

Understanding the V4 Loot Profile System

Tutorial Video

What are Loot Profiles?

Loot Profiles are a powerful system that allows you to create reusable item groups with controlled probability distributions. This system separates the concept of "what items can spawn" from "how often they spawn" in your loot tables.

Loot Profiles (Global)

  • •Reusable: Create once, use across any loot table
  • •Item Probabilities: Must total 100% within each profile
  • •Profile RNG: Controls distribution between items in the profile
  • •Example: 60% weapon A, 40% weapon B

Loot Tables (Import)

  • •Import RNG: Chance the profile is selected
  • •Total Probability: All profiles must total ≤100%
  • •Ungrouped Items: Fill remaining percentage automatically
  • •Example: 30% profile A, 20% profile B, 50% ungrouped

RNG Flow Example

1
Profile Selection
RNG roll (1-100) determines if a profile is selected
If you have profiles totaling 40%, then RNG ≤40% selects a profile, RNG >40% goes to ungrouped
2
Profile RNG
If profile selected, RNG roll within profile determines item
Within "Tier 1 Weapons" profile: 60% bow, 40% crossbow
3
Ungrouped Fallback
If no profile selected, item chosen from ungrouped items
When RNG >40%, item spawns from ungrouped items instead
4
Item Amount
Final RNG determines quantity (min-max range)
If item has min:1, max:3, RNG determines if you get 1, 2, or 3 of that item

Interactive Demo

Configuration

Weapons Profile:30%
Tools Profile:20%
Ungrouped:50%
Total:100%

Current Roll

Click "Roll Once" to start!

Roll History

No rolls yet

🎉BetterLoot - Advanced Item Properties

Version 4.1.1 introduces powerful new features for fine-tuning item properties, including durability settings, weapon attachments, ammunition configuration, and bonus items support. Version 4.2.0 adds per-entry Allow Duplicates on ungrouped items and loot profile items: when disabled, that entry will not roll again if it already spawned for the container (overriding broader duplicate rules). Guaranteed items and bonus items do not use this field.

Duplicate resolution (plugin, v4.2.0)

  • Unique entries: the table rolls again and picks from other items. Inside a loot group, the plugin prefers the higher-probability neighbor, or the previous lower-index neighbor if the blocked entry is last (and not alone)—but only if the probability gap is within the configured nudge (“Allowed probability difference to select neighbour during duplicate item resolution”), so a very common line does not effectively promote a rare neighbor.
  • No group pick: fallback uses ungrouped items weighted by the internal rarity index; duplicate picks retry up to a limit.
  • Single unique item, min/max > 1: the plugin does not invent extra items—you may get fewer drops than min/max unless other entries can fill the table.
  • Avoid turning off duplicates globally unless you understand the impact; prefer per-item settings so min/max behavior stays predictable.

⚙️ Item Durability

Set minimum and maximum durability (0-100%) for items that support condition. Only available for weapons, tools, and attire.

  • Automatically detected for compatible items
  • Range: 0% to 100%
  • Default: 100% (full condition)

🔫 Weapon Attachments

Configure which weapon mods can spawn and their spawn probability. Set min/max attachment counts per weapon.

  • Configure spawn probability per attachment
  • Set attachment durability ranges
  • Control min/max attachment amounts

💣 Ammunition Settings

Configure ammo type and amounts for weapons. Supports all ammo types including rifle, pistol, shotgun, arrows, rockets, and more.

  • Select from all available ammo types
  • Set min/max ammo amounts
  • Single-shot weapons (bows, rockets) use probability

🎁 Bonus Items

Add bonus items that spawn alongside the main item. Each bonus item can have its own durability, attachments, and properties.

  • Full customization per bonus item
  • Supports all item properties
  • Set min/max amounts

How to Use

  1. 1Click the "Advanced Properties" button on any item card
  2. 2Configure durability, ammunition, attachments, or bonus items as needed
  3. 3Click "Save Changes" to apply your settings
  4. 4All settings are automatically included when downloading your loot table

Note: When uploading older loot table formats, you'll be prompted to upgrade to the new format. The upgrade preserves all existing data and adds default values for the new features.