mcMMO Unofficial Docs - treasures.yml

Excavation's Archaeology loot table, what each treasure is, its drop chance, XP, level requirement, and which blocks it drops from.

treasures.yml is the Excavation (Archaeology) loot table. Each entry sets:

Field	Meaning
`Amount`	Stack size dropped
`XP`	Excavation XP granted on drop
`Drop_Chance`	Percent chance per qualifying dig
`Level_Requirement`	Min level (`Standard_Mode` / `Retro_Mode`)
`Drops_From`	Blocks that can yield this treasure

This is one of the files that does not auto-merge new keys on update. If you customize it, hand-update it each release (or delete it to regenerate fresh defaults). For example the MUSIC_DISC_BOUNCE treasure added in 2.2.054 will not appear in an existing treasures.yml — add the entry by hand, or delete the file to regenerate it (a copy of the default is saved to defaults/treasures.yml).

How entries are loaded

A bad treasure entry no longer takes mcMMO down with it. As of 2.2.054, treasures.yml and fishing_treasures.yml classify every entry at startup:

Incompatible — the material (or potion type) doesn't exist in your server's Minecraft version. These are skipped quietly, so a config that lists newer blocks stays valid on older servers.
Invalid / misconfigured — a genuinely broken entry (bad number, malformed value). These are skipped and logged as a warning that names the exact config key, so you can find and fix them instead of the whole plugin refusing to start.
Loaded — everything else.

Each section prints a short load summary (how many treasures loaded) so you can confirm your loot tables came up as expected. Check your startup log after editing.

Default `treasures.yml`

Full default file shipped with mcMMO 2.2.054:

