Looty
Back 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 V4.1.1 - 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.

⚙️ 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.