fabric/fabric-loot-api-v3/README.md

# Fabric Loot API (v3)

This module includes APIs for modifying and creating loot tables.

## [Loot table events](src/main/java/net/fabricmc/fabric/api/loot/v3/LootTableEvents.java)

This class provides two events for modifying loot tables.

`LootTableEvents.REPLACE` runs first and lets you replace loot tables completely.

`LootTableEvents.MODIFY` runs after and lets you modify loot tables,  including the ones created in `REPLACE`,
by adding new loot pools or loot functions to them.

### Loot table sources

Both events have access to a [loot table source](src/main/java/net/fabricmc/fabric/api/loot/v3/LootTableSource.java)
that you can use to check where a loot table is loaded from.

For example, you can use this to check if a loot table is from a user data pack and
not modify the user-provided data in your event.

## Enhanced loot table and loot pool builders

`LootTable.Builder` and `LootPool.Builder` implement
injected interfaces ([`FabricLootTableBuilder`](src/main/java/net/fabricmc/fabric/api/loot/v3/FabricLootTableBuilder.java)
and [`FabricLootPoolBuilder`](src/main/java/net/fabricmc/fabric/api/loot/v3/FabricLootPoolBuilder.java))
which have additional methods for dealing with already-built objects and collections of objects.

Those interfaces also have `copyOf` methods for creating copies of existing loot tables/pools as builders.