#
#  Settings for Excavation's Archaeology
###
Excavation:
    HEART_OF_THE_SEA:
        Amount: 1
        XP: 9999
        Drop_Chance: 0.01
        Level_Requirement:
            Standard_Mode: 90
            Retro_Mode: 900
        Drops_From: [Mud]
    POTATO:
        Amount: 1
        XP: 50
        Drop_Chance: 3.0
        Level_Requirement:
            Standard_Mode: 10
            Retro_Mode: 100
        Drops_From: [Dirt, Mud]
    SPYGLASS:
        Amount: 1
        XP: 500
        Drop_Chance: 0.1
        Level_Requirement:
            Standard_Mode: 7
            Retro_Mode: 70
        Drops_From: [Mud, Dirt]
    STICK:
        Amount: 2
        XP: 50
        Drop_Chance: 2.0
        Level_Requirement:
            Standard_Mode: 1
            Retro_Mode: 10
        Drops_From: [Mud, Muddy_Mangrove_Roots]
    FEATHER:
        Amount: 3
        XP: 100
        Drop_Chance: 1.0
        Level_Requirement:
            Standard_Mode: 5
            Retro_Mode: 50
        Drops_From: [Mud]
    TRIDENT:
        Amount: 1
        XP: 100
        Drop_Chance: 0.02
        Level_Requirement:
            Standard_Mode: 40
            Retro_Mode: 400
        Drops_From: [Mud, Clay, Muddy_Mangrove_Roots]
    CAKE:
        Amount: 1
        XP: 3000
        Drop_Chance: 0.05
        Level_Requirement:
            Standard_Mode: 75
            Retro_Mode: 750
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Clay, Mycelium, Soul_Sand, Soul_Soil]
    GUNPOWDER:
        Amount: 1
        XP: 30
        Drop_Chance: 10.0
        Level_Requirement:
            Standard_Mode: 10
            Retro_Mode: 100
        Drops_From: [Gravel]
    BONE:
        Amount: 1
        XP: 30
        Drop_Chance: 10.0
        Level_Requirement:
            Standard_Mode: 20
            Retro_Mode: 200
        Drops_From: [Gravel, Mud]
    APPLE:
        Amount: 1
        XP: 100
        Drop_Chance: 0.1
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Grass_Block, Mycelium]
    SLIME_BALL:
        Amount: 1
        XP: 100
        Drop_Chance: 5.0
        Level_Requirement:
            Standard_Mode: 15
            Retro_Mode: 150
        Drops_From: [Clay]
    BUCKET:
        Amount: 1
        XP: 100
        Drop_Chance: 0.1
        Level_Requirement:
            Standard_Mode: 50
            Retro_Mode: 500
        Drops_From: [Clay]
    NETHERRACK:
        Amount: 1
        XP: 30
        Drop_Chance: 0.5
        Level_Requirement:
            Standard_Mode: 85
            Retro_Mode: 850
        Drops_From: [Gravel]
    RED_MUSHROOM:
        Amount: 1
        XP: 80
        Drop_Chance: 0.5
        Level_Requirement:
            Standard_Mode: 50
            Retro_Mode: 500
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Mycelium, Mud]
    BROWN_MUSHROOM:
        Amount: 1
        XP: 80
        Drop_Chance: 0.5
        Level_Requirement:
            Standard_Mode: 50
            Retro_Mode: 500
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Mycelium, Mud]
    EGG:
        Amount: 1
        XP: 100
        Drop_Chance: 1.0
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Grass_Block]
    SOUL_SAND:
        Amount: 1
        XP: 80
        Drop_Chance: 0.5
        Level_Requirement:
            Standard_Mode: 65
            Retro_Mode: 650
        Drops_From: [Sand, Red_Sand]
    CLOCK:
        Amount: 1
        XP: 100
        Drop_Chance: 0.1
        Level_Requirement:
            Standard_Mode: 50
            Retro_Mode: 500
        Drops_From: [Clay]
    COBWEB:
        Amount: 1
        XP: 150
        Drop_Chance: 5.0
        Level_Requirement:
            Standard_Mode: 75
            Retro_Mode: 750
        Drops_From: [Clay]
    STRING:
        Amount: 1
        XP: 200
        Drop_Chance: 5.0
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Clay]
    GLOWSTONE_DUST:
        Amount: 1
        XP: 80
        Drop_Chance: 5.0
        Level_Requirement:
            Standard_Mode: 5
            Retro_Mode: 50
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Mycelium]
    MUSIC_DISC_13:
        Amount: 1
        XP: 3000
        Drop_Chance: 0.05
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Clay, Mycelium, Soul_Sand, Soul_Soil]
    MUSIC_DISC_CAT:
        Amount: 1
        XP: 3000
        Drop_Chance: 0.05
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Clay, Mycelium, Soul_Sand, Soul_Soil]
    MUSIC_DISC_BOUNCE:
        Amount: 1
        XP: 3000
        Drop_Chance: 0.01
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Clay, Mycelium, Soul_Sand, Soul_Soil]
    DIAMOND:
        Amount: 1
        XP: 1000
        Drop_Chance: 0.13
        Level_Requirement:
            Standard_Mode: 35
            Retro_Mode: 350
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Clay, Mycelium, Soul_Sand, Soul_Soil, Mud]
    COCOA_BEANS:
        Amount: 1
        XP: 100
        Drop_Chance: 1.33
        Level_Requirement:
            Standard_Mode: 35
            Retro_Mode: 350
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Mycelium, Mud]
    QUARTZ:
        Amount: 1
        XP: 100
        Drop_Chance: 0.5
        Level_Requirement:
            Standard_Mode: 85
            Retro_Mode: 850
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Mycelium, Soul_Sand, Soul_Soil]
    NAME_TAG:
        Amount: 1
        XP: 3000
        Drop_Chance: 0.05
        Level_Requirement:
            Standard_Mode: 25
            Retro_Mode: 250
        Drops_From: [Dirt, Coarse_Dirt, Podzol, Grass_Block, Sand, Red_Sand, Gravel, Clay, Mycelium, Soul_Sand, Soul_Soil]

#
#  Settings for Hylian Luck
#  If you are in retro mode, Level_Requirement is multiplied by 10.
###
Hylian_Luck:
    MELON_SEEDS:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Bushes]
    PUMPKIN_SEEDS:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Bushes]
    COCOA_BEANS:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Bushes]
    CARROT:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Flowers]
    POTATO:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Flowers]
    APPLE:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Flowers]
    EMERALD:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Pots]
    DIAMOND:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Pots]
    GOLD_NUGGET:
        Amount: 1
        XP: 0
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Pots]
    COPPER_NUGGET:
        Amount: 1
        XP: 5
        Drop_Chance: 100.0
        Level_Requirement:
            Standard_Mode: 0
            Retro_Mode: 0
        Drops_From: [Pots]

treasures.yml

How entries are loaded

Default treasures.yml

On this page

Default `treasures.yml`