Lucky Charm Mod banner

A simple mod that reworks loot generation in minecraft using the long-forgotten luck entity attribute only previously used in fishing gameplay when using the luck of the sea enchantment. When having luck, new probabilities for each entry in the loot pool are calculated when generating the loot. The probabilities calculated will give on average better quality loot according to each entry's quality value.

How to play

The basic way you can increase your luck is by drinking luck potions, which are now craftable. To craft them you need to brew awkward potions with a four leaf clover, which you can obtain from grass. Like any other craftable vanilla potion, you can either add redstone to increase the duration or glowstone to brew a Luck II potion for less duration. Similarly you can make splash and lingering potions. You may then use these potions to aid in your search for Gems of Fortune and the Fortuned Traveller Perk Smithing Template which when applied to your armor give a +1 luck boost for each armor piece. The maximum survival-obtainable luck value would then be 6 (a full set of armor plus Luck II potions). With Luck 6 you can obtain insane loot from chests (might be overpowered I haven't playtested enough to be sure):

An ancient city chest opened with Luck 6 featuring 3 enchanted golden apples, a Silence Armor Trim and a Swift Sneak 3 book A treasure bastion chest opened with Luck 6 featuring an enchanted golden apple, two netherite ingots and a netherite upgrade

Then of course, obtaining these items is relatively hard as they are quite rare and can only be found in archaeology sites, desert pyramids, underwater ruins, and shipwreck treasure chests with low chances. Luck also affects the loot from suspicious gravel and suspicious sand. Witches and Elder Guardians have a chance to curse the player with unluckiness which would subtract luck points and give worse loot.

Compatibility / Troubleshooting

This mod should be compatible with most mods, however it might conflict with other mods that directly change loot pools and loot tables. If you suspect this is the case you may first want to try deactivating the loot pool logic rework I've done. To do this, go to your config directory (usually /.minecraft/config/) and you should find lucky_charm.txt (if it does not exist for some reason just create it). The file should look like this:

doHyperLoot: true
replaceChestLootTables: true
replaceArchaeologyLootTables: true
exceptions: []

So set doHyperLoot: false and that should do the trick. However this then defaults to the original minecraft logic for loot pools which gives very different results to my algorithm, you may also prefer this. If this does fix the incompatibility you may then also want to try deactivating the replacement of vanilla loot tables by setting the corresponding field to false. This will basically disable all gameplay changes as it will use the default vanilla loot tables which are unaffected by luck. The exceptions field is if you wanted specific loot tables to bypass whatever setting you configured. You would include the name of the loot table in the brackets separating entries by commas or across multiple lines. To check the name of a loot table, go to /.minecraft/versions/{your_version}/{your_version}.jar and open the .jar with 7-zip or alike then go to /data/minecraft/loot_tables/{your_case}/{loot_table_name}.json should tell you the name of the loot table. Write the exact name of the .json file. If none of this works and you still have issues you may report your case in the issue tracker.

Custom Loot Tables

This mod supports custom loot tables added or changed via datapacks. This is not limited to only container loot tables but any kind of loot table and for any mod. To make use of the luck mechanics you just need to define a "quality" integer field for each entry of the loot pool in each table. Example (`loot_table.json'):

{
  "pools": [
    {
      "rolls": {
        "min": 2,
        "max": 4
      },
    "entries": [
        {
            "type": "item",
            "name": "minecraft:golden_apple",
            "weight": 20,
            "quality": 2
        },
        {
            "type": "item",
            "name": "minecraft:appleEnchanted",
            "weight": 1,
            "quality": 4
        },
        {
            "type": "item",
            "name": "minecraft:name_tag",
            "weight": 30
        }
    ]
    }
  ]
}

If you don't include this field it defaults to a value of 0.

Current state and future plans

This mod is still early beta, so it may contain bugs and the gameplay may be unbalanced and stale. Part of this is due to the subjective perception of quality and luck in gameplay which is why I want to make a better version that enables dynamic configuration of loot pools in game via a friendly UI that would be compatible with any mod's loot tables and would use this algorithm for lucky loot tables. If you read all of this and are looking forward to try my mod feel free to leave feedback and thank you very much :).